Metodo IUIAutomationElement::GetCachedChildren (uiautomationclient.h)

Articolo
03/03/2024

Recupera gli elementi figlio memorizzati nella cache di questo elemento Automazione interfaccia utente.

Sintassi

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

Parametri

[out, retval] children

Tipo: IUIAutomationElementArray**

Riceve un puntatore a una raccolta degli elementi figlio memorizzati nella cache.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La visualizzazione dell'insieme restituito è determinata dalla proprietà TreeFilter dell'oggetto IUIAutomationCacheRequest attivo quando questo elemento è stato ottenuto.

Gli elementi figlio vengono memorizzati nella cache solo se l'ambito della richiesta di cache include TreeScope_Subtree, TreeScope_Children o TreeScope_Descendants.

Se la richiesta di cache ha specificato che gli elementi figlio devono essere memorizzati nella cache a questo livello, ma non sono presenti elementi figlio, il valore di questa proprietà è 0. Tuttavia, se non è stata effettuata alcuna richiesta per memorizzare elementi figlio nella cache a questo livello, un tentativo di recuperare la proprietà restituisce un errore.

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)