共用方式為


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 引數的長度為 0。

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 命名空間