ContentControl-Klasse (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Stellt ein Inhaltssteuerelement in einem Dokument dar.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Syntax

<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

Hinweise

Ein ContentControl-Objekt ist ein änderbares Steuerelement, das jeden der acht Typen von Steuerelementen darstellen kann, die Sie in Microsoft Office Word verwenden können. Wenn Sie beispielsweise ein ContentControl-Objekt erstellen, das anfänglich die Funktionalität eines Nur-Text-Steuerelements aufweist, können Sie es zur Laufzeit so ändern, dass es sich wie ein Kombinationsfeld verhält. Andere Inhaltssteuerelementklassen in Visual Studio Tools for Office können nicht auf diese Weise verwendet werden. Zum Beispiel kann ein RichTextContentControl-Objekt nur ein Rich-Text-Steuerelement darstellen. Weitere Informationen zu Inhaltssteuerelementen finden Sie unter Inhaltssteuerelemente.

Um ein ContentControl zu erstellen, verwenden Sie eine der AddContentControl-Methoden. Sie können ein ContentControl einem Dokument nicht zur Entwurfszeit hinzufügen.

Wenn Sie ein ContentControl erstellen, müssen Sie den Typ des zu erstellenden Steuerelements angeben, oder Sie erstellen das neue Steuerelement auf der Grundlage eines vorhandenen Steuerelements. Nachdem Sie ein ContentControl erstellt haben, können Sie den Typ des Steuerelements, den es darstellt, mithilfe der Type-Eigenschaft ändern.

Einige ContentControl-Member lösen eine Ausnahme aus, wenn sie verwendet werden, während das Steuerelement auf einen Steuerelementtyp festgelegt ist, der nicht für die Verwendung des Members vorgesehen ist. Die DateCalendarType-Eigenschaft löst z. B. eine Ausnahme aus, wenn Sie versuchen, sie mit einem ContentControl zu verwenden, dass keine Datumsauswahl darstellt.

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.