Bookmark.MoveEndWhile 方法
只要在文档中找到任意指定字符,就移动 Bookmark 控件的结束字符位置。
命名空间: Microsoft.Office.Tools.Word
程序集: Microsoft.Office.Tools.Word(在 Microsoft.Office.Tools.Word.dll 中)
语法
声明
Function MoveEndWhile ( _
ByRef cset As Object, _
ByRef count As Object _
) As Integer
int MoveEndWhile(
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 控件,然后向第一个书签中的第三个单词添加另一个 Bookmark 控件。 然后只要该代码能够找到字符 b、o、o、k、m、a、r 或 k,它便移动第二个书签的范围。
此示例针对的是文档级自定义项。
Private Sub BookmarkMoveEndWhile()
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.MoveEndWhile("bookmark", Bookmark1.Characters.Count)
End Sub
private void BookmarkMoveEndWhile()
{
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 = "bookmark";
bookmark2.MoveEndWhile(ref cSet, ref Count);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。