Método IUIAutomationTextPattern2::GetCaretRange (uiautomationclient.h)

Recupera un intervalo de texto de longitud cero en la ubicación del símbolo de intercalación que pertenece al control basado en texto.

Sintaxis

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

Parámetros

[out, retval] isActive

Tipo: BOOL*

TRUE si el control basado en texto que contiene el símbolo de intercalación tiene el foco del teclado; de lo contrario, FALSE.

[out, retval] range

Tipo: IUIAutomationTextRange**

Recibe un intervalo de texto que representa la ubicación actual del símbolo de intercalación que pertenece al control basado en texto.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si el parámetro isActive es FALSE, el símbolo de intercalación que pertenece al control basado en texto podría no estar en la misma ubicación que el símbolo de intercalación del sistema.

Este método recupera un intervalo de texto que un cliente puede usar para buscar el rectángulo delimitador del símbolo de intercalación que pertenece al control basado en texto o para buscar el texto cerca del símbolo de intercalación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationTextPattern2

compatibilidad de Automatización de la interfaz de usuario con contenido textual

Trabajar con controles basados en texto