Freigeben über

Bookmark-Steuerelement

  • Artikel

Das Bookmark -Steuerelement ist eine Textmarke, die über einen eindeutigen Namen verfügt, Ereignisse verfügbar macht und an Daten gebunden werden kann. Die Textmarke kann als Platzhalter verwendet werden, um ein Element oder eine Position in einem Microsoft Office Word-Dokument zu markieren. Das Bookmark -Steuerelement ist eine Kombination aus einem Bookmark - und einem Range -Objekt.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In Projekten auf Dokumentebene können Sie dem Dokument Bookmark -Steuerelemente zur Entwurfszeit oder zur Laufzeit hinzufügen. In VSTO-Add-In-Projekten können Sie einem beliebigen geöffneten Dokument zur Laufzeit Bookmark -Steuerelemente hinzufügen. Weitere Informationen finden Sie unter How to: Add Bookmark controls to Word documents.

Binden von Daten an das Steuerelement

Ein Bookmark -Steuerelement unterstützt die einfache Datenbindung. Die Textmarke sollte mithilfe der DataBindings -Eigenschaft an eine Datenquelle gebunden werden. Die Standardeigenschaft für die Datenbindung der Textmarke ist die Text -Eigenschaft.

Wenn die Daten im gebundenen Dataset aktualisiert werden, zeigt das Bookmark Steuerelement die Änderungen an.

In Projekten auf Dokumentebene können Sie Daten auch an Textmarken binden, indem Sie das Fenster Datenquellen verwenden. Weitere Informationen finden Sie unter How to: Auffüllen von Dokumenten mit Daten aus Objekten.

Formatting

Die gesamte auf Bookmark anwendbare Formatierung kann auf ein Bookmark -Steuerelement angewendet werden. Diese Formatierung umfasst Schriftarten, Einzüge, Abstände, Nummerierung und Formatvorlagen.

Zuweisen von Text zur Textmarke

Ein weiterer Unterschied zwischen einem Microsoft.Office.Interop.Word.Bookmark -Objekt und einem Microsoft.Office.Tools.Word.Bookmark -Steuerelement ist das Verhalten beim Zuweisen von Text zur Textmarke. Wenn Sie Text zu einem Microsoft.Office.Interop.Word.Bookmarkmit der Länge 0 (null) zuweisen, wird der Text rechts neben der Textmarke angefügt und die Textmarke behält die Länge 0 (null). Wenn Sie jedoch Text zu einem Microsoft.Office.Tools.Word.Bookmarkmit der Länge 0 (null) zuweisen, wird der Text in die Textmarke eingefügt und die Länge der Textmarke um die Gesamtzahl der eingefügten Zeichen erweitert.

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

Text-Eigenschaft Beschreibung
Bookmark.Text Verwenden Sie diese Eigenschaft zum Anzeigen von Text in einer Textmarke, und belassen Sie die Textmarke im Dokument. Durch das Zuweisen von Text zur Textmarke wird der Textmarkenbereich erweitert und die Textmarke nicht gelöscht.

Bookmark1.Text = "Hello world" fügt z. B. den Text in die Textmarken ein, und die Textmarke bleibt intakt.
Range.Text Verwenden Sie diese Eigenschaft, um Text an der Position der Textmarke anzuzeigen und die Textmarke automatisch zu löschen. Bookmark1.Range.Text = "Hello world" fügt z. B. den Text in die Textmarke ein, und die Textmarke wird gelöscht.

Umbenennen des Steuerelements zur Entwurfszeit

Wenn Sie in Projekten auf Dokumentebene ein Bookmark -Steuerelement aus der Toolbox in Ihr Dokument ziehen, generiert Visual Studio automatisch einen Namen für das Steuerelement. Sie können den Namen des Steuerelemente im Fenster Eigenschaften ändern.

Überlappende Steuerelemente

Lesezeichensteuerelemente können sich gegenseitig überlappen. Derselbe Text kann von mehreren Textmarken geteilt werden. Wenn Sie einem der überlappenden Textmarken neuen Text zuweisen, enthält es nur den neuen Text, und die Textmarken überlappen sich nicht mehr. Die andere Textmarke enthält jetzt nur den Text, der nicht zwischen den ursprünglichen überlappenden Textmarken geteilt wurde.

Die folgende Tabelle zeigt, wie der Satz "Dies ist Beispieltext" von zwei überlappenden Textmarken geteilt wird:

Lesezeichen Text
Überlappende Textmarken [this is {sample] text.}
Bookmark1 This is sample
Bookmark2 sample text.

Wenn Sie den neuen Text "This is replacement" zu Bookmark1 zuweisen, überlappen sich die Lesezeichen nicht, und Bookmark2 behält nur den Text bei, der ursprünglich nicht Teil von Bookmark1 war.

Lesezeichen Text
Zwei separate Textmarken [this is replacement]{ text.}
Bookmark1 This is replacement
Bookmark2 Text

Wenn Sie den Text einer Textmarke ändern, die ein anderes Lesezeichen enthält, wird die innere Textmarke nicht gelöscht. Die innere Textmarke wird jedoch zu einer leeren Textmarke und wechselt zum Ende der äußeren Textmarke.

Die folgende Tabelle zeigt, wie der Satz "Dies ist Beispieltext" von einer Textmarke geteilt wird, die in einer anderen Textmarke enthalten ist:

Lesezeichen Text
Überlappende Textmarken [this is {sample} text.]
Bookmark1 This is sample text.
Bookmark2 Beispiel

Wenn Sie den neuen Text "This is replacement" zu Bookmark1 zuweisen, werden die Lesezeichen nicht mehr überlappend, und Bookmark2 wird zu einer leeren Textmarke, die sich am Ende von Bookmark1 befindet.

Lesezeichen Text
Zwei separate Textmarken [dies ist Ersetzung.]{}
Bookmark1 This is replacement.
Bookmark2 <empty>

Ereignisse

Die folgenden Ereignisse sind für das Bookmark -Steuerelement verfügbar:

Zugehöriger Inhalt