Método ITextProvider2::GetCaretRange (uiautomationcore.h)

Proporciona 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]         BOOL               *isActive,
  [out, retval] ITextRangeProvider **pRetVal
);

Parámetros

[out] 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] pRetVal

Tipo: ITextRangeProvider**

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 esFALSE, 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 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	uiautomationcore.h (include UIAutomation.h)

Consulte también

ITextProvider2