Word.WebSettings class

Paket:: word

Stellt die Einstellungen zum Speichern eines Word-Dokuments als Webseite dar.

Extends: OfficeExtension.ClientObject

Hinweise

Verwendet von

Word. Dokument: webSettings

Eigenschaften

allowPng	Gibt an, ob PNG als Bildformat zulässig ist, wenn ein Dokument als Webseite gespeichert wird. Der Standardwert ist `false`.
context	Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
encoding	Gibt die Dokumentcodierung (Codepage oder Zeichensatz) an, die vom Webbrowser beim Anzeigen des gespeicherten Dokuments verwendet werden soll.
folderSuffix	Ruft das Ordnersuffix ab, das beim Speichern eines Dokuments als Webseite mit langen Dateinamen und unterstützenden Dateien verwendet wird, in einem separaten Ordner.
organizeInFolder	Gibt an, ob unterstützende Dateien beim Speichern des Dokuments als Webseite in einem separaten Ordner organisiert werden. Der Standardwert ist `true`.
pixelsPerInch	Gibt die Dichte (Pixel pro Zoll) von Grafiken, Bildern und Tabellenzellen auf einer Webseite an.
relyOnCSS	Gibt an, ob Cascading Stylesheets (CSS) für die Schriftartformatierung verwendet werden, wenn ein gespeichertes Dokument in einem Webbrowser angezeigt wird. Der Standardwert ist `true`.
relyOnVectorMarkupLanguage	Gibt an, ob beim Speichern eines Dokuments als Webseite keine Bilddateien aus Zeichnungsobjekten generiert werden. Der Standardwert ist `false`.
screenSize	Gibt die ideale minimale Bildschirmgröße (Breite und Höhe, in Pixel) zum Anzeigen des gespeicherten Dokuments in einem Webbrowser an.
targetBrowser	Gibt den Zielbrowser für Dokumente an, die in einem Webbrowser angezeigt werden.
useLongFileNames	Gibt an, ob lange Dateinamen verwendet werden, wenn das Dokument als Webseite gespeichert wird. Der Standardwert ist `true`.

Methoden

load(options)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "`context.sync()`" aufrufen.
load(propertyNames)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "`context.sync()`" aufrufen.
load(propertyNamesAndPaths)	Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "`context.sync()`" aufrufen.
toJSON()	Überschreibt die JavaScript-Methode `toJSON()` , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an `JSON.stringify()`übergeben wird. (`JSON.stringify`ruft wiederum die `toJSON` Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche `Word.WebSettings` Objekt ein API-Objekt ist, gibt die `toJSON` Methode ein einfaches JavaScript-Objekt (als `Word.Interfaces.WebSettingsData`) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.
track()	Nachverfolgung des Objekts zwecks automatischer Anpassung auf der Grundlage der umgebenden Änderungen im Dokument. Dieser Aufruf ist eine Kurzform für context.trackedObjects.add(thisObject). Wenn Sie dieses Objekt aufrufübergreifend `.sync` und außerhalb der sequenziellen Ausführung eines ".run"-Batches verwenden und beim Festlegen einer Eigenschaft oder beim Aufrufen einer Methode für das Objekt ein "InvalidObjectPath"-Fehler angezeigt wird, müssen Sie das Objekt der nachverfolgten Objektsammlung hinzufügen, wenn das Objekt zum ersten Mal erstellt wurde. Wenn dieses Objekt Teil einer Sammlung ist, sollten Sie auch die übergeordnete Sammlung nachverfolgen.
untrack()	Gibt den diesem Objekt zugewiesenen Arbeitsspeicher frei, wenn das Objekt zuvor nachverfolgt wurde. Dieser Aufruf ist die Kurzform für context.trackedObjects.remove(thisObject). Viele nachverfolgte Objekte verlangsamen die Ausführung der Hostanwendung, also achten Sie darauf, alle hinzugefügten Objekte nach abgeschlossener Verwendung freizugeben. Sie müssen einen Aufruf durchführen `context.sync()` , bevor die Speicherfreigabe wirksam wird.
useDefaultFolderSuffix()	Legt das Ordnersuffix für das angegebene Dokument auf das Standardsuffix für die ausgewählte oder installierte Sprachunterstützung fest.

Details zur Eigenschaft

allowPng

Gibt an, ob PNG als Bildformat zulässig ist, wenn ein Dokument als Webseite gespeichert wird. Der Standardwert ist false.

allowPng: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.4

context

Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

Word.RequestContext

encoding

Gibt die Dokumentcodierung (Codepage oder Zeichensatz) an, die vom Webbrowser beim Anzeigen des gespeicherten Dokuments verwendet werden soll.

encoding: Word.DocumentEncoding | "Thai" | "JapaneseShiftJis" | "SimplifiedChineseGbk" | "Korean" | "TraditionalChineseBig5" | "UnicodeLittleEndian" | "UnicodeBigEndian" | "CentralEuropean" | "Cyrillic" | "Western" | "Greek" | "Turkish" | "Hebrew" | "Arabic" | "Baltic" | "Vietnamese" | "AutoDetect" | "JapaneseAutoDetect" | "SimplifiedChineseAutoDetect" | "KoreanAutoDetect" | "TraditionalChineseAutoDetect" | "CyrillicAutoDetect" | "GreekAutoDetect" | "ArabicAutoDetect" | "Iso88591Latin1" | "Iso88592CentralEurope" | "Iso88593Latin3" | "Iso88594Baltic" | "Iso88595Cyrillic" | "Iso88596Arabic" | "Iso88597Greek" | "Iso88598Hebrew" | "Iso88599Turkish" | "Iso885915Latin9" | "Iso88598HebrewLogical" | "Iso2022JpNoHalfwidthKatakana" | "Iso2022JpJisX02021984" | "Iso2022JpJisX02011989" | "Iso2022Kr" | "Iso2022CnTraditionalChinese" | "Iso2022CnSimplifiedChinese" | "MacRoman" | "MacJapanese" | "MacTraditionalChineseBig5" | "MacKorean" | "MacArabic" | "MacHebrew" | "MacGreek1" | "MacCyrillic" | "MacSimplifiedChineseGb2312" | "MacRomania" | "MacUkraine" | "MacLatin2" | "MacIcelandic" | "MacTurkish" | "MacCroatia" | "EbcdicUsCanada" | "EbcdicInternational" | "EbcdicMultilingualRoeceLatin2" | "EbcdicGreekModern" | "EbcdicTurkishLatin5" | "EbcdicGermany" | "EbcdicDenmarkNorway" | "EbcdicFinlandSweden" | "EbcdicItaly" | "EbcdicLatinAmericaSpain" | "EbcdicUnitedKingdom" | "EbcdicJapaneseKatakanaExtended" | "EbcdicFrance" | "EbcdicArabic" | "EbcdicGreek" | "EbcdicHebrew" | "EbcdicKoreanExtended" | "EbcdicThai" | "EbcdicIcelandic" | "EbcdicTurkish" | "EbcdicRussian" | "EbcdicSerbianBulgarian" | "EbcdicJapaneseKatakanaExtendedAndJapanese" | "EbcdicUsCanadaAndJapanese" | "EbcdicKoreanExtendedAndKorean" | "EbcdicSimplifiedChineseExtendedAndSimplifiedChinese" | "EbcdicUsCanadaAndTraditionalChinese" | "EbcdicJapaneseLatinExtendedAndJapanese" | "OemUnitedStates" | "OemGreek437G" | "OemBaltic" | "OemMultilingualLatinI" | "OemMultilingualLatinIi" | "OemCyrillic" | "OemTurkish" | "OemPortuguese" | "OemIcelandic" | "OemHebrew" | "OemCanadianFrench" | "OemArabic" | "OemNordic" | "OemCyrillicIi" | "OemModernGreek" | "EucJapanese" | "EucChineseSimplifiedChinese" | "EucKorean" | "EucTaiwaneseTraditionalChinese" | "IsciiDevanagari" | "IsciiBengali" | "IsciiTamil" | "IsciiTelugu" | "IsciiAssamese" | "IsciiOriya" | "IsciiKannada" | "IsciiMalayalam" | "IsciiGujarati" | "IsciiPunjabi" | "ArabicAsmo" | "ArabicTransparentAsmo" | "KoreanJohab" | "TaiwanCns" | "TaiwanTca" | "TaiwanEten" | "TaiwanIbm5550" | "TaiwanTeleText" | "TaiwanWang" | "Ia5Irv" | "Ia5German" | "Ia5Swedish" | "Ia5Norwegian" | "UsaAscii" | "T61" | "Iso6937NonSpacingAccent" | "Koi8R" | "ExtAlphaLowercase" | "Koi8U" | "Europa3" | "HzGbSimplifiedChinese" | "SimplifiedChineseGb18030" | "Utf7" | "Utf8";

Eigenschaftswert

Hinweise

API-Satz: WordApiDesktop 1.4

folderSuffix

Ruft das Ordnersuffix ab, das beim Speichern eines Dokuments als Webseite mit langen Dateinamen und unterstützenden Dateien verwendet wird, in einem separaten Ordner.

readonly folderSuffix: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.4

organizeInFolder

Gibt an, ob unterstützende Dateien beim Speichern des Dokuments als Webseite in einem separaten Ordner organisiert werden. Der Standardwert ist true.

organizeInFolder: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.4

pixelsPerInch

Gibt die Dichte (Pixel pro Zoll) von Grafiken, Bildern und Tabellenzellen auf einer Webseite an.

pixelsPerInch: number;

Eigenschaftswert

number

Hinweise

API-Satz: WordApiDesktop 1.4

relyOnCSS

Gibt an, ob Cascading Stylesheets (CSS) für die Schriftartformatierung verwendet werden, wenn ein gespeichertes Dokument in einem Webbrowser angezeigt wird. Der Standardwert ist true.

relyOnCSS: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.4

relyOnVectorMarkupLanguage

Gibt an, ob beim Speichern eines Dokuments als Webseite keine Bilddateien aus Zeichnungsobjekten generiert werden. Der Standardwert ist false.

relyOnVectorMarkupLanguage: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.4

screenSize

Gibt die ideale minimale Bildschirmgröße (Breite und Höhe, in Pixel) zum Anzeigen des gespeicherten Dokuments in einem Webbrowser an.

screenSize: Word.ScreenSize | "Size544x376" | "Size640x480" | "Size720x512" | "Size800x600" | "Size1024x768" | "Size1152x882" | "Size1152x900" | "Size1280x1024" | "Size1600x1200" | "Size1800x1440" | "Size1920x1200";

Eigenschaftswert

Hinweise

API-Satz: WordApiDesktop 1.4

targetBrowser

Gibt den Zielbrowser für Dokumente an, die in einem Webbrowser angezeigt werden.

targetBrowser: Word.TargetBrowser | "V3" | "V4" | "Ie4" | "Ie5" | "Ie6";

Eigenschaftswert

Word.TargetBrowser | "V3" | "V4" | "Ie4" | "Ie5" | "Ie6"

Hinweise

API-Satz: WordApiDesktop 1.4

useLongFileNames

Gibt an, ob lange Dateinamen verwendet werden, wenn das Dokument als Webseite gespeichert wird. Der Standardwert ist true.

useLongFileNames: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.4

Details zur Methode

load(options)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: Word.Interfaces.WebSettingsLoadOptions): Word.WebSettings;

Parameter

options: Word.Interfaces.WebSettingsLoadOptions

Stellt Optionen für die zu ladenden Eigenschaften des Objekts bereit.

Gibt zurück

Word.WebSettings

load(propertyNames)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames?: string | string[]): Word.WebSettings;

Parameter

propertyNames: string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

Word.WebSettings

load(propertyNamesAndPaths)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.WebSettings;

Parameter

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select ist eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Kommas getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

Word.WebSettings

toJSON()

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON Methode des Objekts auf, das an sie übergeben wird.) Während das ursprüngliche Word.WebSettings Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Word.Interfaces.WebSettingsData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Word.Interfaces.WebSettingsData;

Gibt zurück

Word.Interfaces.WebSettingsData

track()

Nachverfolgung des Objekts zwecks automatischer Anpassung auf der Grundlage der umgebenden Änderungen im Dokument. Dieser Aufruf ist eine Kurzform für context.trackedObjects.add(thisObject). Wenn Sie dieses Objekt aufrufübergreifend .sync und außerhalb der sequenziellen Ausführung eines ".run"-Batches verwenden und beim Festlegen einer Eigenschaft oder beim Aufrufen einer Methode für das Objekt ein "InvalidObjectPath"-Fehler angezeigt wird, müssen Sie das Objekt der nachverfolgten Objektsammlung hinzufügen, wenn das Objekt zum ersten Mal erstellt wurde. Wenn dieses Objekt Teil einer Sammlung ist, sollten Sie auch die übergeordnete Sammlung nachverfolgen.

track(): Word.WebSettings;

Gibt zurück

Word.WebSettings

untrack()

Gibt den diesem Objekt zugewiesenen Arbeitsspeicher frei, wenn das Objekt zuvor nachverfolgt wurde. Dieser Aufruf ist die Kurzform für context.trackedObjects.remove(thisObject). Viele nachverfolgte Objekte verlangsamen die Ausführung der Hostanwendung, also achten Sie darauf, alle hinzugefügten Objekte nach abgeschlossener Verwendung freizugeben. Sie müssen einen Aufruf durchführen context.sync() , bevor die Speicherfreigabe wirksam wird.

untrack(): Word.WebSettings;

Gibt zurück

Word.WebSettings

useDefaultFolderSuffix()

Legt das Ordnersuffix für das angegebene Dokument auf das Standardsuffix für die ausgewählte oder installierte Sprachunterstützung fest.

useDefaultFolderSuffix(): void;

Gibt zurück

void

Hinweise

API-Satz: WordApiDesktop 1.4

Feedback

War diese Seite hilfreich?