ContentControl Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 ContentControls collection.
public interface class ContentControl
[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl
type ContentControl = interface
Public Interface ContentControl
- Attributs
Remarques
Utilisez la Add(WdContentControlType, Object) méthode de la ContentControls collection pour créer un contrôle de contenu. Utilisez le Type
paramètre de la méthode Add pour spécifier le type de contrôle de contenu à créer.
Utilisez la Type propriété pour remplacer le contrôle de contenu par un autre type de contrôle de contenu. 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.
Utilisez la SetPlaceholderText(BuildingBlock, Range, String) méthode pour modifier le texte de l’espace réservé de la chaîne par défaut en quelque chose de plus approprié pour le contrôle. Utilisez la Title propriété 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.
BuildingBlockCategory Propriété | Contrôles de contenu BuildingBlock Gallery (wdContentControlBuildingBlockGallery) | |
BuildingBlockType Propriété | Contrôles de contenu BuildingBlock Gallery (wdContentControlBuildingBlockGallery) | |
DateDisplayFormat Propriété | Contrôles de contenu de date (wdContentControlDate) | |
DateDisplayLocale Propriété | Contrôles de contenu de date (wdContentControlDate) | |
DateStorageFormat Propriété | Contrôles de contenu de date (wdContentControlDate) | |
DropdownListEntries Propriété | Contrôles de contenu de zone de liste déroulante et de liste déroulante (wdContentControlComboBox et wdContentControlDropdownList) | |
MultiLine Propriété | Contrôles de contenu de texte brut (wdContentControlText) | |
Ungroup() Méthode | Contrôles de contenu de groupe (wdContentControlGroup) |
Propriétés
AllowInsertDeleteSection |
Obtient ou définit si les utilisateurs peuvent ajouter ou supprimer des sections du contrôle de contenu de section répétée spécifié à l’aide de l’interface utilisateur. |
Appearance |
Renvoie ou définit l’apparence du contrôle de contenu. Lecture/écriture WdContentControlAppearance |
Application |
Renvoie un _Application objet qui représente l’application Microsoft Word. |
BuildingBlockCategory |
Renvoie ou définit la catégorie d’un contrôle de contenu de bloc de construction. Lecture-écriture. |
BuildingBlockType |
Renvoie ou définit le type de bloc de construction d’un contrôle de contenu de bloc de construction. Lecture-écriture. |
Checked |
Obtient ou définit l’état actuel (activé/décoché) d’une case case activée. |
Color |
Renvoie ou définit la couleur du contrôle de contenu. En lecture/écriture WdColor. |
Creator |
Renvoie un entier 32 bits qui indique l'application dans laquelle le complément a été créé. En lecture seule. |
DateCalendarType |
Renvoie ou définit le type de calendrier pour un contrôle de contenu de calendrier. Lecture-écriture. |
DateDisplayFormat |
Renvoie ou définit le format dans lequel les dates sont affichées. Lecture-écriture. |
DateDisplayLocale |
Renvoie un format de langue pour la date affichée dans un contrôle de contenu de date. Lecture-écriture. |
DateStorageFormat |
Renvoie ou définit le format de stockage et de récupération des dates lorsqu’un contrôle de contenu de date est lié au magasin de données XML du document actif. Lecture-écriture. |
DefaultTextStyle |
Renvoie ou définit le nom du style de caractère à utiliser pour mettre en forme le texte dans un contrôle de contenu de texte. Lecture-écriture. |
DropdownListEntries |
Retourne les éléments d’un contrôle de contenu de liste déroulante ou d’un contrôle de contenu de zone de liste déroulante. En lecture seule. |
ID |
Retourne l’identification d’un contrôle de contenu. En lecture seule. |
Level |
Retourne le niveau du contrôle de contenu, que le contrôle de contenu entoure du texte, des paragraphes, des cellules de tableau ou des lignes de tableau ; ou s’il est inline. En lecture seule WdContentControlLevel. |
LockContentControl |
Cette propriété renvoie ou définit un type Boolean qui indique si l'utilisateur peut supprimer un contrôle de contenu à partir du document actif. Lecture-écriture. |
LockContents |
Cette propriété renvoie ou définit un type Boolean qui indique si l'utilisateur peut modifier le contenu d'un contrôle de contenu. Lecture-écriture. |
MultiLine |
Renvoie un type Boolean qui indique si un contrôle de contenu de texte autorise plusieurs lignes de texte. Lecture-écriture. |
Parent |
Renvoie un qui représente l’objet parent de l’objet spécifié ContentControl . |
ParentContentControl |
Retourne le contrôle de contenu parent pour un contrôle de contenu imbriqué à l’intérieur d’un contrôle de texte enrichi ou d’un contrôle de groupe. En lecture seule. |
PlaceholderText |
Renvoie un BuildingBlock objet qui représente le texte de l’espace réservé d’un contrôle de contenu. En lecture seule. |
Range |
Retourne un Range qui représente le contenu du contrôle de contenu dans le document actif. En lecture seule. |
RepeatingSectionItems |
Retourne la collection d’éléments de section répétitifs dans le contrôle de contenu de section répétitif spécifié. En lecture seule. |
RepeatingSectionItemTitle |
Renvoie ou définit le nom des éléments de section répétitifs utilisés dans le menu contextuel associé au contrôle de contenu de section répétitif spécifié. Lecture-écriture. |
ShowingPlaceholderText |
Renvoie un type Boolean qui indique si le texte d'espace réservé pour le contrôle de contenu est affiché. En lecture seule. |
Tag |
Renvoie ou définit une valeur pour identifier un contrôle de contenu. En lecture/écriture |
Temporary |
Cette propriété renvoie ou définit un type Boolean qui indique s'il faut supprimer un contrôle de contenu à partir du document actif lorsque l'utilisateur modifie le contenu du contrôle. Lecture-écriture. |
Title |
Renvoie ou définit le titre d’un contrôle de contenu. En lecture/écriture |
Type |
Renvoie ou définit le type d’un contrôle de contenu. En lecture/écriture |
XMLMapping |
Retourne le mappage d’un contrôle de contenu à des données XML dans le magasin de données d’un document. En lecture seule. |
Méthodes
Copy() |
Copie le contrôle de contenu du document actif dans le Presse-papiers. |
Cut() |
Supprime le contrôle de contenu du document actif et le place dans le Presse-papiers. |
Delete(Boolean) |
Supprime le contrôle de contenu spécifié et son contenu. |
SetCheckedSymbol(Int32, String) |
Définit le symbole utilisé pour représenter l'état activé d'un contrôle de contenu de case à cocher. |
SetPlaceholderText(BuildingBlock, Range, String) |
Définit le texte de l'espace réservé qui s'affiche dans le contrôle de contenu jusqu'à ce qu'un utilisateur entre son propre texte. |
SetUncheckedSymbol(Int32, String) |
Définit le symbole utilisé pour représenter l'état désactivé d'un contrôle de contenu de case à cocher. |
Ungroup() |
Supprime un contrôle de contenu de groupe dans un document pour que ses contrôles enfants ne soient plus imbriqués et pour autoriser leur modification. |