Bookmark.Text Property (2007 System)
Gets or sets the text in the Bookmark control.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)
Syntax
'Declaration
<BindableAttribute(True)> _
Public Property Text As String
'Usage
Dim instance As Bookmark
Dim value As String
value = instance.Text
instance.Text = value
[BindableAttribute(true)]
public string Text { get; set; }
[BindableAttribute(true)]
public:
property String^ Text {
String^ get ();
void set (String^ value);
}
public function get Text () : String
public function set Text (value : String)
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
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.