Word.ContentControlOptions interface

Пакет:

word

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

Комментарии

[ Набор API: WordApi 1.5 ]

Примеры

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

// Toggles the isChecked property of the first checkbox content control found in the selection.
await Word.run(async (context) => {
  const selectedRange: Word.Range = context.document.getSelection();
  let selectedContentControl = selectedRange
    .getContentControls({
      types: [Word.ContentControlType.checkBox]
    })
    .getFirstOrNullObject();
  selectedContentControl.load("id,checkboxContentControl/isChecked");

  await context.sync();

  if (selectedContentControl.isNullObject) {
    const parentContentControl: Word.ContentControl = selectedRange.parentContentControl;
    parentContentControl.load("id,type,checkboxContentControl/isChecked");
    await context.sync();

    if (parentContentControl.isNullObject || parentContentControl.type !== Word.ContentControlType.checkBox) {
      console.warn("No checkbox content control is currently selected.");
      return;
    } else {
      selectedContentControl = parentContentControl;
    }
  }

  const isCheckedBefore = selectedContentControl.checkboxContentControl.isChecked;
  console.log("isChecked state before:", `id: ${selectedContentControl.id} ... isChecked: ${isCheckedBefore}`);
  selectedContentControl.checkboxContentControl.isChecked = !isCheckedBefore;
  selectedContentControl.load("id,checkboxContentControl/isChecked");
  await context.sync();

  console.log(
    "isChecked state after:",
    `id: ${selectedContentControl.id} ... isChecked: ${selectedContentControl.checkboxContentControl.isChecked}`
  );
});

Свойства

types

Массив типов элементов управления содержимым, элемент должен иметь значение richText, , plainTextcheckBox, dropDownList,comboBox ,buildingBlockGallery , repeatingSectiondatePicker, picture, или .group

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

types

Массив типов элементов управления содержимым, элемент должен иметь значение richText, , plainTextcheckBox, dropDownList,comboBox ,buildingBlockGallery , repeatingSectiondatePicker, picture, или .group

types: Word.ContentControlType[];

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

Word.ContentControlType[]

Комментарии

[ Набор API: WordApi 1.5 ]

Примечание. plainText Добавлена поддержка в WordApi 1.5. checkBox добавлена поддержка в WordApi 1.7. dropDownList добавлена поддержка и comboBox в WordApi 1.9. buildingBlockGallery Поддержка ,datePicker ,group , pictureи repeatingSection была добавлена в WordApiDesktop 1.3.