IUIAutomation::GetRootElement-Methode (uiautomationclient.h)
Ruft das Benutzeroberflächenautomatisierung-Element ab, das den Desktop darstellt.
Syntax
HRESULT GetRootElement(
[out, retval] IUIAutomationElement **root
);
Parameter
[out, retval] root
Typ: IUIAutomationElement**
Empfängt einen Zeiger auf das Benutzeroberflächenautomatisierung-Element.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie können das Stammelement als Ausgangspunkt für die Suche nach anderen Elementen verwenden, indem Sie die FindAll - und FindFirst-Methode verwenden.
Achten Sie bei der Suche über das Stammelement darauf, TreeScope_Children im Bereich der Suche anzugeben, nicht TreeScope_Descendants. Eine Suche durch die gesamte Teilstruktur des Desktops könnte Tausende von Elementen durchlaufen und zu einem Stapelüberlauf führen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationclient.h (include UIAutomation.h) |