Comment : mettre à jour le texte d'un signet

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Projets au niveau de l'application Version de Microsoft Office Word 2003 Word 2007 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document
Projets au niveau de l'application

Version de Microsoft Office

Word 2003
Word 2007

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez insérer du texte dans un signet d'espace réservé dans un document Microsoft Office Word afin de pouvoir récupérer le texte ultérieurement ou remplacer le texte dans un signet. Si vous développez une personnalisation au niveau du document, vous pouvez également mettre à jour le texte d'un contrôle Microsoft.Office.Tools.Word.Bookmark lié à des données. Pour plus d'informations, consultez Liaison de données aux contrôles.

L'objet signet (Bookmark) peut être de deux types :

Contrôle hôte Microsoft.Office.Tools.Word.Bookmark.

Les contrôles Microsoft.Office.Tools.Word.Bookmark étendent les objets Microsoft.Office.Interop.Word.Bookmark natifs en activant la liaison de données et en exposant des événements. Pour plus d'informations sur les contrôles hôtes, consultez Vue d'ensemble des éléments hôtes et des contrôles hôtes.
Objet Microsoft.Office.Interop.Word.Bookmark natif.

Les objets Microsoft.Office.Interop.Word.Bookmark n'ont pas d'événements ou de fonctions de liaison de données.

Lorsque vous assignez du texte à un signet, le comportement diffère entre un Microsoft.Office.Interop.Word.Bookmark et un Microsoft.Office.Tools.Word.Bookmark. Pour plus d'informations, consultez Bookmark, contrôle.

Utilisation de contrôles hôtes

Pour mettre à jour le contenu d'un signet à l'aide d'un contrôle Bookmark

Créez une procédure ayant un argument bookmark pour le nom du signet et un argument newText pour la chaîne à attribuer à la propriété Text.

Remarque :

L'assignation de texte à la propriété Bookmark.Text ou Bookmark.FormattedText d'un contrôle Microsoft.Office.Tools.Word.Bookmark ne provoque pas la suppression du signet.
```
Shared Sub BookMarkReplace( _
    ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
    ByVal newText As String)
```
```
static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{
```
Attribuez la chaîne newText à la propriété Text de Microsoft.Office.Tools.Word.Bookmark.
```
    bookmark.Text = newText
End Sub
```
```
    bookmark.Text = newText;
}
```

Remarque :
L'assignation de texte à la propriété Bookmark.Text ou Bookmark.FormattedText d'un contrôle Microsoft.Office.Tools.Word.Bookmark ne provoque pas la suppression du signet.

Utilisation des objets Word

Pour mettre à jour le contenu d'un signet à l'aide d'un objet Bookmark Word

Créez une procédure ayant un argument bookmark pour le nom de Microsoft.Office.Interop.Word.Bookmark et un argument newText pour la chaîne à attribuer à la propriété Range.Text du signet.

Remarque :

L'assignation de texte à un objet Microsoft.Office.Interop.Word.Bookmark Word natif provoque la suppression du signet.
```
Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)
```
```
internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{
```

Remarque :
L'assignation de texte à un objet Microsoft.Office.Interop.Word.Bookmark Word natif provoque la suppression du signet.

Attribuez la chaîne newText à la propriété Range.Text du signet, ce qui supprime automatiquement le signet. Ensuite, ajoutez de nouveau le signet à la collection Bookmarks.

L'exemple de code suivant peut être utilisé dans une personnalisation au niveau du document.

    Dim rng As Word.Range = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText

    Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    this.Bookmarks.Add(bookmarkName, ref rng); 
}

L'exemple de code suivant peut être utilisé dans un complément d'application. Cet exemple utilise le document actif.

    Dim rng As Object = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText
    Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    Word.Document document = this.Application.ActiveDocument;
    document.Bookmarks.Add(bookmarkName, ref rng);
}

Voir aussi

Tâches

Comment : insérer du texte dans les documents Word

Concepts

Vue d'ensemble du modèle objet Word

Bookmark, contrôle

Partager via