Método IUIAutomationElement::GetCachedChildren (uiautomationclient.h)

Artículo
03/13/2024

Recupera los elementos secundarios almacenados en caché de este elemento Automatización de la interfaz de usuario.

Sintaxis

HRESULT GetCachedChildren(
  [out, retval] IUIAutomationElementArray **children
);

Parámetros

[out, retval] children

Tipo: IUIAutomationElementArray**

Recibe un puntero a una colección de los elementos secundarios almacenados en caché.

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

La vista de la colección devuelta viene determinada por la propiedad TreeFilter de IUIAutomationCacheRequest que estaba activa cuando se obtuvo este elemento.

Los elementos secundarios solo se almacenan en caché si el ámbito de la solicitud de caché incluye TreeScope_Subtree, TreeScope_Children o TreeScope_Descendants.

Si la solicitud de caché especificó que los elementos secundarios se almacenaran en caché en este nivel, pero no hay elementos secundarios, el valor de esta propiedad es 0. Sin embargo, si no se realizó ninguna solicitud para almacenar en caché los elementos secundarios en este nivel, un intento de recuperar la propiedad devuelve un error.

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)