Bookmark.MoveStartUntil(Object, Object) 方法

定義

命名空間:

Microsoft.Office.Tools.Word

組件:

Microsoft.Office.Tools.Word.dll

移動 Bookmark 控制項的起始位置，直到在文件中找到其中一個所指定的字元為止。

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

abstract member MoveStartUntil : obj * obj -> int

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

參數

cset

Object

一個或多個字元。 這個引數會區分大小寫。

count

Object

Bookmark 控制項要移動的最大字元數目。 可以是數字，或者是 wdForward 或 wdBackward 常數。 如果 Count 為正數， Bookmark 則會在檔中向前移動控件。 如果它是負數，則 Bookmark 控制項會往後移動。 預設值是 wdForward。

傳回

Int32

Bookmark 控制項的起始位置所移動的字元數目。 如果 Count 大於 0 (零)，這個方法會傳回所移動的字元數加 1。 如果 Count 小於 0 (零)，這個方法會傳回所移動的字元數減 1。 如果找不到 Cset 字元，則不會變更 Bookmark 控制項，且此方法會傳回 0 (零)。

範例

下列程式代碼範例會將含有文字的控件新增 Bookmark 至第一個段落，然後移動書籤的範圍，直到找到空格為止。

此範例適用於檔層級自定義。

private void BookmarkMoveStartUntil()
{
    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.";
 
    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark1.MoveStartUntil(ref cSet, ref Count);
}

Private Sub BookmarkMoveStartUntil()

    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."

    Bookmark1.MoveStartUntil(" ", Bookmark1.Characters.Count)
End Sub

備註

如果移動是透過檔向後移動，則會 Bookmark 展開控件。

如果開始位置往前移動至結束位置以外的點，控件 Bookmark 會折疊，而且開始和結束位置都會一起移動。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。