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’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.

Dans les projets au niveau du document, vous pouvez ajouter Bookmark contrôles à 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 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. Pour plus d’informations, consultez Comment : ajouter un signet des contrôles à des documents Word.For more information, see How to: Add Bookmark controls to Word documents.

Lier des données au contrôleBind 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 DataSet lié sont mis à jour, le Bookmark présente les modifications de contrôle.If the data in the bound dataset is updated, the Bookmark control shows 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. Cette mise en forme inclut les polices, les retraits, l’espacement, numérotation et styles.This formatting includes fonts, indents, spacing, numbering, and styles.

Affecter le texte au signetAssign text to the bookmark

Une différence supplémentaire entre un Bookmark objet et un Bookmark contrôle est leur comportement lorsque du texte est affecté 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 à une longueur de zéro Bookmark, le texte est ajouté à droite du signet et le signet reste de 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 à une longueur de zéro Bookmark, le texte est inséré dans le signet et la longueur du signet se développe et le 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 Bookmark contrôle a également la Text propriété.The Bookmark control also has the Text property. Cette propriété est différente de la Range.Text propriété n’est disponible sur le Range propriété d’un Bookmark (contrôle), ou le Bookmark.Range propriété d’un Bookmark objet.This property is different from the Range.Text property that is available on the Range property of a Bookmark control, or the 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.
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.

Renommez le contrôle au moment du designRename 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.

Contrôles qui se chevauchentOverlapping controls

Les contrôles Bookmark peuvent se chevaucher.Bookmark controls can overlap each other. Le même texte peut être partagé par plusieurs signets.The same text can be shared by more than one bookmark. Lorsque vous assignez le nouveau texte à un des signets qui se chevauchent, il contient uniquement le nouveau texte et les signets ne se chevauchent plus.When you assign new text to one of the overlapping bookmarks, it contains only the new text and the bookmarks no longer overlap. L’autre signet contient désormais uniquement le texte qui n’était pas partagé entre les signets qui se chevauchent d’origine.The other bookmark now contains only the text that wasn't 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 se chevauchent pas et Bookmark2 conserve uniquement le texte qui n’était pas à l’origine partie de Signet1.to Bookmark1, the bookmarks don't overlap, and Bookmark2 retains only the text that wasn't 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 vous modifiez le texte d’un signet qui contient un autre signet, le signet interne n’est pas supprimé.If you change the text of a bookmark that contains another bookmark, the inner bookmark isn't deleted. Toutefois, le signet interne devient un signet vide et le déplace à la fin du signet externe.However, the inner bookmark becomes an empty bookmark, and moves 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é par un signet contenu dans un autre signet :is shared by a bookmark that's 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