Метод ITextRangeProvider::MoveEndpointByUnit (uiautomationcore.h)

Перемещает одну конечную точку текстового диапазона на указанное количество единиц TextUnit в диапазоне документов.

Синтаксис

HRESULT MoveEndpointByUnit(
                TextPatternRangeEndpoint endpoint,
                TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *pRetVal
);

Параметры

endpoint

unit

[in] count

Тип: int

Число перемещаемых единиц. При положительном значении выполняется перемещение вперед. При отрицательном значении выполняется перемещение назад. При значении 0 перемещение не выполняется.

[out, retval] pRetVal

Тип: int*

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Конечная точка перемещается вперед или назад, как указано, к следующей доступной границе единицы. Если исходная конечная точка находилась на границе указанной текстовой единицы, конечная точка перемещается на следующую границу доступной текстовой единицы, как показано на следующем рисунке.

Если перемещаемая конечная точка пересекает другую конечную точку того же текстового диапазона, то другая конечная точка также перемещается, что приводит к вырождению диапазона и обеспечению правильного упорядочения конечной точки (то есть начало всегда меньше или равно концу).

ITextRangeProvider::MoveEndpointByUnit устаревает до следующей поддерживаемой текстовой единицы, если данный блок текста не поддерживается элементом управления .

Здесь приведен порядок от наименьшей единицы до наибольшего.

• Символ
• Формат
• Word
• Линия
• Paragraph
• Страница
• Document

Поведение диапазона при значении единицы измеренияTextUnit::Format

TextUnit::Format как значение единицы позиционирует границу текстового диапазона для расширения или перемещения диапазона на основе атрибутов общего текста (формата) текста в диапазоне. Однако при использовании текстового блока форматирования не следует перемещать или разворачивать текстовый диапазон через границу внедренного объекта, например изображения или гиперссылки. Дополнительные сведения см. в разделе модель автоматизации пользовательского интерфейса текстовых единиц или Шаблоны элементов управления Text и TextRange.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcore.h (включая UIAutomation.h)

См. также раздел

Основные понятия

ITextProvider

ITextRangeProvider

Справочные материалы

Шаблоны элементов управления Text и TextRange

Общие сведения о поставщиках автоматизации пользовательского интерфейса