Bookmark.Characters Property (2007 System)

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

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

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public ReadOnly Property Characters As Characters
'Usage
Dim instance As Bookmark 
Dim value As Characters 

value = instance.Characters
[BrowsableAttribute(false)]
public Characters Characters { get; }
[BrowsableAttribute(false)]
public:
property Characters^ Characters {
    Characters^ get ();
}
public function get Characters () : Characters

Property Value

Type: 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 Class

Bookmark Members

Microsoft.Office.Tools.Word Namespace