Funzione UiaNodeFromPoint (uiautomationcoreapi.h)

Articolo
03/13/2024

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce COM (Component Object Model) di Microsoft Automazione interfaccia utente.

Recupera il nodo Automazione interfaccia utente per l'elemento nel punto specificato.

Sintassi

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

Parametri

[in] x

Tipo: double

Coordinata orizzontale del punto.

[in] y

Tipo: double

Coordinata verticale del punto.

[in] pRequest

Tipo: UiaCacheRequest*

Indirizzo di una struttura UiaCacheRequest che contiene la richiesta di cache per le informazioni dal client.

[out] ppRequestedData

Tipo: SAFEARRAY**

Indirizzo di una variabile che riceve un puntatore a un SAFEARRAY che contiene i dati richiesti. Questo parametro viene passato non inizializzato.

[out] ppTreeStructure

Tipo: BSTR*

Indirizzo di una variabile che riceve la descrizione della struttura ad albero. Questo parametro viene passato non inizializzato. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

L'elemento restituito sarà l'elemento più vicino nella struttura ad albero Automazione interfaccia utente che corrisponde ai criteri specificati.

La struttura ad albero è descritta da una stringa in cui ogni carattere è "p" o ")". Il primo carattere nella stringa rappresenta sempre il nodo radice. La stringa è NULL se nessun elemento viene restituito dalla funzione .

Un "p" rappresenta un nodo (elemento Automazione interfaccia utente). Quando una "p" segue direttamente un'altra, il secondo nodo è un elemento figlio del primo. Un ")" rappresenta un passaggio indietro dell'albero. Ad esempio, "pp)p" rappresenta un nodo seguito da due nodi figlio di pari livello l'uno dall'altro. In "pp))p", l'ultimo nodo è un elemento di pari livello del primo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Condividi tramite