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.