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) |