Metodo IUIAutomationTreeWalker::NormalizeElementBuildCache (uiautomationclient.h)

Recupera l'elemento predecessore più vicino all'elemento Microsoft Automazione interfaccia utente specificato nella visualizzazione albero, prefeta le proprietà richieste e i pattern di controllo e archivia gli elementi prelettura nella cache.

Sintassi

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento da cui avviare la normalizzazione.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache che specifica le proprietà e i pattern di controllo da memorizzare nella cache sull'elemento restituito.

[out, retval] normalized

Tipo: IUIAutomationElement**

Riceve un puntatore all'elemento predecessore più vicino all'elemento specificato nella visualizzazione albero.

Valore restituito

Tipo: HRESULT

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

Commenti

L'elemento viene normalizzato spostandosi verso l'alto nella catena predecessore nell'albero fino a quando non viene raggiunto un elemento che soddisfa la condizione di visualizzazione (specificata da una chiamata precedente a IUIAutomationTreeWalker::Condition). Se viene raggiunto l'elemento radice, viene restituito l'elemento radice, anche se non soddisfa la condizione di visualizzazione.

Questo metodo è utile per le applicazioni che ottengono riferimenti a Automazione interfaccia utente elementi eseguendo il hit testing. L'applicazione potrebbe voler funzionare solo con tipi specifici di elementi e può usare IUIAutomationTreeWalker::NormalizeElement per assicurarsi che, indipendentemente dall'elemento recuperato inizialmente (ad esempio, quando una barra di scorrimento ottiene lo stato attivo per l'input), viene recuperato solo l'elemento di interesse (ad esempio un elemento contenuto).

Requisiti