ContentControl-Schnittstelle

Artikel
08/10/2011

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
	Application	Ruft eine Microsoft.Office.Interop.Word.Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.
	BindingContext	Ruft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Von IBindableComponent geerbt.)
	BuildingBlockCategory	Ruft die Kategorie der Bausteine ab, die in einem ContentControl angezeigt werden, das einen Bausteinkatalog darstellt, oder legt die Kategorie fest.
	BuildingBlockType	Ruft den Typ der Bausteine ab, die in einem ContentControl angezeigt werden, das einen Bausteinkatalog darstellt, oder legt den Typ fest.
	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.Diese Eigenschaft kann nur in Word 2010-Projekten verwendet werden.
	Container	Infrastruktur. (Von ContentControlBase geerbt.)
	ContainerComponent	Infrastruktur. (Von ContentControlBase geerbt.)
	Creator	Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das ContentControl erstellt wurde.
	DataBindings	Ruft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Von IBindableComponent geerbt.)
	DateCalendarType	Ruft den Typ des Kalenders ab, der in einem ContentControl angezeigt wird, das eine Datumsauswahl darstellt, oder legt den Typ fest.
	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.
	DateDisplayLocale	Ruft das Sprachformat des Datums ab, das in einem ContentControl angezeigt wird, das eine Datumsauswahl darstellt, oder legt das Sprachformat fest.
	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.
	DefaultDataSourceUpdateMode	Ruft den Standard-DataSourceUpdateMode für den ContentControlBase ab oder legt diesen fest. (Von ContentControlBase geerbt.)
	DefaultTextStyle	Ruft den Namen des Zeichenstils ab, der verwendet wird, um im ContentControl Text zu formatieren.
	DropDownListEntries	Ruft die Auflistung der Elemente ab, die von einem ContentControl dargestellt werden, das eine Dropdownliste oder ein Kombinationsfeld darstellt.
	ID	Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert. (Von ContentControlBase geerbt.)
	InnerObject	Ruft das zugrunde liegende Microsoft.Office.Interop.Word.ContentControl-Objekt für das Microsoft.Office.Tools.Word.ContentControlBase ab. (Von ContentControlBase geerbt.)
	LockContentControl	Ruft einen Wert ab, der angibt, ob das ContentControl aus dem Dokument gelöscht werden kann, oder legt den Wert fest.
	LockContents	Ruft einen Wert ab, der angibt, ob der Inhalt vom ContentControl bearbeitet werden kann, oder legt den Wert fest.
	MultiLine	Ruft einen Wert ab, der angibt, ob das ContentControl Zeilenumbrüche enthalten kann, oder legt einen Wert fest.
	Parent	Ruft das übergeordnete Element für das ContentControl ab.
	ParentContentControl	Ruft das übergeordnete Inhaltssteuerelement eines ContentControl ab, das in einem anderen Inhaltssteuerelement geschachtelt ist.
	PlaceholderText	Ruft den Text ab, der in ContentControl angezeigt wird, bis der Text durch eine Benutzeraktion oder einen anderen Vorgang geändert wird.
	Range	Ruft einen Range ab, der den Inhalt des ContentControl darstellt.
	ShowingPlaceholderText	Ruft einen Wert ab, der angibt, ob das ContentControl derzeit Platzhaltertext anzeigt.
	Site	Ruft die ISite ab, die IComponent zugeordnet ist, oder legt diese fest. (Von IComponent geerbt.)
	Tag	Ruft eine Zeichenfolge ab, die Sie dem ContentControl zuordnen, oder legt eine Zeichenfolge fest.
	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.
	Title	Ruft den Titel der ContentControl ab oder legt diesen fest.
	Type	Ruft einen Wert ab, der den Typ des Inhaltssteuerelements angibt, das vom ContentControl dargestellt wird, oder legt einen Wert fest.
	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
	BeginInit	Signalisiert dem Objekt den Start der Initialisierung. (Von ISupportInitialize geerbt.)
	Copy	Kopiert das ContentControl aus dem Dokument in die Zwischenablage.
	Cut	Entfernt das ContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.
	Delete	Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument. (Von ContentControlBase geerbt.)
	Dispose	Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
	EndInit	Signalisiert dem Objekt den Abschluss der Initialisierung. (Von ISupportInitialize geerbt.)
	SetCheckedSymbol	Legt das Symbol fest, das den aktivierten Zustand eines ContentControl darstellt, das ein Kontrollkästchen-Steuerelement darstellt.Diese Methode kann nur in Word 2010-Projekten verwendet werden.
	SetPlaceholderText	Zeigt Text an, der sich in einem BuildingBlock, einem Range oder in einer Zeichenfolge als Platzhaltertext im ContentControl befindet.
	SetUncheckedSymbol	Legt das Symbol fest, das den deaktivierten Zustand eines ContentControl darstellt, das ein Kontrollkästchen-Steuerelement darstellt.Diese Methode kann nur in Word 2010-Projekten verwendet werden.
	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
	Added	Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde. (Von ContentControlBase geerbt.)
	BindingContextChanged	Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird. (Von ContentControlBase geerbt.)
	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.)
	Deleting	Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf. (Von ContentControlBase geerbt.)
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
	Entering	Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird. (Von ContentControlBase geerbt.)
	Exiting	Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird. (Von ContentControlBase geerbt.)
	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.)
	Validated	Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde. (Von ContentControlBase geerbt.)
	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.

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for 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

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 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.