Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

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

 

In Projekten auf Dokumentebene können Sie dem Dokument in Ihrem Projekt zur Entwurfs- oder Laufzeit Bookmark-Steuerelemente hinzufügen. In VSTO-Add-In-Projekten können Sie einem beliebigen geöffneten Dokument zur Laufzeit Bookmark-Steuerelemente hinzufügen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In diesem Thema werden die folgenden Aufgaben beschrieben:

Weitere Informationen zu Bookmark-Steuerelementen finden Sie unter Bookmark-Steuerelement.

Es gibt mehrere Möglichkeiten, wie Sie einem Dokument in einem Projekt auf Dokumentebene zur Entwurfszeit Bookmark-Steuerelemente hinzufügen können:

  • Die Toolbox von Visual Studio.

    Sie können das Bookmark-Steuerelement aus der Toolbox in Ihr Dokument ziehen. Möglicherweise entscheiden Sie sich für diese Möglichkeit, falls Sie die Toolbox bereits zum Hinzufügen von Windows Forms-Steuerelementen zu Ihrem Dokument verwenden.

  • In Word.

    Sie können Ihrem Dokument das Bookmark-Steuerelement auf die gleiche Weise wie das systemeigene Lesezeichen hinzufügen. Der Vorteil dieser Vorgehensweise besteht darin, dass Sie das Steuerelement bei der Erstellung benennen können.

  • Im Fenster Datenquellen.

    Sie können das Bookmark-Steuerelement vom Fenster Datenquellen auf Ihr Dokument ziehen. Dies ist hilfreich, wenn Sie das Steuerelement gleichzeitig an Daten binden möchten. Sie können das Hoststeuerelement auf die gleiche Weise hinzufügen wie das Windows Forms-Steuerelement aus dem Fenster Datenquellen. Weitere Informationen finden Sie unter Datenbindung und Windows Forms.

System_CAPS_noteHinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren von Visual Studio-IDE.

So fügen Sie einem Dokument ein Lesezeichen-Steuerelement aus der Toolbox hinzu

  1. Öffnen Sie die Toolbox, und klicken Sie auf die Registerkarte Word-Steuerelemente.

  2. Ziehen Sie ein Bookmark-Steuerelement auf das Dokument.

    Das Dialogfeld Lesezeichen hinzufügen wird angezeigt.

  3. Wählen Sie den Text oder andere Elemente aus, die Sie in das Lesezeichen einschließen möchten.

  4. Click

    Wenn Sie nicht den Standardnamen für das Lesezeichen beibehalten möchten, können Sie den Namen im Fenster Eigenschaften ändern.

So fügen Sie einem Dokument in Word ein Lesezeichen-Steuerelement hinzu

  1. Platzieren Sie den Cursor in dem Dokument, das im Visual Studio-Designer gehostet wird, an der Stelle, an der Sie das Lesezeichen hinzufügen möchten, oder wählen Sie den Text aus, der vom Lesezeichen eingeschlossen werden soll.

  2. Klicken Sie auf der Registerkarte Einfügen des Menübands in der Gruppe Links auf die Schaltfläche Lesezeichen.

  3. Geben Sie im Dialogfeld Lesezeichen den Namen des neuen Lesezeichens ein, und klicken Sie auf Hinzufügen.

Sie können einem Dokument zur Laufzeit Bookmark-Steuerelemente programmgesteuert hinzufügen, indem Sie die Methoden der Controls-Eigenschaft der ThisDocument-Klasse im Projekt verwenden. Es gibt zwei Methodenüberladungen, mit denen Sie ein Bookmark-Steuerelement auf die folgenden Weisen hinzufügen können:

Dynamisch erstellte Bookmark-Steuerelemente werden nicht dauerhaft im Dokument gespeichert, wenn das Dokument geschlossen ist. Ein systemeigenes Microsoft.Office.Interop.Word.Bookmark verbleibt jedoch im Dokument. Beim nächsten Öffnen des Dokuments können Sie ein auf einem systemeigenen Lesezeichen basierendes Bookmark neu erstellen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

So fügen Sie einem Dokument ein Lesezeichen-Steuerelement programmgesteuert hinzu

  1. Fügen Sie im ThisDocument_Startup-Ereignishandler Ihres Projekts den folgenden Code ein, um das Bookmark-Steuerelement dem ersten Absatz des Dokuments hinzuzufügen.

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
    firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "FirstParagraph");
    
    System_CAPS_noteHinweis

    Wenn Sie ein Microsoft.Office.Tools.Word.Bookmark-Steuerelement von einem vorhandenen Microsoft.Office.Interop.Word.Bookmark erstellen möchten, verwenden Sie die AddBookmark-Methode und übergeben das vorhandene Microsoft.Office.Interop.Word.Bookmark.

Sie können einem beliebigen geöffneten Dokument mithilfe eines VSTO-Add-Ins zur Laufzeit programmgesteuert Bookmark-Steuerelemente hinzufügen. Zu diesem Zweck generieren Sie ein Document-Hostelement, das auf einem geöffneten Dokument basiert, und verwenden dann die Methoden der Controls-Eigenschaft dieses Hostelements. Es gibt zwei Methodenüberladungen, mit denen Sie ein Bookmark-Steuerelement auf die folgenden Weisen hinzufügen können:

Dynamisch erstellte Bookmark-Steuerelemente werden nicht dauerhaft im Dokument gespeichert, wenn das Dokument geschlossen ist. Ein systemeigenes Microsoft.Office.Interop.Word.Bookmark verbleibt jedoch im Dokument. Beim nächsten Öffnen des Dokuments können Sie ein auf einem systemeigenen Lesezeichen basierendes Bookmark neu erstellen. Weitere Informationen finden Sie unter Beibehalten von dynamischen Steuerelementen in Office-Dokumenten.

Weitere Informationen zum Generieren von Hostelementen in VSTO-Add-In-Projekten finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.

So fügen Sie ein Lesezeichen-Steuerelement in einem angegebenen Bereich hinzu

  1. Verwenden Sie die ControlCollection.AddBookmark(Range, String)-Methode, und übergeben Sie den Range an der Stelle, an der Sie das Bookmark hinzufügen möchten.

    Im folgenden Codebeispiel wird ein neues Bookmark am Anfang des aktiven Dokuments hinzugefügt. Um dieses Beispiel zu verwenden, führen Sie den Code vom ThisAddIn_Startup-Ereignishandler in einem Word-VSTO-Add-In-Projekt aus.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
        extendedDocument.Paragraphs[1].Range, "FirstParagraph");
    

So fügen Sie ein Lesezeichen-Steuerelement hinzu, das auf einem systemeigenen Lesezeichen-Steuerelement basiert

  1. Verwenden Sie die ControlCollection.AddBookmark(Bookmark, String)-Methode, und übergeben Sie das vorhandene Microsoft.Office.Interop.Word.Bookmark, das Sie als Grundlage für das neue Bookmark verwenden möchten.

    Im folgenden Codebeispiel wird ein neues Bookmark basierend auf dem ersten Microsoft.Office.Interop.Word.Bookmark im aktiven Dokument erstellt. Um dieses Beispiel zu verwenden, führen Sie den Code vom ThisAddIn_Startup-Ereignishandler in einem Word-VSTO-Add-In-Projekt aus.

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
    {
        object index = 1;
        Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);
    
    
         Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
        Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
                firstBookmark, "VSTOBookmark");
    }
    
Anzeigen: