Método ITextProvider::RangeFromPoint (uiautomationcore.h)

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

Sintaxis

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Parámetros

[in] point

Tipo: UiaPoint

Ubicación en las coordenadas de la pantalla.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Recibe un puntero al intervalo de texto degenerado (vacío) más cercano a la ubicación especificada. Este parámetro se pasa sin inicializar.

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 incluye un objeto secundario si las coordenadas de pantalla están dentro de las coordenadas de una imagen, un hipervínculo u otro objeto incrustado.

Dado que ITextProvider::RangeFromPoint no omite el texto oculto, se devuelve un intervalo degenerado del texto visible más cercano al punto especificado.

La propiedad nunca devuelve NULL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	uiautomationcore.h (include UIAutomation.h)

Consulte también

Conceptual

ITextProvider

ITextRangeProvider

Referencia

Información general sobre proveedores de UI Automation