Método IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent (uiautomationclient.h)

Mapeia eventos do Microsoft Automação da Interface do Usuário para WinEvents.

Sintaxe

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

Parâmetros

[in] eventId

Tipo: EVENTID

O identificador de evento. Para obter uma lista de identificadores de eventos, consulte Identificadores de eventos.

[in] propertyId

Tipo: PROPERTYID

O identificador da propriedade. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.

[in] winEvents

Tipo: SAFEARRAY*

A lista de WinEvents que são mapeados para esse evento.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando um aplicativo cliente assina um evento Automação da Interface do Usuário, o núcleo do Automação da Interface do Usuário também escuta winEvents que são mapeados para esse evento. Por exemplo, suponha que UIA_Invoke_InvokedEventId seja mapeado para EVENT_OBJECT_INVOKED. Quando EVENT_OBJECT_INVOKED é gerado, o cliente cria uma instância do proxy e chama RespondToWinEvent nesse proxy. Na implementação de RespondToWinEvent, o proxy chama AddAutomationEvent. Em seguida, o núcleo gera o evento de Automação da Interface do Usuário correspondente.

Requisitos

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

Referência