Compartir a través de

Función UiaNodeFromPoint (uiautomationcoreapi.h)

  • Artículo
Nota Esta función está en desuso. En su lugar, las aplicaciones cliente deben usar las interfaces del Modelo de objetos componentes (COM) de Microsoft Automatización de la interfaz de usuario.
 
Recupera el nodo Automatización de la interfaz de usuario para el elemento en el punto especificado.

Sintaxis

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parámetros

[in] x

Tipo: double

Coordenada horizontal del punto.

[in] y

Tipo: double

Coordenada vertical del punto.

[in] pRequest

Tipo: UiaCacheRequest*

Dirección de una estructura UiaCacheRequest que contiene la solicitud de caché para obtener información del cliente.

[out] ppRequestedData

Tipo: SAFEARRAY**

Dirección de una variable que recibe un puntero a un SAFEARRAY que contiene los datos solicitados. Este parámetro se pasa sin inicializar.

[out] ppTreeStructure

Tipo: BSTR*

Dirección de una variable que recibe la descripción de la estructura de árbol. Este parámetro se pasa sin inicializar. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o si un valor de error de lo contrario.

Comentarios

El elemento devuelto será el elemento más cercano de la estructura de árbol Automatización de la interfaz de usuario que coincida con los criterios especificados.

La estructura de árbol se describe mediante una cadena donde cada carácter es "p" o ")". El primer carácter de la cadena siempre representa el nodo raíz. La cadena es NULL si la función no devuelve ningún elemento.

Una "p" representa un nodo (Automatización de la interfaz de usuario elemento). Cuando una "p" sigue directamente a otra, el segundo nodo es un elemento secundario del primero. Una ")" representa un paso hacia arriba del árbol. Por ejemplo, "pp)p" representa un nodo seguido de dos nodos secundarios que son del mismo nivel entre sí. En "pp))p", el último nodo es un elemento relacionado del primero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll