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

Статья
11/16/2008

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

Перемещает конечное положение элемента управления Bookmark до тех пор, пока в документе не будет найден один из указанных знаков.

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

Синтаксис

'Декларация
Public Function MoveEndUntil ( _
    ByRef Cset As Object, _
    ByRef Count As Object _
) As Integer
'Применение
Dim instance As Bookmark
Dim Cset As Object
Dim Count As Object
Dim returnValue As Integer

returnValue = instance.MoveEndUntil(Cset, _
    Count)

public int MoveEndUntil(
    ref Object Cset,
    ref Object Count
)

Параметры

Cset
Тип: System.Object%
Один или несколько знаков. Аргумент вводится с учетом регистра букв.

Count
Тип: System.Object%
Максимальное число знаков, на которое перемещается элемент управления Bookmark. Может быть числом или одной из двух констант: wdForward либо wdBackward. Если значение параметра Count положительно, элемент управления Bookmark перемещается вперед по документу. Если значение отрицательно, элемент управления Bookmark перемещается назад. Значение по умолчанию — wdForward.

Возвращаемое значение

Тип: System.Int32
Количество знаков, на которое переместилось конечное положение элемента управления Bookmark. Если значение параметра Count больше 0 (ноль), метод возвращает число перемещенных знаков плюс 1. Если значение параметра Count меньше 0 (ноль), метод возвращает число перемещенных знаков минус 1. Если знаки Cset не найдены, элемент управления Bookmark не изменяется, а метод возвращает значение 0 (ноль).

Заметки

При перемещении вперед по документу элемент управления Bookmark расширяется.

При перемещении конечного положения назад до точки, предшествующей исходному начальному положению, начальное положение устанавливается равным новому конечному положению.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В приведенном ниже примере кода в первый абзац документа добавляется элемент управления Bookmark с текстом, после чего для третьего слова в первой закладке добавляется другой элемент управления Bookmark. Затем в коде выполняется перемещение по диапазону второй закладки до тех пор, пока не будет найдена буква k.

В этом примере демонстрируется настройка уровня документа.

Private Sub BookmarkMoveEndUntil()
    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.MoveEndUntil("k", Bookmark1.Characters.Count)
End Sub

private void BookmarkMoveEndUntil()
{
    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 = "k";

    bookmark2.MoveEndUntil(ref cSet, ref Count);
}

Разрешения

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

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