Partager via

Comment : mettre à jour le texte d'un signet par programmation

  • Article

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 dans les solutions Office.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Word 2013 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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

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

  1. 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)
{

  2. Attribuez la chaîne newText à la propriété Text de Microsoft.Office.Tools.Word.Bookmark.

        bookmark.Text = newText
End Sub

        bookmark.Text = newText;
}

Utilisation des objets Word

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

  1. 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)
{

  2. 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 par programmation

Concepts

Bookmark, contrôle

Autres ressources

Vue d'ensemble du modèle objet Word