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 Devolução
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	Apenas 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	Apenas 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	Apenas 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	Apenas 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	Apenas 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	Apenas 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

Confira também

Macros e Globais