Bookmark.MoveEndWhile(Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Word

Сборка:

Microsoft.Office.Tools.Word.dll

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

public int MoveEndWhile (ref object cset, ref object count);

abstract member MoveEndWhile : obj * obj -> int

Public Function MoveEndWhile (ByRef cset As Object, Optional ByRef count As Object) As Integer

Параметры

cset

Object

Один или несколько знаков. Аргумент вводится с учетом регистра букв.

count

Object

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

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

Int32

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

Примеры

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

Этот пример предназначен для настройки на уровне документа.

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

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

Комментарии

При обнаружении любого символа Bookmark в Cset перемещается конечная позиция элемента управления.

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

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

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