Compartir a través de

Método IUIAutomationTextPattern::RangeFromPoint (uiautomationclient.h)

  • Artículo

Recupera el intervalo de texto degenerado (vacío) más cercano a las coordenadas de pantalla especificadas.

Sintaxis

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Parámetros

[in] pt

Tipo: POINT

Estructura que contiene la ubicación, en coordenadas de pantalla.

[out, retval] range

Tipo: IUIAutomationTextRange**

Recibe un puntero al intervalo de texto degenerado más cercano a la ubicación especificada.

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

Se devuelve un intervalo de texto que encapsula un objeto secundario si las coordenadas de pantalla están dentro de las coordenadas de una imagen, un hipervínculo, una hoja de cálculo de Microsoft Excel u otro objeto incrustado.

Dado que no se omite el texto oculto, este método recupera un intervalo degenerado del texto visible más cercano a las coordenadas especificadas.

La implementación de RangeFromPoint en Windows Internet Explorer 9 no devuelve el resultado esperado. En su lugar, los clientes deben:

  1. Llame al método GetVisibleRanges para recuperar una matriz de intervalos de texto visibles.
  2. Para cada intervalo de texto de la matriz, llame a IUIAutomationTextRange::GetBoundingRectangles para recuperar los rectángulos delimitadores.
  3. Compruebe los rectángulos delimitadores para buscar el intervalo de texto que ocupa las coordenadas de pantalla concretas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationTextPattern

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