Compartilhar via


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

Consulte também

Outros recursos

Referência (@@)