Метод ITextProvider::GetVisibleRanges (uiautomationcore.h)

Статья
08/26/2023

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

Синтаксис

HRESULT GetVisibleRanges(
  [out, retval] SAFEARRAY **pRetVal
);

Параметры

[out, retval] pRetVal

Тип: SAFEARRAY**

Получает адрес массива указателей на интерфейсы ITextRangeProvider видимых текстовых диапазонов или пустого массива. Ссылка NULL никогда не возвращается. Этот параметр передается неинициализированным.

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

Тип: HRESULT

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

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

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

Требования


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