Metodo IUIAutomation3::AddTextEditTextChangedEventHandler (uiautomationclient.h)

Articolo
03/03/2024

Registra un metodo che gestisce gli eventi di modifica del testo a livello di codice.

Nota Prima di implementare un gestore eventi, è necessario avere familiarità con i problemi di threading descritti in Informazioni sui problemi di threading.

Sintassi

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento Automazione interfaccia utente associato al gestore eventi.

[in] scope

Tipo: TreeScope

Ambito di eventi da gestire; ovvero, se sono sull'elemento stesso, o sui predecessori e discendenti.

[in] textEditChangeType

Tipo: TextEditChangeType

Tipo di modifica specifico da restare in ascolto. I client eseguono la registrazione per ogni tipo di modifica del testo separatamente, in modo che il sistema Automazione interfaccia utente possa verificare la presenza di listener registrati in fase di esecuzione ed evitare di generare eventi per modifiche di modifica di testo specifiche quando non sono presenti listener.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache o NULL se non si desidera memorizzare nella cache.

[in] handler

Tipo: IUIAutomationTextEditTextChangedEventHandler*

Puntatore all'oggetto che gestisce l'evento di modifica del testo a livello di codice.

Valore restituito

Tipo: HRESULT

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

Commenti

Un client Automazione interfaccia utente non deve usare più thread per aggiungere o rimuovere gestori eventi. Un comportamento imprevisto può determinare se un gestore eventi viene aggiunto o rimosso mentre viene aggiunto o rimosso nello stesso processo client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (include UIAutomation.h)