Metodo IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent (uiautomationclient.h)

Articolo
08/26/2023

Esegue il mapping degli eventi di Microsoft Automazione interfaccia utente a WinEvents.

Sintassi

HRESULT SetWinEventsForAutomationEvent(
  [in] EVENTID    eventId,
  [in] PROPERTYID propertyId,
  [in] SAFEARRAY  *winEvents
);

Parametri

[in] eventId

Tipo: EVENTID

Identificatore dell'evento. Per un elenco di identificatori di evento, vedere Identificatori di evento.

[in] propertyId

Tipo: PROPERTYID

Identificatore della proprietà. Per un elenco di ID proprietà, vedere Identificatori di proprietà.

[in] winEvents

Tipo: SAFEARRAY*

Elenco di WinEvents mappati a questo evento.

Valore restituito

Tipo: HRESULT

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

Commenti

Quando un'applicazione client sottoscrive un evento Automazione interfaccia utente, il core Automazione interfaccia utente ascolta anche WinEvents che esegue il mapping a questo evento. Si supponga, ad esempio, che UIA_Invoke_InvokedEventId venga mappato a EVENT_OBJECT_INVOKED. Quando viene generato EVENT_OBJECT_INVOKED , il client crea un'istanza del proxy e chiama RespondToWinEvent in tale proxy. Nell'implementazione di RespondToWinEvent il proxy chiama AddAutomationEvent. Il core genera quindi l'evento di Automazione interfaccia utente corrispondente.

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)

Vedi anche

Procedure consigliate per l'uso di matrici sicure

Informazioni concettuali

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

Riferimento