Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Bookmark Steuerelement ist eine Textmarke mit einem eindeutigen Namen, macht Ereignisse verfügbar und kann an Daten gebunden werden. 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 Objekt 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 Funktionen verfügbar nach Office-Anwendung und Projekttyp.
In Projekten auf Dokumentebene können Sie Bookmark Steuerelemente zur Entwurfszeit oder zur Laufzeit zu Ihrem Dokument hinzufügen. In VSTO-Add-In-Projekten können Sie jedem geöffneten Dokument zur Laufzeit Steuerelemente hinzufügen Bookmark . Weitere Informationen finden Sie unter How to: Add Bookmark controls to Word documents.
Binden von Daten an das Steuerelement
Ein Bookmark Steuerelement unterstützt einfache Datenbindung. Die Textmarke sollte mithilfe der DataBindings Eigenschaft an eine Datenquelle gebunden werden. Die standardmäßige Datenbindungseigenschaft 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 auch Daten an Lesezeichen binden, indem Sie das Fenster "Datenquellen " verwenden. Weitere Informationen finden Sie unter How to: Auffüllen von Dokumenten mit Daten aus Objekten.
Formatierung
Formatierungen, die auf ein Bookmark-Steuerelement angewendet werden können, können auch auf ein Bookmark-Steuerelement angewendet werden. Diese Formatierung umfasst Schriftarten, Einzüge, Abstände, Nummerierung und Formatvorlagen.
Zuweisen von Text zur Textmarke
Ein zusätzlicher Unterschied zwischen einem Microsoft.Office.Interop.Word.Bookmark Objekt und einem Microsoft.Office.Tools.Word.Bookmark Steuerelement besteht darin, wie sich das Objekt verhält, wenn ein Text der Textmarke zugewiesen wird. Wenn Sie Text einer Länge Microsoft.Office.Interop.Word.Bookmarknull zuweisen, wird der Text rechts neben der Textmarke angefügt, und die Textmarke bleibt leer. Wenn Sie jedoch Text einer Länge Microsoft.Office.Tools.Word.Bookmarknull zuweisen, wird der Text in die Textmarke eingefügt, und die Länge der Textmarke wird auf die Gesamtanzahl 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 | Description |
|---|---|
| Bookmark.Text | Verwenden Sie diese Eigenschaft, um Text innerhalb der Textmarke anzuzeigen und die Textmarke im Dokument zu belassen. Durch das Zuweisen von Text zur Textmarke wird der Textmarkenbereich erweitert und die Textmarke nicht gelöscht. Zum Beispiel fügt Bookmark1.Text = "Hello world" den Text in die Textmarke ein und lässt die Textmarke unverändert. |
| Range.Text | Verwenden Sie diese Eigenschaft, um Text an der Textmarke-Position anzuzeigen und die Textmarke automatisch zu löschen. Fügt beispielsweise Bookmark1.Range.Text = "Hello world" den Text in die Textmarke ein und löscht die Textmarke. |
Umbenennen des Steuerelements während der Entwurfsphase
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 Steuerelements im Eigenschaftenfenster ä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 | [Dies ist {Sample]-Text.} |
| Lesezeichen1 | Dies ist Beispiel |
| Bookmark2 | Beispieltext. |
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 Lesezeichen | [dies ist Ersatz]{ text.} |
| Lesezeichen1 | Dies ist der Ersatz. |
| 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 | [Dies ist {sample}-Text.] |
| Lesezeichen1 | Dies ist Beispieltext. |
| Bookmark2 | Beispiel |
Wenn Sie den neuen Text "Dies ist die Ersetzung." 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 Lesezeichen | [dies ist Ersetzung.]{} |
| Lesezeichen1 | Dies ist der Ersatz. |
| Bookmark2 | <leer> |
Ereignisse
Die folgenden Ereignisse sind für das Bookmark Steuerelement verfügbar: