Word.DatePickerContentControl class

Paket:: word

Stellt das DatePickerContentControl Objekt dar.

Extends: OfficeExtension.ClientObject

Hinweise

Verwendet von

Word. ContentControl: datePickerContentControl

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/insert-and-change-date-picker-content-control.yaml

// Gets and logs the properties of the first date picker content control.
await Word.run(async (context) => {
  let contentControls = context.document.getContentControls({
    types: [Word.ContentControlType.datePicker]
  });
  contentControls.load("items");

  await context.sync();

  if (contentControls.items.length === 0) {
    console.warn("No date picker content controls found in the document.");
    return;
  }

  const firstControl = contentControls.items[0];
  firstControl.load("datePickerContentControl");

  await context.sync();

  const datePicker: Word.DatePickerContentControl = firstControl.datePickerContentControl;
  datePicker.load("dateCalendarType, dateDisplayFormat, dateDisplayLocale, dateStorageFormat");

  await context.sync();

  console.log("Date picker content control properties:");
  console.log("  Calendar type: " + datePicker.dateCalendarType);
  console.log("  Display format: " + datePicker.dateDisplayFormat);
  console.log("  Display locale: " + datePicker.dateDisplayLocale);
  console.log("  Storage format: " + datePicker.dateStorageFormat);
});

Eigenschaften

appearance	Gibt die Darstellung des Inhaltssteuerelements an.
color	Gibt den Rot-Grün-Blau-Wert (RGB) der Farbe des Inhaltssteuerelements an. Sie können den Wert im Format "#RRGGBB" angeben.
context	Der dem Objekt zugeordnete Anforderungskontext. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
dateCalendarType	Gibt einen `CalendarType` Wert an, der den Kalendertyp für das Inhaltssteuerelement der Datumsauswahl darstellt.
dateDisplayFormat	Gibt das Format an, in dem Datumsangaben angezeigt werden.
dateDisplayLocale	Gibt einen an `LanguageId` , der das Sprachformat für das Datum darstellt, das im Inhaltssteuerelement der Datumsauswahl angezeigt wird.
dateStorageFormat	Gibt einen `ContentControlDateStorageFormat` Wert an, der das Format für das Speichern und Abrufen von Datumsangaben darstellt, wenn das Inhaltssteuerelement der Datumsauswahl an den XML-Datenspeicher des aktiven Dokuments gebunden ist.
id	Ruft die Kennung für das Inhaltssteuerelement ab.
isTemporary	Gibt an, ob das Inhaltssteuerelement aus dem aktiven Dokument entfernt werden soll, wenn der Benutzer den Inhalt des Steuerelements bearbeitet.
level	Gibt die Ebene des Inhaltssteuerelements an: ob das Inhaltssteuerelement Text, Absätze, Tabellenzellen oder Tabellenzeilen umschließt; oder ob sie inline ist.
lockContentControl	Gibt an, ob das Inhaltssteuerelement gesperrt ist (kann nicht gelöscht werden). `true` bedeutet, dass der Benutzer es nicht aus dem aktiven Dokument löschen kann, bedeutet, `false` dass es gelöscht werden kann.
lockContents	Gibt an, ob der Inhalt des Inhaltssteuerelements gesperrt (nicht bearbeitbar) ist. `true` bedeutet, dass der Benutzer den Inhalt nicht bearbeiten kann, bedeutet, `false` dass der Inhalt bearbeitet werden kann.
placeholderText	Gibt ein `BuildingBlock` Objekt zurück, das den Platzhaltertext für das Inhaltssteuerelement darstellt.
range	Ruft ein `Range` Objekt ab, das den Inhalt des Inhaltssteuerelements im aktiven Dokument darstellt.
showingPlaceholderText	Ruft ab, ob der Platzhaltertext für das Inhaltssteuerelement angezeigt wird.
tag	Gibt ein Tag zur Identifizierung des Inhaltssteuerelements an.
title	Gibt den Titel für das Inhaltssteuerelement an.
xmlMapping	Ruft ein `XmlMapping` Objekt ab, das die Zuordnung des Inhaltssteuerelements zu XML-Daten im Datenspeicher des Dokuments darstellt.

Methoden

copy()	Kopiert das Inhaltssteuerelement aus dem aktiven Dokument in die Zwischenablage.
cut()	Entfernt das Inhaltssteuerelement aus dem aktiven Dokument und verschiebt dieses in die Zwischenablage.
delete(deleteContents)	Löscht dieses Inhaltssteuerelement und den Inhalt des Inhaltssteuerelements.
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.
set(properties, options)	Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.
set(properties)	Legt mehrere Eigenschaften für das Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.
setPlaceholderText(options)	Legt den Platzhaltertext fest, der im Inhaltssteuerelement angezeigt wird, bis ein Benutzer einen eigenen Text einfügt.
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.DatePickerContentControl` Objekt ein API-Objekt ist, gibt die `toJSON` Methode ein einfaches JavaScript-Objekt (als `Word.Interfaces.DatePickerContentControlData`) 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.

Details zur Eigenschaft

appearance

Gibt die Darstellung des Inhaltssteuerelements an.

appearance: Word.ContentControlAppearance | "BoundingBox" | "Tags" | "Hidden";

Eigenschaftswert

Word.ContentControlAppearance | "BoundingBox" | "Tags" | "Hidden"

Hinweise

API-Satz: WordApiDesktop 1.3

color

Gibt den Rot-Grün-Blau-Wert (RGB) der Farbe des Inhaltssteuerelements an. Sie können den Wert im Format "#RRGGBB" angeben.

color: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.3

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

dateCalendarType

Gibt einen CalendarType Wert an, der den Kalendertyp für das Inhaltssteuerelement der Datumsauswahl darstellt.

dateCalendarType: Word.CalendarType | "Western" | "Arabic" | "Hebrew" | "Taiwan" | "Japan" | "Thai" | "Korean" | "SakaEra" | "TranslitEnglish" | "TranslitFrench" | "Umalqura";

Eigenschaftswert

Hinweise

API-Satz: WordApiDesktop 1.3

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/insert-and-change-date-picker-content-control.yaml

function changeCalendarType(datePicker: Word.DatePickerContentControl) {
    // The calendar type can only be set to a value compatible with the display locale. 
    // For the Japanese locale, valid calendar types are Gregorian and Japan.
    datePicker.dateCalendarType = Word.CalendarType.japan;
}

dateDisplayFormat

Gibt das Format an, in dem Datumsangaben angezeigt werden.

dateDisplayFormat: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.3

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/insert-and-change-date-picker-content-control.yaml

function changeDisplayFormat(datePicker: Word.DatePickerContentControl) {
    // Set the display format.
    datePicker.dateDisplayFormat = "yyyy/MM/dd";
}

dateDisplayLocale

Gibt einen an LanguageId , der das Sprachformat für das Datum darstellt, das im Inhaltssteuerelement der Datumsauswahl angezeigt wird.

dateDisplayLocale: Word.LanguageId | "Afrikaans" | "Albanian" | "Amharic" | "Arabic" | "ArabicAlgeria" | "ArabicBahrain" | "ArabicEgypt" | "ArabicIraq" | "ArabicJordan" | "ArabicKuwait" | "ArabicLebanon" | "ArabicLibya" | "ArabicMorocco" | "ArabicOman" | "ArabicQatar" | "ArabicSyria" | "ArabicTunisia" | "ArabicUAE" | "ArabicYemen" | "Armenian" | "Assamese" | "AzeriCyrillic" | "AzeriLatin" | "Basque" | "BelgianDutch" | "BelgianFrench" | "Bengali" | "Bulgarian" | "Burmese" | "Belarusian" | "Catalan" | "Cherokee" | "ChineseHongKongSAR" | "ChineseMacaoSAR" | "ChineseSingapore" | "Croatian" | "Czech" | "Danish" | "Divehi" | "Dutch" | "Edo" | "EnglishAUS" | "EnglishBelize" | "EnglishCanadian" | "EnglishCaribbean" | "EnglishIndonesia" | "EnglishIreland" | "EnglishJamaica" | "EnglishNewZealand" | "EnglishPhilippines" | "EnglishSouthAfrica" | "EnglishTrinidadTobago" | "EnglishUK" | "EnglishUS" | "EnglishZimbabwe" | "Estonian" | "Faeroese" | "Filipino" | "Finnish" | "French" | "FrenchCameroon" | "FrenchCanadian" | "FrenchCongoDRC" | "FrenchCotedIvoire" | "FrenchHaiti" | "FrenchLuxembourg" | "FrenchMali" | "FrenchMonaco" | "FrenchMorocco" | "FrenchReunion" | "FrenchSenegal" | "FrenchWestIndies" | "FrisianNetherlands" | "Fulfulde" | "GaelicIreland" | "GaelicScotland" | "Galician" | "Georgian" | "German" | "GermanAustria" | "GermanLiechtenstein" | "GermanLuxembourg" | "Greek" | "Guarani" | "Gujarati" | "Hausa" | "Hawaiian" | "Hebrew" | "Hindi" | "Hungarian" | "Ibibio" | "Icelandic" | "Igbo" | "Indonesian" | "Inuktitut" | "Italian" | "Japanese" | "Kannada" | "Kanuri" | "Kashmiri" | "Kazakh" | "Khmer" | "Kirghiz" | "Konkani" | "Korean" | "Kyrgyz" | "LanguageNone" | "Lao" | "Latin" | "Latvian" | "Lithuanian" | "MacedonianFYROM" | "Malayalam" | "MalayBruneiDarussalam" | "Malaysian" | "Maltese" | "Manipuri" | "Marathi" | "MexicanSpanish" | "Mongolian" | "Nepali" | "NoProofing" | "NorwegianBokmol" | "NorwegianNynorsk" | "Oriya" | "Oromo" | "Pashto" | "Persian" | "Polish" | "Portuguese" | "PortugueseBrazil" | "Punjabi" | "RhaetoRomanic" | "Romanian" | "RomanianMoldova" | "Russian" | "RussianMoldova" | "SamiLappish" | "Sanskrit" | "SerbianCyrillic" | "SerbianLatin" | "Sesotho" | "SimplifiedChinese" | "Sindhi" | "SindhiPakistan" | "Sinhalese" | "Slovak" | "Slovenian" | "Somali" | "Sorbian" | "Spanish" | "SpanishArgentina" | "SpanishBolivia" | "SpanishChile" | "SpanishColombia" | "SpanishCostaRica" | "SpanishDominicanRepublic" | "SpanishEcuador" | "SpanishElSalvador" | "SpanishGuatemala" | "SpanishHonduras" | "SpanishModernSort" | "SpanishNicaragua" | "SpanishPanama" | "SpanishParaguay" | "SpanishPeru" | "SpanishPuertoRico" | "SpanishUruguay" | "SpanishVenezuela" | "Sutu" | "Swahili" | "Swedish" | "SwedishFinland" | "SwissFrench" | "SwissGerman" | "SwissItalian" | "Syriac" | "Tajik" | "Tamazight" | "TamazightLatin" | "Tamil" | "Tatar" | "Telugu" | "Thai" | "Tibetan" | "TigrignaEritrea" | "TigrignaEthiopic" | "TraditionalChinese" | "Tsonga" | "Tswana" | "Turkish" | "Turkmen" | "Ukrainian" | "Urdu" | "UzbekCyrillic" | "UzbekLatin" | "Venda" | "Vietnamese" | "Welsh" | "Xhosa" | "Yi" | "Yiddish" | "Yoruba" | "Zulu";

Eigenschaftswert

Hinweise

API-Satz: WordApiDesktop 1.3

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/insert-and-change-date-picker-content-control.yaml

function changeCalendarLanguage(datePicker: Word.DatePickerContentControl) {
    // Set the display locale before changing the calendar type, since calendar type must be compatible with the locale.
    datePicker.dateDisplayLocale = Word.LanguageId.japanese;
}

dateStorageFormat

Gibt einen ContentControlDateStorageFormat Wert an, der das Format für das Speichern und Abrufen von Datumsangaben darstellt, wenn das Inhaltssteuerelement der Datumsauswahl an den XML-Datenspeicher des aktiven Dokuments gebunden ist.

dateStorageFormat: Word.ContentControlDateStorageFormat | "Text" | "Date" | "DateTime";

Eigenschaftswert

Word.ContentControlDateStorageFormat | "Text" | "Date" | "DateTime"

Hinweise

API-Satz: WordApiDesktop 1.3

Beispiele

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/10-content-controls/insert-and-change-date-picker-content-control.yaml

function changeStorageFormat(datePicker: Word.DatePickerContentControl) {
    // Set the storage format to DateTime, which means the date and time will be stored in ISO format (e.g., "2024-12-31T23:59:00Z"). 
    // The time portion will be ignored when getting/setting the value of the content control, since it's a date picker.
    datePicker.dateStorageFormat = Word.ContentControlDateStorageFormat.dateTime;
}

id

Ruft die Kennung für das Inhaltssteuerelement ab.

readonly id: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.3

isTemporary

Gibt an, ob das Inhaltssteuerelement aus dem aktiven Dokument entfernt werden soll, wenn der Benutzer den Inhalt des Steuerelements bearbeitet.

isTemporary: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.3

level

Gibt die Ebene des Inhaltssteuerelements an: ob das Inhaltssteuerelement Text, Absätze, Tabellenzellen oder Tabellenzeilen umschließt; oder ob sie inline ist.

readonly level: Word.ContentControlLevel | "Inline" | "Paragraph" | "Row" | "Cell";

Eigenschaftswert

Word.ContentControlLevel | "Inline" | "Paragraph" | "Row" | "Cell"

Hinweise

API-Satz: WordApiDesktop 1.3

lockContentControl

Gibt an, ob das Inhaltssteuerelement gesperrt ist (kann nicht gelöscht werden). true bedeutet, dass der Benutzer es nicht aus dem aktiven Dokument löschen kann, bedeutet, false dass es gelöscht werden kann.

lockContentControl: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.3

lockContents

Gibt an, ob der Inhalt des Inhaltssteuerelements gesperrt (nicht bearbeitbar) ist. true bedeutet, dass der Benutzer den Inhalt nicht bearbeiten kann, bedeutet, false dass der Inhalt bearbeitet werden kann.

lockContents: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.3

placeholderText

Gibt ein BuildingBlock Objekt zurück, das den Platzhaltertext für das Inhaltssteuerelement darstellt.

readonly placeholderText: Word.BuildingBlock;

Eigenschaftswert

Word.BuildingBlock

Hinweise

API-Satz: WordApiDesktop 1.3

range

Ruft ein Range Objekt ab, das den Inhalt des Inhaltssteuerelements im aktiven Dokument darstellt.

readonly range: Word.Range;

Eigenschaftswert

Word.Range

Hinweise

API-Satz: WordApiDesktop 1.3

showingPlaceholderText

Ruft ab, ob der Platzhaltertext für das Inhaltssteuerelement angezeigt wird.

readonly showingPlaceholderText: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: WordApiDesktop 1.3

tag

Gibt ein Tag zur Identifizierung des Inhaltssteuerelements an.

tag: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.3

title

Gibt den Titel für das Inhaltssteuerelement an.

title: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.3

xmlMapping

Ruft ein XmlMapping Objekt ab, das die Zuordnung des Inhaltssteuerelements zu XML-Daten im Datenspeicher des Dokuments darstellt.

readonly xmlMapping: Word.XmlMapping;

Eigenschaftswert

Word.XmlMapping

Hinweise

API-Satz: WordApiDesktop 1.3

Details zur Methode

copy()

Kopiert das Inhaltssteuerelement aus dem aktiven Dokument in die Zwischenablage.

copy(): void;

Gibt zurück

void

Hinweise

API-Satz: WordApiDesktop 1.3

cut()

Entfernt das Inhaltssteuerelement aus dem aktiven Dokument und verschiebt dieses in die Zwischenablage.

cut(): void;

Gibt zurück

void

Hinweise

API-Satz: WordApiDesktop 1.3

delete(deleteContents)

Löscht dieses Inhaltssteuerelement und den Inhalt des Inhaltssteuerelements.

delete(deleteContents?: boolean): void;

Parameter

deleteContents: boolean

Optional. If truelöscht auch den Inhalt.

Gibt zurück

void

Hinweise

API-Satz: WordApiDesktop 1.3

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.DatePickerContentControlLoadOptions): Word.DatePickerContentControl;

Parameter

options: Word.Interfaces.DatePickerContentControlLoadOptions

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

Gibt zurück

Word.DatePickerContentControl

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.DatePickerContentControl;

Parameter

propertyNames: string | string[]

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

Gibt zurück

Word.DatePickerContentControl

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.DatePickerContentControl;

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.DatePickerContentControl

set(properties, options)

Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.

set(properties: Interfaces.DatePickerContentControlUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parameter

properties: Word.Interfaces.DatePickerContentControlUpdateData

Ein JavaScript-Objekt mit Eigenschaften, die isomorph zu den Eigenschaften des Objekts strukturiert sind, für das die Methode aufgerufen wird.

options: OfficeExtension.UpdateOptions

Bietet eine Option zum Unterdrücken von Fehlern, wenn das properties-Objekt versucht, schreibgeschützte Eigenschaften festzulegen.

Gibt zurück

void

set(properties)

Legt mehrere Eigenschaften für das Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.

set(properties: Word.DatePickerContentControl): void;

Parameter

properties: Word.DatePickerContentControl

Gibt zurück

void

setPlaceholderText(options)

Legt den Platzhaltertext fest, der im Inhaltssteuerelement angezeigt wird, bis ein Benutzer einen eigenen Text einfügt.

setPlaceholderText(options?: Word.ContentControlPlaceholderOptions): void;

Parameter

options: Word.ContentControlPlaceholderOptions

Optional. Die Optionen zum Konfigurieren des Platzhaltertexts des Inhaltssteuerelements.

Gibt zurück

void

Hinweise

API-Satz: WordApiDesktop 1.3

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.DatePickerContentControl Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Word.Interfaces.DatePickerContentControlData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Word.Interfaces.DatePickerContentControlData;

Gibt zurück

Word.Interfaces.DatePickerContentControlData

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.DatePickerContentControl;

Gibt zurück

Word.DatePickerContentControl

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.DatePickerContentControl;

Gibt zurück

Word.DatePickerContentControl

Feedback

War diese Seite hilfreich?