Freigeben über

Programmgesteuertes Aktualisieren von Textmarkentext

  • Artikel

Sie können Text in ein Platzhalterlesezeichen in einem Microsoft Office Word-Dokument einfügen, um den Text zu einem späteren Zeitpunkt abzurufen oder Text in einem Lesezeichen zu ersetzen. Wenn Sie eine Anpassung auf Dokumentebene entwickeln, können Sie auch Text in einem an Daten gebundenen Bookmark-Steuerelement aktualisieren. Weitere Informationen finden Sie unter Binden von Daten an Steuerelemente in Office-Lösungen.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Das Lesezeichenobjekt kann einem von zwei Typen entsprechen:

  • Einem Bookmark-Hoststeuerelement.

    Bookmark-Steuerelemente erweitern systemeigene Bookmark-Objekte, indem sie die Datenbindung aktivieren und Ereignisse verfügbar machen. Weitere Informationen zu Hoststeuerelementen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.

  • Ein systemeigenes Bookmark-Objekt.

    Bookmark-Objekte verfügen über keine Ereignisse oder Datenbindungsfunktionen.

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

Verwenden von Hoststeuerelementen

So aktualisieren Lesezeicheninhalte mithilfe des Lesezeichen-Steuerelements

  1. Erstellen Sie eine Prozedur, die ein bookmark-Argument für den Namen des Lesezeichens akzeptiert, und einnewText-Argument für die Zeichenfolge zum Zuweisen der Text-Eigenschaft.

    Hinweis

    Die Zuweisung von Text zu den Eigenschaften Text oder FormattedText eines Bookmark-Steuerelements führt nicht dazu, dass das Lesezeichen gelöscht wird.

    static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{

  2. Weisen Sie die newText-Zeichenfolge der Text Eigenschaft der Bookmark.

        bookmark.Text = newText;
}

Verwenden von Word-Objekten

So aktualisieren Lesezeicheninhalte mithilfe eines Word-Lesezeichenobjekts

  1. Erstellen Sie eine Prozedur, die ein bookmark-Argument für den Namen von Bookmark und ein newText-Argument für die Zeichenfolge zur Zuweisung zur Text-Eigenschaft des Lesezeichens enthält.

    Hinweis

    Die Zuweisung von Text zu einem systemeigenen Word-Bookmark-Objekt führt nicht dazu, dass das Lesezeichen gelöscht wird.

    internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{

  2. Weisen Sie der Eigenschaft der Textmarke die Text newText-Zeichenfolge zu, die die Textmarke automatisch löscht. Fügen Sie das Lesezeichen der Bookmarks-Auflistung dann erneut hinzu.

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

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

    bookmark.Range.Text = newText;

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

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

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

    bookmark.Range.Text = newText;

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

Zugehöriger Inhalt