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

Artikel
08/10/2011

In Projekten auf Dokumentebene können Sie dem Dokument im Projekt Bookmark-Steuerelemente zur Entwurfszeit oder zur Laufzeit hinzufügen. In Projekten auf Anwendungsebene können Sie zur Laufzeit jedem geöffneten Dokument Bookmark-Steuerelemente hinzufügen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In diesem Thema werden die folgenden Aufgaben erläutert:

Hinzufügen von Bookmark-Steuerelementen zur Entwurfszeit
Hinzufügen von Bookmark-Steuerelementen zur Laufzeit in einem Projekt auf Dokumentebene
Hinzufügen von Bookmark-Steuerelementen zur Laufzeit in einem Projekt auf Anwendungsebene

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

Hinzufügen von Bookmark-Steuerelementen zur Entwurfszeit

Es gibt verschiedene Möglichkeiten, um Bookmark-Steuerelemente zur Entwurfszeit zu einem Projekt auf Dokumentebene hinzuzufügen.

Aus der Visual Studio-Toolbox

Sie können das Bookmark-Steuerelement von der Toolbox in das Dokument ziehen. Diese Vorgehensweise bietet sich an, wenn Sie die Toolbox bereits verwenden, um dem Dokument Windows Forms-Steuerelemente hinzuzufügen.
Aus Word heraus

Sie können dem Dokument das Bookmark-Steuerelement auf dieselbe Weise wie das systemeigene Lesezeichen hinzufügen. Wenn Sie das Steuerelement jedoch auf diese Weise hinzufügen, besteht der Vorteil, dass Sie das Steuerelement bei der Erstellung benennen können.
Aus dem Datenquellenfenster

Sie können das Bookmark-Steuerelement vom Datenquellenfenster in das Dokument ziehen. Dies ist hilfreich, wenn Sie das Steuerelement gleichzeitig an Daten binden möchten. Fügen Sie das Hoststeuerelement genauso hinzu wie ein Windows Forms-Steuerelement aus dem Datenquellenfenster. Weitere Informationen finden Sie unter Datenbindung und Windows Forms.

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

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

Öffnen Sie die Toolbox, und klicken Sie auf die Registerkarte Word-Steuerelemente.
Ziehen Sie ein Bookmark-Steuerelement in das Dokument.

Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.
Wählen Sie den Text bzw. andere Elemente aus, die Sie ins Lesezeichen einschließen möchten.
Klicken Sie auf OK.

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

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

Setzen Sie in dem Dokument, das im Visual Studio-Designer gehostet wird, den Cursor an die Stelle, an der das Bookmark-Steuerelement eingefügt werden soll, oder wählen Sie den Text aus, den das Lesezeichen einschließen soll.
Klicken Sie auf der Registerkarte Einfügen des Menübands in der Gruppe Links auf die Schaltfläche Lesezeichen.
Geben Sie im Dialogfeld Lesezeichen den Namen des neuen Lesezeichens ein, und klicken Sie auf Hinzufügen.

Hinzufügen von Bookmark-Steuerelementen zur Laufzeit in einem Projekt auf Dokumentebene

Sie können dem Dokument zur Laufzeit programmgesteuert Bookmark-Steuerelemente hinzufügen, indem Sie Methoden der Controls-Eigenschaft der ThisDocument-Klasse in Ihrem Projekt verwenden. Es gibt zwei Methodenüberladungen, die Sie verwenden können, um ein Bookmark-Steuerelement folgendermaßen hinzuzufügen:

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 Microsoft.Office.Interop.Word.Bookmark).

Dynamisch erstellte Bookmark-Steuerelemente werden beim Schließen des Dokuments nicht im Dokument beibehalten. Ein systemeigenes Microsoft.Office.Interop.Word.Bookmark verbleibt jedoch im Dokument. Sie können ein Bookmark neu erstellen, das auf einem systemeigenen Lesezeichen im Dokument basiert, wenn das Dokument das nächste Mal geöffnet wird. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

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

Fügen Sie im ThisDocument_Startup-Ereignishandler in Ihrem Projekt den folgenden Code ein, um dem ersten Absatz des Dokuments das Bookmark-Steuerelement hinzuzufügen.
```
Dim firstParagraph As Microsoft.Office.Tools.Word.Bookmark
firstParagraph = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "FirstParagraph")
```
```
Microsoft.Office.Tools.Word.Bookmark firstParagraph;
firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
    "FirstParagraph");
```
Tipp

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

Hinzufügen von Bookmark-Steuerelementen zur Laufzeit in einem Projekt auf Anwendungsebene

Sie können jedem geöffneten Dokument zur Laufzeit programmgesteuert mit einem Add-In auf Anwendungsebene Bookmark-Steuerelemente hinzufügen. Generieren Sie dazu ein Document-Hostelement auf der Basis eines geöffneten Dokuments, und verwenden Sie dann die Methoden der Controls-Eigenschaft dieses Hostelements. Es gibt zwei Methodenüberladungen, die Sie verwenden können, um ein Bookmark-Steuerelement folgendermaßen hinzuzufügen:

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 Microsoft.Office.Interop.Word.Bookmark).

Dynamisch erstellte Bookmark-Steuerelemente werden beim Schließen des Dokuments nicht im Dokument beibehalten. Ein systemeigenes Microsoft.Office.Interop.Word.Bookmark verbleibt jedoch im Dokument. Sie können ein Bookmark neu erstellen, das auf einem systemeigenen Lesezeichen im Dokument basiert, wenn das Dokument das nächste Mal geöffnet wird. Weitere Informationen hierzu finden Sie unter Beibehalten von dynamischen Steuerelementen in Office-Dokumenten.

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

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

Verwenden Sie die ControlCollection.AddBookmark(Range, String)-Methode, und geben Sie den Range ein, in dem 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 im ThisAddIn_Startup-Ereignishandlers eines Add-In-Projekts für Word aus.

' Use the following line of code in projects that target the .NET Framework 4.
Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

' In projects that target the .NET Framework 3.5, use the following line of code.
' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
    extendedDocument.Paragraphs(1).Range, "FirstParagraph")

// Use the following line of code in projects that target the .NET Framework 4.
Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

// In projects that target the .NET Framework 3.5, use the following line of code.
// Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

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

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

Im folgenden Codebeispiel wird ein neues Bookmark auf der Basis des ersten Microsoft.Office.Interop.Word.Bookmark im aktiven Dokument erstellt. Um dieses Beispiel zu verwenden, führen Sie den Code im ThisAddIn_Startup-Ereignishandlers eines Add-In-Projekts für Word aus.

If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
    Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    ' In projects that target the .NET Framework 3.5, use the following line of code.
    ' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

    Dim vstoBookmark As Bookmark = extendedDocument.Controls.AddBookmark( _
        firstBookmark, "VSTOBookmark")
End If

if (this.Application.ActiveDocument.Bookmarks.Count > 0)
{
    object index = 1;
    Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);

    // Use the following line of code in projects that target the .NET Framework 4.
    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

Siehe auch

Freigeben über