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
)
參數
- range
型別:Microsoft.Office.Interop.Word.Range
提供控制項繫結的 Range。
- name
型別:System.String
可用於索引 ControlCollection 執行個體中的控制項之名稱。
傳回值
型別: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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。