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 des contrôles Bookmark au document de votre projet au moment du design ou au moment de l'exécution.In document-level projects, you can add Bookmark controls to the document in your project at design time or at run time. Dans les projets de complément VSTO, vous pouvez ajouter des contrôles Bookmark à tout document ouvert au moment de l’exécution.In VSTO Add-in projects, you can add Bookmark controls to any open document at run time.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de compléments VSTO 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:

Adding Bookmark Controls at Design TimeAdding 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 Data Binding and 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 Personnalisation de l'IDE.For more information, see Personalizing 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.

Ajout de contrôles Bookmark au moment de l'exécution dans un projet au niveau du documentAdding Bookmark Controls at Run Time in a Document-Level Project

Vous pouvez ajouter des contrôles Bookmark par programmation à votre document au moment de l'exécution à l'aide des méthodes de la propriété Controls de la classe ThisDocument de votre projet.You can add Bookmark controls programmatically to your document at run time 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.

Ajout de contrôles Bookmark au moment de l’exécution dans un projet de complément VSTOAdding Bookmark Controls at Run Time in an VSTO Add-in project

Vous pouvez ajouter des contrôles Bookmark par programmation à tout document ouvert au moment de l'exécution en utilisant un complément VSTO.You can add Bookmark controls programmatically to any open document at run time 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

Automatisation de Word à l’aide d’objets étendus Automating Word by Using Extended Objects
Vue d'ensemble des éléments hôtes et des contrôles hôtes Host Items and Host Controls Overview
Ajout de contrôles aux Documents Office au moment de l’exécution Adding Controls to Office Documents at Run Time
Limitations de programmation des éléments hôtes et des contrôles hôtes Programmatic Limitations of Host Items and Host Controls
Programming VSTO Add-Ins Programming VSTO Add-Ins
Programmation des personnalisations au niveau du Document Programming Document-Level Customizations
Guide pratique pour redimensionner les contrôles BookmarkHow to: Resize Bookmark Controls