Mensagens AFX
Essas mensagens são usadas no MFC Feature Pack biblioteca.
Mensagens
A tabela a seguir lista as mensagens que são usadas na biblioteca MFC:
Message (Mensagem) |
Descrição |
[in] lParam |
wParam (Todos os parâmetros são [in] salvo indicação em contrário). |
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 de acessibilidade..Enviar esta mensagem para CMFCPopupMenu ou CMFCRibbonPanelMenu para recuperar o estado do elemento corrente. |
Índice do elemento, que pode ser um botão de menu ou o separador. |
Não usado. |
Estado do elemento.É -1 se o índice é inválido, 0 se o botão de menu tem sem atributos especiais.Caso contrário, ele é uma combinação dos sinalizadores a seguir: TBBS_DISABLED –item desabilitado TBBS_CHECKED – item é verificado TBBS_BUTTON – o item é um padrão pushbutton TBBS_PRESSED –botão é pressionado TBBS_INDETERMINATE – estado indefinido TBBS_SEPARATOR - e não um botão de menu, esse elemento formulários uma separação entre outros itens de menu |
AFX_WM_CHANGE_ACTIVE_TAB |
A estrutura envia essa mensagem para o controle da BAR de controle redimensionável.processo nesta mensagem para receber notificações de CMFCTabCtrl objetos quando um usuário altera uma guia ativo. |
O índice de uma guia. |
Não usado. |
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 corrente. |
Não usado. |
Não usado. |
Não usado. |
AFX_WM_CHANGE_RIBBON_CATEGORY |
A estrutura envia essa mensagem para o quadro principal quando o usuário altera a categoria de controle da faixa de opções ativo. |
Não usado. |
Um ponteiro para CMFCRibbonBar cuja categoria foi alterado. |
Não usado. |
AFX_WM_CHANGEVISUALMANAGER |
A estrutura envia essa mensagem para todas as janelas de quadro quando o usuário altera o Gerenciador Visual corrente.Em resposta a esta mensagem, uma janela do quadro recalcula sua região e ajusta outros parâmetros conforme necessário.Você pode processo mensagem AFX_WM_CHANGEVISUALMANAGER no seu aplicativo se você precisar ser notificado sobre esse evento.Você deve telefonar o manipulador de classe base (OnChangeVisualManager) para garantir que a estrutura do interna processamento esse evento ocorre. |
Não usado. |
Não usado. |
Não usado. |
AFX_WM_CHANGING_ACTIVE_TAB |
Enviado para o pai de CMFCTabCtrl objeto. processo Essa mensagem se você deseja receber notificações de CMFCTabCtrl Quando um usuário redefine uma guia de objetos. |
O índice de tabulação que está sendo ativada. |
Não usado. |
Diferente de zero. |
AFX_WM_CHECKEMPTYMINIFRAME |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
Não aplicável. |
AFX_WM_CREATETOOLBAR |
Enviado de CMFCToolBarsListPropertyPage Quando um usuário cria uma nova barra de ferramentas durante o processo de personalização. Você pode processo nesta mensagem para instanciar um objeto derivado de CMFCToolBar personalizado.Se você tratar essa mensagem e criar sua própria barra de ferramentas, omita a telefonar para o manipulador padrão. |
Não usado. |
Um ponteiro para uma seqüência de caracteres que contém o nome da barra de ferramentas. |
Um ponteiro para a barra de ferramentas recém-criado.nulo indica que a barra de ferramentas criação foi cancelada. |
AFX_WM_CUSTOMIZEHELP |
Enviada para a janela do quadro principal de personalização propriedade folha CMFCToolbarCustomizeDialog Quando o usuário pressiona a Ajuda botão ou a tecla F1. |
Especifica a página ativo da folha de propriedades de personalização. |
Um ponteiro para um CMFCToolbarCustomizeDialog objeto. |
Zero. |
AFX_WM_CUSTOMIZETOOLBAR |
The CMFCToolbarCustomizeDialog envia esta mensagem para notificar o quadro pai que o usuário estiver criando uma nova barra de ferramentas. |
TRUE Quando a personalização é iniciada, FALSE Quando a personalização estiver concluída. |
Não usado. |
Zero. |
AFX_WM_DELETETOOLBAR |
Enviado para a janela do quadro principal quando o usuário está prestes a excluir 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 de (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 CMFCToolBar objeto a ser excluído. |
Diferente de zero se uma barra de ferramentas não pode ser excluída; caso contrário, 0. |
AFX_WM_GETDOCUMENTCOLORS |
CMFCColorMenuButton envia esta mensagem para a janela do quadro principal para recuperar as cores do documento. |
Não usado. |
[in, out] Ponteiro para um CList<COLORREF, COLORREF> objeto. |
Zero. |
AFX_WM_GETDRAGBOUNDS |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
Não aplicável. |
AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM |
Enviado para a janela do quadro principal quando um usuário destaca um item da lista de faixa de opções. |
Í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 CMFCShellTreeCtrl Controla 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 processa essa mensagem, ele deverá 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 processo esta mensagem e modificar menus pop-up a qualquer momento. |
Não usado. |
Um ponteiro para CMFCBaseRibbonElement |
Não usado. |
AFX_WM_ON_CANCELTABMOVE |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
|
AFX_WM_ON_CLOSEPOPUPWINDOW |
A estrutura envia essa mensagem para notificar o proprietário de CMFCDesktopAlertWnd que a janela é Sobre seja fechada. |
Não usado. |
Um ponteiro para CMFCDesktopAlertWnd objeto. |
Não usado. |
AFX_WM_ON_DRAGCOMPLETE |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
Não aplicável. |
AFX_WM_ON_GET_TAB_TOOLTIP |
Enviado para a janela do quadro principal quando uma janela do guia está prestes a exibir uma dica de ferramenta para uma guia, se as dicas de ferramentas personalizadas estiverem ativadas. |
Não usado. |
Um ponteiro para um CMFCTabToolTipInfo estrutura. |
Não usado. |
AFX_WM_ON_HSCROLL |
Enviado para o redimensionável BAR de controle controle.Processar esta mensagem para receber notificações de CMFCTabCtrl objetos quando ocorre um evento de rolar no widget com guias horizontal BAR de rolar. |
A palavra de ordem inferior Especifica um valor de BAR de rolar que indica que o usuário da solicitação de rolar.Para obter mais informações, consulte a tabela neste tópico. |
Não usado. |
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 sua nova posição. |
Zero. |
AFX_WM_ON_MOVETABCOMPLETE |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
Não aplicável. |
AFX_WM_ON_MOVETOTABGROUP |
Enviado para a janela do quadro principal quando um usuário mova uma janela filho MDI de um agrupar com guias para outro. |
Um identificador de janela com abas (CMFCTabCtrl) de que a janela filho MDI foi removida. |
[out] Um identificador de janela com abas (CMFCTabCtrl) para 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 o Fechara legenda da BAR de controle da BAR de . |
Não usado. |
Um ponteiro para um painel encaixável em que o usuário clicou a Fechar botão. |
TRUE Se um painel não puder ser fechado; caso contrário, FALSE. |
AFX_WM_ON_RENAME_TAB |
Enviado para o pai da janela com abas depois que o usuário renomeado uma guia editável. |
O índice baseado em zero da guia renomeado. |
[out] Um ponteiro para uma seqüência de caracteres que contém o novo nome de guia. |
Diferente de zero se o aplicativo processa essa mensagem; a estrutura suprimirá a telefonar para CMFCBaseTabCtrl::SetTabLabel. Se zero for retornado, em seguida, CMFCBaseTabCtrl::SetTabLabel. é chamado pela estrutura. |
AFX_WM_ON_RIBBON_CUSTOMIZE |
Enviado para quadro pai quando o usuário começar a personalização.processo Essa mensagem se você desejar exibir sua própria caixa de diálogo de personalização. |
Não usado. |
Um ponteiro para o controle da faixa de opções para ser personalizado. |
Diferente de zero se o aplicativo processa essa mensagem e exibe sua própria caixa de diálogo de personalização.Se o aplicativo retornará zero, a estrutura exibirá a caixa de diálogo Personalização internos. |
AFX_WM_ON_TABGROUPMOUSEMOVE |
Para uso interno somente. |
Não aplicável. |
Não aplicável. |
Não aplicável. |
AFX_WM_POSTSETPREVIEWFRAME |
Enviado para notificar o quadro principal 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 altera o valor da propriedade selected. |
A ID de controle da lista de propriedades. |
Um ponteiro para a propriedade (CMFCPropertyGridProperty) que tenha alterado. |
Não usado. |
AFX_WM_RESETCONTEXTMENU |
Enviado para a janela do quadro principal quando o usuário redefine o menu de contexto durante a personalização. |
A ID de recurso do menu de contexto. |
Um ponteiro para o menu de contexto corrente, CMFCPopupMenu. |
Não usado. |
AFX_WM_RESETKEYBOARD |
A estrutura envia essa mensagem para a janela do quadro principal 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 de menu (uma janela de quadro) quando o usuário redefine o menu de quadro um aplicativo durante a personalização |
O ID do recurso de menu. |
Não usado. |
Não usado. |
AFX_WM_RESETPROMPT |
A estrutura envia essa mensagem quando o usuário redefine a barra de ferramentas da barra de ferramentas caixa de diálogo Personalizar.O manipulador padrão exibe uma caixa de mensagem que pergunta se o usuário deseja reiniciar a barra de ferramentas. |
Não usado. |
Não usado. |
Não usado. |
AFX_WM_RESETTOOLBAR |
A CMFCToolBar objeto envia essa mensagem quando uma barra de ferramentas é restaurada ao estado original, ou seja, carregado a partir de recursos. processo nesta mensagem para reinserir os botões da barra de ferramentas cujos classes são derivados de CMFCToolbarButton. Para obter mais informações, consulte CMFCToolbarComboBoxButton. |
A ID de recurso de uma barra de ferramentas cujo estado foi restaurado. |
Não usado. |
Zero. |
AFX_WM_SHOWREGULARMENU |
CMFCToolbarMenuButton objeto envia essa mensagem para seu proprietário, quando o usuário clica em um botão de menu regular. Processar esta mensagem sempre que você use CMFCToolbarMenuButton Para exibir um menu pop-up quando o usuário clica em um botão. |
A ID de comando de um botão que envia a mensagem. |
Coordenadas de tela do cursor.A palavra de ordem inferior Especifica a coordenada x.A palavra de ordem alta Especifica a coordenada y. |
Não usado. |
AFX_WM_TOOLBARMENU |
Enviado para a janela do quadro principal quando o usuário libera o botão direito do mouse enquanto o ponteiro do mouse está no cliente ou na área que não é destinada aos clientes de um painel. |
Não usado. |
Coordenadas de tela do ponteiro do mouse.A palavra de ordem inferior Especifica a coordenada x.A palavra de ordem alta Especifica a coordenada y. |
Zero se o aplicativo processa essa mensagem; caso contrário, diferente de zero. |
AFX_WM_UPDATETOOLTIPS |
Enviada a todos os proprietários de dica de ferramenta para indicar que os seus controles de dica de ferramenta devem ser recriadas. |
O tipo de controle que deve processar esta mensagem.Consulte a tabela neste tópico para obter uma lista dos 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 o Ajuda botão, ou insere o modo de Ajuda, clicando no Ajuda legenda botão ou o F1 chave. |
Não usado. |
Um ponteiro para a instância de CMFCWindowsManagerDialog. |
Não usado. |
A tabela a seguir mostra os valores para a palavra baixa do lParam parâmetro do método AFX_WM_HSCROLL:
Valor |
Significado |
SB_ENDSCROLL |
O usuário termina de rolar. |
SB_LEFT |
O usuário rola para o canto superior esquerdo. |
SB_RIGHT |
O usuário rola para o canto inferior direito. |
SB_LINELEFT |
O usuário rola esquerda em uma unidade. |
SB_LINERIGHT |
O usuário rola da direita em uma unidade. |
SB_PAGELEFT |
O usuário rola à esquerda, da largura da janela. |
SB_PAGERIGHT |
O usuário rola da direita, da largura da janela. |
SB_THUMBPOSITION |
O usuário tiver arrastado o caixa de rolar (miniatura) e lançou o botão do mouse.A palavra de ordem superior indica a posição do caixa de rolar no participante da operação arrastar. |
SB_THUMBTRACK |
O usuário está arrastando o caixa de rolar.A mensagem AFX_WM_ON_HSCROLL é enviada repetidamente com esse valor até que o usuário libera o botão do mouse.A palavra de ordem superior indica a posição à qual o caixa de rolar foi arrastada. |
Observação: |
---|
A palavra de ordem superior da lParam parâmetro especifica a posição corrente da caixa de rolar se a palavra de ordem inferior for SB_THUMBPOSITION ou SB_THUMBTRACK; caso contrário, esta palavra não é usada. |
A tabela a seguir lista os valores de sinalizar para o lParam parâmetro da mensagem AFX_WM_UPDATETOOLTIPS:
Sinalizador |
Valor |
AFX_TOOLTIP_TYPE_DEFAULT |
0 x 0001 |
AFX_TOOLTIP_TYPE_TOOLBAR |
0 x 0002 |
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 |