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) |