ContentControl, interface

Article
08/10/2011

Représente un contrôle de contenu de document.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Le type ContentControl expose les membres suivants.

Propriétés

	Nom	Description
	Application	Obtient une Microsoft.Office.Interop.Word.Application qui représente l'instance actuelle de Microsoft Office Word.
	BindingContext	Obtient ou définit la collection de gestionnaires de devise pour IBindableComponent. (Hérité de IBindableComponent.)
	BuildingBlockCategory	Obtient ou définit la catégorie des blocs de construction affichés dans un ContentControl qui représente une galerie de bloc de construction.
	BuildingBlockType	Obtient ou définit le type des blocs de construction affichés dans un ContentControl qui représente une galerie de bloc de construction.
	Checked	Obtient ou définit une valeur qui indique si un ContentControl représentant un contrôle de case à cocher est activé ou désactivé.Cette propriété peut uniquement être utilisée dans les projets Word 2010.
	Container	Infrastructure. (Hérité de ContentControlBase.)
	ContainerComponent	Infrastructure. (Hérité de ContentControlBase.)
	Creator	Obtient un entier 32 bits qui indique l'application dans laquelle le ContentControl a été créé.
	DataBindings	Obtient la collection d'objets de liaison de données pour ce IBindableComponent. (Hérité de IBindableComponent.)
	DateCalendarType	Obtient ou définit le type de calendrier affiché dans un ContentControl qui représente un sélecteur de dates.
	DateDisplayFormat	Obtient ou définit une chaîne qui spécifie le format des dates affichées dans un ContentControl qui représente un sélecteur de dates.
	DateDisplayLocale	Obtient ou définit le format de langage de la date affichée dans un ContentControl qui représente un sélecteur de dates.
	DateStorageFormat	Obtient ou définit le format dans lequel les dates sont enregistrées dans une partie XML personnalisée par un ContentControl qui représente un sélecteur de dates.
	DefaultDataSourceUpdateMode	Obtient ou définit la valeur DataSourceUpdateMode par défaut de ContentControlBase. (Hérité de ContentControlBase.)
	DefaultTextStyle	Obtient le nom du style de caractère utilisé pour mettre en forme le texte dans le ContentControl.
	DropDownListEntries	Obtient la collection des éléments affichés par un ContentControl qui représente une liste déroulante ou une zone de liste déroulante.
	ID	Obtient un nombre unique qui identifie le contrôle de contenu. (Hérité de ContentControlBase.)
	InnerObject	Obtient l'objet Microsoft.Office.Interop.Word.ContentControl sous-jacent de Microsoft.Office.Tools.Word.ContentControlBase. (Hérité de ContentControlBase.)
	LockContentControl	Obtient ou définit une valeur qui spécifie si le ContentControl peut être supprimé du document.
	LockContents	Obtient ou définit une valeur qui spécifie si le contenu de ContentControl peut être modifié.
	MultiLine	Obtient ou définit une valeur qui spécifie si le ContentControl peut contenir des sauts de ligne.
	Parent	Définit le parent du ContentControl.
	ParentContentControl	Obtient le contrôle de contenu parent d'un ContentControl imbriqué dans un autre contrôle de contenu.
	PlaceholderText	Obtient le texte affiché dans le ContentControl jusqu'à ce que le texte soit modifié par une action utilisateur ou une autre opération.
	Range	Obtient un Range qui représente le contenu du ContentControl.
	ShowingPlaceholderText	Obtient une valeur qui indique si le ContentControl affiche actuellement le texte de l'espace réservé.
	Site	Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
	Tag	Obtient ou définit une chaîne à associer au ContentControl.
	Temporary	Obtient ou définit une valeur qui spécifie si le ContentControl est supprimé automatiquement du document lorsque le contrôle est modifié.
	Title	Obtient ou définit le titre de la ContentControl.
	Type	Obtient ou définit une valeur qui spécifie le type de contrôle de contenu que le ContentControl représente.
	XMLMapping	Obtient un XMLMapping qui représente la liaison entre le ContentControl et un élément dans une partie XML personnalisée.

Début

Méthodes

	Nom	Description
	BeginInit	Signale à l'objet que l'initialisation démarre. (Hérité de ISupportInitialize.)
	Copy	Copie le ContentControl du document vers le Presse-papiers.
	Cut	Supprime le ContentControl du document et l'ajoute au Presse-papiers.
	Delete	Supprime un contrôle de contenu créé dynamiquement du document et le retire de ControlCollection dans le document. (Hérité de ContentControlBase.)
	Dispose	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.)
	EndInit	Signale à l'objet que l'initialisation est terminée. (Hérité de ISupportInitialize.)
	SetCheckedSymbol	Définit le symbole utilisé pour représenter l'état activé d'un ContentControl qui correspond à un contrôle de case à cocher.Cette méthode peut uniquement être utilisée dans les projets Word 2010.
	SetPlaceholderText	Affiche le texte qui se trouve dans BuildingBlock, Range ou une chaîne sous forme de texte d'espace réservé dans ContentControl.
	SetUncheckedSymbol	Définit le symbole utilisé pour représenter l'état désactivé d'un ContentControl qui correspond à un contrôle de case à cocher.Cette méthode peut uniquement être utilisée dans les projets Word 2010.
	Ungroup	Supprime le contrôle de contenu du groupe, qui contient le ContentControl du document afin que la région ne soit plus protégée.

Début

Événements

	Nom	Description
	Added	Se produit après l'ajout du contrôle de contenu au document. (Hérité de ContentControlBase.)
	BindingContextChanged	Se produit lorsque la valeur de la propriété BindingContext de ContentControlBase est modifiée. (Hérité de ContentControlBase.)
	ContentUpdating	Se produit juste avant que Microsoft Office Word mette à jour le texte dans le contrôle de contenu, si ce dernier est lié à une partie XML personnalisée. (Hérité de ContentControlBase.)
	Deleting	Se produit juste avant que le contrôle de contenu soit supprimé du document. (Hérité de ContentControlBase.)
	Disposed	Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.)
	Entering	Se produit lorsque l'utilisateur clique dans le contrôle de contenu ou lorsque le curseur est amené par programme dans le contrôle de contenu. (Hérité de ContentControlBase.)
	Exiting	Se produit lorsque l'utilisateur clique en dehors du contrôle de contenu, ou lorsque le curseur quitte le contrôle de contenu par programme. (Hérité de ContentControlBase.)
	StoreUpdating	Se produit juste avant que Microsoft Office Word mette à jour les données dans une partie XML personnalisée liée au contrôle de contenu (à savoir, après la modification du texte dans le contrôle de contenu). (Hérité de ContentControlBase.)
	Validated	Se produit lorsque le contrôle de contenu a été validé. (Hérité de ContentControlBase.)
	Validating	Se produit lorsque le contenu du contrôle est validé. (Hérité de ContentControlBase.)

Début

Notes

Un objet ContentControl est un contrôle mutable qui peut représenter l'un des huit types de contrôles de contenu que vous pouvez utiliser dans Microsoft Office Word. Par exemple, si vous créez un ContentControl qui initialement a les fonctionnalités d'un contrôle de texte ordinaire, vous pouvez le modifier au moment de l'exécution afin qu'il se comporte comme une zone de liste déroulante. Les autres contrôles de contenu ne peuvent pas être utilisés de cette façon. Par exemple, un RichTextContentControl peut uniquement représenter un contrôle de texte enrichi. Pour plus d'informations sur les contrôles de contenu, consultez Contrôles de contenu.

Pour créer un ContentControl, utilisez l'une des méthodes AddContentControl. Vous ne pouvez pas ajouter un ContentControl à un document au moment du design.

Lorsque vous créez un ContentControl, vous devez spécifier le type du contrôle de contenu, ou vous pouvez baser le nouveau contrôle sur un contrôle de contenu existant. Après avoir créé un ContentControl, vous pouvez modifier le type de contrôle de contenu qu'il représente en utilisant la propriété Type.

Certains membres ContentControl lèveront une exception si vous les utilisez pendant que le contrôle a pour valeur un type de contrôle qui n'est pas sensé utiliser le membre. Par exemple, la propriété DateCalendarType lèvera une exception si vous essayez de l'utiliser dans un ContentControl qui ne représente pas un sélecteur de dates.

Notes

Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.

Utilisation

Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : https://go.microsoft.com/fwlink/?LinkId=160658.