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
)

パラメーター

  • 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 セキュリティ

  • 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

ControlCollection インターフェイス

AddBookmark オーバーロード

Microsoft.Office.Tools.Word 名前空間