Partilhar via

Mensagens AFX

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Estas mensagens são usadas no MFC.

Messages

A tabela seguinte lista as mensagens utilizadas na biblioteca MFC:

Message Description [dentro] wParam lParam (Todos os parâmetros estão [em] salvo indicação em contrário.) Valor de retorno
AFX_WM_ACCGETOBJECT Não utilizado. Não utilizado. Não aplicável. Não aplicável.
AFX_WM_ACCGETSTATE Usado para apoio à acessibilidade. Envie esta mensagem para CMFCPopupMenu ou CMFCRibbonPanelMenu para recuperar o estado do elemento atual. Índice de elemento, que pode ser um botão de menu ou separador. Não utilizado. O estado elemental. É -1 se o índice for inválido, 0 se o botão do menu não tiver atributos especiais. Caso contrário, é uma combinação das seguintes bandeiras:

TBBS_DISABLED — item desativado

TBBS_CHECKED — o item é verificado

TBBS_BUTTON — o item é um botão padrão

TBBS_PRESSED — é pressionado o botão

TBBS_INDETERMINATE — estado indefinido

TBBS_SEPARATOR - em vez de um botão de menu, este elemento forma uma separação entre outros itens do menu
AFX_WM_CHANGE_ACTIVE_TAB O framework envia esta mensagem para o controlo da barra de controlo redimensionável. Processe esta mensagem para receber notificações de CMFCTabCtrl objetos quando um utilizador altere um separador ativo. O índice de uma tabulação. Não utilizado. Não-zero.
AFX_WM_CHANGE_CURRENT_FOLDER O framework envia esta mensagem para o pai quando CMFCShellListCtrl o utilizador alterou a pasta atual. Não utilizado. Não utilizado. Não utilizado.
AFX_WM_CHANGEVISUALMANAGER O framework envia esta mensagem para todas as janelas de frames quando o utilizador altera o Visual Manager atual. Em resposta a esta mensagem, uma janela de frame recalcula a sua região e ajusta outros parâmetros conforme necessário. Pode processar a mensagem AFX_WM_CHANGEVISUALMANAGER na sua candidatura caso precise de ser notificado sobre este evento. Deve chamar o handler da classe base (OnChangeVisualManager) para garantir que o processamento interno deste evento pelo framework ocorre. Não utilizado. Não utilizado. Não utilizado.
AFX_WM_CHANGING_ACTIVE_TAB Enviado ao pai do CMFCTabCtrl objeto. Processe esta mensagem se quiser receber notificações de CMFCTabCtrl objetos quando um utilizador reiniciar um separador. O índice do separador que está a ser ativado. Não utilizado. Não-zero.
AFX_WM_CHECKEMPTYMINIFRAME Apenas para uso interno. Não aplicável. Não aplicável. Não aplicável.
AFX_WM_CREATETOOLBAR Enviado a partir do CMFCToolBarsListPropertyPage momento em que um utilizador cria uma nova barra de ferramentas durante o processo de personalização. Pode processar esta mensagem para instanciar um objeto personalizado derivado do CMFCToolBar. Se tratar desta mensagem e criar a sua própria barra de ferramentas, omita a chamada ao handler predefinido. Não utilizado. Um ponteiro para uma string que contém o nome da barra de ferramentas. Um apontador 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 principal do quadro a partir da folha CMFCToolbarCustomize Dialog de propriedades de personalização quando o utilizador 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 CMFCToolbarCustomize Dialog objeto. Zero.
AFX_WM_CUSTOMIZETOOLBAR Envia CMFCToolbarCustomize Dialog esta mensagem para notificar o frame pai de que o utilizador está a criar uma nova barra de ferramentas. TRUE quando a personalização começa, FALSE quando a personalização termina. Não utilizado. Zero.
AFX_WM_DELETETOOLBAR Enviado para a janela principal quando o utilizador está prestes a eliminar uma barra de ferramentas no modo de personalização.

Processe esta mensagem para tomar ações adicionais quando um utilizador eliminar uma barra de ferramentas em modo de personalização. Deves também chamar o handler padrão (OnToolbarDelete), que apaga a barra de ferramentas. O handler por defeito devolve um valor que indica se é possível eliminar a barra de ferramentas.		 Não utilizado. Apontar para um CMFCToolBar objeto a eliminar. Diferente de zero se uma barra de ferramentas não puder ser eliminada; caso contrário, 0.
AFX_WM_GETDOCUMENTCOLORS CMFCColorMenuButton envia esta mensagem para a janela principal para recuperar as cores do documento. Não utilizado. [inspira, expira] Aponta para um CList<COLORREF, COLORREF> objeto. 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 principal quando um utilizador destaca um item da lista de fitas. Índice do item destacado Um indicador para CMFCBaseRibbonElement Não utilizado.
AFX_WM_ON_AFTER_SHELL_COMMAND Enviado para um pai de CMFCShellListCtrl ou CMFCShellTreeCtrl controlos quando um utilizador termina de executar um comando shell. O ID do comando que o utilizador executou Não utilizado. Se a aplicação processar esta mensagem, deverá devolver zero.
AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU A estrutura envia esta mensagem para o pai da fita antes de este mostrar o menu pop-up. Pode processar esta mensagem e modificar menus pop-up a qualquer momento. Não utilizado. Um indicador para CMFCBaseRibbonElement Não utilizado.
AFX_WM_ON_CANCELTABMOVE Apenas para uso interno. Não aplicável. Não aplicável.
AFX_WM_ON_CHANGE_RIBBON_CATEGORY O framework envia esta mensagem para o quadro principal quando o utilizador altera a categoria ativa de Controlo de Fita. Não utilizado. Um apontador para a CMFCRibbonBar categoria de quem mudou. Não utilizado.
AFX_WM_ON_CLOSEPOPUPWINDOW O framework envia esta mensagem para notificar o proprietário de CMFCDesktopAlertWnd que a janela está prestes a ser fechada. Não utilizado. Um indicador para CMFCDesktopAlertWnd o objeto. Não utilizado.
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 principal do frame quando uma janela de separador está prestes a mostrar uma dica de ferramenta para um separador, se estiverem ativadas descrições personalizadas. Não utilizado. Um ponteiro para uma CMFCTabToolTipInfo estrutura. Não utilizado.
AFX_WM_ON_HSCROLL Enviado para a barra de controlo redimensionável. Processe esta mensagem para receber notificações de CMFCTabCtrl objetos quando ocorra um evento de scroll na barra horizontal de scroll do widget com separadores. A palavra de ordem baixa especifica um valor na barra de scroll que indica o pedido de scroll do utilizador. Para mais informações, consulte a tabela mais adiante neste tópico. Não utilizado. Não-zero.
AFX_WM_ON_MOVE_TAB Enviado para o pai de uma janela separada quando um utilizador arrasta um separador para uma nova posição. O índice em base zero do separador na sua posição original. [fora] O índice baseado em zero da aba na sua 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 principal quando um utilizador move uma janela filho MDI de um grupo separado para outro. Uma alavanca para janela separada (CMFCTabCtrl) da qual a janela filha MDI foi removida. [fora] Uma alavanca para janela separada (CMFCTabCtrl) à qual a janela filha MDI foi inserida. Ignorado.
AFX_WM_ON_PRESS_CLOSE_BUTTON Enviado para um dos pais quando CDockablePane o utilizador clica no botão Fechar na legenda da barra de controlo. Não utilizado. Um apontador para um painel acoplável onde o utilizador clicava no botão Fechar . VERDADEIRO se um painel não puder ser fechado; caso contrário, FALSO.
AFX_WM_ON_RENAME_TAB Enviado para o pai da janela separada depois do utilizador ter renomeado um separador editável. O índice baseado em zero do separador renomeado. [fora] Um apontador para uma cadeia que contém o novo nome do separador. Diferente de zero se a aplicação processar esta mensagem; A estrutura suprimirá a chamada para CMFCBaseTabCtrl::SetTabLabel. Se zero for devolvido, então CMFCBaseTabCtrl::SetTabLabel é chamado pelo framework.
AFX_WM_ON_RIBBON_CUSTOMIZE Enviado para o frame principal quando o utilizador inicia a personalização. Processa esta mensagem se quiseres mostrar a tua própria caixa de diálogo de personalização. Não utilizado. Um apontador para o controlo de fita a ser personalizado. Diferente de zero se a aplicação processar esta mensagem e mostrar a sua própria caixa de diálogo de personalização. Se a aplicação devolver zero, o framework irá mostrar a caixa de diálogo de personalização incorporada.
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 quadro principal de que o utilizador alterou o modo de pré-visualização de impressão TRUE indica que o modo de pré-visualização de impressão está definido. FALSE indica que o modo de pré-visualização de impressão está desligado. Não utilizado. Não utilizado.
AFX_WM_PROPERTY_CHANGED Enviado ao proprietário do controlo da grelha da propriedade (CMFCPropertyGridCtrl) quando o utilizador altera o valor da propriedade selecionada. O ID de controlo da lista de propriedades. Um indicador para a propriedade (CMFCPropertyGridProperty) que mudou. Não utilizado.
AFX_WM_RESETCONTEXTMENU Enviado para a janela principal do frame quando o utilizador reinicia o menu de contexto durante a personalização. O ID do recurso do menu de contexto. Um apontador para o menu de contexto atual, CMFCPopupMenu. Não utilizado.
AFX_WM_RESETKEYBOARD A framework envia esta mensagem para a janela principal quando o utilizador reinicia todos os aceleradores de teclado durante a personalização. Não utilizado. Não utilizado. Não utilizado.
AFX_WM_RESETMENU O framework envia esta mensagem ao proprietário do menu (uma janela de frame) quando o utilizador reinicia um menu de frame de aplicação durante a personalização O ID do recurso do menu. Não utilizado. Não utilizado.
AFX_WM_RESETPROMPT O framework envia esta mensagem quando o utilizador reinicia uma barra de ferramentas a partir da caixa de diálogo de personalização da barra de ferramentas. O handler predefinido mostra uma caixa de mensagem que pergunta se o utilizador quer reiniciar a barra de ferramentas. Não utilizado. Não utilizado. Não utilizado.
AFX_WM_RESETTOOLBAR Um CMFCToolBar objeto envia esta mensagem quando uma barra de ferramentas é restaurada ao seu estado original, ou seja, carregada a partir dos recursos. Processe esta mensagem para reinserir botões da barra de ferramentas cujas classes derivam de CMFCToolbarButton. Para obter mais informações, consulte CMFCToolbarComboBoxButton. O ID de recurso de uma barra de ferramentas cujo estado foi restaurado. Não utilizado. Zero.
AFX_WM_SHOWREGULARMENU CMFCToolbarMenuButton O objeto envia esta mensagem ao seu proprietário quando o utilizador clica num botão de menu normal. Processe esta mensagem sempre que usar CMFCToolbarMenuButton para mostrar um menu pop-up quando o utilizador clicar num botão. O ID do comando de um botão que envia a mensagem. Coordenadas do ecrã do cursor. A palavra de ordem baixa especifica a coordenada x. A palavra de ordem superior especifica a coordenada y. Não utilizado.
AFX_WM_TOOLBARMENU Enviado para a janela principal do frame quando o utilizador solta o botão direito do rato enquanto o ponteiro do rato está na área cliente ou não cliente de um painel. Não utilizado. Coordenadas do ecrã do ponteiro do rato. A palavra de ordem baixa especifica a coordenada x. A palavra de ordem superior especifica a coordenada y. Zero se a aplicação processar esta mensagem; caso contrário, diferente de zero.
AFX_WM_UPDATETOOLTIPS Enviado a todos os proprietários de tooltips para indicar que os seus controlos de tooltip devem ser recriados. O tipo de controlo que deve processar esta mensagem. Consulte a tabela mais adiante neste tópico para uma lista de valores possíveis. Não utilizado. Não utilizado.
AFX_WM_WINDOW_HELP CMFCWindowsManagerDialog envia esta mensagem para a moldura principal quando o utilizador clica no botão Ajuda , ou entra no modo de ajuda clicando no botão de legenda Ajuda ou na tecla F1. Não utilizado. Um apontador para a instância de CMFCWindowsManagerDialog. Não utilizado.

A tabela seguinte mostra os valores para a palavra baixa do parâmetro lParam do método AFX_WM_HSCROLL:

Valor Meaning
SB_ENDSCROLL O utilizador termina o pergaminho.
SB_LEFT O utilizador desloca-se para o canto superior esquerdo.
SB_RIGHT O utilizador desloca-se para o canto inferior direito.
SB_LINELEFT O utilizador desloca-se para a esquerda por uma unidade.
SB_LINERIGHT O utilizador desliza até uma unidade para a direita.
SB_PAGELEFT O utilizador desloca-se para a esquerda pela largura da janela.
SB_PAGERIGHT O utilizador percorre a largura da janela.
SB_THUMBPOSITION O utilizador arrastou a caixa de rolagem (polegar) e largou o botão do rato. A palavra de ordem superior indica a posição da caixa de deslocamento no final da operação de arrasto.
SB_THUMBTRACK O utilizador está a arrastar a caixa de scroll. A mensagem AFX_WM_ON_HSCROLL é enviada repetidamente com este valor até o utilizador soltar o botão do rato. A palavra de ordem alta indica a posição para onde a caixa de rolo foi arrastada.

Observação

A palavra de ordem superior do parâmetro lParam especifica a posição atual da caixa de deslocamento se a palavra de ordem baixa for SB_THUMBPOSITION ou SB_THUMBTRACK; caso contrário, esta palavra não é usada.

A tabela seguinte lista os valores de flag para o parâmetro lParam da mensagem AFX_WM_UPDATETOOLTIPS:

Flag 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

Macros e Globais

  • Last updated on