Freigeben über


ContentControl-Schnittstelle

Stellt ein Inhaltssteuerelement in einem Dokument dar.

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

Syntax

'Declaration
<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

Der ContentControl-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Application Ruft eine Microsoft.Office.Interop.Word.Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.
Öffentliche Eigenschaft BindingContext Ruft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Von IBindableComponent geerbt.)
Öffentliche Eigenschaft BuildingBlockCategory Ruft die Kategorie der Bausteine ab, die in einem ContentControl angezeigt werden, das einen Bausteinkatalog darstellt, oder legt die Kategorie fest.
Öffentliche Eigenschaft BuildingBlockType Ruft den Typ der Bausteine ab, die in einem ContentControl angezeigt werden, das einen Bausteinkatalog darstellt, oder legt den Typ fest.
Öffentliche Eigenschaft Checked Ruft einen Wert ab, der angibt, ob ein ContentControl, das ein Kontrollkästchen-Steuerelement darstellt, aktiviert oder deaktiviert ist, oder legt diesen Wert fest.
Öffentliche Eigenschaft Container Infrastruktur. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft ContainerComponent Infrastruktur. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft Creator Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das ContentControl erstellt wurde.
Öffentliche Eigenschaft DataBindings Ruft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Von IBindableComponent geerbt.)
Öffentliche Eigenschaft DateCalendarType Ruft den Typ des Kalenders ab, der in einem ContentControl angezeigt wird, das eine Datumsauswahl darstellt, oder legt den Typ fest.
Öffentliche Eigenschaft DateDisplayFormat Ruft eine Zeichenfolge ab, die das Format der Datumsangaben angibt, die in einem ContentControl, das eine Datumsauswahl darstellt, angezeigt werden, oder legt die Zeichenfolge fest.
Öffentliche Eigenschaft DateDisplayLocale Ruft das Sprachformat des Datums ab, das in einem ContentControl angezeigt wird, das eine Datumsauswahl darstellt, oder legt das Sprachformat fest.
Öffentliche Eigenschaft DateStorageFormat Ruft das Format ab, in dem Datumsangaben in einem benutzerdefinierten XML-Abschnitt von einem ContentControl, das eine Datumsauswahl darstellt, gespeichert werden, oder legt das Format fest.
Öffentliche Eigenschaft DefaultDataSourceUpdateMode Ruft den Standard-DataSourceUpdateMode für den ContentControlBase ab oder legt diesen fest. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft DefaultTextStyle Ruft den Namen des Zeichenstils ab, der verwendet wird, um im ContentControl Text zu formatieren.
Öffentliche Eigenschaft DropDownListEntries Ruft die Auflistung der Elemente ab, die von einem ContentControl dargestellt werden, das eine Dropdownliste oder ein Kombinationsfeld darstellt.
Öffentliche Eigenschaft ID Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft InnerObject Ruft das zugrunde liegende Microsoft.Office.Interop.Word.ContentControl-Objekt für das Microsoft.Office.Tools.Word.ContentControlBase ab. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft LockContentControl Ruft einen Wert ab, der angibt, ob das ContentControl aus dem Dokument gelöscht werden kann, oder legt den Wert fest.
Öffentliche Eigenschaft LockContents Ruft einen Wert ab, der angibt, ob der Inhalt vom ContentControl bearbeitet werden kann, oder legt den Wert fest.
Öffentliche Eigenschaft MultiLine Ruft einen Wert ab, der angibt, ob das ContentControl Zeilenumbrüche enthalten kann, oder legt einen Wert fest.
Öffentliche Eigenschaft Parent Ruft das übergeordnete Element der ContentControl ab.
Öffentliche Eigenschaft ParentContentControl Ruft das übergeordnete Inhaltssteuerelement eines ContentControl ab, das in einem anderen Inhaltssteuerelement geschachtelt ist.
Öffentliche Eigenschaft PlaceholderText Ruft den Text ab, der in ContentControl angezeigt wird, bis der Text durch eine Benutzeraktion oder einen anderen Vorgang geändert wird.
Öffentliche Eigenschaft Range Ruft einen Range ab, der den Inhalt des ContentControl darstellt.
Öffentliche Eigenschaft ShowingPlaceholderText Ruft einen Wert ab, der angibt, ob das ContentControl derzeit Platzhaltertext anzeigt.
Öffentliche Eigenschaft Site Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
Öffentliche Eigenschaft Tag Ruft eine Zeichenfolge ab, die Sie dem ContentControl zuordnen, oder legt eine Zeichenfolge fest.
Öffentliche Eigenschaft Temporary Ruft einen Wert ab, der angibt, ob das ContentControl bei Bearbeitung des Steuerelements automatisch aus dem Dokument gelöscht wird, oder legt den Wert fest.
Öffentliche Eigenschaft Title Ruft den Titel für das ContentControl ab oder legt diesen fest.
Öffentliche Eigenschaft Type Ruft einen Wert ab, der den Typ des Inhaltssteuerelements angibt, das vom ContentControl dargestellt wird, oder legt einen Wert fest.
Öffentliche Eigenschaft XMLMapping Ruft ein XMLMapping-Element ab, das die Bindung zwischen dem ContentControl-Element und einem Element in einem benutzerdefinierten XML-Abschnitt darstellt.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode BeginInit Signalisiert dem Objekt den Start der Initialisierung. (Von ISupportInitialize geerbt.)
Öffentliche Methode Copy Kopiert das ContentControl aus dem Dokument in die Zwischenablage.
Öffentliche Methode Cut Entfernt das ContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.
Öffentliche Methode Delete Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument. (Von ContentControlBase geerbt.)
Öffentliche Methode Dispose Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
Öffentliche Methode EndInit Signalisiert dem Objekt den Abschluss der Initialisierung. (Von ISupportInitialize geerbt.)
Öffentliche Methode SetCheckedSymbol Legt das Symbol fest, das den aktivierten Zustand eines ContentControl darstellt, das ein Kontrollkästchen-Steuerelement darstellt.
Öffentliche Methode SetPlaceholderText Zeigt Text an, der sich in einem BuildingBlock, einem Range oder in einer Zeichenfolge als Platzhaltertext im ContentControl befindet.
Öffentliche Methode SetUncheckedSymbol Legt das Symbol fest, das verwendet wird, um den deaktivierten Zustand eines ContentControl darzustellen, der ein Kontrollkästchen-Steuerelement darstellt
Öffentliche Methode Ungroup Entfernt das Gruppeninhalts-Steuerelement, das das ContentControl enthält, aus dem Dokument, sodass der Bereich nicht länger geschützt ist.

Zum Seitenanfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis Added Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde. (Von ContentControlBase geerbt.)
Öffentliches Ereignis BindingContextChanged Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis ContentUpdating Tritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Deleting Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Disposed Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
Öffentliches Ereignis Entering Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Exiting Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis StoreUpdating Tritt auf, kurz bevor Microsoft Office Word Daten in einem benutzerdefinierten XML-Abschnitt aktualisiert, der an das Inhaltssteuerelement gebunden ist (nachdem der Text im Inhaltssteuerelement sich ändert). (Von ContentControlBase geerbt.)
Öffentliches Ereignis Validated Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Validating Tritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird. (Von ContentControlBase geerbt.)

Zum Seitenanfang

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 Inhaltssteuerelemente können nicht auf diese Weise verwendet werden. Zum Beispiel kann ein RichTextContentControl 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.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Verwendung

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und .NET Framework 4.5 ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.

Siehe auch

Referenz

Microsoft.Office.Tools.Word-Namespace

Weitere Ressourcen

Inhaltssteuerelemente

Gewusst wie: Hinzufügen von Inhaltssteuerelementen zu Word-Dokumenten

Gewusst wie: Schützen von Teilen von Dokumenten mithilfe von Inhaltssteuerelementen