Bookmark.Characters Property

Gets a Characters collection that represents the characters in a Bookmark control.

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

Syntax

'Declaration
ReadOnly Property Characters As Characters
Characters Characters { get; }

Property Value

Type: Microsoft.Office.Interop.Word.Characters
A Characters collection that represents the characters in a Bookmark control.

Examples

The following code example adds a Bookmark control with text to the document and then adds another Bookmark control to the sixth character of the first bookmark. The total number of bookmarks found within the bookmark are then displayed in a message box.

This example is for a document-level customization.

Private Sub BookmarkBookmarks()

    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."
    Bookmark1.Characters(6).Select()

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Application.Selection.Range, _
        "Bookmark2")
    MessageBox.Show("Total Bookmarks in bookmark1: " _
        & Bookmark1.Bookmarks.Count.ToString)

End Sub
private void BookmarkBookmarks()
{
    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.";
    bookmark1.Characters[6].Select();

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(Application.Selection.Range,
        "bookmark2");
    MessageBox.Show("Total Bookmarks in bookmark1: " +
        bookmark1.Bookmarks.Count);
}

.NET Framework Security

See Also

Reference

Bookmark Interface

Microsoft.Office.Tools.Word Namespace