Метод ITextProvider::GetSelection (uiautomationcore.h)
Извлекает коллекцию диапазонов текста, представляющую текущий выделенный текст в текстовом элементе управления.
Синтаксис
HRESULT GetSelection(
[out, retval] SAFEARRAY **pRetVal
);
Параметры
[out, retval] pRetVal
Тип: SAFEARRAY**
Получает адрес массива указателей на интерфейсы ITextRangeProvider текстовых диапазонов, по одному для каждого выделенного диапазона текста. Этот параметр передается неинициализированным.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Для поставщиков автоматизации пользовательского интерфейса, поддерживающих выбор текста, поставщик должен реализовать этот метод, а также вернуть значение ITextProvider::SupportedTextSelection .
Если элемент управления содержит только один диапазон выделенного текста, массив pRetVal должен содержать один текстовый диапазон.
Если элемент управления содержит точку вставки текста, но текст не выбран, массив pRetVal должен содержать диапазон вырожденного (пустого) текста в позиции точки вставки текста.
Если элемент управления не содержит выделенный текст или элемент управления не содержит точку вставки текста, задайте для параметра pRetValзначение NULL.
Требования
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | uiautomationcore.h (включая UIAutomation.h) |
См. также раздел
Рекомендации по использованию безопасных массивов
Основные понятия
Справочные материалы
Общие сведения о поставщиках автоматизации пользовательского интерфейса