Método IUIAutomationTreeWalker::GetFirstChildElementBuildCache (uiautomationclient.h)

Recupera el primer elemento secundario del elemento de automatización de la interfaz de usuario especificado y almacena en caché las propiedades y los patrones de control.

Sintaxis

HRESULT GetFirstChildElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **first
);

Parámetros

[in] element

Tipo: IUIAutomationElement*

Puntero al elemento para el que se va a recuperar el primer elemento secundario.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntero a una solicitud de caché que especifica las propiedades y los patrones de control que se van a almacenar en caché en el elemento devuelto.

[out, retval] first

Tipo: IUIAutomationElement**

Recibe un puntero al primer elemento secundario o NULL si no hay ningún elemento secundario.

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

Un elemento puede tener elementos secundarios adicionales que no coincidan con la condición de vista actual y, por tanto, no se devuelven al navegar por el árbol de elementos.

La estructura del árbol de Automatización de la interfaz de usuario de Microsoft cambia a medida que cambian los elementos visibles de la interfaz de usuario en el escritorio. No se garantiza que un elemento devuelto como primer elemento secundario se devolverá como primer elemento secundario en los pases posteriores.

Requisitos

Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma 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)