ContentControl Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

GuidAttribute

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.