Mensagens AFX
Essas mensagens são usadas na biblioteca MFC.
Mensagens
A tabela a seguir lista as mensagens usadas na biblioteca MFC:
| Mensagem | Descrição | [in] wParam | lParam (todos os parâmetros são [in], a menos que indicado de outra forma.) | Valor de retorno |
|---|---|---|---|---|
| AFX_WM_ACCGETOBJECT | Não usado. | Não usado. | Não aplicável. | Não aplicável. |
| AFX_WM_ACCGETSTATE | Usado para suporte à acessibilidade. Envia essa mensagem para CMFCPopupMenu ou CMFCRibbonPanelMenu para recuperar o estado do elemento atual. |
Índice do elemento, que pode ser um botão de menu ou separador. | Não usado. | O estado do elemento. É -1, se o índice for inválido, 0, se o botão de menu não tiver atributos especiais. Caso contrário, pode ser uma combinação dos seguintes sinalizadores: TBBS_DISABLED — o item está desabilitado TBBS_CHECKED — o item está marcado TBBS_BUTTON — o item é um botão de ação padrão TBBS_PRESSED — o botão está pressionado TBBS_INDETERMINATE — estado indefinido TBBS_SEPARATOR – em vez de um botão de menu, esse elemento forma uma separação entre outros itens de menu |
| AFX_WM_CHANGE_ACTIVE_TAB | A estrutura envia essa mensagem para o controle de barra de controle redimensionável. Processe essa mensagem para receber notificações de objetos CMFCTabCtrl, quando um usuário alterar uma guia ativa. |
O índice de uma guia. | Não usado. | Um valor diferente de zero. |
| AFX_WM_CHANGE_CURRENT_FOLDER | A estrutura envia essa mensagem para o pai de CMFCShellListCtrl, quando o usuário alterou a pasta atual. |
Não usado. | Não usado. | Não usado. |
| AFX_WM_CHANGEVISUALMANAGER | A estrutura envia essa mensagem para todas as janelas com moldura, quando o usuário altera o Visual Manager atual. Em resposta a essa mensagem, uma janela com moldura recalcula a região e ajusta outros parâmetros, conforme necessário. Você pode processar a mensagem AFX_WM_CHANGEVISUALMANAGER no aplicativo, se precisar ser notificado sobre esse evento. Você deve chamar o manipulador de classe base (OnChangeVisualManager) para garantir que o processamento interno da estrutura desse evento ocorra. |
Não usado. | Não usado. | Não usado. |
| AFX_WM_CHANGING_ACTIVE_TAB | Enviado para o pai do objeto CMFCTabCtrl. Processe esta mensagem, se você quiser receber notificações dos objetos CMFCTabCtrl, quando um usuário redefinir uma guia. |
O índice da guia está sendo ativada. | Não usado. | Um valor diferente de zero. |
| AFX_WM_CHECKEMPTYMINIFRAME | Somente para uso Interno. | Não aplicável. | Não aplicável. | Não aplicável. |
| AFX_WM_CREATETOOLBAR | Enviado por CMFCToolBarsListPropertyPage, quando um usuário cria uma nova barra de ferramentas durante o processo de personalização. Você pode processar essa mensagem para instanciar um objeto personalizado derivado de CMFCToolBar. Se você lidar com essa mensagem e criar sua própria barra de ferramentas, omita a chamada para o manipulador padrão. |
Não usado. | Um ponteiro para uma cadeia de caracteres que contém o nome da barra de ferramentas. | Um ponteiro para a barra de ferramentas recém-criada. NULL indica que a criação da barra de ferramentas foi cancelada. |
| AFX_WM_CUSTOMIZEHELP | Enviado para a janela de mainframe na folha de propriedades de personalização CMFCToolbarCustomize Dialog, quando o usuário pressiona o botão Ajuda ou a tecla F1. |
Especifica a página ativa da folha de propriedades de personalização. | Um ponteiro para um objeto CMFCToolbarCustomize Dialog. |
Zero. |
| AFX_WM_CUSTOMIZETOOLBAR | O CMFCToolbarCustomize Dialog envia essa mensagem para notificar o quadro pai de que o usuário está criando uma nova barra de ferramentas. |
TRUE, quando a personalização é iniciada. FALSE, quando a personalização é concluída. | Não usado. | Zero. |
| AFX_WM_DELETETOOLBAR | Enviado para a janela de mainframe, quando o usuário está prestes a excluir uma barra de ferramentas no modo de personalização. Processe essa mensagem para executar ações adicionais, quando um usuário excluir uma barra de ferramentas no modo de personalização. Você também deve chamar o manipulador padrão ( OnToolbarDelete), que exclui a barra de ferramentas. O manipulador padrão retorna um valor que indica se é possível excluir a barra de ferramentas. |
Não usado. | Ponteiro para um objeto CMFCToolBar a ser excluído. |
Um valor diferente de zero, se não for possível excluir uma barra de ferramentas. Caso contrário, 0. |
| AFX_WM_GETDOCUMENTCOLORS | CMFCColorMenuButton envia essa mensagem para a janela de mainframe, para recuperar as cores do documento. |
Não usado. | [in, out] Ponteiro para um objeto CList<COLORREF, COLORREF>. |
Zero. |
| AFX_WM_GETDRAGBOUNDS | Somente para uso Interno. | Não aplicável. | Não aplicável. | Não aplicável. |
| AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM | Enviado para a janela de mainframe, quando um usuário realça um item da lista de faixas de opções. | Índice do item realçado | Um ponteiro para CMFCBaseRibbonElement |
Não usado. |
| AFX_WM_ON_AFTER_SHELL_COMMAND | Enviado para um pai dos controles CMFCShellListCtrl ou CMFCShellTreeCtrl, quando um usuário termina de executar um comando shell. |
A ID do comando que o usuário executou | Não usado. | Se o aplicativo processar essa mensagem, deve retornar zero. |
| AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU | A estrutura envia essa mensagem para o pai da faixa de opções, antes de exibir o menu pop-up. Você pode processar essa mensagem e modificar os menus pop-up a qualquer momento. | Não usado. | Um ponteiro para CMFCBaseRibbonElement |
Não usado. |
| AFX_WM_ON_CANCELTABMOVE | Somente para uso Interno. | Não aplicável. | Não aplicável. | |
| AFX_WM_ON_CHANGE_RIBBON_CATEGORY | A estrutura envia essa mensagem para o mainframe, quando o usuário altera a categoria de controle de faixa de opções ativa. | Não usado. | Um ponteiro para o CMFCRibbonBar cuja categoria foi alterada. |
Não usado. |
| AFX_WM_ON_CLOSEPOPUPWINDOW | A estrutura envia essa mensagem para notificar o proprietário do CMFCDesktopAlertWnd de que a janela está prestes a ser fechada. |
Não usado. | Um ponteiro para objeto CMFCDesktopAlertWnd. |
Não usado. |
| AFX_WM_ON_DRAGCOMPLETE | Somente para uso Interno. | Não aplicável. | Não aplicável. | Não aplicável. |
| AFX_WM_ON_GET_TAB_TOOLTIP | Enviado para a janela de mainframe, quando uma janela de tabulação está prestes a exibir uma dica de ferramenta para uma guia, se as dicas de ferramenta personalizadas estiverem habilitadas. | Não usado. | Um ponteiro para uma estrutura CMFCTabToolTipInfo. |
Não usado. |
| AFX_WM_ON_HSCROLL | Enviado para o controle de barra de controle redimensionável. Processe essa mensagem para receber notificações dos objetos CMFCTabCtrl, quando ocorrer um evento de rolagem na barra de rolagem horizontal do widget com guias. |
A palavra de ordem inferior especifica um valor de barra de rolagem que indica a solicitação de rolagem do usuário. Para obter mais informações, consulte a tabela posteriormente neste tópico. | Não usado. | Um valor diferente de zero. |
| AFX_WM_ON_MOVE_TAB | Enviado para o pai de uma janela com guias, quando um usuário arrasta uma guia para uma nova posição. | O índice baseado em zero da guia na posição original. | [out] O índice baseado em zero da guia na nova posição. | Zero. |
| AFX_WM_ON_MOVETABCOMPLETE | Somente para uso Interno. | Não aplicável. | Não aplicável. | Não aplicável. |
| AFX_WM_ON_MOVETOTABGROUP | Enviado para a janela de mainframe, quando um usuário move uma janela filho da interface MDI de um grupo com guias para outro. | Um identificador para a janela com guias (CMFCTabCtrl) da qual a janela filho da interface MDI foi removida. |
[out] Um identificador para a janela com guias (CMFCTabCtrl) à qual a janela filho da interface MDI foi inserida. |
Ignorado. |
| AFX_WM_ON_PRESS_CLOSE_BUTTON | Enviado para um pai de CDockablePane, quando o usuário clica no botão Fechar na legenda da barra de controle. |
Não usado. | Um ponteiro para um painel encaixado em que o usuário clicou no botão Fechar. | TRUE, se não for possível fechar um painel. Caso contrário, FALSE. |
| AFX_WM_ON_RENAME_TAB | Enviado para o pai da janela com guias, depois que o usuário renomeou uma guia editável. | O índice baseado em zero da guia renomeada. | [out] Um ponteiro para uma cadeia de caracteres que contém o nome da nova guia. | Um valor diferente de zero, se o aplicativo processar essa mensagem. A estrutura suprimirá a chamada para CMFCBaseTabCtrl::SetTabLabel. Se zero for retornado, CMFCBaseTabCtrl::SetTabLabel será chamado pela estrutura. |
| AFX_WM_ON_RIBBON_CUSTOMIZE | Enviado para o quadro pai, quando o usuário inicia a personalização. Processe essa mensagem, se quiser exibir sua própria caixa de diálogo de personalização. | Não usado. | Um ponteiro para o controle de faixa de opções a ser personalizado. | Um valor diferente de zero, se o aplicativo processar essa mensagem e exibir sua própria caixa de diálogo de personalização. Se o aplicativo retornar zero, a estrutura exibirá a caixa de diálogo de personalização interna. |
| AFX_WM_ON_TABGROUPMOUSEMOVE | Somente para uso Interno. | Não aplicável. | Não aplicável. | Não aplicável. |
| AFX_WM_POSTSETPREVIEWFRAME | Enviado para notificar o mainframe de que o usuário alterou o modo de visualização de impressão | TRUE indica que o modo de visualização de impressão foi definido. FALSE indica que o modo de visualização de impressão está desativado. | Não usado. | Não usado. |
| AFX_WM_PROPERTY_CHANGED | Enviado ao proprietário do controle de grade de propriedades (CMFCPropertyGridCtrl), quando o usuário altera o valor da propriedade selecionada. |
A ID de controle da lista de propriedades. | Um ponteiro para a propriedade (CMFCPropertyGridProperty) alterada. |
Não usado. |
| AFX_WM_RESETCONTEXTMENU | Enviado para a janela de mainframe, quando o usuário redefine o menu de contexto durante a personalização. | A ID do recurso do menu de contexto. | Um ponteiro para o menu de contexto, CMFCPopupMenu. |
Não usado. |
| AFX_WM_RESETKEYBOARD | A estrutura envia essa mensagem para a janela de mainframe, quando o usuário redefine todos os aceleradores de teclado durante a personalização. | Não usado. | Não usado. | Não usado. |
| AFX_WM_RESETMENU | A estrutura envia essa mensagem para o proprietário do menu (uma janela com moldura), quando o usuário redefine um menu de quadro de aplicativo durante a personalização | A ID do recurso de menu. | Não usado. | Não usado. |
| AFX_WM_RESETPROMPT | A estrutura envia essa mensagem, quando o usuário redefine uma barra de ferramentas na caixa de diálogo Personalizar da barra de ferramentas. O manipulador padrão exibe uma caixa de mensagem que pergunta se o usuário deseja redefinir a barra de ferramentas. | Não usado. | Não usado. | Não usado. |
| AFX_WM_RESETTOOLBAR | Um objeto CMFCToolBar envia essa mensagem, quando uma barra de ferramentas é restaurada para o estado original, ou seja, carregada dos recursos. Processe essa mensagem para reinserir botões de barra de ferramentas cujas classes são derivadas do CMFCToolbarButton. Para obter mais informações, consulte CMFCToolbarComboBoxButton. |
A ID do recurso de uma barra de ferramentas cujo estado foi restaurado. | Não usado. | Zero. |
| AFX_WM_SHOWREGULARMENU | O objeto CMFCToolbarMenuButton envia essa mensagem ao proprietário, quando o usuário clica em um botão de menu regular. Processe essa mensagem sempre que você usar CMFCToolbarMenuButton para exibir um menu pop-up, quando o usuário clicar em um botão. |
A ID de comando de um botão que envia a mensagem. | Coordenadas na tela do cursor. A palavra de ordem inferior especifica a coordenada x. A palavra de ordem superior especifica a coordenada y. | Não usado. |
| AFX_WM_TOOLBARMENU | Enviado para a janela de mainframe, quando o usuário libera o botão direito de um mouse, enquanto o ponteiro do mouse está na área cliente ou não cliente de um painel. | Não usado. | As coordenadas na tela do ponteiro do mouse. A palavra de ordem inferior especifica a coordenada x. A palavra de ordem superior especifica a coordenada y. | Zero, se o aplicativo processar essa mensagem. Caso contrário, um valor diferente de zero. |
| AFX_WM_UPDATETOOLTIPS | Enviado a todos os proprietários da dica de ferramenta, para indicar que os controles de dica de ferramenta devem ser recriados. | O tipo de controle que deve processar essa mensagem. Confira a tabela posteriormente neste tópico, para obter uma lista de valores possíveis. | Não usado. | Não usado. |
| AFX_WM_WINDOW_HELP | CMFCWindowsManagerDialog envia essa mensagem para o quadro pai, quando o usuário clica no botão Ajuda ou entra no modo de ajuda clicando no botão de legenda da Ajuda ou na tecla F1. |
Não usado. | Um ponteiro para a instância de CMFCWindowsManagerDialog. |
Não usado. |
A tabela a seguir mostra os valores para a palavra inferior do parâmetro lParam do método AFX_WM_HSCROLL:
| Valor | Significado |
|---|---|
| SB_ENDSCROLL | O usuário encerra a rolagem. |
| SB_LEFT | O usuário rola até o canto superior esquerdo. |
| SB_RIGHT | O usuário rola para o canto inferior direito. |
| SB_LINELEFT | O usuário rola para a esquerda por uma unidade. |
| SB_LINERIGHT | O usuário rola para a direita por uma unidade. |
| SB_PAGELEFT | O usuário rola para a esquerda pela largura da janela. |
| SB_PAGERIGHT | O usuário rola para a direita pela largura da janela. |
| SB_THUMBPOSITION | O usuário arrastou a caixa de rolagem (polegar) e liberou o botão do mouse. A palavra de ordem superior indica a posição da caixa de rolagem ao final da operação de arrastar. |
| SB_THUMBTRACK | O usuário está arrastando a caixa de rolagem. A mensagem AFX_WM_ON_HSCROLL é enviada repetidamente com esse valor até que o usuário libere o botão do mouse. A palavra de ordem superior indica a posição para a qual a caixa de rolagem foi arrastada. |
Observação
A palavra de ordem superior do parâmetro lParam especifica a posição atual da caixa de rolagem, se a palavra de ordem inferior for SB_THUMBPOSITION ou SB_THUMBTRACK. Caso contrário, essa palavra não será usada.
A tabela a seguir lista os valores de sinalizador para o parâmetro lParam da mensagem AFX_WM_UPDATETOOLTIPS:
| Sinalizador | Valor |
|---|---|
| AFX_TOOLTIP_TYPE_DEFAULT | 0x0001 |
| AFX_TOOLTIP_TYPE_TOOLBAR | 0x0002 |
| AFX_TOOLTIP_TYPE_TAB | 0x0004 |
| AFX_TOOLTIP_TYPE_MINIFRAME | 0x0008 |
| AFX_TOOLTIP_TYPE_DOCKBAR | 0x0010 |
| AFX_TOOLTIP_TYPE_EDIT | 0x0020 |
| AFX_TOOLTIP_TYPE_BUTTON | 0x0040 |
| AFX_TOOLTIP_TYPE_TOOLBOX | 0x0080 |
| AFX_TOOLTIP_TYPE_ALL | 0xFFFF |