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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。