Bookmark.GoTo Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает объект Range, представляющий начальное положение элемента в элементе управления Bookmark.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Function GoTo ( _
    ByRef What As Object, _
    ByRef Which As Object, _
    ByRef Count As Object, _
    ByRef Name As Object _
) As Range
'Применение
Dim instance As Bookmark
Dim What As Object
Dim Which As Object
Dim Count As Object
Dim Name As Object
Dim returnValue As Range

returnValue = instance.GoTo(What, Which, _
    Count, Name)

public 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());
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через