Freigeben über

Inhaltssteuerelemente

Inhaltssteuerelemente bieten eine Möglichkeit zum Entwerfen von Dokumenten und Vorlagen mit den folgenden Features:

Informationen zu Inhaltssteuerelementen

Inhaltssteuerelemente bieten eine Benutzeroberfläche, die sowohl für die Benutzereingabe als auch für den Druck optimiert ist. Wenn Sie einem Dokument ein Inhaltssteuerelement hinzufügen, wird das Steuerelement durch einen Rahmen, einen Titel und temporären Text identifiziert, der dem Benutzer Anweisungen bereitstellen kann. Der Rahmen und der Titel des Steuerelements werden in gedruckten Versionen des Dokuments nicht angezeigt.

Wenn der Benutzer beispielsweise ein Datum in einen Abschnitt Ihres Dokuments eingeben soll, können Sie dem Dokument ein Inhaltssteuerelement für die Datumsauswahl hinzufügen. Wenn Benutzer auf das Steuerelement klicken, wird die Standardmäßige Benutzeroberfläche für die Datumsauswahl angezeigt. Sie können auch Eigenschaften des Steuerelements festlegen, um den angezeigten regionalen Kalender festzulegen und das Datumsformat anzugeben. Nachdem der Benutzer ein Datum ausgewählt hat, wird die Benutzeroberfläche des Steuerelements ausgeblendet, und nur das Datum wird angezeigt, wenn der Benutzer das Dokument druckt.

Inhaltssteuerelemente unterstützen Sie außerdem bei den folgenden Aufgaben:

  • Verhindern, dass Benutzer Teile eines Dokuments bearbeiten oder löschen. Dies ist nützlich, wenn Sie Informationen in einem Dokument oder einer Vorlage haben, die Benutzer lesen, aber nicht bearbeiten können sollen, oder wenn Sie möchten, dass Benutzer Inhaltssteuerelemente bearbeiten, aber nicht löschen können.

  • Binden sie Teile eines Dokuments oder einer Vorlage an Daten. Sie können Inhaltssteuerelemente an Datenbankfelder, verwaltete Objekte im .NET Framework, XML-Elemente binden, die im Dokument gespeichert sind, und andere Datenquellen.

    In Projekten auf Dokumentebene können Sie Ihrem Dokument Inhaltssteuerelemente zur Entwurfszeit oder zur Laufzeit einfügen. In VSTO-Add-In-Projekten können Sie Inhaltssteuerelemente zu jedem geöffneten Dokument zur Laufzeit hinzufügen. Weitere Informationen finden Sie unter How to: Add content controls to Word documents.

Hinweis

Sie können Inhaltssteuerelemente nur in Dokumenten verwenden, die im Open XML-Format gespeichert sind. Inhaltssteuerelemente können nicht in Dokumenten verwendet werden, die im Word 97-2003-Dokumentformat (.doc) gespeichert sind.

Typen von Inhaltssteuerelementen

Es gibt neun verschiedene Arten von Inhaltssteuerelementen, die Sie Dokumenten hinzufügen können. Die meisten Inhaltssteuerelemente weisen einen entsprechenden Typ im Microsoft.Office.Tools.Word Namespace auf. Sie können auch ein generisches ContentControl Steuerelement verwenden, das eines der verfügbaren Inhaltssteuerelemente darstellen kann. Eine exemplarische Vorgehensweise, die die Verwendung der einzelnen verfügbaren Inhaltssteuerelemente veranschaulicht, finden Sie unter Walkthrough: Create a template by using content controls.

Mit einem Bausteinkatalog können Benutzer aus einer Liste von Dokumentbausteinen auswählen, die in ein Dokument eingefügt werden sollen. Ein Dokumentbaustein ist ein Teil des Inhalts, der mehrmals verwendet werden kann, z. B. ein gemeinsames Deckblatt, eine formatierte Tabelle oder eine Kopfzeile. Weitere Informationen finden Sie im BuildingBlockGalleryContentControl-Typ. Weitere Informationen zu Bausteinen finden Sie unter What's new for developers in Word 2007.

Kontrollk.

Ein Kontrollkästchen stellt eine Benutzeroberfläche bereit, die einen binären Zustand darstellt: ausgewählt oder deaktiviert.

Im Gegensatz zu den anderen Inhaltssteuerelementtypen stellt die Visual Studio-Tools für Office-Laufzeit keinen bestimmten Typ bereit, der ein Kontrollkästchen-Inhaltssteuerelement darstellt. Mit anderen Worten, es gibt keinen CheckBoxContentControl Typ. Sie können jedoch weiterhin ein Kontrollkästchen-Inhaltssteuerelement erstellen, indem Sie einem Dokument programmgesteuert ein generisches ContentControl Steuerelement hinzufügen. Weitere Informationen finden Sie unter Kontrollkästchen-Inhaltssteuerelemente in Word-Projekten.

Kombinationsfeld

Ein Kombinationsfeld zeigt eine Liste von Elementen an, die Benutzer auswählen können. Im Gegensatz zu einer Dropdownliste ermöglicht das Kombinationsfeld Benutzern das Hinzufügen eigener Elemente. Weitere Informationen finden Sie im ComboBoxContentControl-Typ.

Datumswähler

Eine Datumswahl bietet eine Kalenderansicht zum Auswählen eines Datums. Der Kalender wird angezeigt, wenn der Endbenutzer auf den Dropdownpfeil im Steuerelement klickt. Sie können regionale Kalender und verschiedene Datumsformate verwenden. Weitere Informationen finden Sie im DatePickerContentControl Datentyp.

In einer Dropdownliste wird eine Liste mit Elementen angezeigt, die Benutzer auswählen können. Im Gegensatz zu einem Kombinationsfeld ermöglicht die Dropdownliste benutzern nicht das Hinzufügen oder Bearbeiten von Elementen. Weitere Informationen finden Sie unter dem Typ DropDownListContentControl.

Gruppe

Ein Gruppensteuerelement definiert einen geschützten Bereich eines Dokuments, den Benutzer nicht bearbeiten oder löschen können. Ein Gruppensteuerelement kann beliebige Dokumentelemente enthalten, z. B. Text, Tabellen, Grafiken und andere Inhaltssteuerelemente. Weitere Informationen finden Sie im GroupContentControl Typ.

Bild

Ein Bildsteuerelement zeigt ein Bild an. Sie können das Bild zur Entwurfszeit oder Laufzeit angeben, oder Benutzer können auf dieses Steuerelement klicken, um ein Bild auszuwählen, das in das Dokument eingefügt werden soll. Weitere Informationen finden Sie zur PictureContentControl Typdefinition.

Rich-Text

Ein Rich-Text-Steuerelement enthält Text oder andere Elemente wie Tabellen, Bilder oder andere Inhaltssteuerelemente. Weitere Informationen finden Sie im RichTextContentControl-Typ.

Nur-Text

Ein einfaches Text-Steuerelement enthält Text. Ein Nur-Text-Steuerelement kann keine anderen Elemente enthalten, z. B. Tabellen, Bilder oder andere Inhaltssteuerelemente. Darüber hinaus weist der gesamte Text in einem Nur-Text-Steuerelement dieselbe Formatierung auf. Wenn Sie beispielsweise ein Wort eines Satzes kursiv formatieren, der sich in einem Nur-Text-Steuerelement befindet, wird der gesamte Text innerhalb des Steuerelements kursiv formatiert. Weitere Informationen finden Sie im PlainTextContentControl-Typ.

Generisches Inhaltskontrollelement

Ein generisches Inhaltssteuerelement ist ein ContentControl Objekt, das alle verfügbaren Arten von Inhaltssteuerelementen darstellen kann. Sie können ein ContentControl Objekt so ändern, dass es sich wie ein anderer Inhaltssteuerelementtyp verhält, indem Sie die Type Eigenschaft verwenden. Wenn Sie beispielsweise ein ContentControl Objekt erstellen, das ein Nur-Text-Steuerelement darstellt, können Sie es zur Laufzeit so ändern, dass es sich wie ein Kombinationsfeld verhält.

Sie können ContentControl Objekte nur zur Laufzeit erstellen, nicht zur Entwurfszeit. Weitere Informationen finden Sie unter How to: Add content controls to Word documents.

Allgemeine Features von Inhaltssteuerelementen

Die meisten Inhaltssteuerelemente teilen eine Gruppe von Mitgliedern, die Sie zum Ausführen allgemeiner Aufgaben verwenden können. In der folgenden Tabelle werden einige der Aufgaben beschrieben, die Sie mithilfe dieser Mitglieder ausführen können.

Für diesen Vorgang: Gehen Sie wie folgt vor:
Dient zum Abrufen oder Festlegen des Texts, der im Steuerelement angezeigt wird. Verwenden Sie die Text-Eigenschaft . Anmerkung: Die Typen PictureContentControl und ContentControl haben diese Eigenschaft nicht.
Dient zum Abrufen oder Festlegen des temporären Texts, der im Steuerelement angezeigt wird, bis ein Benutzer das Steuerelement bearbeitet, das Steuerelement mit Daten aus einer Datenquelle aufgefüllt wird oder der Inhalt des Steuerelements gelöscht wird. Verwenden Sie die PlaceholderText-Eigenschaft . Anmerkung: Der PictureContentControl Typ besitzt diese Eigenschaft nicht.
Dient zum Abrufen oder Festlegen des Titels, der im Rahmen des Inhaltssteuerelements angezeigt wird, wenn der Benutzer darauf klickt. Verwenden Sie die Title-Eigenschaft .
Entfernen Sie das Steuerelement automatisch aus dem Dokument, nachdem der Benutzer das Steuerelement bearbeitet hat. (Der Text im Steuerelement verbleibt im Dokument.) Verwenden Sie die temporäre Eigenschaft.
Führen Sie Code aus, wenn der Benutzer im Inhaltssteuerelement klickt oder wenn der Cursor programmgesteuert in das Inhaltssteuerelement verschoben wird. Behandeln Sie das Entering Ereignis des Steuerelements.
Führen Sie Code aus, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder wenn der Cursor programmgesteuert außerhalb des Inhaltssteuerelements verschoben wird. Behandeln Sie das Exiting Ereignis des Steuerelements.
Führen Sie Code aus, nachdem das Inhaltssteuerelement dem Dokument als Ergebnis eines Redo- oder Rückgängig-Vorgangs hinzugefügt wurde. Behandeln Sie das Added Ereignis des Steuerelements.
Führen Sie Code direkt vor dem Löschen des Inhaltssteuerelements aus dem Dokument aus. Behandeln Sie das Deleting Ereignis des Steuerelements.

Schützen von Teilen von Dokumenten mithilfe von Inhaltssteuerelementen

Wenn Sie einen Teil eines Dokuments schützen, verhindern Sie, dass Benutzer den Inhalt in diesem Teil des Dokuments ändern oder löschen. Es gibt verschiedene Möglichkeiten, Teile eines Dokuments mithilfe von Inhaltssteuerelementen zu schützen.

Wenn sich der zu schützende Bereich in einem Inhaltssteuerelement befindet, können Sie eigenschaften des Inhaltssteuerelements verwenden, um zu verhindern, dass Benutzer das Steuerelement bearbeiten oder löschen:

  • Die LockContents-Eigenschaft verhindert, dass Benutzer den Inhalt bearbeiten.

  • Die LockContentControl-Eigenschaft verhindert, dass Benutzer das Steuerelement löschen.

    Wenn sich der Bereich, den Sie schützen möchten, nicht innerhalb eines Inhaltssteuerelements befindet oder wenn Sie einen Bereich schützen möchten, der Inhaltssteuerelemente und andere Inhaltstypen enthält, können Sie den gesamten Bereich in einen GroupContentControl. Im Gegensatz zu anderen Inhaltssteuerelementen wird bei einem GroupContentControl keine Benutzeroberfläche angezeigt, die für den Benutzer sichtbar ist. Der einzige Zweck besteht darin, eine Region zu definieren, die Benutzer nicht bearbeiten können.

Hinweis

Wenn Sie ein GroupContentControl Steuerelement erstellen, das eingebettete Inhaltssteuerelemente enthält, werden die eingebetteten Inhaltssteuerelemente nicht automatisch geschützt. Sie müssen die LockContents-Eigenschaft jedes eingebetteten Steuerelements verwenden, um zu verhindern, dass Benutzer ihre Inhalte bearbeiten.

Weitere Informationen zum Verwenden von Inhaltssteuerelementen zum Schützen von Teilen von Dokumenten finden Sie unter How to: Protect parts of documents by using content controls.

Binden von Daten an Inhaltssteuerelemente

Sie können Daten in Dokumenten anzeigen, indem Sie ein Inhaltssteuerelement an eine Datenquelle binden. Wenn die Datenquelle aktualisiert wird, spiegelt das Inhaltssteuerelement die Änderungen wider. Sie können Änderungen auch wieder in der Datenquelle speichern.

Inhaltssteuerelemente stellen folgende Optionen für die Datenbindung bereit:

  • Sie können Inhaltssteuerelemente an Datenbankfelder oder verwaltete Objekte binden, indem Sie dasselbe Datenbindungsmodell wie Windows Forms verwenden.

  • Sie können Inhaltssteuerelemente an Elemente in XML-Elementen (auch als benutzerdefinierte XML-Komponenten bezeichnet) binden, die in das Dokument eingebettet sind.

    Eine Übersicht über das Binden von Hoststeuerelementen in Office-Lösungen an Daten finden Sie unter Binden von Daten an Steuerelemente in Office-Lösungen.

Verwenden des Windows Forms-Datenbindungsmodells

Die meisten Inhaltssteuerelemente unterstützen das einfache Datenbindungsmodell, das Von Windows Forms verwendet wird. Einfache Datenbindung bedeutet, dass ein Steuerelement an ein einzelnes Datenelement gebunden ist, z. B. einen Wert in einer Spalte einer Datentabelle. Weitere Informationen finden Sie unter Datenbindung und Windows Forms.

In Projekten auf Dokumentebene können Sie Daten mithilfe des Fensters " Datenquellen " in Visual Studio an Inhaltssteuerelemente binden. Weitere Informationen zum Hinzufügen von datengebundenen Inhaltssteuerelementen zu Dokumenten finden Sie unter How to: Populate documents with data from a database and How to: Populate documents with data from objects.

In der folgenden Tabelle sind die Inhaltssteuerelemente aufgeführt, die Sie im Fenster " Datenquellen " an jeden Datentyp binden können.

Datentyp Standardinhaltssteuerelement Andere Inhaltssteuerelemente, die an diesen Datentyp gebunden werden können
Boolean

Byte

Char

Double

Enum

Guid

Int16

Int32

Int64

SByte

Single

String

TimeSpan

UInt16

UInt32

UInt64		 PlainTextContentControl BuildingBlockGalleryContentControl

ComboBoxContentControl

DatePickerContentControl

RichTextContentControl
DateTime DatePickerContentControl BuildingBlockGalleryContentControl

ComboBoxContentControl

PlainTextContentControl

RichTextContentControl
Image

Byte Array		 PictureContentControl Nichts

In Projekten auf Dokumentebene und VSTO-Add-In können Sie ein Inhaltssteuerelement programmgesteuert an eine Datenquelle binden, indem Sie die Add Methode der DataBindings Eigenschaft des Steuerelements verwenden. Wenn Sie dies tun, übergeben Sie den Zeichenfolgentext an den PropertyName-Parameter der Add Methode. Die Text-Eigenschaft ist die Standarddatenbindungseigenschaft von Inhaltssteuerelementen.

Inhaltssteuerelemente unterstützen auch die bidirektionale Datenbindung, bei der Änderungen innerhalb des Steuerelements in die Datenquelle übernommen werden. Weitere Informationen finden Sie unter Anleitung: Aktualisieren einer Datenquelle mit Daten von einem Host-Steuerelement.

Hinweis

Inhaltssteuerelemente unterstützen keine komplexe Datenbindung. Wenn Sie ein DropDownListContentControl oder ComboBoxContentControl an eine Datenquelle mithilfe des Windows Forms-Datenmodells binden, sehen Benutzer nur einen Wert, wenn sie auf das Steuerelement klicken. Wenn Sie diese Steuerelemente an eine Gruppe von Datenwerten binden möchten, aus denen Benutzer auswählen können, können Sie diese Steuerelemente an Elemente in einer benutzerdefinierten XML-Komponente binden.

Binden von Inhaltssteuerelementen an benutzerdefinierte XML-Komponenten

Sie können einige Inhaltssteuerelemente an Elemente in benutzerdefinierten XML-Komponenten binden, die in das Dokument eingebettet sind. Weitere Informationen zu benutzerdefinierten XML-Komponenten finden Sie in der Übersicht über benutzerdefinierte XML-Komponenten.

Verwenden Sie die XMLMapping-Eigenschaft des Steuerelements, um ein Inhaltssteuerelement an ein Element in einer benutzerdefinierten XML-Komponente zu binden. Im folgenden Codebeispiel wird veranschaulicht, wie ein PlainTextContentControl An das Price Element unter dem Product Knoten in einer benutzerdefinierten XML-Komponente gebunden wird, die dem Dokument bereits hinzugefügt wurde.

plainTextContentControl1.XMLMapping.SetMapping("/Product/Price", String.Empty, null);

Eine exemplarische Vorgehensweise, die veranschaulicht, wie Inhaltssteuerelemente an benutzerdefinierte XML-Komponenten ausführlicher gebunden werden, finden Sie unter Walkthrough: Bind content controls to custom XML parts.

Wenn Sie ein Inhaltssteuerelement an eine benutzerdefinierte XML-Komponente binden, wird die bidirektionale Datenbindung automatisch aktiviert. Wenn ein Benutzer Text im Steuerelement bearbeitet, werden die entsprechenden XML-Elemente automatisch aktualisiert. Ähnlich, wenn Elementwerte in den benutzerdefinierten XML-Teilen geändert werden, zeigen die an die XML-Elemente gebundenen Inhaltssteuerelemente die neuen Daten an.

Sie können die folgenden Arten von Inhaltssteuerelementen an benutzerdefinierte XML-Komponenten binden:

Datenbindungsereignisse für Inhaltssteuerelemente

Alle Inhaltssteuerelemente stellen eine Reihe von Ereignissen bereit, mit denen Sie datenbezogene Aufgaben ausführen können, z. B. die Überprüfung, dass der Text in einem Steuerelement bestimmte Kriterien erfüllt, bevor die Datenquelle aktualisiert wird. In der folgenden Tabelle sind die Inhaltskontrollereignisse aufgeführt, die mit der Datenbindung zusammenhängen.

Aufgabe Event
Führen Sie Code direkt vor der automatischen Aktualisierung des Textes in einem Inhaltssteuerelement aus, das an eine benutzerdefinierte XML-Komponente gebunden ist. ContentUpdating
Führen Sie Code direkt aus, bevor Word Daten in einem benutzerdefinierten XML-Teil automatisch aktualisiert, der an ein Inhaltssteuerelement gebunden ist (d. h. nachdem sich der Text im Inhaltssteuerelement geändert hat). StoreUpdating
Führen Sie Ihren eigenen Code aus, um den Inhalt des Steuerelements gemäß benutzerdefinierten Kriterien zu überprüfen. Validating
Führen Sie Code aus, nachdem der Inhalt des Steuerelements erfolgreich überprüft wurde. Validated

Einschränkungen von Inhaltskontrollen

Wenn Sie Inhaltssteuerelemente in Ihren Office-Projekten verwenden, beachten Sie die folgenden Einschränkungen.

Verhaltensunterschiede zwischen Entwurfszeit und Laufzeit

Viele der Einschränkungen, die Microsoft Office Word zur Laufzeit auf Inhaltssteuerelemente aufzwingt, werden während der Entwurfszeit nicht strikt angewendet. Achten Sie beim Entwerfen der Benutzeroberfläche einer Dokumentlösung in Visual Studio darauf, Inhaltssteuerelemente nur auf die Arten zu modifizieren, die zur Laufzeit unterstützt werden.

Wenn Sie ein Inhaltssteuerelement zur Entwurfszeit so ändern, dass das Steuerelement zur Laufzeit nicht unterstützt wird, benachrichtigt der Visual Studio-Designer Sie nicht über die nicht unterstützten Änderungen. Wenn Sie das Projekt jedoch debuggen oder ausführen oder wenn Sie das Projekt speichern und dann erneut öffnen, zeigt Word eine Fehlermeldung an und fordert die Berechtigung zum Reparieren des Dokuments an. Wenn Sie das Dokument reparieren, entfernt Word alle nicht unterstützten Inhalte und Formatierungen aus dem Steuerelement.

Word verhindert beispielsweise nicht, dass Sie einer Tabelle im Entwurfsmodus ein PlainTextContentControl hinzufügen. Da PlainTextContentControl Objekte jedoch zur Laufzeit keine Tabellen enthalten können, zeigt Word beim Öffnen des Dokuments eine Fehlermeldung an.

Beachten Sie außerdem, dass viele Eigenschaften, die das Verhalten von Inhaltssteuerelementen definieren, zur Entwurfszeit keine Auswirkungen haben. Wenn Sie beispielsweise die LockContents-Eigenschaft eines Inhaltssteuerelements zur Entwurfszeit auf "True " festlegen, können Sie text im Visual Studio-Designer weiterhin bearbeiten. Diese Eigenschaft verhindert nur, dass Benutzer das Steuerelement zur Laufzeit bearbeiten.

Ereignisbeschränkungen

Inhaltssteuerelemente stellen kein Ereignis bereit, das ausgelöst wird, wenn der Benutzer Text oder andere Elemente im Steuerelement ändert. Es gibt z. B. kein Ereignis, das ausgelöst wird, wenn ein Benutzer ein anderes Element in einem DropDownListContentControl oder ComboBoxContentControl auswählt.

Um zu bestimmen, wann ein Benutzer den Inhalt eines Inhaltssteuerelements bearbeitet, können Sie das Steuerelement an eine benutzerdefinierte XML-Komponente binden und dann das StoreUpdating Ereignis behandeln. Dieses Ereignis wird ausgelöst, wenn der Benutzer den Inhalt eines Steuerelements ändert, das an eine benutzerdefinierte XML-Komponente gebunden ist. Eine exemplarische Vorgehensweise, die veranschaulicht, wie ein Inhaltssteuerelement an eine benutzerdefinierte XML-Komponente gebunden wird, finden Sie unter Walkthrough: Bind content controls to custom XML parts.

Kontrollkästchen-Inhaltssteuerelemente in Word-Projekten

Word 2010 hat einen neuen Inhaltssteuerelementtyp eingeführt, der ein Kontrollkästchen darstellt. Die Visual Studio Tools für Office-Laufzeit stellt jedoch keinen entsprechenden CheckBoxContentControl-Typ bereit, den Sie in Office-Projekten verwenden können. Verwenden Sie zum Erstellen eines Kontrollkästchen-Inhaltssteuerelements in einem Word 2013- oder Word 2010-Projekt die AddContentControl Methode zum Erstellen eines ContentControl Objekts, und übergeben Sie den wdContentControlCheckBox Wert an die Methode, um ein Kontrollkästchen-Inhaltssteuerelement anzugeben. Im folgenden Codebeispiel wird dies veranschaulicht.

this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
Microsoft.Office.Tools.Word.ContentControl checkBoxControl1 = 
    this.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox);

checkBoxControl1.Checked = true;

Verwandte Inhalte

  • Last updated on