Comment : ajouter des contrôles Bookmark à des documents WordHow to: Add Bookmark controls to Word documents

Dans les projets au niveau du document, vous pouvez ajouter Bookmark contrôles au document dans votre projet au moment du design ou lors de l’exécution.In document-level projects, you can add Bookmark controls to the document in your project at design time or at runtime. Dans les projets de complément VSTO, vous pouvez ajouter Bookmark contrôles à tout document ouvert au moment de l’exécution.In VSTO Add-in projects, you can add Bookmark controls to any open document at runtime.

S’applique à : les informations contenues dans cette rubrique s’applique au document-projets et ajouter de VSTO de niveau-dans les projets pour Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Cette rubrique décrit les tâches suivantes :This topic describes the following tasks:

Ajouter des contrôles Bookmark au moment du DesignAdd Bookmark controls at Design Time

Il existe plusieurs façons d'ajouter des contrôles Bookmark au document Word d'un projet au niveau du document au moment du design :There are several ways to add Bookmark controls to the document in a document-level project at design time:

  • À partir de la boîte à outilsVisual Studio.From the Visual Studio Toolbox.

    Vous pouvez alors faire glisser le contrôle Bookmark depuis la boîte à outils vers votre document.You can drag the Bookmark control from the Toolbox to your 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.You might want to choose this way if you are already using the Toolbox to add Windows Forms controls to your document.

  • À partir de Word.From within Word.

    Vous pouvez ajouter le contrôle Bookmark à votre document de la même manière que vous ajouteriez le signet natif.You can add the Bookmark control to your document in the same manner you would add the native bookmark. L'avantage de cette méthode est que vous pouvez nommer votre contrôle au moment de sa création.The advantage of adding it this way is that you can name your control at the time you create it.

  • À partir de la fenêtre Sources de données .From the Data Sources window.

    Vous pouvez faire glisser le contrôle Bookmark vers votre document à partir de la fenêtre Sources de données .You can drag the Bookmark control to your document from the Data Sources window. Cela est utile lorsque vous souhaitez lier simultanément le contrôle aux données.This is useful when you want to bind the control to data at the same time. Vous pouvez ajouter le contrôle hôte de la même manière que vous ajouteriez un contrôle Windows Form à partir de la fenêtre Sources de données .You can add the host control in the same way you would add a Windows Form control from the Data Sources window. Pour plus d’informations, consultez liaison de données et Windows Forms.For more information, see Data binding and Windows Forms.

    Note

    Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use determine these elements. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Pour ajouter un contrôle Bookmark à un document à partir de la boîte à outilsTo add a Bookmark control to a document from the Toolbox

  1. Ouvrez la Boîte à outils , puis cliquez sur l'onglet Contrôles Word .Open the Toolbox and click the Word Controls tab.

  2. Faites glisser un contrôle Bookmark vers le document.Drag a Bookmark control to the document.

    La boîte de dialogue Ajouter un signet s'affiche.The Add Bookmark dialog box appears.

  3. Sélectionnez le texte ou autres éléments que vous souhaitez inclure dans le signet.Select the text or other items you want to include in the bookmark.

  4. Cliquez sur OK.Click OK.

    Si vous ne souhaitez pas conserver le nom du signet par défaut, vous pouvez modifier le nom dans la fenêtre Propriétés .If you do not want to keep the default bookmark name, you can change the name in the Properties window.

Pour ajouter un contrôle Bookmark à un document dans WordTo add a Bookmark control to a document in Word

  1. Dans le document hébergé dans le Concepteur Visual StudioVisual Studio , placez le curseur où vous souhaitez ajouter le signet ou sélectionnez le texte que le signet doit encadrer.In the document that is hosted in the Visual StudioVisual Studio designer, put the cursor where you want to add the bookmark, or select the text that you want the bookmark to enclose.

  2. Sous l'onglet Insertion du ruban, dans le groupe Liens , cliquez sur le bouton Signet .On the Insert tab of the Ribbon, in the Links group, click the Bookmark button.

  3. Dans la boîte de dialogue Signet , entrez le nom du nouveau signet, puis cliquez sur Ajouter.In the Bookmark dialog box, type the name of the new bookmark, and click Add.

Ajouter des contrôles Bookmark au moment de l’exécution dans un projet au niveau du documentAdd Bookmark controls at runtime in a document-level project

Vous pouvez ajouter Bookmark par programmation des contrôles à votre document au moment de l’exécution à l’aide des méthodes de la Controls propriété de la ThisDocument classe dans votre projet.You can add Bookmark controls programmatically to your document at runtime by using methods of the Controls property of the ThisDocument class in your project. Il existe deux surcharges de méthode qui permettent d'ajouter un contrôle Bookmark de la façon suivante :There are two method overloads that you can use to add a Bookmark control in the following ways:

Pour ajouter un contrôle Bookmark à un document par programmationTo add a Bookmark control to a document programmatically

  1. 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.In the ThisDocument_Startup event handler in your project, insert the following code to add the Bookmark control to the first paragraph in the document.

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

    Note

    Si vous souhaitez créer un contrôle Bookmark à partir d'un Bookmarkexistant, utilisez la méthode AddBookmark et transmettez le Bookmarkexistant.If you want create a Bookmark control from an existing Bookmark, use the AddBookmark method and pass in the existing Bookmark.

Ajouter des contrôles Bookmark au moment de l’exécution dans un projet de complément VSTOAdd Bookmark controls at runtime in a VSTO Add-in project

Vous pouvez ajouter Bookmark contrôles par programmation à tout document ouvert lors de l’exécution en utilisant un complément, VSTO.You can add Bookmark controls programmatically to any open document at runtime by using a VSTO Add-in. Pour ce faire, vous devez générer un élément hôte Document basé sur un document ouvert, puis utiliser les méthodes de la propriété Controls de cet élément hôte.To do this, generate a Document host item that is based on an open document, and then use methods of the Controls property of this host item. Il existe deux surcharges de méthode qui permettent d'ajouter un contrôle Bookmark de la façon suivante :There are two method overloads that you can use to add a Bookmark control in the following ways:

Pour ajouter un contrôle Bookmark à une plage spécifiéeTo add a Bookmark control at a specified range

  1. Utilisez la méthode AddBookmark et passez le Range à l'emplacement où vous souhaitez ajouter le Bookmark.Use the AddBookmark method, and pass in the Range where you want to add the Bookmark.

    L'exemple de code suivant ajoute un nouveau Bookmark au début du document actif.The following code example adds a new Bookmark to the beginning of the active document. Pour utiliser cet exemple, exécutez le code à partir du gestionnaire d'événements ThisAddIn_Startup dans un projet de complément VSTO Word.To use this example, run the code from the ThisAddIn_Startup event handler in a Word VSTO Add-in project.

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

Pour ajouter un contrôle Bookmark basé sur un contrôle Bookmark natifTo add a Bookmark control that is based on a native Bookmark control

  1. Utilisez la méthode AddBookmark et passez le Bookmark existant que vous souhaitez utiliser comme base pour le nouveau Bookmark.Use the AddBookmark method, and pass in the existing Bookmark that you want to use as the basis for the new Bookmark.

    L'exemple de code suivant crée un Bookmark basé sur le premier Bookmark du document actif.The following code example creates a new Bookmark that is based on the first Bookmark in the active document. Pour utiliser cet exemple, exécutez le code à partir du gestionnaire d'événements ThisAddIn_Startup dans un projet de complément VSTO Word.To use this example, run the code from the ThisAddIn_Startup event handler in a Word VSTO Add-in project.

    If Me.Application.ActiveDocument.Bookmarks.Count > 0 Then
        Dim firstBookmark As Word.Bookmark = Me.Application.ActiveDocument.Bookmarks(1)
    
        Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    
        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 = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
        Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
                firstBookmark, "VSTOBookmark");
    }
    

Voir aussiSee also

Automatiser Word à l’aide d’objets étendus Automate Word by using extended objects
Éléments hôtes et la vue d’ensemble des contrôles hôtes Host items and host controls overview
Ajouter des contrôles aux documents Office au moment de l’exécution Add controls to Office documents at runtime
Limitations de programmation des éléments hôtes et contrôles hôtes Programmatic limitations of host items and host controls
Programmer des Compléments VSTO Program VSTO Add-ins
Programmer des personnalisations au niveau du document Program document-level customizations
Comment : redimensionner les contrôles BookmarkHow to: Resize Bookmark controls