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

  • Статья

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

Синтаксис

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

Параметры

[out, retval] pRetVal

Тип: SAFEARRAY**

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

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

Тип: HRESULT

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

Комментарии

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

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

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

Требования

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

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

Рекомендации по использованию безопасных массивов

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

ITextProvider

ITextRangeProvider

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

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