Word.ContentControlOptions interface

Paket:

word

Gibt die Optionen an, die definieren, welche Inhaltssteuerelemente zurückgegeben werden.

Hinweise

[ API-Satz: WordApi 1.5 ]

Beispiele

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

Eigenschaften

types

Ein Array von Inhaltssteuerelementtypen, das Element muss "RichText", "PlainText", "CheckBox", "DropDownList" oder "ComboBox" sein.

Details zur Eigenschaft

types

Ein Array von Inhaltssteuerelementtypen, das Element muss "RichText", "PlainText", "CheckBox", "DropDownList" oder "ComboBox" sein.

types: Word.ContentControlType[];

Eigenschaftswert

Word.ContentControlType[]

Hinweise

[ API-Satz: WordApi 1.5 ]

Hinweis: Die Unterstützung von "PlainText" wurde in WordApi 1.5 hinzugefügt. Die "CheckBox"-Unterstützung wurde in WordApi 1.7 hinzugefügt. Unterstützung für "DropDownList" und "ComboBox" wurde in WordApi 1.9 hinzugefügt.