Função NotifyWinEvent (winuser.h)

Sinaliza ao sistema que ocorreu um evento predefinido. Se algum aplicativo cliente tiver registrado uma função de gancho para o evento, o sistema chamará a função de gancho do cliente.

Sintaxe

void NotifyWinEvent(
  [in] DWORD event,
  [in] HWND  hwnd,
  [in] LONG  idObject,
  [in] LONG  idChild
);

Parâmetros

[in] event

Tipo: DWORD

Especifica se o evento ocorreu. I valor deve ser uma das constantes de evento.

[in] hwnd

Tipo: HWND

Manipule para a janela que contém o objeto que gerou o evento.

[in] idObject

Tipo: LONG

Identifica o objeto que gerou o evento. Esse valor é um dos identificadores de objeto predefinidos ou um valor de ID de objeto personalizado.

[in] idChild

Tipo: LONG

Identifica se o evento foi gerado por um objeto ou por um elemento filho do objeto . Se esse valor for CHILDID_SELF, o evento será gerado pelo próprio objeto. Se não CHILDID_SELF, esse valor será a ID filho do elemento que gerou o evento.

Retornar valor

Nenhum

Comentários

Os servidores chamam essa função para notificar o sistema de que ocorreu um evento. O Microsoft Active Accessibility verifica se algum aplicativo cliente definiu procedimentos de gancho para o evento e, nesse caso, chama os procedimentos de gancho apropriados.

Se nenhum procedimento de gancho for registrado para o evento, a penalidade de desempenho para chamar essa função será menor.

Os servidores chamam NotifyWinEvent para anunciar o evento para o sistema após o evento ter ocorrido; eles nunca devem notificar o sistema de um evento antes que o evento ocorra.

Quando o procedimento de gancho do cliente é chamado, ele recebe uma série de parâmetros que descrevem o evento e o objeto que gerou o evento. O procedimento de gancho usa a função AccessibleObjectFromEvent para recuperar um ponteiro para a interface IAccessible do objeto que gerou o evento.

Os servidores podem receber uma mensagem WM_GETOBJECT imediatamente após chamar essa função. Isso pode acontecer se houver clientes no contexto que chamem AccessibleObjectFromEvent no retorno de chamada do evento.

Quando os servidores chamam essa função, eles devem estar prontos para lidar com WM_GETOBJECT, retornar um ponteiro de interface IAccessible e manipular qualquer um dos métodos IAccessible .

Observação para desenvolvedores de servidores: Quando você chama NotifyWinEvent, se algum cliente estiver escutando esse evento no contexto, seus manipuladores de eventos, que normalmente enviam WM_GETOBJECT e chamam métodos IAccessible , serão executados antes que NotifyWinEvent retorne. Ao chamar NotifyWinEvent, você deverá estar preparado para lidar com essas chamadas, se elas ocorrerem. Se você precisar fazer uma configuração extra para permitir isso, faça isso antes de chamar NotifyWinEvent, não depois.

Requisitos

Requisito Valor
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)
Biblioteca User32.lib
DLL User32.dll
Redistribuível Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95
Conjunto de APIs ext-ms-win-ntuser-server-l1-1-0 (introduzido em Windows 8)

Confira também

AccessibleObjectFromEvent

SetWinEventHook

UnHookWinEvent

WinEvents