Bookmark.MoveUntil - метод

Статья
08/11/2011

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

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

Синтаксис

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

int MoveUntil(
    ref Object cset,
    ref Object count
)

Параметры

cset
Тип: System.Object%
Один или несколько знаков.При нахождении любого знака из набора Cset до истечения значения Count элемент управления Bookmark размещается в точке вставки непосредственно перед найденным знаком.Аргумент вводится с учетом регистра букв.

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

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

Тип: System.Int32
Число знаков, на которое был перемещен элемент управления Bookmark.Если значение параметра Count больше 0 (ноль), этот метод возвращает число перемещенных знаков плюс один.Если значение параметра Count меньше 0 (ноль), этот метод возвращает число перемещенных знаков минус один.Если знаки из набора Cset не найдены, элемент управления Bookmark не изменяется, а метод возвращает значение 0 (ноль).

Заметки

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

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

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

Примеры

В приведенном ниже примере кода в первый абзац документа добавляется элемент управления Bookmark с текстом, после чего для третьего слова в первой закладке добавляется другой элемент управления Bookmark. Затем в коде перемещается диапазон второй закладки, пока удается найти пробел.

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

Private Sub BookmarkMoveUntil()

    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."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveUntil(" ", Bookmark1.Characters.Count)
End Sub

private void BookmarkMoveUntil()
{
    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.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

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

    bookmark2.MoveUntil(ref cSet, ref Count);
}

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

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

См. также

Ссылки

Bookmark Интерфейс

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

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