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

  • Статья

Извлекает коллекцию диапазонов текста, представляющую текущий выделенный текст в текстовом элементе управления.

Синтаксис

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

Параметры

[out, retval] ranges

Тип: IUIAutomationTextRangeArray**

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

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

Тип: HRESULT

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

Комментарии

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

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

Если элемент управления содержит точку вставки текста, но текст не выбран, коллекция ranges получает дегенерированный (пустой) текстовый диапазон в позиции точки вставки текста.

Если элемент управления не содержит точку вставки текста или не поддерживает выделение текста, диапазоны будут иметь значение NULL.

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

Требования

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

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