Метод IUIAutomationTextPattern::GetVisibleRanges (uiautomationclient.h)

  • Статья

Извлекает массив несвязанных текстовых диапазонов из текстового элемента управления, где каждый текстовый диапазон представляет непрерывный диапазон видимого текста.

Синтаксис

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

Параметры

[out, retval] ranges

Тип: IUIAutomationTextRangeArray**

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

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

Тип: HRESULT

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

Комментарии

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

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

IUIAutomationTextPattern::GetVisibleRanges извлекает вырожденный (пустой) текстовый диапазон, если текст не отображается, если весь текст прокручивается вне представления или если текстовый элемент управления не содержит текста.

Требования

Требование Значение
Минимальная версия клиента 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)

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

IUIAutomationTextPattern

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