Bookmark.GoTo 方法
获取一个 Range 对象,该对象表示 Bookmark 控件中某个项的起始位置。
命名空间: Microsoft.Office.Tools.Word
程序集: Microsoft.Office.Tools.Word(在 Microsoft.Office.Tools.Word.dll 中)
语法
声明
Function GoTo ( _
ByRef What As Object, _
ByRef Which As Object, _
ByRef Count As Object, _
ByRef Name As Object _
) As Range
Range GoTo(
ref Object What,
ref Object Which,
ref Object Count,
ref Object Name
)
参数
- What
类型:System.Object%
在 Range 中检索的项的类型。可以是 WdGoToItem 常数之一。
- Which
类型:System.Object%
在 Range 中检索的项可以是 WdGoToDirection 常数之一。
- Count
类型:System.Object%
文档中项的编号。默认值为 1。
只有正数值才有效。若要指定位于 Bookmark 控件之前的项,请使用 wdGoToPrevious 作为 Which 参数,并指定一个 Count 值。
- Name
类型:System.Object%
如果 What 参数是 wdGoToBookmark、wdGoToComment、wdGoToField 或 wdGoToObject,则此参数指定一个名称。
返回值
类型:Microsoft.Office.Interop.Word.Range
Range 对象。
备注
如果将 GoTo 方法与 wdGoToGrammaticalError、wdGoToProofreadingError 或 wdGoToSpellingError 常数一起使用,则返回的 Range 将包括任何有语法错误的文本或有拼写错误的文本。
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例向第一个段落插入一个带有拼写错误的文本的 Bookmark 控件,然后转到该书签中的第一个拼写错误,并在消息框中显示其位置。
此示例针对的是文档级自定义项。
Private Sub BookmarkGoTo()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "This bookmark contains spellling erors."
Dim Range1 As Word.Range = Bookmark1.GoTo( _
What:=Word.WdGoToItem.wdGoToSpellingError, _
Which:=Word.WdGoToDirection.wdGoToFirst)
MessageBox.Show("The first spelling error in Bookmark1 " & _
"is at position " & Range1.Start.ToString)
End Sub
private void BookmarkGoTo()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "This bookmark contains spellling erors.";
object What = Word.WdGoToItem.wdGoToSpellingError;
object Which = Word.WdGoToDirection.wdGoToFirst;
Word.Range range1 = bookmark1.GoTo(ref What, ref Which, ref missing,
ref missing);
MessageBox.Show("The first spelling error in bookmark1 is at position "
+ range1.Start.ToString());
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。