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

public int MoveStartWhile(
    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 с текстом, после чего диапазон закладки перемещается до тех пор, пока удается найти знаки T, h, i или s.

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

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

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

Разрешения

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

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