Word.ContentControlOptions interface

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

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. Die Unterstützung für "DropDownList" und "ComboBox" befindet sich derzeit in der Vorschauphase.