Bookmark.MoveStartWhile - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Function MoveStartWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

Bookmark Интерфейс

Microsoft.Office.Tools.Word - пространство имен

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