Bookmark (contrôle)

  • Article

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. Vous pouvez utiliser le signet comme espace réservé pour marquer un élément ou un emplacement dans un document Microsoft Office Word. Le contrôle Bookmark est une combinaison d’un objet Bookmark et d’un objet Range .

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.

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. Dans les projets de complément VSTO, vous pouvez ajouter des contrôles Bookmark à tout document ouvert au moment de l’exécution. Pour plus d’informations, consultez How to : Add Bookmark controls to Word documents.

Lier des données au contrôle

Un contrôle 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 jeu de données lié sont mises à jour, le Bookmark contrôle affiche les modifications.

Dans les projets au niveau du document, vous pouvez également lier des données à des signets via la fenêtre Sources de données . Pour plus d’informations, consultez Guide pratique pour remplir des documents à partir d’objets.

Mise en forme

Une mise en forme qui peut être appliquée à Bookmark peut également être appliquée à un contrôle Bookmark . Cette mise en forme inclut les polices, les retraits, l’espacement, la numérotation et les styles.

Affecter du texte au signet

Il existe une différence supplémentaire entre un objet Microsoft.Office.Interop.Word.Bookmark et un contrôle Microsoft.Office.Tools.Word.Bookmark . Il s’agit du comportement observé quand vous assignez du texte au signet. Si vous assignez du texte à un Microsoft.Office.Interop.Word.Bookmarkde longueur nulle, ce texte est ajouté à droite du signet. Par ailleurs, le signet conserve une longueur nulle. Toutefois, si vous assignez du texte à un Microsoft.Office.Tools.Word.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.

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

Text (propriété) Description
Bookmark.Text Utilisez cette propriété pour afficher le texte contenu dans le signet, et laisser le signet dans le document. L’assignation de texte au signet développe la plage du signet et ne supprime pas le signet.

Par exemple, Bookmark1.Text = "Hello world" insère le texte dans le signet et laisse le signet intact.
Range.Text Utilisez cette propriété pour afficher du texte à l’emplacement du 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, 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. Vous pouvez changer le nom du contrôle dans la fenêtre Propriétés .

Contrôles qui se chevauchent

Les contrôles de signet peuvent se chevaucher. Le même texte peut être partagé par plusieurs signets. Lorsque vous affectez un nouveau texte à l’un des signets qui se chevauchent, il contient uniquement le nouveau texte et les signets ne se chevauchent plus. L’autre signet contient désormais uniquement le texte qui n’a pas été partagé entre les signets qui se chevauchent d’origine.

Le tableau suivant montre comment la phrase « Il s’agit d’un exemple de texte ». est partagée par deux signets qui se chevauchent :

Signet Texte
Chevauchement de signets [voici un {exemple] textuel.}
Signet1 Voici un exemple
Signet2 exemple textuel.

Si vous affectez le nouveau texte « Ceci est remplacement ». à Bookmark1, les signets ne se chevauchent pas, et Bookmark2 conserve uniquement le texte qui n’a pas été initialement inclus dans Bookmark1.

Signet Texte
Deux signets séparés [voici un remplacement]{ textuel.}
Signet1 Voici un remplacement
Signet2 texte.

Si vous modifiez le texte d’un signet qui contient un autre signet, le signet interne n’est pas supprimé. Toutefois, le signet interne devient un signet vide et passe à la fin du signet externe.

Le tableau suivant montre comment la phrase « Il s’agit d’un exemple de texte ». Est partagée par un signet contenu dans un autre signet :

Signet Texte
Chevauchement de signets [voici un {exemple} textuel.]
Signet1 Voici un exemple textuel.
Signet2 Échantillon

Si vous attribuez le nouveau texte « Ceci est remplacement ». à Bookmark1, les signets ne se chevauchent plus et Bookmark2 devient un signet vide situé à la fin de Bookmark1.

Signet Texte
Deux signets séparés [il s’agit d’un remplacement.]{}
Signet1 Voici un remplacement.
Signet2 <empty>

Événements

Les événements suivants sont disponibles pour le contrôle Bookmark :

Contenu connexe