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

Метод IUIAutomationTextRange::ExpandToEnclosingUnit (uiautomationclient.h)

  • Статья

Нормализует диапазон текста по заданной единице текста. Диапазон расширяется, если он меньше указанной единицы, или сокращается, если он длиннее указанной единицы.

Синтаксис

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit textUnit
);

Параметры

[in] textUnit

Тип: TextUnit

Блок текста, например строка или абзац.

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

Тип: HRESULT

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

Remarks

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

Несмотря на свое название, метод ExpandToEnclosingUnit не обязательно расширяет текстовый диапазон. Вместо этого он "нормализует" текстовый диапазон, перемещая конечные точки таким образом, чтобы диапазон охватывал указанную текстовую единицу. Диапазон расширяется, если он меньше указанной единицы, или сокращается, если он длиннее указанной единицы. Если диапазон уже является точным количеством указанных единиц, он остается неизменным. На следующей схеме показано, как ExpandToEnclosingUnit нормализует текстовый диапазон путем перемещения конечных точек диапазона.

Схема конечных точек до и после ExpandToEnclosingUnit

Схема конечных точек до и после ExpandToEnclosingUnit

По умолчанию в ExpandToEnclosingUnit используется следующая по величине поддерживаемая единица текста, если указанная текстовая единица не поддерживается элементом управления .

Порядок от наименьшей единицы к наибольшему выглядит следующим образом:

  • Символ
  • Формат
  • Word
  • Строка
  • Paragraph
  • Страница
  • Документ

ExpandToEnclosingUnit учитывает как видимый, так и скрытый текст.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header uiautomationclient.h (включая UIAutomation.h)

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

Интерфейс IUIAutomationTextRange, модель автоматизации пользовательского интерфейса поддержка текстового содержимого