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 | |
---|---|---|
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. | |
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 der 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 den dem IComponent zugeordneten ISite ab oder legt diesen 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 für das 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. | |
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 verwendet wird, um den deaktivierten Zustand eines ContentControl darzustellen, der ein Kontrollkästchen-Steuerelement darstellt | |
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.
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
Gewusst wie: Hinzufügen von Inhaltssteuerelementen zu Word-Dokumenten
Gewusst wie: Schützen von Teilen von Dokumenten mithilfe von Inhaltssteuerelementen