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

Article
08/10/2011

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. Dans les projets au niveau de l'application, 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 de niveau document et de niveau application pour Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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.

Notes

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de 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

Ouvrez la Boîte à outils et cliquez sur l'onglet Contrôles Word.
Faites glisser un contrôle Bookmark vers le document.

La boîte de dialogue Ajouter un contrôle Bookmark s'affiche.
Sélectionnez le texte ou les autres éléments à inclure dans le signet.
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

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.
Sous l'onglet Insérer du ruban, dans le groupe Liens, cliquez sur le bouton Signet.
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 programmation 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 programmation 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");
```
Notes

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

Vous pouvez ajouter par programmation des contrôles Bookmark à tout document ouvert au moment de l'exécution à l'aide d'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.

' Use the following line of code in projects that target the .NET Framework 4.
Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

' In projects that target the .NET Framework 3.5, use the following line of code.
' Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

Dim firstParagraph As Bookmark = extendedDocument.Controls.AddBookmark( _
    extendedDocument.Paragraphs(1).Range, "FirstParagraph")

// Use the following line of code in projects that target the .NET Framework 4.
Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

// In projects that target the .NET Framework 3.5, use the following line of code.
// 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)

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

    ' In projects that target the .NET Framework 3.5, use the following line of code.
    ' 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);

    // Use the following line of code in projects that target the .NET Framework 4.
    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

Voir aussi

Partager via