ContentControl, classe (System 2007)

Article
08/23/2008

Mise à jour : novembre 2007

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

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

Syntaxe

<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As ContentControl

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

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 classes de contrôle de contenu dans Visual Studio Tools pour Office ne peuvent pas être utilisées de cette manière. Par exemple, un objet RichTextContentControl peut représenter uniquement un contrôle de texte riche. 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.

Hiérarchie d'héritage

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.ContentControl

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.