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

public int MoveStartUntil(
    ref Object Cset,
    ref Object Count
)

Параметры

Cset
Тип: System.Object%
Один или несколько знаков. Аргумент вводится с учетом регистра букв.

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

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

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

Заметки

При перемещении назад по документу элемент управления Bookmark расширяется.

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

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

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

Примеры

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

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

Private Sub BookmarkMoveStartUntil()

    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.MoveStartUntil(" ", Bookmark1.Characters.Count)
End Sub

private void BookmarkMoveStartUntil()
{
    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 = " ";

    bookmark1.MoveStartUntil(ref cSet, ref Count);
}

Разрешения

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

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