Metodo IUIAutomation::GetRootElement (uiautomationclient.h)

Recupera l'elemento Automazione interfaccia utente che rappresenta il desktop.

Sintassi

HRESULT GetRootElement(
  [out, retval] IUIAutomationElement **root
);

Parametri

[out, retval] root

Tipo: IUIAutomationElement**

Riceve un puntatore all'elemento Automazione interfaccia utente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È possibile usare l'elemento radice come punto di partenza per trovare altri elementi usando i metodi FindAll e FindFirst .

Quando si esegue la ricerca dall'elemento radice, assicurarsi di specificare TreeScope_Children nell'ambito della ricerca, non TreeScope_Descendants. Una ricerca nell'intero sottoalbero del desktop potrebbe scorrere migliaia di elementi e causare un overflow dello stack.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomation

IUIAutomation::GetRootElementBuildCache