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

Aktualisiert: Juli 2008

In Projekten auf Dokumentebene können Sie dem Dokument im Projekt Bookmark-Steuerelemente zur Entwurfszeit oder zur Laufzeit hinzufügen. Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie jedem beliebigen Dokument Bookmark-Steuerelemente zur Laufzeit mit einem Add-In auf Anwendungsebene für Word 2007 hinzufügen.

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.

Hinweis:
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

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

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

   Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.

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

4. 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

1. 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.

2. Führen Sie einen der folgenden Vorgänge aus:

   • Für Word 2003: Klicken Sie im Menü Einfügen auf Lesezeichen.

   • Für Word 2007: Klicken Sie auf der Registerkarte Einfügen der Multifunktionsleiste 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 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");
  

  Hinweis:
  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

Ab SP1 können Sie jedem geöffneten Dokument zur Laufzeit programmgesteuert mit einem Add-In auf Anwendungsebene ein Bookmark-Steuerelement 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.

  Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()
  Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
      extendedDocument.Paragraphs(1).Range, "FirstParagraph")
  

  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-Ereignishandler 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)
      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);
      Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();
  
      Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
              firstBookmark, "VSTOBookmark");
  }
  

Siehe auch

Aufgaben

Gewusst wie: Ändern der Größe von Bookmark-Steuerelementen

Konzepte

Übersicht über Hostelemente und Hoststeuerelemente

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Programmieren von Add-Ins auf Anwendungsebene

Programmieren von Anpassungen auf Dokumentebene

Hilfsmethoden für Hoststeuerelemente

Weitere Ressourcen

Word-Hoststeuerelemente

Änderungsverlauf