Bookmark.MoveEndWhile - метод

Статья
08/11/2011

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

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

Синтаксис

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

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

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

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

См. также

Ссылки

Bookmark Интерфейс

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

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