Metodo IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler (uiautomationclient.h)

Articolo
08/08/2024

Registra un metodo che gestisce un evento di modifica della proprietà.

Importante i client di Automazione interfaccia utente Microsoft devono usare i metodi del gruppo di gestori per registrare i listener di eventi anziché i singoli metodi di registrazione eventi definiti nei vari spazi dei nomi IUIAutomation.

Sintassi

HRESULT AddPropertyChangedEventHandler(
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
       int                                      propertyCount
);

Parametri

[in] scope

Ambito degli eventi da gestire; cioè, sia che si trovino sull'elemento stesso, o sui suoi predecessori e figli.

[in] cacheRequest

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

[in] handler

Puntatore all'oggetto che gestisce l'evento.

[in] propertyArray

Puntatore alle proprietà di automazione interfaccia utente di interesse. Per un elenco degli ID proprietà, vedere identificatori di proprietà .

propertyCount

Numero di proprietà monitorate.

Valore restituito

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

Osservazioni

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1809 [solo app desktop]
server minimo supportato	Windows Server, versione 1709 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	uiautomationclient.h (include UIAutomation.h)

Vedere anche

IUIAutomationEventHandlerGroup

Condividi tramite