Word.ContentControlOptions interface
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é
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 » est actuellement en préversion.