ITextRange.EndOf(TextRangeUnit, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает или расширяет текстовый диапазон до конца ближайшей указанной текстовой единицы. Текстовый диапазон перемещается или расширяется в документе.
public:
int EndOf(TextRangeUnit unit, bool extend);int EndOf(TextRangeUnit const& unit, bool const& extend);public int EndOf(TextRangeUnit unit, bool extend);function endOf(unit, extend)Public Function EndOf (unit As TextRangeUnit, extend As Boolean) As IntegerПараметры
- unit
- TextRangeUnit
Единица измерения для перемещения конечной позиции текстового диапазона.
- extend
-
Boolean
bool
Значение True расширяет текстовый диапазон, перемещая только конец диапазона в конец указанной единицы. Значение False перемещает оба конца текстового диапазона в конец указанного блока. Значением по умолчанию является false.
Возвращаемое значение
int
Количество позиций символов, в которых был перемещен или расширен диапазон, плюс 1, если текстовый диапазон свернулся до начала диапазона. Если текстовый диапазон включает окончательный возврат каретки (CR) в конце истории, а расширение имеет значение false, возвращаемое значение устанавливается в –1, чтобы указать, что сворачивание произошло до конца диапазона. Это связано с тем, что точка вставки не может существовать за пределами окончательного CR.
Комментарии
Если диапазон является точкой вставки на границе между единицами, метод EndOf не изменяет конечное положение диапазона.