Funzione UiaNodeFromFocus (uiautomationcoreapi.h)

Articolo
03/03/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 dell'interfaccia utente che attualmente ha lo stato attivo per l'input.

Sintassi

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parametri

[in] pRequest

Tipo: UiaCacheRequest*

Indirizzo di una struttura UiaCacheRequest che contiene informazioni sui dati da memorizzare nella cache.

[out] ppRequestedData

Tipo: SAFEARRAY**

Indirizzo di una variabile che riceve un puntatore a un SAFEARRAY che contiene le informazioni richieste. 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

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