ControlCollection.AddBookmark メソッド (Range, String) (2007 System)
更新 : 2007 年 11 月
新しい Bookmark コントロールを指定された範囲で文書に追加します。
名前空間 : Microsoft.Office.Tools.Word
アセンブリ : Microsoft.Office.Tools.Word.v9.0 (Microsoft.Office.Tools.Word.v9.0.dll 内)
構文
'宣言
Public Function AddBookmark ( _
range As Range, _
name As String _
) As Bookmark
'使用
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As Bookmark
returnValue = instance.AddBookmark(range, _
name)
public Bookmark AddBookmark(
Range range,
string name
)
パラメータ
range
型 : Microsoft.Office.Interop.Word.Rangeコントロールの境界線となる Range。
name
型 : System.StringControlCollection インスタンス内のコントロールにインデックスを作成するために使用できる名前。
戻り値
型 : 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.";
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。