Share via


Bookmark.Text Property

Gets or sets the text in the Bookmark control.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Property Text As String
string Text { get; set; }

Property Value

Type: System.String
The text of the Bookmark control.

Remarks

The Text property returns the plain, unformatted text of the bookmark. When you set this property, the text of the Bookmark control is replaced.

Setting the Bookmark.Text property does not delete the bookmark.

Setting the Bookmark.Text property of a bookmark that spans multiple table cells will set the text within the first cell only. If the bookmark contains the entire table and surrounding text, the entire table will be deleted.

For information about setting the Bookmark.Text property of a bookmark that overlaps another bookmark, see Bookmark Control.

Examples

The following code example adds a Bookmark control with text and then displays the total number of characters in the bookmark using the ComputeStatistics method.

This example is for a document-level customization.

Private Sub BookmarkComputeStatistics()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text." 

    Dim totalCharacters As Integer = Bookmark1.ComputeStatistics( _
        Word.WdStatistic.wdStatisticCharacters)
    MessageBox.Show("The bookmark contains " & _
        totalCharacters.ToString() & " characters.")

End Sub
private void BookmarkComputeStatistics()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";
    int totalCharacters = bookmark1.ComputeStatistics(Word
        .WdStatistic.wdStatisticCharacters);
    MessageBox.Show("The bookmark contains " + 
        totalCharacters.ToString() + " characters.");
}

.NET Framework Security

See Also

Reference

Bookmark Interface

Microsoft.Office.Tools.Word Namespace