Word.ContentControlOptions interface

Paquet:

word

Spécifie les options qui définissent les contrôles de contenu qui sont retournés.

Remarques

[ Ensemble d’API : WordApi 1.5 ]

Exemples

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

Propriétés

types

Tableau de types de contrôle de contenu, l’élément doit être « RichText », « PlainText », « CheckBox », « DropDownList » ou « ComboBox ».

Détails de la propriété

types

Tableau de types de contrôle de contenu, l’élément doit être « RichText », « PlainText », « CheckBox », « DropDownList » ou « ComboBox ».

types: Word.ContentControlType[];

Valeur de propriété

Word.ContentControlType[]

Remarques

[ Ensemble d’API : WordApi 1.5 ]

Remarque : La prise en charge de « PlainText » a été ajoutée dans WordApi 1.5. La prise en charge de « CheckBox » a été ajoutée dans WordApi 1.7. La prise en charge de « DropDownList » et de « ComboBox » a été ajoutée dans WordApi 1.9.