Bookmark.MoveStartUntil(Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает начальное положение элемента управления Bookmark до тех пор, пока в документе не будет найден один из указанных знаков.
public int MoveStartUntil (ref object cset, ref object count);
Параметры
- cset
- Object
Один или несколько знаков. Аргумент вводится с учетом регистра букв.
- count
- Object
Максимальное число знаков, на которое перемещается элемент управления Bookmark. Может быть числом или одной из двух констант: wdForward либо wdBackward. Если значение параметра Count положительно, элемент управления Bookmark перемещается вперед по документу. Если значение отрицательно, элемент управления Bookmark перемещается назад. Значение по умолчанию — wdForward.
Возвращаемое значение
Число знаков, на которое переместилось начальное положение элемента управления Bookmark. Если значение параметра Count больше 0 (нуля), этот метод возвращает число перемещенных знаков, увеличенное на 1. Если значение параметра Count меньше 0 (нуля), этот метод возвращает число перемещенных знаков, уменьшенное на 1. Если знаки из набора Cset не найдены, элемент управления Bookmark не изменяется, а метод возвращает значение 0 (ноль).
Примеры
Следующий пример кода добавляет Bookmark элемент управления с текстом в первый абзац, а затем перемещает диапазон закладки до тех пор, пока не найдет пробел.
Этот пример предназначен для настройки на уровне документа.
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);
}
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
Комментарии
Если перемещение перемещается назад по документу, Bookmark элемент управления расширяется.
Если начальная позиция перемещается вперед к точке, расположенной за концом, Bookmark элемент управления сворачивается, а начальное и конечное положение перемещаются вместе.
Необязательные параметры
Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.