Partager via


Word.Interfaces.ContentControlLoadOptions interface

Représente un contrôle de contenu. Les contrôles de contenu sont des zones d’un document délimitées par des bordures et pouvant porter une étiquette qui servent à contenir certains types de contenu. Les contrôles de contenu individuels peuvent contenir des images, des tableaux ou des paragraphes de texte mis en forme. Actuellement, seuls les contrôles de contenu texte enrichi, texte brut, case à cocher, liste déroulante et zone de liste déroulante sont pris en charge.

Remarques

[ Ensemble d’API : WordApi 1.1 ]

Propriétés

$all

La spécification des options de $all chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

appearance

Spécifie l’apparence du contrôle de contenu. La valeur peut être boundingBox, tagsou hidden.

buildingBlockGalleryContentControl

Obtient les données liées à la galerie de blocs de construction si le contrôle de contenu Word. ContentControlType est buildingBlockGallery. C’est null le contraire.

cannotDelete

Spécifie une valeur qui indique si l’utilisateur peut supprimer le contrôle de contenu. Mutuellement exclusif avec removeWhenEdited.

cannotEdit

Spécifie une valeur qui indique si l’utilisateur peut modifier le contenu du contrôle de contenu.

checkboxContentControl

Obtient les données du contrôle de contenu lorsque son type est checkBox. C’est null le contraire.

color

Spécifie la couleur du contrôle de contenu. La couleur est spécifiée au format « #RRGGBB » ou à l’aide du nom de la couleur.

datePickerContentControl

Obtient les données associées au sélecteur de dates si la Word du contrôle de contenu. ContentControlType est datePicker. C’est null le contraire.

font

Obtient le format de texte du contrôle de contenu. Utilisez cette propriété pour obtenir et définir le nom de la police, la taille, la couleur et d’autres propriétés.

groupContentControl

Obtient les données liées au groupe si le contrôle de contenu Word. ContentControlType est group. C’est null le contraire.

id

Obtient un entier qui représente l’identificateur du contrôle de contenu.

parentBody

Obtient le corps parent du contrôle de contenu.

parentContentControl

Obtient le contrôle de contenu qui contient le contrôle de contenu spécifié. Génère une ItemNotFound erreur s’il n’existe pas de contrôle de contenu parent.

parentContentControlOrNullObject

Obtient le contrôle de contenu qui contient le contrôle de contenu spécifié. S’il n’existe pas de contrôle de contenu parent, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

parentTable

Obtient le tableau qui contient le contrôle de contenu. Génère une ItemNotFound erreur si elle n’est pas contenue dans une table.

parentTableCell

Obtient la cellule de tableau qui contient le contrôle de contenu. Génère une ItemNotFound erreur si elle n’est pas contenue dans une cellule de tableau.

parentTableCellOrNullObject

Obtient la cellule de tableau qui contient le contrôle de contenu. Si elle n’est pas contenue dans une cellule de tableau, cette méthode renvoie un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

parentTableOrNullObject

Obtient le tableau qui contient le contrôle de contenu. Si elle n’est pas contenue dans une table, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

pictureContentControl

Obtient les données liées à l’image si le contrôle de contenu Word. ContentControlType est picture. C’est null le contraire.

placeholderText

Spécifie le texte de l’espace réservé du contrôle de contenu. Ce texte apparaît de façon estompée lorsque le contrôle de contenu est vide.

removeWhenEdited

Spécifie une valeur qui indique si le contrôle de contenu est supprimé après sa modification. Mutuellement exclusif avec cannotDelete.

repeatingSectionContentControl

Obtient les données de section répétées si le contrôle de contenu Word. ContentControlType est repeatingSection. C’est null le contraire.

style

Spécifie le nom du style pour le contrôle de contenu. Utilisez cette propriété pour les noms des styles personnalisés et localisés. Pour utiliser les styles intégrés qui sont portables entre les paramètres régionaux, consultez la styleBuiltIn propriété .

styleBuiltIn

Spécifie le nom de style intégré pour le contrôle de contenu. Utilisez cette propriété pour les styles intégrés qui sont portables entre les paramètres régionaux. Pour utiliser des styles personnalisés ou des noms de style localisés, consultez la style propriété .

subtype

Obtient le sous-type du contrôle de contenu. Le sous-type peut être richTextInline,richTextParagraphs , richTextTableRowrichTextTableCellet richTextTable pour les contrôles de contenu de texte enrichi, plainTextInline et plainTextParagraph pour les contrôles de contenu de texte brut, checkBox pour les contrôles de contenu de case à cocher, dropDownList pour les contrôles de contenu de liste déroulante, comboBox pour les contrôles de contenu de zone de liste déroulante, buildingBlockGallery pour les contrôles de contenu de la galerie de blocs de construction, datePicker pour les contrôles de contenu du sélecteur de dates, repeatingSection pour les contrôles de contenu de section répétée, picture pour les contrôles de contenu d’image et group pour les contrôles de contenu de groupe.

tag

Spécifie une balise pour identifier un contrôle de contenu.

text

Obtient le texte du contrôle de contenu.

title

Spécifie le titre d’un contrôle de contenu.

type

Obtient le type du contrôle de contenu. Seuls les contrôles texte enrichi, texte brut, zone de case activée, liste déroulante, zone de liste déroulante, galerie de blocs de construction, sélecteur de dates, section répétée, image et contenu de groupe sont actuellement pris en charge.

xmlMapping

Renvoie un XmlMapping objet qui représente le mappage du contrôle de contenu aux données XML dans le magasin de données du document.

Détails de la propriété

$all

La spécification des options de $all chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

$all?: boolean;

Valeur de propriété

boolean

appearance

Spécifie l’apparence du contrôle de contenu. La valeur peut être boundingBox, tagsou hidden.

appearance?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

buildingBlockGalleryContentControl

Obtient les données liées à la galerie de blocs de construction si le contrôle de contenu Word. ContentControlType est buildingBlockGallery. C’est null le contraire.

buildingBlockGalleryContentControl?: Word.Interfaces.BuildingBlockGalleryContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]

cannotDelete

Spécifie une valeur qui indique si l’utilisateur peut supprimer le contrôle de contenu. Mutuellement exclusif avec removeWhenEdited.

cannotDelete?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

cannotEdit

Spécifie une valeur qui indique si l’utilisateur peut modifier le contenu du contrôle de contenu.

cannotEdit?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

checkboxContentControl

Obtient les données du contrôle de contenu lorsque son type est checkBox. C’est null le contraire.

checkboxContentControl?: Word.Interfaces.CheckboxContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.7 ]

color

Spécifie la couleur du contrôle de contenu. La couleur est spécifiée au format « #RRGGBB » ou à l’aide du nom de la couleur.

color?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

datePickerContentControl

Obtient les données associées au sélecteur de dates si la Word du contrôle de contenu. ContentControlType est datePicker. C’est null le contraire.

datePickerContentControl?: Word.Interfaces.DatePickerContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]

font

Obtient le format de texte du contrôle de contenu. Utilisez cette propriété pour obtenir et définir le nom de la police, la taille, la couleur et d’autres propriétés.

font?: Word.Interfaces.FontLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.1 ]

groupContentControl

Obtient les données liées au groupe si le contrôle de contenu Word. ContentControlType est group. C’est null le contraire.

groupContentControl?: Word.Interfaces.GroupContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]

id

Obtient un entier qui représente l’identificateur du contrôle de contenu.

id?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

parentBody

Obtient le corps parent du contrôle de contenu.

parentBody?: Word.Interfaces.BodyLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

parentContentControl

Obtient le contrôle de contenu qui contient le contrôle de contenu spécifié. Génère une ItemNotFound erreur s’il n’existe pas de contrôle de contenu parent.

parentContentControl?: Word.Interfaces.ContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.1 ]

parentContentControlOrNullObject

Obtient le contrôle de contenu qui contient le contrôle de contenu spécifié. S’il n’existe pas de contrôle de contenu parent, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

parentContentControlOrNullObject?: Word.Interfaces.ContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

parentTable

Obtient le tableau qui contient le contrôle de contenu. Génère une ItemNotFound erreur si elle n’est pas contenue dans une table.

parentTable?: Word.Interfaces.TableLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

parentTableCell

Obtient la cellule de tableau qui contient le contrôle de contenu. Génère une ItemNotFound erreur si elle n’est pas contenue dans une cellule de tableau.

parentTableCell?: Word.Interfaces.TableCellLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

parentTableCellOrNullObject

Obtient la cellule de tableau qui contient le contrôle de contenu. Si elle n’est pas contenue dans une cellule de tableau, cette méthode renvoie un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

parentTableCellOrNullObject?: Word.Interfaces.TableCellLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

parentTableOrNullObject

Obtient le tableau qui contient le contrôle de contenu. Si elle n’est pas contenue dans une table, cette méthode retourne un objet avec sa isNullObject propriété définie sur true. Pour plus d’informations, consultez *Méthodes et propriétés OrNullObject.

parentTableOrNullObject?: Word.Interfaces.TableLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApi 1.3 ]

pictureContentControl

Obtient les données liées à l’image si le contrôle de contenu Word. ContentControlType est picture. C’est null le contraire.

pictureContentControl?: Word.Interfaces.PictureContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]

placeholderText

Spécifie le texte de l’espace réservé du contrôle de contenu. Ce texte apparaît de façon estompée lorsque le contrôle de contenu est vide.

placeholderText?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

removeWhenEdited

Spécifie une valeur qui indique si le contrôle de contenu est supprimé après sa modification. Mutuellement exclusif avec cannotDelete.

removeWhenEdited?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

repeatingSectionContentControl

Obtient les données de section répétées si le contrôle de contenu Word. ContentControlType est repeatingSection. C’est null le contraire.

repeatingSectionContentControl?: Word.Interfaces.RepeatingSectionContentControlLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]

style

Spécifie le nom du style pour le contrôle de contenu. Utilisez cette propriété pour les noms des styles personnalisés et localisés. Pour utiliser les styles intégrés qui sont portables entre les paramètres régionaux, consultez la styleBuiltIn propriété .

style?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

styleBuiltIn

Spécifie le nom de style intégré pour le contrôle de contenu. Utilisez cette propriété pour les styles intégrés qui sont portables entre les paramètres régionaux. Pour utiliser des styles personnalisés ou des noms de style localisés, consultez la style propriété .

styleBuiltIn?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.3 ]

subtype

Obtient le sous-type du contrôle de contenu. Le sous-type peut être richTextInline,richTextParagraphs , richTextTableRowrichTextTableCellet richTextTable pour les contrôles de contenu de texte enrichi, plainTextInline et plainTextParagraph pour les contrôles de contenu de texte brut, checkBox pour les contrôles de contenu de case à cocher, dropDownList pour les contrôles de contenu de liste déroulante, comboBox pour les contrôles de contenu de zone de liste déroulante, buildingBlockGallery pour les contrôles de contenu de la galerie de blocs de construction, datePicker pour les contrôles de contenu du sélecteur de dates, repeatingSection pour les contrôles de contenu de section répétée, picture pour les contrôles de contenu d’image et group pour les contrôles de contenu de groupe.

subtype?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.3 ]

tag

Spécifie une balise pour identifier un contrôle de contenu.

tag?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

text

Obtient le texte du contrôle de contenu.

text?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

title

Spécifie le titre d’un contrôle de contenu.

title?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

type

Obtient le type du contrôle de contenu. Seuls les contrôles texte enrichi, texte brut, zone de case activée, liste déroulante, zone de liste déroulante, galerie de blocs de construction, sélecteur de dates, section répétée, image et contenu de groupe sont actuellement pris en charge.

type?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApi 1.1 ]

xmlMapping

Renvoie un XmlMapping objet qui représente le mappage du contrôle de contenu aux données XML dans le magasin de données du document.

xmlMapping?: Word.Interfaces.XmlMappingLoadOptions;

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.3 ]