Bookmark-Steuerelement

Das Microsoft.Office.Tools.Word.Bookmark-Steuerelement ist ein Lesezeichen mit eindeutigem Namen, das Ereignisse verfügbar macht und an Daten gebunden werden kann. Das Lesezeichen kann als Platzhalter verwendet werden, um ein Element oder eine Position in einem Microsoft Office Word-Dokument zu markieren. Das Microsoft.Office.Tools.Word.Bookmark-Steuerelement ist eine Kombination aus einem Microsoft.Office.Interop.Word.Bookmark-Objekt und einem Microsoft.Office.Interop.Word.Range-Objekt.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In Projekten auf Dokumentebene können Sie dem Dokument Microsoft.Office.Tools.Word.Bookmark-Steuerelemente zur Entwurfszeit oder zur Laufzeit hinzufügen. In Projekten auf Anwendungsebene können Sie zur Laufzeit jedem geöffneten Dokument Microsoft.Office.Tools.Word.Bookmark-Steuerelemente hinzufügen. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Bookmark-Steuerelementen zu Word-Dokumenten.

Binden von Daten an das Steuerelement

Das Microsoft.Office.Tools.Word.Bookmark-Steuerelement unterstützt die einfache Datenbindung. Das Lesezeichen sollte unter Verwendung der DataBindings-Eigenschaft an eine Datenquelle gebunden werden. Die standardmäßige Datenbindungseigenschaft des Lesezeichens ist die Text-Eigenschaft.

Wenn die Daten im gebundenen Dataset aktualisiert werden, werden diese Änderungen vom Microsoft.Office.Tools.Word.Bookmark-Steuerelement nachvollzogen.

In Projekten auf Dokumentebene können Sie auch Daten mithilfe des Fensters Datenquellen an Lesezeichen binden. Weitere Informationen finden Sie unter Gewusst wie: Auffüllen von Dokumenten mit Daten von Objekten.

Formatierung

Die Formatierungen für das Microsoft.Office.Interop.Word.Bookmark können auch auf das Microsoft.Office.Tools.Word.Bookmark-Steuerelement angewendet werden. Dazu gehören Schriftarten, Einzüge, Abstände, Nummerierungen und Formate.

Zuweisen von Text zum Lesezeichen

Ein weiterer Unterschied zwischen einem Microsoft.Office.Interop.Word.Bookmark-Objekt und einem Microsoft.Office.Tools.Word.Bookmark-Steuerelement besteht in dem Verhalten beim Zuweisen von Text zum Lesezeichen. Wenn Sie einem Microsoft.Office.Interop.Word.Bookmark der Länge 0 einen Text zuweisen, wird der Text rechts vom Lesezeichen eingefügt, und das Lesezeichen behält die Länge 0 bei. Wenn Sie jedoch einem Microsoft.Office.Tools.Word.Bookmark der Länge 0 einen Text zuweisen, wird der Text in das Lesezeichen eingefügt, und die Länge des Lesezeichens erhöht sich auf die Anzahl der insgesamt eingefügten Zeichen.

Das Microsoft.Office.Tools.Word.Bookmark-Steuerelement verfügt auch über die Bookmark.Text-Eigenschaft. Dies unterscheidet sich von der Range.Text-Eigenschaft, die auf der Range-Eigenschaft eines Microsoft.Office.Tools.Word.Bookmark-Steuerelements oder der Range-Eigenschaft eines Microsoft.Office.Interop.Word.Bookmark-Objekts verfügbar ist.

"Text"-Eigenschaft	Beschreibung
Bookmark.Text	Mithilfe dieser Eigenschaft können Sie den Text innerhalb eines Lesezeichens anzeigen. Das Lesezeichen verbleibt dabei im Dokument. Beim Zuweisen von Text zum Lesezeichen wird der Lesezeichenbereich erweitert. Das Lesezeichen wird nicht gelöscht. So fügt zum Beispiel Bookmark1.Text = "Hello world" den Text in das Lesezeichen ein und belässt das Lesezeichen in funktionsfähigem Zustand.
Range.Text	Mithilfe dieser Eigenschaft können Sie Text an der Position des Lesezeichens anzeigen und das Lesezeichen automatisch löschen. So fügt zum Beispiel Bookmark1.Range.Text = "Hello world" den Text in das Lesezeichen ein und löscht das Lesezeichen.

Umbenennen des Steuerelements zur Entwurfszeit

Wenn Sie in Projekten auf Dokumentebene ein Microsoft.Office.Tools.Word.Bookmark-Steuerelement aus der Toolbox auf das Dokument ziehen, generiert Visual Studio automatisch einen Namen für das Steuerelement. Sie können den Namen des Steuerelements im Eigenschaftenfenster ändern.

Überlappende Steuerelemente

Bookmark-Steuerelemente können einander überlappen, d. h. derselbe Text kann in mehr als einem Lesezeichen enthalten sein. Wenn Sie einem der überlappenden Lesezeichen neuen Text zuweisen, enthält dieses Lesezeichen nur noch den neuen Text, und es gibt keine Überlappung mehr. Das andere Lesezeichen enthält dann nur noch den Teil des ursprünglichen Textes, der nicht zur Überlappung gehörte.

Die folgende Tabelle zeigt, wie der Satz "Dies ist ein Beispieltext." auf zwei überlappende Lesezeichen verteilt wird.

Lesezeichen	Text
Überlappende Lesezeichen	[Dies ist ein {Beispiel]text.}
Lesezeichen1	Dies ist ein Beispiel
Lesezeichen2	Beispieltext.

Wenn Sie Lesezeichen1 den neuen Text "Dies ist ein Ersatz" zuweisen, überlappen sich die Lesezeichen nicht mehr, und in Lesezeichen2 wird nur den Text beibehalten, der ursprünglich nicht zu Lesezeichen1 gehörte.

Bookmark	Text
Zwei separate Lesezeichen	[Dies ist ein Ersatz]{text.}
Lesezeichen1	Dies ist ein Ersatz
Lesezeichen2	text.

Wenn ein Lesezeichen vollständig in einem anderen Lesezeichen enthalten ist und Sie den Text des äußeren Lesezeichens ändern, wird das innere Lesezeichen dadurch nicht gelöscht. Das innere Lesezeichen wird jedoch zu einem leeren Lesezeichen, das an das Ende des äußeren Lesezeichens verschoben wird. Die folgende Tabelle zeigt, wie der Satz "Dies ist ein Beispieltext." auf ein Lesezeichen verteilt wird, das in einem anderen Lesezeichen enthalten ist.

Lesezeichen	Text
Überlappende Lesezeichen	[Dies ist ein {Beispiel}text.]
Lesezeichen1	Dies ist ein Beispieltext.
Lesezeichen2	Beispiel

Wenn Sie Lesezeichen1 den neuen Text "Dies ist ein Ersatz." zuweisen, überlappen sich die Lesezeichen nicht mehr, und Lesezeichen2 wird zu einem leeren Lesezeichen, das sich am Ende von Lesezeichen1 befindet.

Lesezeichen	Text
Zwei separate Lesezeichen	[Dies ist ein Ersatz.]{}
Lesezeichen1	Dies ist ein Ersatz.
Lesezeichen2	<empty>

Ereignisse

Die folgenden Ereignisse sind für das Microsoft.Office.Tools.Word.Bookmark-Steuerelement verfügbar:

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Deselected

• Disposed

• Selected

• SelectionChange

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Bookmark-Steuerelementen zu Word-Dokumenten

Exemplarische Vorgehensweise: Erstellen von Kontextmenüs für Lesezeichen

Konzepte

Automatisieren von Word mithilfe von erweiterten Objekten

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Weitere Ressourcen

Binden von Daten an Steuerelemente in Office-Projektmappen