Compartilhar via

Função de retorno de chamada WINEVENTPROC (winuser.h)

  • Artigo

Uma função de retorno de chamada (ou gancho) definida pelo aplicativo que o sistema chama em resposta a eventos gerados por um objeto acessível. A função hook processa as notificações de evento conforme necessário. Os clientes instalam a função hook e solicitam tipos específicos de notificações de evento chamando SetWinEventHook.

O tipo WINEVENTPROC define um ponteiro para essa função de retorno de chamada. WinEventProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

WINEVENTPROC Wineventproc;

void Wineventproc(
  HWINEVENTHOOK hWinEventHook,
  DWORD event,
  HWND hwnd,
  LONG idObject,
  LONG idChild,
  DWORD idEventThread,
  DWORD dwmsEventTime
)
{...}

Parâmetros

hWinEventHook

Tipo: HWINEVENTHOOK

Manipular para uma função de gancho de evento. Esse valor é retornado por SetWinEventHook quando a função hook é instalada e é específica para cada instância da função hook.

event

Tipo: DWORD

Especifica se o evento ocorreu. Esse valor é uma das constantes de evento.

hwnd

Tipo: HWND

Manipule para a janela que gera o evento ou NULL se nenhuma janela estiver associada ao evento. Por exemplo, o ponteiro do mouse não está associado a uma janela.

idObject

Tipo: LONG

Identifica o objeto associado ao evento. Esse é um dos identificadores de objeto ou uma ID de objeto personalizado.

idChild

Tipo: LONG

Identifica se o evento foi disparado por um objeto ou um elemento filho do objeto. Se esse valor for CHILDID_SELF, o evento foi disparado pelo objeto ; caso contrário, esse valor é a ID filho do elemento que disparou o evento.

idEventThread

dwmsEventTime

Tipo: DWORD

Especifica a hora, em milissegundos, em que o evento foi gerado.

Valor retornado

Nenhum

Comentários

Dentro da função hook, os parâmetros hwnd, idObject e idChild são usados ao chamar AccessibleObjectFromEvent.

Os servidores geram eventos chamando NotifyWinEvent.

Crie várias funções de retorno de chamada para lidar com eventos diferentes. Para obter mais informações, consulte Registrando uma função hook.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [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 winuser.h (inclua Windows.h)
Redistribuível Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95

Confira também

SetWinEventHook