Função UiaAddEvent (uiautomationcoreapi.h)

Artigo
08/26/2023

Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto do Componente de Automação da Interface do Usuário) da Microsoft.

Adiciona um ouvinte para eventos em um nó na árvore de Automação da Interface do Usuário.

Sintaxe

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

Parâmetros

[in] hnode

Tipo: HUIANODE

O nó ao qual adicionar um ouvinte de eventos.

[in] eventId

Tipo: EVENTID

O identificador do evento a ser escutado. Para obter uma lista de IDs de evento, consulte Identificadores de evento.

[in] pCallback

Tipo: UiaEventCallback*

O endereço da função de retorno de chamada UiaEventCallback definida pelo aplicativo que é chamada quando o evento é gerado.

[in] scope

Tipo: TreeScope*

Um valor do tipo enumerado TreeScope que indica o escopo dos eventos a serem manipulados; ou seja, se eles estão no próprio elemento, ou em seus ancestrais e filhos.

[in] pProperties

Tipo: PROPERTYID*

O endereço de uma matriz que contém os identificadores das propriedades a serem monitoradas para eventos de alteração, quando eventId é o EVENTID derivado de AutomationPropertyChanged_Event_GUID; caso contrário, esse parâmetro será NULL. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.

[in] cProperties

Tipo: int

A contagem de elementos na matriz pProperties .

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que define a solicitação de cache em vigor para nós retornados com eventos.

[out] phEvent

Tipo: HUIEVENT*

Quando essa função retorna, contém um ponteiro para o evento que é adicionado. Este parâmetro é passado não inicializado.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcoreapi.h
Biblioteca	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Confira também

UiaLookupId

Compartilhar via