Metodo IUIAutomation::AddPropertyChangedEventHandler (uiautomationclient.h)

Articolo
08/08/2024

Registra un metodo che gestisce e la matrice di eventi di modifica delle proprietà.

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

Sintassi

HRESULT AddPropertyChangedEventHandler(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] SAFEARRAY                                *propertyArray
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento di automazione interfaccia utente associato al gestore eventi.

[in] scope

Tipo: TreeScope

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

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

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

[in] handler

Tipo: IUIAutomationPropertyChangedEventHandler*

Puntatore all'oggetto che gestisce l'evento.

[in] propertyArray

Tipo: * SAFEARRAY

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

Valore restituito

Tipo: HRESULT

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

Osservazioni

L'elemento dell'interfaccia utente specificato da elemento potrebbe non supportare le proprietà specificate dal parametro propertyArray .

Un client di 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 un altro viene aggiunto o rimosso nello stesso processo client.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Aggiornamento della piattaforma per Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Aggiornamento della piattaforma per Windows Server 2008, Windows Server 2003 con SP2 e Aggiornamento della piattaforma per Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	uiautomationclient.h (include UIAutomation.h)