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, используйте в качестве аргумента Which объект wdGoToPrevious и укажите значение 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
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.