Bookmark.MoveWhile(Object, Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當在文件中找到任何指定的字元時,就會移動 Bookmark 控制項。
public int MoveWhile (ref object cset, ref object count);
abstract member MoveWhile : obj * obj -> int
Public Function MoveWhile (ByRef cset As Object, Optional ByRef count As Object) As Integer
參數
- cset
- Object
一個或多個字元。 這個引數會區分大小寫。
- count
- Object
Bookmark 控制項要移動的最大字元數目。 可以是數字,或者是 wdForward 或 wdBackward 常數。 如果 Count
為正數, Bookmark 則控件會往前移動,從結束位置開始。 如果是負數,Bookmark 控制項便會從起始位置開始向後移動。 預設值是 wdForward。
傳回
Bookmark 控制項所移動的字元數目。 如果找不到 Cset
字元,則不會變更 Bookmark 控制項,且此方法會傳回 0 (零)。
範例
下列程式代碼範例會將含有文字的控件新增 Bookmark 至第一個段落,然後將另一個控件新增至第一個書籤中的第三個 Bookmark 字。 然後,程式代碼會折疊並移動第二個書籤,同時可以找到 b、o、o 或 k 字元。
此範例適用於檔層級自定義。
private void BookmarkMoveWhile()
{
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.";
Microsoft.Office.Tools.Word.Bookmark bookmark2 =
this.Controls.AddBookmark(bookmark1.Words[3],
"bookmark2");
object Count = bookmark1.Characters.Count;
object cSet = "book";
bookmark2.MoveWhile(ref cSet, ref Count);
}
Private Sub BookmarkMoveWhile()
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."
Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")
Bookmark2.MoveWhile("stamp", Bookmark1.Characters.Count)
End Sub
備註
找到中的任何 Cset
字元時,控件 Bookmark 會移動。 折 Bookmark 疊為零長度書籤。
選擇性參數
如需選擇性參數的資訊,請參閱 Office 方案中的選擇性參數。