Поделиться через

Метод ITextProvider2::GetCaretRange (uiautomationcore.h)

  • Статья

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

Синтаксис

HRESULT GetCaretRange(
  [out]         BOOL               *isActive,
  [out, retval] ITextRangeProvider **pRetVal
);

Параметры

[out] isActive

Тип: BOOL*

Значение TRUE , если текстовый элемент управления, содержащий курсор, имеет фокус клавиатуры, в противном случае — FALSE.

[out, retval] pRetVal

Тип: ITextRangeProvider**

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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

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

ITextProvider2