Metodo IUIAutomation::AddPropertyChangedEventHandlerNativeArray (uiautomationclient.h)

Articolo
08/08/2024

Registra un metodo che gestisce una matrice nativa 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 AddPropertyChangedEventHandlerNativeArray(
  [in] IUIAutomationElement                     *element,
  [in] TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
  [in] int                                      propertyCount
);

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: PROPERTYID*

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

[in] propertyCount

Tipo: int

Numero di identificatori di proprietà in propertyArray.

Valore restituito

Tipo: HRESULT

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

esempio

Per esempi di codice che illustrano come implementare interfacce che consentono ai client di ricevere e gestire eventi di automazione interfaccia utente Microsoft (incluso AddPropertyChangedEventHandlerNativeArray), vedere How to Implement Event Handlers.

Osservazioni

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

Questo metodo ha lo stesso scopo di IUIAutomation::AddPropertyChangedEventHandler, ma accetta una normale matrice di identificatori di proprietà anziché SAFEARRAY.

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)