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

  • Статья

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

Синтаксис

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

Параметры

[in] endpoint

Тип: TextPatternRangeEndpoint

Конечная точка для перемещения.

[in] unit

Тип: TextUnit

Тип текстовых единиц, таких как символ, слово, абзац и т. д.

[in] count

Тип: int

Количество единиц перемещения. Положительное значение перемещает конечную точку вперед. Отрицательное значение перемещается назад. Значение 0 не действует.

[out, retval] pRetVal

Тип: int*

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

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

Тип: HRESULT

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

Замечания

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

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

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

Порядок, от наименьшей единицы до наибольшего, указан здесь.

  • символ
  • Форматирование
  • Word
  • строки
  • абзац
  • страницы
  • документ

поведение диапазона при единицTextUnit::Format

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2003 [классические приложения | Приложения UWP]
целевая платформа Виндоус
заголовка uiautomationcore.h (include UIAutomation.h)

См. также

концептуальные

ITextProvider

ITextRangeProvider

Справочник

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

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