Freigeben über


Gewusst wie: Programmgesteuertes Aktualisieren von Lesezeichentext

Sie können Text in ein Platzhalterlesezeichen in einem Microsoft Office Word-Dokument einfügen, sodass Sie den Text später abfragen oder Text in einem Lesezeichen ersetzen können.Wenn Sie eine Anpassung auf Dokumentebene entwickeln, können Sie auch Text in einem Microsoft.Office.Tools.Word.Bookmark-Steuerelement aktualisieren, das an Daten gebunden ist.Weitere Informationen finden Sie unter Binden von Daten an Steuerelemente in Office-Projektmappen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Word 2013 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Es gibt zwei verschiedene Bookmark-Objekttypen:

Wenn Sie einem Lesezeichen Text zuordnen, unterscheidet sich das Verhalten zwischen einem Microsoft.Office.Interop.Word.Bookmark und einem Microsoft.Office.Tools.Word.Bookmark.Weitere Informationen finden Sie unter Bookmark-Steuerelement.

Verwenden von Hoststeuerelementen

So aktualisieren Sie Inhalte mit einem Bookmark-Steuerelement

  1. Erstellen Sie eine Prozedur, die sowohl ein bookmark-Argument für den Namen des Lesezeichens als auch ein newText-Argument für die Zeichenfolge akzeptiert, die der Text-Eigenschaft zugewiesen werden soll.

    HinweisHinweis

    Durch Zuweisen von Text zu einer Bookmark.Text-Eigenschaft oder Bookmark.FormattedText-Eigenschaft eines Microsoft.Office.Tools.Word.Bookmark-Steuerelements wird das Lesezeichen nicht gelöscht.

    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. Weisen Sie die newText-Zeichenfolge der Text-Eigenschaft des Microsoft.Office.Tools.Word.Bookmark zu.

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

Verwenden von Word-Objekten

So aktualisieren Sie Lesezeicheninhalte mit einem Bookmark-Objekt in Word

  1. Erstellen Sie eine Prozedur mit einem bookmark-Argument für den Namen des Microsoft.Office.Interop.Word.Bookmark und einem newText-Argument für die Zeichenfolge, die der Range.Text-Eigenschaft des Lesezeichens zugewiesen werden soll.

    HinweisHinweis

    Durch Zuweisen von Text zu einem systemeigenen Microsoft.Office.Interop.Word.Bookmark-Objekt in Word wird das Lesezeichen gelöscht.

    Friend Sub BookMarkReplaceNative( _
        ByVal bookmark As Word.Bookmark, _
        ByVal newText As String)
    
    internal void BookMarkReplaceNative(
        Word.Bookmark bookmark, 
        string newText)
    {
    
  2. Weisen Sie der Range.Text-Eigenschaft des Lesezeichens die Zeichenfolge newText zu, wodurch das Lesezeichen automatisch gelöscht wird.Fügen Sie dann das Lesezeichen wieder der Bookmarks-Auflistung hinzu.

    Das folgende Codebeispiel kann in einer Anpassung auf Dokumentebene verwendet werden.

        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); 
    }
    

    Das folgende Codebeispiel kann in einem Add-In auf Anwendungsebene verwendet werden.In diesem Beispiel wird das aktive Dokument verwendet.

        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);
    }
    

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuertes Einfügen von Text in Word-Dokumente

Konzepte

Bookmark-Steuerelement

Weitere Ressourcen

Übersicht über das Word-Objektmodell