Word.DatePickerContentControl class

Пакет:

word

Представляет DatePickerContentControl объект.

Extends

OfficeExtension.ClientObject

Комментарии

Набор API: WordApiDesktop 1.3

Используется

• Word. ContentControl: datePickerContentControl

Примеры

// 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);
});

Свойства

appearance	Определяет внешний вид элемента управления содержимым.
color	Определяет красно-зелено-синее (RGB) значение цвета элемента управления содержимым. Вы можете указать значение в формате "#RRGGBB".
context	Контекст запроса, связанный с объектом. Это соединяет процесс надстройки с процессом основного приложения Office.
dateCalendarType	Указывает CalendarType значение, представляющее тип календаря для элемента управления "Выбор даты".
dateDisplayFormat	Формат отображения дат.
dateDisplayLocale	Определяет LanguageId языковой формат даты, отображаемой в элементе управления содержимым средства выбора даты.
dateStorageFormat	Задает ContentControlDateStorageFormat значение, которое представляет формат для хранения и получения дат, когда элемент управления содержимым средства выбора даты привязан к хранилищу данных XML активного документа.
id	Получает идентификатор элемента управления содержимым.
isTemporary	Указывает, следует ли удалять элемент управления содержимым из активного документа, когда пользователь изменяет содержимое элемента управления.
level	Определяет уровень элемента управления содержимым: распространяется ли элемент управления содержимым на текст, абзацы, ячейки таблицы или строки таблицы. или если он встроен.
lockContentControl	Указывает, заблокирован ли элемент управления содержимым (его нельзя удалить). true означает, что пользователь не может удалить его из активного документа, означает, false что его можно удалить.
lockContents	Указывает, заблокировано ли содержимое элемента управления содержимым (недоступно для редактирования). true означает, что пользователь не может изменять содержимое, означает, false что содержимое можно редактировать.
placeholderText	Возвращает BuildingBlock объект, представляющий замещающий текст для элемента управления содержимым.
range	Получает объект, Range представляющий содержимое элемента управления содержимым в активном документе.
showingPlaceholderText	Указывает, отображается ли замещающий текст для элемента управления содержимым.
tag	Указывает тег для идентификации элемента управления содержимым.
title	Указывает название элемента управления содержимым.
xmlMapping	Получает XmlMapping объект, представляющий сопоставление элемента управления содержимым с данными XML в хранилище данных документа.

Методы

copy()	Копирует элемент управления содержимым из активного документа в буфер обмена.
cut()	Удаляет элемент управления содержимым из активного документа и перемещает его в буфер обмена.
delete(deleteContents)	Удаляет этот элемент управления содержимым и его содержимое.
load(options)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNames)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
load(propertyNamesAndPaths)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
set(properties, options)	Задает несколько свойств объекта одновременно. Вы можете передать либо простой объект с соответствующими свойствами, либо другой объект API того же типа.
set(properties)	Одновременно задает несколько свойств объекта на основе существующего загруженного объекта.
setPlaceholderText(options)	Задает замещающий текст, отображаемый в элементе управления содержимым, пока пользователь не введет собственный текст.
toJSON()	Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringify, в свою очередь, вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.DatePickerContentControl объект является объектом API, toJSON метод возвращает простой объект JavaScript (типизированный как Word.Interfaces.DatePickerContentControlData), который содержит неглубокие копии любых загруженных дочерних свойств исходного объекта.
track()	Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением от context.trackedObjects.add(thisObject). Если вы используете этот объект во всех .sync вызовах и вне последовательного выполнения пакета ".run" и получаете сообщение об ошибке "InvalidObjectPath" при установке свойства или вызове метода объекта, необходимо добавить объект в коллекцию отслеживаемых объектов при его первом создании. Если этот объект является частью семейства, следует также отслеживать родительскую коллекцию.
untrack()	Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращением от context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вам нужно позвонить context.sync() , прежде чем освобождение памяти вступит в силу.

Сведения о свойстве

appearance

Определяет внешний вид элемента управления содержимым.

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

Значение свойства

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

Комментарии

Набор API: WordApiDesktop 1.3

color

Определяет красно-зелено-синее (RGB) значение цвета элемента управления содержимым. Вы можете указать значение в формате "#RRGGBB".

color: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.3

context

Контекст запроса, связанный с объектом. Это соединяет процесс надстройки с процессом основного приложения Office.

context: RequestContext;

Значение свойства

Word.RequestContext

dateCalendarType

Указывает CalendarType значение, представляющее тип календаря для элемента управления "Выбор даты".

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

Значение свойства

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

Комментарии

Набор API: WordApiDesktop 1.3

Примеры

// 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

Формат отображения дат.

dateDisplayFormat: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.3

Примеры

// 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

Определяет LanguageId языковой формат даты, отображаемой в элементе управления содержимым средства выбора даты.

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";

Значение свойства

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"

Комментарии

Набор API: WordApiDesktop 1.3

Примеры

// 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

Задает ContentControlDateStorageFormat значение, которое представляет формат для хранения и получения дат, когда элемент управления содержимым средства выбора даты привязан к хранилищу данных XML активного документа.

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

Значение свойства

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

Комментарии

Набор API: WordApiDesktop 1.3

Примеры

// 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

Получает идентификатор элемента управления содержимым.

readonly id: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.3

isTemporary

Указывает, следует ли удалять элемент управления содержимым из активного документа, когда пользователь изменяет содержимое элемента управления.

isTemporary: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

level

Определяет уровень элемента управления содержимым: распространяется ли элемент управления содержимым на текст, абзацы, ячейки таблицы или строки таблицы. или если он встроен.

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

Значение свойства

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

Комментарии

Набор API: WordApiDesktop 1.3

lockContentControl

Указывает, заблокирован ли элемент управления содержимым (его нельзя удалить). true означает, что пользователь не может удалить его из активного документа, означает, false что его можно удалить.

lockContentControl: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

lockContents

Указывает, заблокировано ли содержимое элемента управления содержимым (недоступно для редактирования). true означает, что пользователь не может изменять содержимое, означает, false что содержимое можно редактировать.

lockContents: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

placeholderText

Возвращает BuildingBlock объект, представляющий замещающий текст для элемента управления содержимым.

readonly placeholderText: Word.BuildingBlock;

Значение свойства

Word.BuildingBlock

Комментарии

Набор API: WordApiDesktop 1.3

range

Получает объект, Range представляющий содержимое элемента управления содержимым в активном документе.

readonly range: Word.Range;

Значение свойства

Word.Range

Комментарии

Набор API: WordApiDesktop 1.3

showingPlaceholderText

Указывает, отображается ли замещающий текст для элемента управления содержимым.

readonly showingPlaceholderText: boolean;

Значение свойства

boolean

Комментарии

Набор API: WordApiDesktop 1.3

tag

Указывает тег для идентификации элемента управления содержимым.

tag: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.3

title

Указывает название элемента управления содержимым.

title: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.3

xmlMapping

Получает XmlMapping объект, представляющий сопоставление элемента управления содержимым с данными XML в хранилище данных документа.

readonly xmlMapping: Word.XmlMapping;

Значение свойства

Word.XmlMapping

Комментарии

Набор API: WordApiDesktop 1.3

Сведения о методе

copy()

Копирует элемент управления содержимым из активного документа в буфер обмена.

copy(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

cut()

Удаляет элемент управления содержимым из активного документа и перемещает его в буфер обмена.

cut(): void;

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

delete(deleteContents)

Удаляет этот элемент управления содержимым и его содержимое.

delete(deleteContents?: boolean): void;

Параметры

deleteContents

boolean

Необязательный параметр. Если true, также удаляет содержимое.

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(options?: Word.Interfaces.DatePickerContentControlLoadOptions): Word.DatePickerContentControl;

Параметры

options

Word.Interfaces.DatePickerContentControlLoadOptions

Предоставляет параметры для загружаемых свойств объекта.

Возвращаемое значение

Word.DatePickerContentControl

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

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

Параметры

propertyNames

string | string[]

Строка с разделителями-запятыми или массив строк, которые определяют свойства для загрузки.

Возвращаемое значение

Word.DatePickerContentControl

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

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

Параметры

propertyNamesAndPaths

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

propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и строка propertyNamesAndPaths.expand через запятую, указывающая свойства навигации для загрузки.

Возвращаемое значение

Word.DatePickerContentControl

set(properties, options)

Задает несколько свойств объекта одновременно. Вы можете передать либо простой объект с соответствующими свойствами, либо другой объект API того же типа.

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

Параметры

properties

Word.Interfaces.DatePickerContentControlUpdateData

Объект JavaScript со свойствами, структурированными изоморфно свойствам объекта, для которого вызывается метод.

options

OfficeExtension.UpdateOptions

Предоставляет возможность подавления ошибок, если объект properties пытается задать какие-либо свойства только для чтения.

Возвращаемое значение

void

set(properties)

Одновременно задает несколько свойств объекта на основе существующего загруженного объекта.

set(properties: Word.DatePickerContentControl): void;

Параметры

properties

Word.DatePickerContentControl

Возвращаемое значение

void

setPlaceholderText(options)

Задает замещающий текст, отображаемый в элементе управления содержимым, пока пользователь не введет собственный текст.

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

Параметры

options

Word.ContentControlPlaceholderOptions

Необязательный параметр. Параметры для настройки замещающего текста элемента управления содержимым.

Возвращаемое значение

void

Комментарии

Набор API: WordApiDesktop 1.3

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringify, в свою очередь, вызывает toJSON метод переданного ему объекта.) В то время как исходный Word.DatePickerContentControl объект является объектом API, toJSON метод возвращает простой объект JavaScript (типизированный как Word.Interfaces.DatePickerContentControlData), который содержит неглубокие копии любых загруженных дочерних свойств исходного объекта.

toJSON(): Word.Interfaces.DatePickerContentControlData;

Возвращаемое значение

Word.Interfaces.DatePickerContentControlData

track()

Отслеживает объект для автоматической корректировки с учетом окружающих изменений в документе. Этот вызов является сокращением от context.trackedObjects.add(thisObject). Если вы используете этот объект во всех .sync вызовах и вне последовательного выполнения пакета ".run" и получаете сообщение об ошибке "InvalidObjectPath" при установке свойства или вызове метода объекта, необходимо добавить объект в коллекцию отслеживаемых объектов при его первом создании. Если этот объект является частью семейства, следует также отслеживать родительскую коллекцию.

track(): Word.DatePickerContentControl;

Возвращаемое значение

Word.DatePickerContentControl

untrack()

Освобождает память, связанную с этим объектом, если он ранее отслеживался. Этот вызов является сокращением от context.trackedObjects.remove(thisObject). Наличие большого количества отслеживаемых объектов замедляет ведущее приложение, поэтому не забывайте освобождать любые добавленные объекты после завершения их использования. Вам нужно позвонить context.sync() , прежде чем освобождение памяти вступит в силу.

untrack(): Word.DatePickerContentControl;

Возвращаемое значение

Word.DatePickerContentControl