Comment : mettre à jour le texte d'un signet par programmationHow to: Programmatically Update Bookmark Text

Vous pouvez insérer un texte dans un signet d'espace réservé d'un document Microsoft Office Word afin de pouvoir récupérer le texte ultérieurement, ou pour remplacer le texte d'un signet.You can insert text into a placeholder bookmark in a Microsoft Office Word document so that you can retrieve the text at a later time, or to replace text in a bookmark. Si vous développez une personnalisation au niveau du document, vous pouvez également mettre à jour le texte dans un contrôle Bookmark lié aux données.If you are developing a document-level customization, you can also update text in a Bookmark control that is bound to data. Pour plus d’informations, consultez liaison de données aux contrôles dans les Solutions Office.For more information, see Binding Data to Controls in Office Solutions.

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.

L'objet Bookmark peut être de deux types :The bookmark object can be one of two types:

Utilisation des contrôles hôtesUsing Host Controls

Pour mettre à jour le contenu d'un signet à l'aide d'un contrôle BookmarkTo update bookmark contents using a Bookmark control

  1. Créez une procédure qui accepte un argument bookmark comme nom du signet et un argument newText comme chaîne à attribuer à la propriété Text.Create a procedure that takes a bookmark argument for the name of the bookmark, and a newText argument for the string to assign to the Text property.

    Note

    L'affectation de texte à la propriété Text ou FormattedText d'un contrôle Bookmark n'entraîne pas la suppression du signet.Assigning text to the Text or FormattedText property of a Bookmark control does not cause the bookmark to be deleted.

    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. Affecter le newText de chaîne pour le Text propriété de la Bookmark.Assign the newText string to the Text property of the Bookmark.

        bookmark.Text = newText
    End Sub
    
        bookmark.Text = newText;
    }
    

Utilisation des objets WordUsing Word Objects

Pour mettre à jour le contenu d'un signet à l'aide d'un objet Bookmark WordTo update bookmark contents using a Word Bookmark object

  1. Créez une procédure qui accepte un argument bookmark comme nom du Bookmark et un argument newText comme chaîne à attribuer à la propriété Text du signet.Create a procedure that has a bookmark argument for the name of the Bookmark, and a newText argument for the string to assign to the Text property of the bookmark.

    Note

    L'assignation de texte à un objet Word Bookmark natif entraîne la suppression du signet.Assigning text to a native Word Bookmark object causes the bookmark to be deleted.

    Friend Sub BookMarkReplaceNative( _
        ByVal bookmark As Word.Bookmark, _
        ByVal newText As String)
    
    internal void BookMarkReplaceNative(
        Word.Bookmark bookmark, 
        string newText)
    {
    
  2. Affecter le newText de chaîne pour le Text propriété de signet, ce qui supprime automatiquement le signet.Assign the newText string to the Text property of the bookmark, which automatically deletes the bookmark. Puis, ajoutez de nouveau le signet à la collection Bookmarks.Then re-add the bookmark to the Bookmarks collection.

    Vous pouvez utiliser l’exemple de code suivant dans une personnalisation au niveau du document.The following code example can be used in a document-level customization.

        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 VSTO.The following code example can be used in a VSTO Add-in. Cet exemple utilise le document actif.This example uses the active document.

        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 aussiSee Also

Comment : insérer du texte dans des Documents Word par programmation How to: Programmatically Insert Text into Word Documents
Vue d’ensemble du modèle d’objet Word Word Object Model Overview
Bookmark, contrôleBookmark Control