Bookmark (contrôle)Bookmark Control

Le contrôle Bookmark est un signet qui possède un nom unique, qui expose des événements et qui peut être lié à des données.The Bookmark control is a bookmark that has a unique name, exposes events, and can be bound to data. Vous pouvez utiliser le signet comme espace réservé pour marquer un élément ou un emplacement dans un document Microsoft Office Word.The bookmark can be used as a placeholder to mark an item or location in a Microsoft Office Word document. Le contrôle Bookmark est une combinaison d’un objet Bookmark et d’un objet Range .The Bookmark control is a combination of a Bookmark object and a Range object.

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.

Dans les projets au niveau du document, vous pouvez ajouter des contrôles Bookmark à votre document au moment du design ou au moment de l’exécution.In document-level projects, you can add Bookmark controls to your document at design time or at run time. Dans les projets de complément VSTO, vous pouvez ajouter des contrôles Bookmark aux documents ouverts au moment de l’exécution.In VSTO Add-in projects, you can add Bookmark controls to any open document at run time. Pour plus d'informations, consultez Comment : ajouter des contrôles Bookmark à des documents Word.For more information, see How to: Add Bookmark Controls to Word Documents.

Liaison de données au contrôleBinding Data to the Control

Un contrôle Bookmark prend en charge la liaison de données simple.A Bookmark control supports simple data binding. Le signet doit être lié à une source de données à l’aide de la propriété DataBindings .The bookmark should be bound to a data source using the DataBindings property. La propriété de liaison de données par défaut du signet est la propriété Text .The default data binding property of the bookmark is the Text property.

Si les données du jeu de données lié sont mises à jour, le contrôle Bookmark reflète les changements apportés.If the data in the bound dataset is updated, the Bookmark control reflects the changes.

Dans les projets au niveau du document, vous pouvez également lier des données à des signets via la fenêtre Sources de données .In document-level projects, you can also bind data to bookmarks by using the Data Sources window. Pour plus d'informations, consultez Comment : remplir des documents avec les données d'objets.For more information, see How to: Populate Documents with Data from Objects.

Mise en formeFormatting

Une mise en forme qui peut être appliquée à Bookmark peut également être appliquée à un contrôle Bookmark .Formatting that can be applied to a Bookmark can be applied to a Bookmark control. Cela inclut les polices, les retraits, l’espacement, la numérotation et les styles.This includes fonts, indents, spacing, numbering, and styles.

Assignation de texte au signetAssigning Text to the Bookmark

Il existe une différence supplémentaire entre un objet Bookmark et un contrôle Bookmark . Il s’agit du comportement observé quand vous assignez du texte au signet.An additional difference between a Bookmark object and a Bookmark control is how it behaves when text is assigned to the bookmark. Si vous assignez du texte à un Bookmarkde longueur nulle, ce texte est ajouté à droite du signet. Par ailleurs, le signet conserve une longueur nulle.If you assign text to a zero-length Bookmark, the text is appended to the right of the bookmark and the bookmark remains zero-length. Toutefois, si vous assignez du texte à un Bookmarkde longueur nulle, le texte est inséré dans le signet. Par ailleurs, la longueur du signet se développe en fonction du nombre total de caractères insérés.However, if you assign text to a zero-length Bookmark, the text is inserted into the bookmark and the bookmark's length expands to the total number of characters inserted.

Le contrôle Bookmark possède également la propriété Text .The Bookmark control also has the Text property. Cela diffère de la propriété Microsoft.Office.Interop.Word.Range.Text* , disponible pour la propriété Range d’un contrôle Bookmark ou la propriété Microsoft.Office.Interop.Word.Bookmark.Range* d’un objet Bookmark .This is different from the Microsoft.Office.Interop.Word.Range.Text* property that is available on the Range property of a Bookmark control or the Microsoft.Office.Interop.Word.Bookmark.Range* property of a Bookmark object.

Text (propriété)Text Property DescriptionDescription
Text Utilisez cette propriété pour afficher le texte contenu dans le signet, et laisser le signet dans le document.Use this property to display text within the bookmark and leave the bookmark on the document. L’assignation de texte au signet développe la plage du signet et ne supprime pas le signet.Assigning text to the bookmark expands the bookmark range and does not delete the bookmark.

Par exemple, Bookmark1.Text = "Hello world" insère le texte dans le signet et laisse le signet intact.For example, Bookmark1.Text = "Hello world" inserts the text into the bookmark and leaves the bookmark intact.
Microsoft.Office.Interop.Word.Range.Text* Utilisez cette propriété pour afficher du texte à l’emplacement du signet et supprimer automatiquement le signet.Use this property to display text at the bookmark location and automatically delete the bookmark. Par exemple, Bookmark1.Range.Text = "Hello world" insère le texte dans le signet et supprime le signet.For example, Bookmark1.Range.Text = "Hello world" inserts the text into the bookmark and deletes the bookmark.

Changement de nom du contrôle au moment au moment du designRenaming the Control at Design Time

Dans les projets au niveau du document, quand vous faites glisser un contrôle Bookmark de la Boîte à outils vers votre document, Visual Studio génère automatiquement un nom pour le contrôle.In document-level projects, when you drag a Bookmark control from the Toolbox to your document, Visual Studio automatically generates a name for the control. Vous pouvez changer le nom du contrôle dans la fenêtre Propriétés .You can change the name of the control in the Properties window.

Chevauchement de contrôlesOverlapping Controls

Les contrôles Bookmark peuvent se chevaucher. En d’autres termes, plusieurs signets peuvent partager le même texte.Bookmark controls can overlap each other; that is, the same text can be shared by more than one bookmark. Quand vous assignez un nouveau texte à l’un des signets qui se chevauchent, celui-ci contient uniquement le nouveau texte. En outre, les signets ne se chevauchent plus.When you assign new text to one of the overlapping bookmarks, it will contain only the new text and the bookmarks will no longer overlap. L’autre signet contient désormais uniquement le texte qui n’était pas partagé entre les signets qui se chevauchaient à l’origine.The other bookmark will now contain only the text that was not shared between the original overlapping bookmarks.

Le tableau suivant montre comment la phrase « Voici un exemple textuel. »The following table shows how the sentence "This is sample text." est partagée par deux signets qui se chevauchent.is shared by two overlapping bookmarks.

SignetBookmark TexteText
Chevauchement de signetsOverlapping bookmarks [voici un {exemple] textuel.}[this is {sample] text.}
Signet1Bookmark1 Voici un exempleThis is sample
Signet2Bookmark2 exemple textuel.sample text.

Si vous assignez le nouveau texte « Voici un remplacement. »If you assign the new text "This is replacement." à Signet1, les signets ne sont plus superposés et Signet2 conserve uniquement le texte qui ne faisait pas partie de Signet1 à l’origine.to Bookmark1, the bookmarks are no longer overlapping and Bookmark2 retains only the text that was not originally part of Bookmark1.

SignetBookmark TexteText
Deux signets séparésTwo separate bookmarks [voici un remplacement]{ textuel.}[this is replacement]{ text.}
Signet1Bookmark1 Voici un remplacementThis is replacement
Signet2Bookmark2 textuel.text.

Si un signet est entièrement contenu dans un autre signet, et si vous changez le texte du signet externe, le signet interne n’est pas supprimé.If one bookmark is fully contained within another bookmark and you change the text of the outer bookmark, the inner bookmark is not deleted. Toutefois, le signet interne devient un signet vide qui est déplacé à la fin du signet externe.However, the inner bookmark becomes an empty bookmark that is moved to the end of the outer bookmark. Le tableau suivant montre comment la phrase « Voici un exemple textuel. »The following table shows how the sentence "This is sample text." est partagée par un signet contenu dans un autre signet.is shared by a bookmark that is contained within another bookmark.

SignetBookmark TexteText
Chevauchement de signetsOverlapping bookmarks [voici un {exemple} textuel.][this is {sample} text.]
Signet1Bookmark1 Voici un exemple textuel.This is sample text.
Signet2Bookmark2 exemplesample

Si vous assignez le nouveau texte « Voici un remplacement. »If you assign the new text "This is replacement." à Signet1, les signets ne se chevauchent plus. Par ailleurs, Signet2 devient un signet vide situé à la fin de Signet1.to Bookmark1, the bookmarks are no longer overlapping and Bookmark2 becomes an empty bookmark that is located at the end of Bookmark1.

SignetBookmark TexteText
Deux signets séparésTwo separate bookmarks [voici un remplacement.]{}[this is replacement.]{}
Signet1Bookmark1 Voici un remplacement.This is replacement.
Signet2Bookmark2 <vide ><empty>

ÉvénementsEvents

Les événements suivants sont disponibles pour le contrôle Bookmark :The following events are available for the Bookmark control:

Voir aussiSee Also

Automatisation de Word à l’aide d’objets étendus Automating Word by Using Extended Objects
Comment : ajouter des contrôles Bookmark à des documents Word How to: Add Bookmark Controls to Word Documents
Procédure pas à pas : Création de Menus contextuels pour les signets Walkthrough: Creating Shortcut Menus for Bookmarks
Liaison de données aux contrôles dans les Solutions Office Binding Data to Controls in Office Solutions
Limitations de programmation des éléments hôtes et des contrôles hôtesProgrammatic Limitations of Host Items and Host Controls