Bookmark.MoveEndWhile Метод (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 MoveEndWhile ( _
    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.MoveEndWhile(Cset, _
    Count)

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

Параметры

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

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

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

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

Заметки

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

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

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

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

Примеры

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

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

Private Sub BookmarkMoveEndWhile()
    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.MoveEndWhile("bookmark", Bookmark1.Characters.Count)
End Sub

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

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

Разрешения

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

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