Constantes de eventos (Winuser.h)
Este tópico descreve os eventos gerados pelo sistema operacional e por aplicativos de servidor. As constantes são listadas em ordem alfabética.
Antes de usar esses eventos, os aplicativos cliente devem usar o Observador de Eventos Acessível para verificar se esses eventos são usados por elementos da interface do usuário.
Para obter mais informações sobre eventos em geral, consulte O que são WinEvents? e Eventos de nível de sistema e de nível de objeto. Para obter mais informações sobre os eventos enviados pelo sistema, consulte Apêndice A: Referência de elementos de interface do usuário com suporte.
| Constante/valor | Descrição |
|---|---|
|
O intervalo de valores constantes WinEvent especificados pela AIA (Accessibility Interoperability Alliance) para uso em todo o setor. Para obter mais informações, consulte Alocação de IDs winEvent. |
|
Os valores de evento mais baixos e mais altos possíveis. |
|
A propriedade KeyboardShortcut de um objeto foi alterada. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
Enviado quando uma janela está camuflada. Uma janela camuflada ainda existe, mas é invisível para o usuário. |
|
A rolagem de um objeto de janela foi encerrada. Ao contrário de EVENT_SYSTEM_SCROLLEND, esse evento está associado à janela de rolagem. Se a rolagem for horizontal ou vertical, esse evento deverá ser enviado sempre que a ação de rolagem for concluída. O parâmetro hwnd da função de retorno de chamada WinEventProc descreve a janela de rolagem; o parâmetro idObject é OBJID_CLIENT e o parâmetro idChild é CHILDID_SELF. |
|
Um objeto foi criado. O sistema envia esse evento para os seguintes elementos de interface do usuário: cursor, controle de cabeçalho, controle de exibição de lista, controle tab, controle de barra de ferramentas, controle de exibição de árvore e objeto de janela . Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Antes de enviar o evento para o objeto pai, os servidores devem enviá-lo para todos os objetos filho de um objeto. Os servidores devem garantir que todos os objetos filho sejam totalmente criados e prontos para aceitar chamadas IAccessible de clientes antes que o objeto pai envie esse evento. Como um objeto pai é criado após seus objetos filho, os clientes devem garantir que o pai de um objeto tenha sido criado antes de chamar IAccessible::get_accParent, especialmente se as funções de gancho no contexto forem usadas. |
|
A propriedade DefaultAction de um objeto foi alterada. O sistema envia esse evento para caixas de diálogo. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
A propriedade Description de um objeto foi alterada. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
Um objeto foi destruído. O sistema envia esse evento para os seguintes elementos de interface do usuário: cursor, controle de cabeçalho, controle de exibição de lista, controle tab, controle de barra de ferramentas, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Os clientes pressupõem que todos os filhos de um objeto são destruídos quando o objeto pai envia esse evento. Depois de receber esse evento, os clientes não chamam as propriedades ou métodos IAccessible de um objeto. No entanto, o ponteiro de interface deve permanecer válido desde que haja uma contagem de referência sobre ele (devido a regras COM), mas o elemento de interface do usuário pode não estar mais presente. Outras chamadas no ponteiro da interface podem retornar erros de falha; para evitar isso, os servidores criam objetos proxy e monitoram seus períodos de vida. |
|
O usuário começou a arrastar um elemento. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o objeto que está sendo arrastado. |
|
O usuário encerrou uma operação de arrastar antes de soltar o elemento arrastado em um destino de soltar. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o objeto que está sendo arrastado. |
|
O usuário removeu um elemento em um destino de soltar. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o objeto que está sendo arrastado. |
|
O usuário arrastou um elemento para o limite de um destino de soltar. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o destino de soltar. |
|
O usuário arrastou um elemento para fora do limite de um destino de soltar. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o destino de soltar. |
|
O usuário removeu um elemento em um destino de soltar. Os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc identificam o destino de soltar. |
|
O valor de evento de objeto mais alto. |
|
Um objeto recebeu o foco do teclado. O sistema envia esse evento para os seguintes elementos de interface do usuário: controle de exibição de lista, barra de menus, menu pop-up, janela de comutador, controle guia, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. O parâmetro hwnd da função de retorno de chamada WinEventProc identifica a janela que recebe o foco do teclado. |
|
A propriedade Help de um objeto foi alterada. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
Um objeto está oculto. O sistema envia esse evento para os seguintes elementos de interface do usuário: cursor e cursor. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Quando esse evento é gerado para um objeto pai, todos os objetos filho já estão ocultos. Os aplicativos de servidor não enviam esse evento para os objetos filho. Objetos ocultos incluem o sinalizador STATE_SYSTEM_INVISIBLE ; objetos mostrados não incluem esse sinalizador. O evento EVENT_OBJECT_HIDE também indica que o sinalizador STATE_SYSTEM_INVISIBLE está definido. Portanto, os servidores não enviam o evento EVENT_OBJECT_STATECHANGE nesse caso. |
|
Uma janela que hospeda outros objetos acessíveis alterou os objetos hospedados. Um cliente pode precisar consultar a janela do host para descobrir os novos objetos hospedados, especialmente se o cliente estiver monitorando eventos da janela. Um objeto hospedado é um objeto de uma estrutura de acessibilidade (MSAA ou Automação da Interface do Usuário) diferente da do host. As alterações em objetos hospedados que são da mesma estrutura que o host devem ser entregues com os eventos de alteração estrutural, como EVENT_OBJECT_CREATE para MSAA. Para obter mais informações, consulte comentários em winuser.h. |
|
Uma janela IME ficou oculta. |
|
Uma janela IME tornou-se visível. |
|
O tamanho ou a posição de uma janela IME foi alterado. |
|
Um objeto foi invocado; por exemplo, o usuário clicou em um botão. Esse evento é compatível com controles comuns e é usado pela Automação da Interface do Usuário. Para esse evento, os parâmetros hwnd, ID e idChild da função de retorno de chamada WinEventProc identificam o item invocado. |
|
Um objeto que faz parte de uma região dinâmica foi alterado. Uma região dinâmica é uma área de um aplicativo que muda com frequência e/ou de forma assíncrona. |
|
Um objeto mudou de localização, forma ou tamanho. O sistema envia esse evento para os seguintes elementos de interface do usuário: objetos caret e window. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento é gerado em resposta a uma alteração no objeto de nível superior dentro da hierarquia de objetos; ele não é gerado para nenhum filho que o objeto possa ter. Por exemplo, se o usuário redimensionar uma janela, o sistema enviará essa notificação para a janela, mas não para a barra de menus, barra de título, barra de rolagem ou outros objetos que também foram alterados. O sistema não envia esse evento para cada janela filho não flutuante quando o pai é movido. No entanto, se um aplicativo redimensionar explicitamente janelas filho como resultado do redimensionamento da janela pai, o sistema enviará vários eventos para os filhos redimensionados. Se a propriedade State de um objeto estiver definida como STATE_SYSTEM_FLOATING, o servidor enviará EVENT_OBJECT_LOCATIONCHANGE sempre que o objeto mudar de local. Se um objeto não tiver esse estado, os servidores só dispararão esse evento quando o objeto for movido em relação ao pai. Para essa notificação de evento, o parâmetro idChild da função de retorno de chamada WinEventProc identifica o objeto filho que foi alterado. |
|
A propriedade Name de um objeto foi alterada. O sistema envia esse evento para os seguintes elementos de interface do usuário: caixa marcar, cursor, controle de exibição de lista, botão de push, botão de opção, controle de barra de status, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
Um objeto tem um novo objeto pai. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
Um objeto de contêiner adicionou, removeu ou reordenou seus filhos. O sistema envia esse evento para os seguintes elementos de interface do usuário: controle de cabeçalho, controle de exibição de lista, controle de barra de ferramentas e objeto de janela. Os aplicativos de servidor enviam esse evento, conforme apropriado, para os objetos acessíveis. Por exemplo, esse evento é gerado por um objeto list-view quando o número de elementos filho ou a ordem dos elementos é alterado. Esse evento também é enviado por uma janela pai quando a ordem Z para as janelas filho é alterada. |
|
A seleção dentro de um objeto de contêiner foi alterada. O sistema envia esse evento para os seguintes elementos de interface do usuário: controle de exibição de lista, controle de tabulação, controle de exibição de árvore e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento sinaliza uma única seleção: uma criança é selecionada em um contêiner que anteriormente não continha filhos selecionados ou a seleção foi alterada de um filho para outro. Os parâmetros hwnd e idObject da função de retorno de chamada WinEventProc descrevem o contêiner; o parâmetro idChild identifica o objeto selecionado. Se o filho selecionado for uma janela que também contém objetos, o parâmetro idChildserá OBJID_WINDOW. |
|
Um filho dentro de um objeto de contêiner foi adicionado a uma seleção existente. O sistema envia esse evento para os seguintes elementos de interface do usuário: caixa de listagem, controle de exibição de lista e controle de exibição de árvore. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Os parâmetros hwnd e idObject da função de retorno de chamada WinEventProc descrevem o contêiner. O parâmetro idChild é o filho que é adicionado à seleção. |
|
Um item dentro de um objeto de contêiner foi removido da seleção. O sistema envia esse evento para os seguintes elementos de interface do usuário: caixa de listagem, controle de exibição de lista e controle de exibição de árvore. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Esse evento sinaliza que um filho é removido de uma seleção existente. Os parâmetros hwnd e idObject da função de retorno de chamada WinEventProc descrevem o contêiner; o parâmetro idChild identifica o filho que foi removido da seleção. |
|
Várias alterações de seleção ocorreram em um objeto de contêiner. O sistema envia esse evento para caixas de listagem; os aplicativos de servidor o enviam para seus objetos acessíveis. Esse evento é enviado quando os itens selecionados dentro de um controle são alterados substancialmente. O evento informa ao cliente que muitas alterações de seleção ocorreram e que ele é enviado em vez de vários eventos EVENT_OBJECT_SELECTIONADD ou EVENT_OBJECT_SELECTIONREMOVE . O cliente consulta os itens selecionados chamando o método IAccessible::get_accSelection do objeto contêiner e enumerando os itens selecionados. Para essa notificação de evento, os parâmetros hwnd e idObject da função de retorno de chamada WinEventProc descrevem o contêiner no qual as alterações ocorreram. |
|
Um objeto oculto é mostrado. O sistema envia esse evento para os seguintes elementos da interface do usuário: objeto de janela, cursor e cursor do sistema. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Os clientes pressupõem que, quando esse evento é enviado por um objeto pai, todos os objetos filho já são exibidos. Portanto, os aplicativos de servidor não enviam esse evento para os objetos filho. Objetos ocultos incluem o sinalizador STATE_SYSTEM_INVISIBLE ; objetos mostrados não incluem esse sinalizador. O evento EVENT_OBJECT_SHOW também indica que o sinalizador STATE_SYSTEM_INVISIBLE está limpo. Portanto, os servidores não enviam o evento EVENT_OBJECT_STATECHANGE nesse caso. |
|
O estado de um objeto foi alterado. O sistema envia esse evento para os seguintes elementos de interface do usuário: caixa de marcar, caixa de combinação, controle de cabeçalho, botão de push, botão de opção, barra de rolagem, controle de barra de ferramentas, controle de exibição de árvore, controle para cima e objeto de janela. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. Por exemplo, uma alteração de estado ocorre quando um objeto de botão é clicado ou liberado, ou quando um objeto está habilitado ou desabilitado. Para essa notificação de evento, o parâmetro idChild da função de retorno de chamada WinEventProc identifica o objeto filho cujo estado foi alterado. |
|
O destino de conversão em uma composição IME foi alterado. O destino de conversão é o subconjunto da composição do IME que é selecionado ativamente como o destino para conversões iniciadas pelo usuário. |
|
A seleção de texto de um objeto foi alterada. Esse evento é compatível com controles comuns e é usado pela Automação da Interface do Usuário. Os parâmetros hwnd, ID e idChild da função de retorno de chamada WinEventProc descrevem o item contido na seleção de texto atualizada. |
|
Enviado quando uma janela é desconscrito. Uma janela camuflada ainda existe, mas é invisível para o usuário. |
|
A propriedade Value de um objeto foi alterada. O sistema envia esse evento para os elementos da interface do usuário que incluem a barra de rolagem e os seguintes controles: editar, cabeçalho, tecla de acesso, barra de progresso, controle deslizante e para cima para baixo. Os aplicativos de servidor enviam esse evento para os objetos acessíveis. |
|
O intervalo de valores constantes de evento reservados para OEMs. Para obter mais informações, consulte Alocação de IDs winEvent. |
|
Um alerta foi gerado. Os aplicativos de servidor não devem enviar esse evento. |
|
Um retângulo de visualização está sendo exibido. |
|
Uma janela perdeu a captura do mouse. Esse evento é enviado pelo sistema, nunca por servidores. |
|
Uma janela recebeu a captura do mouse. Esse evento é enviado pelo sistema, nunca por servidores. |
|
Uma janela saiu do modo de Ajuda contextual. Esse evento não é enviado consistentemente pelo sistema. |
|
Uma janela inseriu o modo de Ajuda contextual. Esse evento não é enviado consistentemente pelo sistema. |
|
A área de trabalho ativa foi alternada. |
|
Uma caixa de diálogo foi fechada. O sistema envia esse evento para caixas de diálogo padrão; os servidores o enviam para caixas de diálogo personalizadas. Esse evento não é enviado consistentemente pelo sistema. |
|
Uma caixa de diálogo foi exibida. O sistema envia esse evento para caixas de diálogo padrão, que são criadas usando modelos de recurso ou funções da caixa de diálogo Win32. Os servidores enviam esse evento para caixas de diálogo personalizadas, que são janelas que funcionam como caixas de diálogo, mas não são criadas da maneira padrão. Esse evento não é enviado consistentemente pelo sistema. |
|
Um aplicativo está prestes a sair do modo de "arrastar e soltar". Os aplicativos que dão suporte a operações de arrastar e soltar devem enviar esse evento; o sistema não envia esse evento. |
|
Um aplicativo está prestes a entrar no modo de "arrastar e soltar". Os aplicativos que dão suporte a operações de arrastar e soltar devem enviar esse evento porque o sistema não o envia. |
|
O valor de evento do sistema mais alto. |
|
A janela em primeiro plano foi alterada. O sistema envia esse evento mesmo que a janela em primeiro plano tenha sido alterada para outra janela no mesmo thread. Os aplicativos de servidor nunca enviam esse evento. Para esse evento, o parâmetro hwnd da função de retorno de chamada WinEventProc é o identificador para a janela que está em primeiro plano, o parâmetro idObject é OBJID_WINDOW e o parâmetro idChild é CHILDID_SELF. |
|
Um menu pop-up foi fechado. O sistema envia esse evento para menus padrão; os servidores o enviam para menus personalizados. Quando um menu pop-up é fechado, o cliente recebe essa mensagem e, em seguida, o evento EVENT_SYSTEM_MENUEND . Esse evento não é enviado consistentemente pelo sistema. |
|
Um menu pop-up foi exibido. O sistema envia esse evento para menus padrão, que são identificados pelo HMENU e são criados usando recursos de modelo de menu ou funções de menu Win32. Os servidores enviam esse evento para menus personalizados, que são elementos de interface do usuário que funcionam como menus, mas não são criados da maneira padrão. Esse evento não é enviado consistentemente pelo sistema. |
|
Um menu da barra de menus foi fechado. O sistema envia esse evento para menus padrão; os servidores o enviam para menus personalizados. Para esse evento, os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc referem-se ao controle que contém a barra de menus ou o controle que ativa o menu de contexto. O parâmetro hwnd é o identificador para a janela relacionada ao evento. O parâmetro idObject é OBJID_MENU ou OBJID_SYSMENU para um menu ou OBJID_WINDOW para um menu pop-up. O parâmetro idChild é CHILDID_SELF. |
|
Um item de menu na barra de menus foi selecionado. O sistema envia esse evento para menus padrão, que são identificados pelo HMENU, criados usando recursos de modelo de menu ou elementos da API do menu Win32. Os servidores enviam esse evento para menus personalizados, que são elementos de interface do usuário que funcionam como menus, mas não são criados da maneira padrão. Para esse evento, os parâmetros hwnd, idObject e idChild da função de retorno de chamada WinEventProc referem-se ao controle que contém a barra de menus ou o controle que ativa o menu de contexto. O parâmetro hwnd é o identificador da janela relacionada ao evento. O parâmetro idObject é OBJID_MENU ou OBJID_SYSMENU para um menu ou OBJID_WINDOW para um menu pop-up. O parâmetro idChild é CHILDID_SELF. O sistema dispara mais de um evento EVENT_SYSTEM_MENUSTART que nem sempre corresponde ao evento EVENT_SYSTEM_MENUEND . |
|
Um objeto de janela está prestes a ser restaurado. Esse evento é enviado pelo sistema, nunca por servidores. |
|
Um objeto de janela está prestes a ser minimizado. Esse evento é enviado pelo sistema, nunca por servidores. |
|
O movimento ou redimensionamento de uma janela foi concluído. Esse evento é enviado pelo sistema, nunca por servidores. |
|
Uma janela está sendo movida ou redimensionada. Esse evento é enviado pelo sistema, nunca por servidores. |
|
A rolagem terminou em uma barra de rolagem. Esse evento é enviado pelo sistema para controles de barra de rolagem padrão e para barras de rolagem anexadas a uma janela. Os servidores enviam esse evento para barras de rolagem personalizadas, que são elementos de interface do usuário que funcionam como barras de rolagem, mas não são criados da maneira padrão. O parâmetro idObject enviado para a função de retorno de chamada WinEventProc é OBJID_HSCROLL para barras de rolagem horizontais e OBJID_VSCROLL para barras de rolagem verticais. |
|
A rolagem foi iniciada em uma barra de rolagem. O sistema envia esse evento para controles de barra de rolagem padrão e para barras de rolagem anexadas a uma janela. Os servidores enviam esse evento para barras de rolagem personalizadas, que são elementos de interface do usuário que funcionam como barras de rolagem, mas não são criados da maneira padrão. O parâmetro idObject enviado para a função de retorno de chamada WinEventProc é OBJID_HSCROLL para barras de rolagem horizontais e OBJID_VSCROLL para barras de rolagem verticais. |
|
Um som foi tocado. O sistema envia esse evento quando um som do sistema, como um para um menu, é reproduzido mesmo que nenhum som seja audível (por exemplo, devido à falta de um arquivo de som ou um som cartão). Os servidores enviam esse evento sempre que um elemento de interface do usuário personalizado gera um som. Para esse evento, a função de retorno de chamada WinEventProc recebe o valor OBJID_SOUND como o parâmetro idObject . |
|
O usuário lançou ALT+TAB. Esse evento é enviado pelo sistema, nunca por servidores. O parâmetro hwnd da função de retorno de chamada WinEventProc identifica a janela para a qual o usuário alternou. Se apenas um aplicativo estiver em execução quando o usuário pressionar ALT+TAB, o sistema enviará esse evento sem um evento de EVENT_SYSTEM_SWITCHSTART correspondente. |
|
O usuário pressionou ALT+TAB, o que ativa a janela de comutador. Esse evento é enviado pelo sistema, nunca por servidores. O parâmetro hwnd da função de retorno de chamada WinEventProc identifica a janela para a qual o usuário está alternando. Se apenas um aplicativo estiver em execução quando o usuário pressionar ALT+TAB, o sistema enviará um evento EVENT_SYSTEM_SWITCHEND sem um evento de EVENT_SYSTEM_SWITCHSTART correspondente. |
|
O intervalo de valores constantes de evento reservados para identificadores de eventos da Automação da Interface do Usuário. Para obter mais informações, consulte Alocação de IDs do WinEvent. |
|
O intervalo de valores constantes de evento reservados para identificadores de evento alterados pela propriedade da Automação da Interface do Usuário. Para obter mais informações, consulte Alocação de IDs do WinEvent. |
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de