Bookmark-Steuerelement
Aktualisiert: Juli 2008
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekte auf Dokumentebene
Projekte auf Anwendungsebene
Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Das Bookmark-Steuerelement ist ein Lesezeichen, das über einen eindeutigen Namen verfügt, Ereignisse zur Verfügung stellt 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 Bookmark-Steuerelement ist eine Kombination aus einem Microsoft.Office.Interop.Word.Bookmark-Objekt und einem Microsoft.Office.Interop.Word.Range-Objekt. Beim Hinzufügen eines Lesezeichens zu einem Dokument erstellt Visual Studio Tools for Office ein Lesezeichenobjekt, das Sie direkt für die Programmierung verwenden können, ohne das Word-Objektmodell durchlaufen zu müssen.
In Projekten auf Dokumentebene können Sie dem Dokument Bookmark-Steuerelemente zur Entwurfszeit oder zur Laufzeit hinzufügen. Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie jedem beliebigen Dokument auch Bookmark-Steuerelemente zur Laufzeit mit einem Add-In auf Anwendungsebene für Word 2007 hinzufügen. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Bookmark-Steuerelementen zu Word-Dokumenten.
Binden von Daten an das Steuerelement
Das 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 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 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 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 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.
Zusätzlich fügt Visual Studio Tools for Office dem Bookmark-Steuerelement eine Bookmark.Text-Eigenschaft hinzu. Diese unterscheidet sich von der Range.Text-Eigenschaft, die von der Range des Lesezeichens zur Verfügung gestellt wird.
"Text"-Eigenschaft |
Beschreibung |
|---|---|
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. |
|
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 Bookmark-Steuerelement aus der Toolbox auf das Dokument ziehen, generiert Visual Studio Tools for Office 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.
Bookmark |
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 Lesezeichen2 behält nur den Text bei, der nicht ursprünglich Teil von Lesezeichen1 war.
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.
Bookmark |
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.
Bookmark |
Text |
|---|---|
Zwei separate Lesezeichen |
[Dies ist ein Ersatz.]{} |
Lesezeichen1 |
Dies ist ein Ersatz. |
Lesezeichen2 |
<empty> |
Ereignisse
Die folgenden Ereignisse sind für das Bookmark-Steuerelement verfügbar:
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen von Bookmark-Steuerelementen zu Word-Dokumenten
Exemplarische Vorgehensweise: Erstellen von Kontextmenüs für Lesezeichen
Konzepte
Binden von Daten an Steuerelemente
Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen
Weitere Ressourcen
Änderungsprotokoll
Date |
Versionsgeschichte |
Grund |
|---|---|---|
|
Juli 2008 |
Informationen über das Verwenden von Lesezeichen-Steuerelementen in Projekten auf Anwendungsebene hinzugefügt. |
SP1-Featureänderung. |