Bookmark.MoveEndUntil(Object, Object) メソッド

定義

名前空間:

Microsoft.Office.Tools.Word

アセンブリ:

Microsoft.Office.Tools.Word.dll

Bookmark コントロールの終了位置を、指定の文字のいずれかが文書内に見つかるまで移動します。

public int MoveEndUntil (ref object cset, ref object count);

abstract member MoveEndUntil : obj * obj -> int

Public Function MoveEndUntil (ByRef cset As Object, Optional ByRef count As Object) As Integer

パラメーター

cset

Object

1 つまたは複数の文字。 この引数では、大文字と小文字が区別されます。

count

Object

Bookmark コントロールを移動する最大文字数。 数値、または wdForward 定数または wdBackward 定数のどちらかです。 が正の数の場合 Count 、 Bookmark コントロールは文書内で前方に移動します。 負の数であれば、Bookmark コントロールは逆方向に移動します。 既定値は wdForward です。

戻り値

Int32

Bookmark コントロールの終了位置が移動した文字数。 Count が 0 (ゼロ) よりも大きい場合、このメソッドは移動した文字数に 1 を足した値を返します。 Count が 0 (ゼロ) よりも小さい場合、このメソッドは移動した文字数から 1 を引いた値を返します。 Cset の文字が見つからない場合、Bookmark コントロールは変更されず、メソッドは 0 (ゼロ) を返します。

例

次のコード例では、テキストを Bookmark 含むコントロールを最初の段落に追加し、最初のブックマークの 3 番目の単語に別 Bookmark のコントロールを追加します。 次に、2 番目のブックマークの範囲を、文字 k が見つかるまで移動します。

この例は、ドキュメント レベルのカスタマイズ用です。

private void BookmarkMoveEndUntil()
{
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = "k";

    bookmark2.MoveEndUntil(ref cSet, ref Count);
}

Private Sub BookmarkMoveEndUntil()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveEndUntil("k", Bookmark1.Characters.Count)
End Sub

注釈

ドキュメント内で移動が進む場合は、 Bookmark コントロールが展開されます。

終了位置が元の開始位置の前のポイントに後方に移動した場合、開始位置は新しい終了位置に設定されます。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。