Objet ContentControl (Word)

Contrôle de contenu spécifique. Les contrôles de contenu sont des régions liées et potentiellement étiquetées d'un document qui servent de conteneur pour des types de contenu spécifiques. Chaque contrôle de contenu peut comporter des dates, des listes ou des paragraphes de texte mis en forme. L’objet ContentControl est membre de la collection ContentControls .

Remarques

Utilisez la méthode Add de la collection ContentControls pour créer un contrôle de contenu. Use the Type parameter of the Add method to specify the type of content control to create. The following example create a new drop-down list content control and adds several items to the list.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList) 
 
'List entries 
objCC.DropdownListEntries.Add "Cat" 
objCC.DropdownListEntries.Add "Dog" 
objCC.DropdownListEntries.Add "Horse" 
objCC.DropdownListEntries.Add "Monkey" 
objCC.DropdownListEntries.Add "Snake" 
objCC.DropdownListEntries.Add "Other"

Utilisez la propriété Type pour changer le type du contrôle de contenu (par exemple, pour remplacer un contrôle de date par un contrôle de texte). Néanmoins, vous risquez de ne pas pouvoir modifier le type de tous les contrôles de contenu. En effet, la modification de certains types de contenu n’est pas autorisée. En outre, il est possible que le type d’un contrôle de contenu ne puisse pas être modifié à cause de son contenu. Par exemple, si le contrôle de contenu à modifier n’autorise pas le type de contenu figurant dans le contrôle existant, vous ne pouvez pas modifier le type du contrôle, au risque de générer une erreur d’exécution.

L'exemple suivant montre comment insérer un contrôle de contenu de date, comment en définir la valeur et comment le modifier en contrôle de contenu de texte.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate) 
 
objCC.Range.Text = "January 1, 2007" 
objCC.Type = wdContentControlText

Utilisez la méthode SetPlaceholderText pour remplacer le texte de l’espace réservé dans la chaîne par défaut par un texte plus approprié. Utilisez la propriété Title pour spécifier le texte du titre du contrôle. Celui-ci s’affiche au-dessus du contrôle lorsque le curseur est situé dans le contrôle ou lorsque le pointeur de la souris se trouve sur le contrôle.

En fonction du type de votre contrôle de contenu, certaines propriétés et méthodes de l’objet ContentControl risquent de ne pas être utilisables.

Toutes les propriétés de contrôles de contenu ne s'appliquent pas à tous leurs types. Le tableau suivant indique quelles propriétés sont applicables aux types de contrôles de contenu.

Propriété/Méthode	Applicable aux
BuildingBlockCategory property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
BuildingBlockType property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
DateDisplayFormat property	Date content controls (wdContentControlDate)
DateDisplayLocale property	Date content controls (wdContentControlDate)
DateStorageFormat property	Date content controls (wdContentControlDate)
DropdownListEntries property	Combo box and drop-down list content controls (wdContentControlComboBox and wdContentControlDropdownList)
MultiLine property	Plain text content controls (wdContentControlText)
Ungroup method	Group content controls (wdContentControlGroup)

Voir aussi

Référence du modèle objet Word

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.