Freigeben über


Hinzufügen von Textmarkensteuerelementen 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.

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 diesem Thema werden die folgenden Aufgaben beschrieben:

Hinzufügen von Lesezeichensteuerelementen zur Entwurfszeit

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

  • Die Toolboxvon 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.

    Hinweis

    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 der 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. Klicken Sie auf OK.

    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 im Dokument, das im Visual Studio-Designer gehostet wird, den Cursor an der Stelle, an der Sie die Textmarke hinzufügen möchten, oder markieren Sie den Text, den die Textmarke einschließen 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.

Hinzufügen von Lesezeichensteuerelementen zur Laufzeit in einem Projekt auf Dokumentebene

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:

  • Fügen Sie ein Bookmark in einem angegebenen Bereich hinzu.

  • Fügen Sie ein Bookmark hinzu, das auf einem systemeigenen Lesezeichen im Dokument basiert (d. h. ein Bookmark).

    Dynamisch erstellte Bookmark -Steuerelemente werden nicht dauerhaft im Dokument gespeichert, wenn das Dokument geschlossen ist. Ein systemeigenes 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");
    

    Hinweis

    Wenn Sie ein Bookmark -Steuerelement von einem vorhandenen Bookmarkerstellen möchten, verwenden Sie die AddBookmark -Methode und übergeben das vorhandene Bookmark.

Hinzufügen von Lesezeichensteuerelementen zur Laufzeit in einem VSTO-Add-In-Projekt

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:

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

  1. Verwenden Sie die AddBookmark -Methode, und übergeben Sie den Range an der Stelle, an der Sie das Bookmarkhinzufü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 AddBookmark -Methode, und übergeben Sie das vorhandene Bookmark , das Sie als Grundlage für das neue Bookmarkverwenden möchten.

    Im folgenden Codebeispiel wird ein neues Bookmark basierend auf dem ersten 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");
    }