ContentControl Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein einzelnes Inhaltssteuerelement. Inhaltssteuerelemente sind gebundene und möglicherweise mit Beschriftungen versehene Bereiche in einem Dokument, die als Container für bestimmte Typen von Inhalt dienen. Einzelne Inhaltssteuerelemente können Inhalt wie Daten, Listen oder Absätze mit formatiertem Text enthalten. Das ContentControl-Objekt ist ein Element der ContentControls Auflistung.

public interface class ContentControl

[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl

type ContentControl = interface

Public Interface ContentControl

Attribute: GuidAttribute

Hinweise

Verwenden Sie die Add(WdContentControlType, Object) -Methode der ContentControls Auflistung, um ein Inhaltssteuerelement zu erstellen. Verwenden Sie den Type Parameter der Add-Methode , um den Typ des zu erstellenden Inhaltssteuerelements anzugeben.

Verwenden Sie die Type -Eigenschaft, um das Inhaltssteuerelement in einen anderen Typ von Inhaltssteuerelement zu ändern. Sie können z. B. ein Datumssteuerelement in ein Textsteuerelement ändern. Allerdings können nicht alle Inhaltssteuerelemente in einen anderen Typ geändert werden, da bei einigen Inhaltssteuerelementen das Ändern des Typs nicht zulässig ist. Außerdem kann es auch an dem Inhalt eines Inhaltssteuerelements liegen, dass der Typ nicht geändert werden kann. Wenn z. B. das Inhaltssteuerelement, in das Sie die Änderung vornehmen möchten, den Typ von Inhalt nicht zulässt, der sich im vorhandenen Inhaltssteuerelement befindet, wird eine Änderung nicht zugelassen, und es wird ein Laufzeitfehler ausgegeben.

Verwenden Sie die SetPlaceholderText(BuildingBlock, Range, String) -Methode, um den Platzhaltertext von der Standardzeichenfolge in etwas zu ändern, das für das Steuerelement besser geeignet ist. Verwenden Sie die Title -Eigenschaft, um den Titeltext für das Steuerelement anzugeben. Dieser wird oberhalb des Steuerelements angezeigt, wenn Sie den Cursor innerhalb des Steuerelements positionieren oder den Mauszeiger über das Steuerelement bewegen.

Je nach Typ des vorliegenden Steuerelements können Sie möglicherweise nicht alle Eigenschaften und Methoden des ContentControl-Objekts verwenden.

Nicht alle Eigenschaften von Inhaltssteuerelementen gelten für all die verschiedenen Typen von Inhaltssteuerelementen. In der folgenden Tabelle wird aufgeführt, welche Eigenschaften für welche Typen von Inhaltssteuerelementen gelten.

	BuildingBlockCategory Eigenschaft	BuildingBlock Gallery-Inhaltssteuerelemente (wdContentControlBuildingBlockGallery)
	BuildingBlockType Eigenschaft	BuildingBlock Gallery-Inhaltssteuerelemente (wdContentControlBuildingBlockGallery)
	DateDisplayFormat Eigenschaft	Datumsinhaltssteuerelemente (wdContentControlDate)
	DateDisplayLocale Eigenschaft	Datumsinhaltssteuerelemente (wdContentControlDate)
	DateStorageFormat Eigenschaft	Datumsinhaltssteuerelemente (wdContentControlDate)
	DropdownListEntries Eigenschaft	Inhaltssteuerelemente für Kombinationsfeld und Dropdownliste (wdContentControlComboBox und wdContentControlDropdownList)
	MultiLine Eigenschaft	Nur-Text-Inhaltssteuerelemente (wdContentControlText)
	Ungroup() Methode	Gruppeninhaltssteuerelemente (wdContentControlGroup)

Eigenschaften

AllowInsertDeleteSection	Ruft ab oder legt fest, ob Benutzer Abschnitte über die Benutzeroberfläche dem angegebenen Inhaltssteuerelement für wiederholte Abschnitte hinzufügen oder daraus entfernen können.
Appearance	Gibt die Darstellung des Inhaltssteuerelements zurück oder legt sie fest. Lese-/Schreibzugriff WdContentControlAppearance
Application	Gibt ein _Application Objekt zurück, das die Microsoft Word-Anwendung darstellt.
BuildingBlockCategory	Gibt die Kategorie für ein Bausteininhaltssteuerelement zurück oder legt sie fest. Lese-/Schreibzugriff.
BuildingBlockType	Gibt den Typ des Bausteins für ein Bausteininhaltssteuerelement zurück oder legt den Typ fest. Lese-/Schreibzugriff.
Checked	Ruft den aktuellen Zustand (aktiviert/deaktiviert) für ein Kontrollkästchen ab oder legt diese fest.
Color	Gibt die Farbe des Inhaltssteuerelements zurück oder legt sie fest. Lese-/Schreibzugriff WdColor.
Creator	Gibt eine 32-Bit-Ganzzahl zurück, die auf die Anwendung verweist, in der das Add-In erstellt wurde. Schreibgeschützt.
DateCalendarType	Gibt den Kalendertyp für ein Kalenderinhaltssteuerelement zurück oder legt den Typ fest. Lese-/Schreibzugriff.
DateDisplayFormat	Gibt das Format zurück, in dem Datumsangaben angezeigt werden, oder legt es fest. Lese-/Schreibzugriff.
DateDisplayLocale	Gibt das Sprachformat für das Datum zurück, das in einem Datumsinhaltssteuerelement angezeigt wird. Lese-/Schreibzugriff.
DateStorageFormat	Gibt das Format für das Speichern und Abrufen von Datumsangaben zurück, wenn ein Datumsinhaltssteuerelement an den XML-Datenspeicher des aktiven Dokuments gebunden ist, oder legt es fest. Lese-/Schreibzugriff.
DefaultTextStyle	Gibt den Namen der Zeichenformatvorlage zurück, die zum Formatieren von Text in einem Textinhaltssteuerelement verwendet werden soll, oder legt diesen fest. Lese-/Schreibzugriff.
DropdownListEntries	Gibt die Elemente in einem Dropdownlisten-Inhaltssteuerelement oder in einem Kombinationsfeld-Inhaltssteuerelement zurück. Schreibgeschützt.
ID	Gibt die Identifikation für ein Inhaltssteuerelement zurück. Schreibgeschützt.
Level	Gibt die Ebene des Inhaltssteuerelements zurück– unabhängig davon, ob das Inhaltssteuerelement Text, Absätze, Tabellenzellen oder Tabellenzeilen umgibt; oder , wenn es inline ist. Schreibgeschützt WdContentControlLevel.
LockContentControl	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob der Benutzer ein Inhaltssteuerelement aus dem aktiven Dokument löschen kann, oder legt diesen Wert fest. Lese-/Schreibzugriff.
LockContents	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob der Benutzer den Inhalt eines Inhaltssteuerelements bearbeiten kann, oder legt diesen Wert fest. Lese-/Schreibzugriff.
MultiLine	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob ein Text-Inhaltssteuerelement mehrere Textzeilen zulässt. Lese-/Schreibzugriff.
Parent	Gibt ein zurück, das das übergeordnete Objekt des angegebenen ContentControl Objekts darstellt.
ParentContentControl	Gibt das übergeordnete Inhaltssteuerelement für ein Inhaltssteuerelement zurück, das in einem Rich-Text-Steuerelement oder Gruppensteuerelement geschachtelt ist. Schreibgeschützt.
PlaceholderText	Gibt ein BuildingBlock -Objekt zurück, das den Platzhaltertext für ein Inhaltssteuerelement darstellt. Schreibgeschützt.
Range	Gibt einen Range zurück, der den Inhalt des Inhaltssteuerelements im aktiven Dokument darstellt. Schreibgeschützt.
RepeatingSectionItems	Gibt die Auflistung von wiederholten Abschnittselementen im angegebenen Steuerelement zum Wiederholen von Abschnittsinhalten zurück. Schreibgeschützt.
RepeatingSectionItemTitle	Gibt den Namen der wiederholten Abschnittselemente zurück, die im Kontextmenü verwendet werden, das dem angegebenen Inhaltssteuerelement für wiederholte Abschnitte zugeordnet ist, oder legt diesen fest. Lese-/Schreibzugriff.
ShowingPlaceholderText	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob der Platzhaltertext für das Inhaltssteuerelement angezeigt wird. Schreibgeschützt.
Tag	Gibt einen Wert zurück, um ein Inhaltssteuerelement zu identifizieren, oder legt diesen fest. Lese-/Schreibzugriff.
Temporary	Gibt einen Wert vom Typ Boolean zurück, der angibt, ob ein Inhaltssteuerelement aus dem aktiven Dokument entfernt wird, wenn der Benutzer den Inhalt des Steuerelements bearbeitet, oder legt diesen Wert fest. Lese-/Schreibzugriff.
Title	Gibt den Titel für ein Inhaltssteuerelement zurück oder legt den Titel fest. Lese-/Schreibzugriff.
Type	Gibt den Typ für ein Inhaltssteuerelement zurück oder legt den Typ fest. Lese-/Schreibzugriff.
XMLMapping	Gibt die Zuordnung eines Inhaltssteuerelements zu XML-Daten im Datenspeicher eines Dokuments zurück. Schreibgeschützt.

Methoden

Copy()	Kopiert das Inhaltssteuerelement aus dem aktiven Dokument in die Zwischenablage.
Cut()	Entfernt das Inhaltssteuerelement aus dem aktiven Dokument und verschiebt dieses in die Zwischenablage.
Delete(Boolean)	Löscht das angegebene Inhaltssteuerelement und die Inhalte des Steuerelements.
SetCheckedSymbol(Int32, String)	Legt das Symbol fest, mit dem der aktivierte Zustand eines Kontrollkästchen-Inhaltssteuerelements dargestellt wird.
SetPlaceholderText(BuildingBlock, Range, String)	Legt den Platzhaltertext fest, der im Inhaltssteuerelement angezeigt wird, bis ein Benutzer einen eigenen Text einfügt.
SetUncheckedSymbol(Int32, String)	Legt das Symbol fest, mit dem der deaktivierte Zustand eines Kontrollkästchen-Inhaltssteuerelements dargestellt wird.
Ungroup()	Entfernt ein Gruppeninhaltssteuerelement aus einem Dokument, sodass die untergeordneten Inhaltssteuerelemente nicht mehr geschachtelt sind und frei bearbeitet werden können.

Gilt für:

Freigeben über