ControlCollection.AddBookmark 方法 (Range, String)

在指定的范围内向文档添加一个新的 Bookmark 控件。

命名空间:  Microsoft.Office.Tools.Word
程序集:  Microsoft.Office.Tools.Word(在 Microsoft.Office.Tools.Word.dll 中)

语法

声明
Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark
Bookmark AddBookmark(
    Range range,
    string name
)

参数

返回值

类型:Microsoft.Office.Tools.Word.Bookmark
添加到 ControlCollection 实例的 Bookmark 控件。

异常

异常 条件
ArgumentNullException

name 或 range 参数为 nullnull 引用(在 Visual Basic 中为 Nothing),或者 name 参数长度为零。

ControlNameAlreadyExistsException

ControlCollection 实例中已存在一个同名控件。

InvalidRangeException

指定的范围无效。

备注

使用此方法可以将 Bookmark 控件添加到 ControlCollection 的末尾。

若要移除通过编程方式添加的 Bookmark 控件,请使用 Remove 方法。

示例

下面的代码示例向文档中添加一个 Bookmark 控件,然后向该书签添加文本。

Private Sub WordAddBookmark()
    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."
End Sub
private void WordAddBookmark()
{
    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.";
}

.NET Framework 安全性

请参见

参考

ControlCollection 接口

AddBookmark 重载

Microsoft.Office.Tools.Word 命名空间