Bookmark, contrôle

Le contrôle Microsoft.Office.Tools.Word.Bookmark est un signet qui porte un nom unique, expose des événements et peut être lié à des données. Le signet peut être utilisé comme espace réservé pour marquer un élément ou un emplacement dans un document Microsoft Office Word. Le contrôle Microsoft.Office.Tools.Word.Bookmark est une combinaison d'un objet Microsoft.Office.Interop.Word.Bookmark et d'un objet Microsoft.Office.Interop.Word.Range.

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.

Dans les projets au niveau du document, vous pouvez ajouter des contrôles Microsoft.Office.Tools.Word.Bookmark à votre document au moment du design ou au moment de l'exécution. Dans les projets au niveau de l'application, vous pouvez ajouter des contrôles Microsoft.Office.Tools.Word.Bookmark à tout document ouvert au moment de l'exécution. Pour plus d'informations, consultez Comment : ajouter des contrôles Bookmark à des documents Word.

Liaison de données au contrôle

Un contrôle Microsoft.Office.Tools.Word.Bookmark prend en charge la liaison de données simple. Le signet doit être lié à une source de données à l'aide de la propriété DataBindings. La propriété de liaison de données par défaut du signet est la propriété Text.

Si les données du groupe de données lié sont mises à jour, les modifications sont répercutées dans le contrôle Microsoft.Office.Tools.Word.Bookmark.

Dans les projets au niveau du document, vous pouvez également lier des données à des signets en utilisant la fenêtre Sources de données. Pour plus d'informations, consultez Comment : remplir des documents avec les données d'objets.

Mise en forme

Une mise en forme qui peut être appliquée à un Microsoft.Office.Interop.Word.Bookmark peut s'appliquer à un contrôle Microsoft.Office.Tools.Word.Bookmark. Cela comprend les polices, les retraits, l'espacement, la numérotation et les styles.

Assignation de texte au signet

Une différence supplémentaire entre un objet Microsoft.Office.Interop.Word.Bookmark et un contrôle Microsoft.Office.Tools.Word.Bookmark est leur comportement lorsque du texte est affecté au signet. Si vous assignez du texte à un Microsoft.Office.Interop.Word.Bookmark de longueur nulle, le texte est ajouté à droite du signet et le signet reste de longueur nulle. Toutefois, si vous assignez du texte à un Microsoft.Office.Tools.Word.Bookmark de longueur nulle, le texte est inséré dans le signet et la longueur du signet correspond au nombre total de caractères insérés.

Le contrôle Microsoft.Office.Tools.Word.Bookmark possède également une propriété Bookmark.Text. Elle est différente de la propriété Range.Text qui est disponible sur la propriété Range d'un contrôle Microsoft.Office.Tools.Word.Bookmark ou de la propriété Range d'un objet Microsoft.Office.Interop.Word.Bookmark.

Propriété Text	Description
Bookmark.Text	Utilisez cette propriété pour afficher du texte dans le signet et laisser le signet sur le document. L'assignation de texte au signet développe la plage de signet et ne supprime pas le signet. Par exemple, Bookmark1.Text = "Hello world" insère le texte dans le signet et conserve le signet intact.
Range.Text	Utilisez cette propriété pour afficher du texte à l'emplacement de signet et supprimer automatiquement le signet. Par exemple, Bookmark1.Range.Text = "Hello world" insère le texte dans le signet et supprime le signet.

Renommer le contrôle au moment du design

Dans les projets au niveau du document, lorsque vous faites glisser un contrôle Microsoft.Office.Tools.Word.Bookmark de la Boîte à outils vers votre document, Visual Studio génère automatiquement un nom pour le contrôle. Vous pouvez modifier le nom du contrôle dans la fenêtre Propriétés.

Contrôles superposés

Les contrôles Bookmark peuvent se superposer, c'est-à-dire que le même texte peut être partagé par plusieurs signets. Lorsque vous assignez un nouveau texte à l'un des signets superposés, celui-ci contient uniquement le nouveau texte et les signets ne sont plus superposés. L'autre signet ne contient plus que le texte qui n'était pas partagé entre les signets superposés d'origine.

Le tableau suivant illustre le partage de la phrase « Ceci est un exemple de texte. » par deux signets superposés.

Signet	Texte
Signets superposés	[ceci est un {exemple] de texte.}
Bookmark1	Ceci est un exemple
Bookmark2	échantillon de texte.

Si vous assignez le nouveau texte « Ceci est un remplacement. » au Bookmark1, les signets ne seront plus redondants et Bookmark2 conservera uniquement le texte qui ne faisait pas partie de Bookmark1 à l'origine.

Signet	Texte
Deux signets séparés	[ceci est un remplacement]{ texte.}
Bookmark1	Ceci est un remplacement
Bookmark2	texte.

Si un signet est entièrement intégré dans un autre signet et que vous modifiez le texte du signet externe, le signet interne n'est pas supprimé. Toutefois, le signet interne devient un signet vide qui est déplacé à la fin du signet externe. Le tableau suivant illustre le partage de la phrase « Ceci est un exemple de texte. » par un signet contenu dans un autre signet.

Signet	Texte
Signets superposés	[ceci est un {exemple} de texte.]
Bookmark1	Ceci est un exemple de texte.
Bookmark2	exemple

Si vous assignez le nouveau texte « Ceci est un remplacement. » au Bookmark1, les signets ne seront plus redondants et Bookmark2 deviendra un signet vide situé à la fin de Bookmark1.

Signet	Texte
Deux signets séparés	[ceci est un remplacement.]{}
Bookmark1	Ceci est un remplacement.
Bookmark2	<vide>

Événements

Les événements suivants sont disponibles pour le contrôle Microsoft.Office.Tools.Word.Bookmark :

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Deselected

• Disposed

• Selected

• SelectionChange

Voir aussi

Tâches

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

Procédure pas à pas : création de menus contextuels pour les signets

Concepts

Automatisation de Word à l'aide d'objets étendus

Limitations de programmation des éléments hôtes et des contrôles hôtes

Autres ressources

Liaison de données aux contrôles dans les solutions Office