Metodo IUIAutomationTreeWalker::NormalElement (uiautomationclient.h)

Articolo
03/08/2023

Recupera l'elemento predecessore più vicino all'elemento Microsoft Automazione interfaccia utente specificato nella visualizzazione albero.

Sintassi

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento da cui avviare la normalizzazione.

[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 passando verso l'alto della catena predecessore nell'albero fino a quando non viene raggiunta una condizione di visualizzazione (specificata da una chiamata precedente a IUIAutomationTreeWalker::Condition). Ma prima di tutto, l'elemento passato viene testato per verificare se corrisponde a una condizione di normalizzazione. In tal caso, l'elemento passato viene restituito, anche se non è un predecessore.

Il metodo restituisce UIA_E_ELEMENTNOTAVAILABLE se non è stato trovato alcun elemento corrispondente.

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

Requisiti


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 (includere UIAutomation.h)

Condividi tramite