Metodo IUIAutomation::AddPropertyChangedEventHandlerNativeArray (uiautomationclient.h)

Articolo
08/26/2023

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

Parametri

[in] element

Tipo: IUIAutomationElement*

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

scope

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache o NULL se non è richiesta alcuna memorizzazione 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 di 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 gli eventi di Microsoft Automazione interfaccia utente (inclusi AddPropertyChangedEventHandlerNativeArray), vedere Come implementare gestori eventi.

Commenti

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

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

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

Requisiti

Requisito	Valore
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)