Mensagens AFX

Artigo
02/25/2013

Essas mensagens são usadas no MFC.

Mensagens

A tabela a seguir lista as mensagens que são usadas na biblioteca MFC:

Message (Mensagem)	Descrição	[in] wParam	lParam (todos os parâmetros são [in] salvo indicação em isso.)	Retornar valor
AFX_WM_ACCGETOBJECT	Não usado.	Não usado.	Não aplicável.	Não aplicável.
AFX_WM_ACCGETSTATE	Usado para suporte de acessibilidade.Enviar esta mensagem a CMFCPopupMenu ou a CMFCRibbonPanelMenu para recuperar o estado atual do elemento.	O índice de um elemento, que pode ser um botão ou um separador de menu.	Não usado.	O estado do elemento.É -1 se o índice é inválido, 0 se o botão de menu não tem nenhum atributo especial de.Se não é uma combinação das seguintes sinalizações: TBBS_DISABLED – o item é desativado TBBS_CHECKED – o item é verificado TBBS_BUTTON – o item é uma tecla padrão TBBS_PRESSED – o botão é 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 redimensionável da barra de controle.Processar esta mensagem para receber notificações de objetos de CMFCTabCtrl quando um usuário altera um guia ativo.	O índice de tabulação.	Não usado.	Diferente de zero.
AFX_WM_CHANGE_CURRENT_FOLDER	A estrutura envia esta mensagem ao 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 esta mensagem a todas as janelas de quadro quando o usuário altera o gerenciador visual atual.Em resposta a esta mensagem, uma janela de quadro recalcula sua região e ajusta outros parâmetros quando necessário.Você pode processar a mensagem de AFX_WM_CHANGEVISUALMANAGER em seu aplicativo se você precisa ser notificado sobre este evento.Você deve chamar o manipulador de classe base ()OnChangeVisualManagerpara garantir que o processamento interno de estrutura que esse evento ocorra.	Não usado.	Não usado.	Não usado.
AFX_WM_CHANGING_ACTIVE_TAB	Enviado ao pai do objeto de CMFCTabCtrl .Processar esta mensagem se você desejar receber notificações de objetos de CMFCTabCtrl quando um usuário redefina um guia.	O índice de tabulação que está sendo ativado.	Não usado.	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 de CMFCToolBarsListPropertyPage quando um usuário criar uma nova barra de ferramentas durante o processo de personalização.Você pode processar esta mensagem para criar uma instância de um objeto derivado CMFCToolBar- personalizado.Se você manipula esta mensagem e criar sua própria barra de ferramentas, omitir 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-criado.NULL indica que a criação da barra de ferramentas esteve cancelada.
AFX_WM_CUSTOMIZEHELP	Enviadas para a janela de quadro chave da folha de propriedades CMFCToolbarCustomizede personalizaçãoDialog quando o usuário pressionar o botão de Ajuda ou a tecla F1.	Especifica a página ativo da folha de propriedades de personalização.	Um ponteiro para um objeto de CMFCToolbarCustomizeDialog .	Zero.
AFX_WM_CUSTOMIZETOOLBAR	CMFCToolbarCustomizeDialog envia esta mensagem para notificar o elemento pai 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	Enviadas para a janela de quadro chave quando o usuário está prestes a exclusão de uma barra de ferramentas no modo de personalização. Processar esta mensagem para executar ações adicionais quando um usuário exclui 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 de CMFCToolBar a ser excluído.	Diferente de zero se uma barra de ferramentas não pode ser excluída; se não 0.
AFX_WM_GETDOCUMENTCOLORS	CMFCColorMenuButton envia estas mensagens para a janela de quadro chave para recuperar as cores do documento.	Não usado.	em, [out] um ponteiro para um objeto de 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	Enviadas para a janela de quadro chave quando um usuário realçar um item de lista de fita.	Índice do item realçado	Um ponteiro para CMFCBaseRibbonElement	Não usado.
AFX_WM_ON_AFTER_SHELL_COMMAND	Enviado a um pai de CMFCShellListCtrl ou controles de CMFCShellTreeCtrl quando um usuário conclui executar um comando de shell.	A identificação de comando que o usuário executado	Não usado.	Se os processos de aplicativo esta mensagem, ele retorna zero.
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU	A estrutura envia esta mensagem ao pai de fita antes que exibe o menu pop-up.Você pode processar esta mensagem e alterar 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 quadro chave quando o usuário altera a categoria do controle ativo de fita.	Não usado.	Um ponteiro para CMFCRibbonBar cuja categoria foi alterado.	Não usado.
AFX_WM_ON_CLOSEPOPUPWINDOW	A estrutura envia esta mensagem para notificar o proprietário de CMFCDesktopAlertWnd que a janela está prestes a ser fechada.	Não usado.	Um ponteiro para o objeto de 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	Enviadas para a janela de quadro chave quando uma janela de guia é o ponto de exibir uma dica de ferramenta para uma guia, se as dicas personalizados estão habilitados.	Não usado.	Um ponteiro a estrutura de CMFCTabToolTipInfo .	Não usado.
AFX_WM_ON_HSCROLL	Redimensionável enviado ao controle de barra de controle.Processar esta mensagem para receber notificações de objetos de CMFCTabCtrl quando ocorre um evento de rolagem na barra de rolagem horizontal widget com guias.	A palavra de ordem baixa especifica um valor de barra de rolagem que indica a solicitação de rolagem do usuário.Para mais informações, consulte a tabela posteriormente neste tópico.	Não usado.	Diferente de zero.
AFX_WM_ON_MOVE_TAB	Enviado ao pai de uma janela com guias quando um usuário arrasta um guia para uma nova posição.	O índice com base zero da guia na sua posição original.	[out] o índice com base zero da guia na sua 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	Enviadas para a janela de quadro chave quando um usuário move uma janela filho MDI de um grupo listado para outro.	Um identificador para a janelaCMFCTabCtrlcom guias () da janela filho MDI foi removida.	[out] um identificador de janela com guiasCMFCTabCtrl() que a janela filho MDI foi inserida.	Ignorado.
AFX_WM_ON_PRESS_CLOSE_BUTTON	Enviado a um pai de CDockablePane quando o usuário clica no botão de Fechar na barra de título do controle.	Não usado.	Um ponteiro para um painel encaixável em que o usuário clicou no botão de Fechar .	TRUE se um painel não pode ser fechada; se não FALSO.
AFX_WM_ON_RENAME_TAB	Enviado ao pai de janela com guias após o usuário renomeado um guia editável.	O índice com base zero da guia renomeado.	[out] um ponteiro à uma cadeia de caracteres que contém o novo nome da guia.	Diferente de zero se os processos de aplicativo; esta mensagem a estrutura irá suprimir a chamada a CMFCBaseTabCtrl::SetTabLabel.Se for zero são retornados, então CMFCBaseTabCtrl::SetTabLabel é chamado pela estrutura.
AFX_WM_ON_RIBBON_CUSTOMIZE	Enviado para o elemento pai quando o usuário começar a personalização.Processar esta mensagem se você deseja exibir sua própria caixa de diálogo de personalização.	Não usado.	Um ponteiro para o controle de fita a ser personalizado.	Diferente de zero se os processos de aplicativo esta mensagem e exibe sua própria caixa de diálogo de personalização.Se o aplicativo retorna zero, a estrutura exibirá a caixa de diálogo interno de personalização.
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 quadro chave que o usuário alterou o modo de visualização de impressão	TRUE indica que o modo de visualização de impressão está 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 para o proprietário do controle de grade de propriedade (CMFCPropertyGridCtrl) quando o usuário altere o valor da propriedade selecionada.	A identificação de O controle de lista de propriedades.	Um ponteiro para a propriedade (CMFCPropertyGridProperty) que mudou.	Não usado.
AFX_WM_RESETCONTEXTMENU	Enviadas para a janela de quadro chave quando o usuário redefina o menu de contexto durante a personalização.	A identificação de recurso do menu de contexto.	Um ponteiro para o menu de contexto atual, CMFCPopupMenu.	Não usado.
AFX_WM_RESETKEYBOARD	A estrutura envia estas mensagens para a janela de quadro chave quando o usuário redefina todos os aceleradores de teclado durante a personalização.	Não usado.	Não usado.	Não usado.
AFX_WM_RESETMENU	A estrutura envia esta mensagem para o proprietário do menu (uma janela de quadro) quando o usuário redefina um menu do quadro do aplicativo durante a personalização	A identificação do recurso de menu	Não usado.	Não usado.
AFX_WM_RESETPROMPT	A estrutura envia esta mensagem quando o usuário redefina uma barra de ferramentas de barra de ferramentas personaliza a caixa de diálogo.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 de CMFCToolBar envia esta mensagem quando uma barra de ferramentas é restaurada ao seu estado original, isso é carregado, recursos.Processar esta mensagem para reintroduzir os botões da barra de ferramentas cujas classes são derivadas de CMFCToolbarButton.Para obter mais informações, consulte CMFCToolbarComboBoxButton.	A identificação de recurso de uma barra de ferramentas cujo estado é restaurado.	Não usado.	Zero.
AFX_WM_SHOWREGULARMENU	o objeto deCMFCToolbarMenuButton envia esta mensagem ao proprietário quando o usuário clica em um botão normal do menu.Processar esta mensagem sempre que você usa CMFCToolbarMenuButton para exibir um menu pop-up quando o usuário clica em um botão.	A identificação de comando de um botão que envia a mensagem.	Coordenadas da tela do cursor.A palavra de ordem baixa especificam a coordenada x.A palavra de alta-ordem especificam a coordenada y.	Não usado.
AFX_WM_TOOLBARMENU	Enviadas para a janela de quadro chave quando o usuário liberar o botão direito do mouse quando o ponteiro do mouse está na área cliente ou não-cliente de um painel.	Não usado.	Coordenadas da tela do ponteiro do mouse.A palavra de ordem baixa especificam a coordenada x.A palavra de alta-ordem especificam a coordenada y.	Zero se os processos de aplicativo; esta mensagem caso contrário, diferente de zero.
AFX_WM_UPDATETOOLTIPS	Enviado a todos os proprietários de dica de ferramenta para indicar que os controles de dica de ferramenta deve ser recriados.	O tipo de controle que deve processar esta mensagem.Consulte 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 elemento pai quando o usuário clica no botão de Ajuda , ou entra em modo da ajuda clicando no botão de legenda Ajuda ou a tecla F1.	Não usado.	Um ponteiro para a instância de CMFCWindowsManagerDialog.	Não usado.

A tabela a seguir mostra os valores para as palavras monitores de parâmetro de lParam do método de AFX_WM_HSCROLL:

Valor	Significado
SB_ENDSCROLL	O usuário encerra a rolagem.
SB_LEFT	O rola de usuário ao canto superior esquerdo.
SB_RIGHT	O rola de usuário ao canto inferior direito.
SB_LINELEFT	O usuário rola à esquerda por uma unidade.
SB_LINERIGHT	O usuário rola determinados por uma unidade.
SB_PAGELEFT	O usuário rola à esquerda pela largura da janela.
SB_PAGERIGHT	O usuário rola determinados pela largura da janela.
SB_THUMBPOSITION	O usuário arrastou a caixa de rolagem (thumb) e liberou-se o botão do mouse.A palavra de alta-ordem indica a posição da caixa de rolagem no final da operação de arrastar.
SB_THUMBTRACK	O usuário estiver arrastando a caixa de rolagem.A mensagem de AFX_WM_ON_HSCROLL é enviada repetidamente com esse valor até que o usuário libere o botão do mouse.A palavra de alta-ordem indica a posição que a caixa de rolagem foi arrastada.

Observação
A palavra de alta-ordem de parâmetro de lParam especifica a posição atual na caixa de rolagem se a palavra de ordem baixa são SB_THUMBPOSITION ou SB_THUMBTRACK; caso contrário, estas palavras não são usados.

A tabela a seguir lista os valores de parâmetro para o parâmetro de lParam de mensagem de AFX_WM_UPDATETOOLTIPS:

Sinalizar	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

Consulte também

Conceitos

Globais e Macros do MFC

Compartilhar via

Mensagens AFX

Mensagens

Consulte também

Conceitos

Recursos adicionais