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


Метод IUIAutomationTextPattern2::GetCaretRange (uiautomationclient.h)

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

Синтаксис

HRESULT GetCaretRange(
  [out, retval] BOOL                   *isActive,
  [out, retval] IUIAutomationTextRange **range
);

Параметры

[out, retval] isActive

Тип: BOOL*

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

[out, retval] range

Тип: IUIAutomationTextRange**

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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

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

IUIAutomationTextPattern2

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

Работа с текстовыми элементами управления