Comment : ajouter des contrôles Bookmark à des documents Word

Mise à jour : Juillet 2008

Dans les projets au niveau du document, vous pouvez ajouter des contrôles Bookmark au document de votre projet au moment du design ou de l'exécution. À partir de Visual Studio 2008 Service Pack 1 (SP1), vous pouvez également ajouter des contrôles Bookmark à tout document ouvert au moment de l'exécution en utilisant un complément d'application pour Word 2007.

Cette rubrique décrit les tâches suivantes :

• Ajout de contrôles Bookmark au moment du design

• Ajout de contrôles Bookmark au moment de l'exécution dans un projet au niveau du document

• Ajout de contrôles Bookmark au moment de l'exécution dans un projet au niveau de l'application

Pour plus d'informations sur les contrôles Bookmark, consultez Bookmark, contrôle.

Ajout de contrôles Bookmark au moment du design

Il existe plusieurs manières d'ajouter des contrôles Bookmark au document dans un projet au niveau du document au moment du design :

• À partir de la boîte à outils Visual Studio.

  Vous pouvez faire glisser le contrôle Bookmark de la Boîte à outils vers votre document. Vous souhaiterez peut-être choisir cette méthode si vous utilisez déjà la Boîte à outils pour ajouter des contrôles Windows Forms à votre document.

• À partir de Word.

  Vous pouvez ajouter au document le contrôle Bookmark de la même manière que le signet natif. L'avantage de cette méthode est que vous pouvez nommer votre contrôle au moment de sa création.

• À partir de la fenêtre Sources de données.

  Vous pouvez faire glisser le contrôle Bookmark vers votre document à partir de la fenêtre Sources de données. Cela est utile lorsque vous souhaitez lier en même temps le contrôle aux données. Vous pouvez ajouter le contrôle hôte comme vous ajouteriez un contrôle Windows Form à partir de la fenêtre Sources de données. Pour plus d'informations, consultez Liaison de données et Windows Forms.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour ajouter un contrôle Bookmark à un document à partir de la boîte à outils

1. Ouvrez la Boîte à outils et cliquez sur l'onglet Contrôles Word.

2. Faites glisser un contrôle Bookmark vers le document.

   La boîte de dialogue Ajouter un contrôle Bookmark s'affiche.

3. Sélectionnez le texte ou les autres éléments à inclure dans le signet.

4. Cliquez sur OK.

   Si vous ne souhaitez pas conserver le nom de signet par défaut, vous pouvez modifier ce nom dans la fenêtre Propriétés.

Pour ajouter un contrôle Bookmark à un document dans Word

1. Dans le document hébergé par le concepteur Visual Studio, placez le curseur où vous souhaitez ajouter le signet ou sélectionnez le texte qu'il doit encadrer.

2. Exécutez une des opérations suivantes :

   • Dans Word 2003 : Dans le menu Insertion, cliquez sur Signet.

   • Dans Word 2007 : dans l'onglet Insertion du Ruban, cliquez sur le bouton Signet dans le groupe Liens.

3. Dans la boîte de dialogue Signet, tapez le nom du nouveau signet, puis cliquez sur Ajouter.

Ajout de contrôles Bookmark au moment de l'exécution dans un projet au niveau du document

Vous pouvez ajouter par programme des contrôles Bookmark à votre document au moment de l'exécution en utilisant des méthodes de la propriété Controls de la classe ThisDocument dans votre projet. Vous pouvez utiliser deux surcharges de méthode pour ajouter un contrôle Bookmark de l'une des manières suivantes :

• Ajoutez un Bookmark à une plage spécifiée.

• Ajoutez un Bookmark basé sur un signet natif dans le document (autrement dit, Microsoft.Office.Interop.Word.Bookmark).

Les contrôles Bookmark créés dynamiquement ne sont pas conservés dans le document après sa fermeture. Par contre, un Microsoft.Office.Interop.Word.Bookmark natif reste dans le document. Vous pouvez recréer un Bookmark basé sur un signet natif la prochaine fois que vous ouvrez le document. Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

Pour ajouter par programme un contrôle Bookmark à un document

• Dans le gestionnaire d'événements ThisDocument_Startup de votre projet, insérez le code suivant pour ajouter le contrôle Bookmark au premier paragraphe du document.

  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");
  

  Remarque :
  Pour créer un contrôle Microsoft.Office.Tools.Word.Bookmark à partir d'un Microsoft.Office.Interop.Word.Bookmark existant, utilisez la méthode AddBookmark et passez le Microsoft.Office.Interop.Word.Bookmark existant.

Ajout de contrôles Bookmark au moment de l'exécution dans un projet au niveau de l'application

À partir du SP1, vous pouvez ajouter par programme des contrôles Bookmark à tout document ouvert au moment de l'exécution en utilisant un complément d'application. Pour ce faire, générez un élément hôte Document basé sur un document ouvert, puis utilisez des méthodes de la propriété Controls de cet élément hôte. Vous pouvez utiliser deux surcharges de méthode pour ajouter un contrôle Bookmark de l'une des manières suivantes :

• Ajoutez un Bookmark à une plage spécifiée.

• Ajoutez un Bookmark basé sur un signet natif dans le document (autrement dit, Microsoft.Office.Interop.Word.Bookmark).

Les contrôles Bookmark créés dynamiquement ne sont pas conservés dans le document après sa fermeture. Par contre, un Microsoft.Office.Interop.Word.Bookmark natif reste dans le document. Vous pouvez recréer un Bookmark basé sur un signet natif la prochaine fois que vous ouvrez le document. Pour plus d'informations, consultez Rendre des contrôles dynamiques persistants dans des documents Office.

Pour plus d'informations sur la génération d'éléments hôtes dans des projets au niveau de l'application, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

Pour ajouter un contrôle Bookmark à une plage spécifiée

• Utilisez la méthode ControlCollection.AddBookmark(Range, String) et passez la Range où vous voulez ajouter Bookmark.

  L'exemple de code suivant ajoute un nouveau la méthode Bookmark au début du document actif. Pour utiliser cet exemple, exécutez le code depuis le gestionnaire d'événements ThisAddIn_Startup dans un projet de complément Word.

  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");
  

Pour ajouter un contrôle Bookmark basé sur un contrôle Bookmark natif

• Utilisez la méthode ControlCollection.AddBookmark(Bookmark, String) et passez le Microsoft.Office.Interop.Word.Bookmark existant que vous voulez utiliser comme base du nouveau Bookmark.

  L'exemple de code suivant crée un Bookmark basé sur le premier Microsoft.Office.Interop.Word.Bookmark du document actif. Pour utiliser cet exemple, exécutez le code depuis le gestionnaire d'événements ThisAddIn_Startup dans un projet de complément Word.

  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");
  }
  

Voir aussi

Tâches

Comment : redimensionner les contrôles Bookmark

Concepts

Vue d'ensemble des éléments hôtes et des contrôles hôtes

Ajout de contrôles à des documents Office au moment de l'exécution

Limitations de programmation des éléments hôtes et des contrôles hôtes

Programmation de compléments d'application

Programmation de personnalisations au niveau du document

Méthodes d'assistance pour les contrôles hôtes

Autres ressources

Contrôles hôtes Word

Historique des modifications