Ajouter des contrôles Signet aux documents Word

  • Article

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. Dans les projets de complément VSTO, vous pouvez ajouter des contrôles Bookmark à tout document ouvert au moment de l’exécution.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO pour Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Cette rubrique décrit les tâches suivantes :

Ajouter des contrôles Signet au moment du design

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 :

  • À partir de la boîte à outilsVisual Studio.

    Vous pouvez alors faire glisser le contrôle Bookmark depuis 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 le contrôle Bookmark à votre document de la même manière que vous ajouteriez 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 simultanément le contrôle aux données. 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 . Pour plus d’informations, consultez Liaison de données et Windows Forms.

    Remarque

    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. 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 Personnaliser l’IDE.

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

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

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

    La boîte de dialogue Ajouter un signet s'affiche.

  3. Sélectionnez le texte ou autres éléments que vous souhaitez inclure dans le signet.

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

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

  1. Dans le document hébergé dans le concepteur Visual Studio, placez le curseur dans lequel vous souhaitez ajouter le signet ou sélectionnez le texte que vous souhaitez placer dans le signet.

  2. Sous l'onglet Insertion du ruban, dans le groupe Liens , cliquez sur le bouton Signet .

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

Ajouter des contrôles Signet au moment de l’exécution dans un projet au niveau du document

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. Il existe deux surcharges de méthode qui permettent d'ajouter un contrôle Bookmark de la façon suivante :

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

  • Ajouter un Bookmark basé sur un signet natif dans le document (autrement dit, un Bookmark).

    Les contrôles Bookmark créés de façon dynamique ne sont pas conservés dans le document lorsque le document est fermé. Toutefois, un Bookmark natif demeure dans le document. Vous pouvez recréer un Bookmark basé sur un signet lors de la prochaine ouverture du document. Pour plus d’informations, consultez Ajouter des contrôles à Bureau documents au moment de l’exécution.

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

  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.

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

    Remarque

    Si vous souhaitez créer un contrôle Bookmark à partir d'un Bookmarkexistant, utilisez la méthode AddBookmark et transmettez le Bookmarkexistant.

Ajouter des contrôles Signet au moment de l’exécution dans un projet de complément VSTO

Vous pouvez ajouter des contrôles Bookmark par programmation à tout document ouvert au moment de l'exécution en utilisant un complément VSTO. 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. Il existe deux surcharges de méthode qui permettent d'ajouter un contrôle Bookmark de la façon suivante :

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

  1. Utilisez la méthode AddBookmark et passez le Range à l'emplacement où vous souhaitez ajouter le Bookmark.

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

    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 natif

  1. Utilisez la méthode AddBookmark et passez le Bookmark existant que vous souhaitez utiliser comme base pour le nouveau Bookmark.

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

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

Contenu connexe