Metodo IUIAutomationTextRange3::GetChildrenBuildCache (uiautomationclient.h)

Articolo
03/09/2024

Restituisce gli elementi figlio e le proprietà e i criteri forniti per gli elementi in un intervallo di testo in una singola chiamata tra processi. Equivale a chiamare GetChildren, ma aggiunge il modello di cache di compilazione standard.

Sintassi

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

Parametri

[in] cacheRequest

Oggetto IUIAutomationCacheRequest che specifica le proprietà e i pattern di controllo da memorizzare nella cache.

[out, retval] children

Restituisce gli elementi figlio e le proprietà o i criteri di ogni figlio dell'intervallo di testo che soddisfano i criteri della cacheRequest fornita.

Valore restituito

Restituisce S_OK in caso di esito positivo; in caso contrario, viene restituito un codice di errore HRESULT .

Commenti

Seguendo la progettazione di GetChildren:

Verranno inclusi anche elementi figlio che si sovrappongono all'intervallo di testo, ma non sono completamente racchiusi da esso.
Se non esistono elementi figlio, viene restituita una raccolta vuota.

A seguito di una chiamata riuscita, Automazione interfaccia utente client sono in grado di chiamare le API "Cached" di IUIAutomationElement fornite nella cacheRequest, ad esempio IUIAutomationElement::GetCachedPropertyValue.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomationTextRange3

supporto di Automazione interfaccia utente per il contenuto testuale

Condividi tramite