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

Определение

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

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

Параметры

cset
Object

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

count
Object

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

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

Int32

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

Примеры

Следующий пример кода добавляет Bookmark элемент управления с текстом в первый абзац, а затем перемещает диапазон закладки, когда он может найти символы T, h, i или s.

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

private void BookmarkMoveStartWhile()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";

    object Count = bookmark1.Characters.Count;
    object cSet = "This";

    bookmark1.MoveStartWhile(ref cSet, ref Count);
}
Private Sub BookmarkMoveStartWhile()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text."

    Bookmark1.MoveStartWhile("This", Bookmark1.Characters.Count)
End Sub

Комментарии

Хотя любой символ в Cset обнаруживается, начальное расположение Bookmark элемента управления перемещается.

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

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

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

Применяется к