ContentControl Schnittstelle

Definition

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

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 EigenschaftBuildingBlock Gallery-Inhaltssteuerelemente (wdContentControlBuildingBlockGallery)
BuildingBlockType EigenschaftBuildingBlock Gallery-Inhaltssteuerelemente (wdContentControlBuildingBlockGallery)
DateDisplayFormat EigenschaftDatumsinhaltssteuerelemente (wdContentControlDate)
DateDisplayLocale EigenschaftDatumsinhaltssteuerelemente (wdContentControlDate)
DateStorageFormat EigenschaftDatumsinhaltssteuerelemente (wdContentControlDate)
DropdownListEntries EigenschaftInhaltssteuerelemente für Kombinationsfeld und Dropdownliste (wdContentControlComboBox und wdContentControlDropdownList)
MultiLine EigenschaftNur-Text-Inhaltssteuerelemente (wdContentControlText)
Ungroup() MethodeGruppeninhaltssteuerelemente (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: