Bookmark.MoveStartWhile 方法
只要在文档中找到任意指定字符,就移动 Bookmark 控件的起始位置。
命名空间: Microsoft.Office.Tools.Word
程序集: Microsoft.Office.Tools.Word(在 Microsoft.Office.Tools.Word.dll 中)
语法
声明
Function MoveStartWhile ( _
ByRef cset As Object, _
ByRef count As Object _
) As Integer
int MoveStartWhile(
ref Object cset,
ref Object count
)
参数
- cset
类型:System.Object%
一个或多个字符。此参数区分大小写。
- count
类型:System.Object%
要将 Bookmark 控件移动的最大字符数。可以是一个数字,也可以是 wdForward 或 wdBackward 常数。如果 Count 是正数,Bookmark 控件将在文档中向前移动。如果是负数,Bookmark 控件将向后移动。默认值为 wdForward。
返回值
类型:System.Int32
Bookmark 控件的起始位置被移动的字符数。如果未找到 Cset 字符,则不会更改 Bookmark 控件,并且该方法返回 0(零)。
备注
只要找到 Cset 中的任意字符,就移动 Bookmark 控件的起始位置。
如果将起始位置向前移动到超出原始结束位置的某个位置,则该结束位置将设置为新的起始位置。
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例向第一个段落添加一个带有文本的 Bookmark 控件,然后只要能够找到字符 T、h、i 或 s,就移动该书签的范围。
此示例针对的是文档级自定义项。
Private Sub BookmarkMoveStartWhile()
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.MoveStartWhile("This", Bookmark1.Characters.Count)
End Sub
private void BookmarkMoveStartWhile()
{
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 = "This";
bookmark1.MoveStartWhile(ref cSet, ref Count);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。