Compartir a través de


Método IUIAutomation::GetRootElement (uiautomationclient.h)

Recupera el elemento Automatización de la interfaz de usuario que representa el escritorio.

Sintaxis

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

Parámetros

[out, retval] root

Tipo: IUIAutomationElement**

Recibe un puntero al elemento Automatización de la interfaz de usuario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Puede usar el elemento raíz como punto de partida para buscar otros elementos mediante los métodos FindAll y FindFirst .

Al buscar desde el elemento raíz, asegúrese de especificar TreeScope_Children en el ámbito de la búsqueda, no TreeScope_Descendants. Una búsqueda en todo el subárbol del escritorio podría recorrer en iteración miles de elementos y provocar un desbordamiento de pila.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomation

IUIAutomation::GetRootElementBuildCache