Compartilhar via


Classe CMFCToolBarMenuButton

Um botão na barra de ferramentas que contém um menu pop-up.

class CMFCToolBarMenuButton : public CMFCToolBarButton

Membros

Construtores public

Nome

Descrição

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Constrói um objeto de CMFCToolBarMenuButton .

Métodos públicos

Nome

Descrição

CMFCToolBarMenuButton::CompareWith

Compara com essa instância do objeto fornecido CMFCToolBarButton . Overrides ( CMFCToolBarButton::CompareWith.)

CMFCToolBarMenuButton::CopyFrom

Copia as propriedades de outro botão da barra de ferramentas para o botão atual. Overrides ( CMFCToolBarButton::CopyFrom.)

CMFCToolBarMenuButton::CreateFromMenu

Inicializa o menu da barra de ferramentas de um identificador do menu do windows.

CMFCToolBarMenuButton::CreateMenu

Cria um menu do windows que consiste nos comandos no menu da barra de ferramentas. Retorna um identificador para o menu do windows.

CMFCToolBarMenuButton::CreatePopupMenu

Cria um objeto de menus pop-up (Classe CMFCPopupMenu) para exibir o menu da barra de ferramentas.

CMFCToolBarMenuButton::EnableQuickCustomize

 

CMFCToolBarMenuButton::GetCommands

Fornece acesso somente leitura à lista de comandos no menu da barra de ferramentas.

CMFCToolBarMenuButton::GetImageRect

Recupera o retângulo delimitador para a imagem do botão.

CMFCToolBarMenuButton::GetPaletteRows

Retorna o número de linhas no menu pop-up quando o menu está no modo de paleta.

CMFCToolBarMenuButton::GetPopupMenu

Retorna um ponteiro para o objeto de menus pop-up que está associado com o botão.

CMFCToolBarMenuButton::HasButton

 

CMFCToolBarMenuButton::HaveHotBorder

Determina se uma borda do botão é exibida quando um usuário selecione. Overrides ( CMFCToolBarButton::HaveHotBorder.)

CMFCToolBarMenuButton::IsBorder

 

CMFCToolBarMenuButton::IsClickedOnMenu

 

CMFCToolBarMenuButton::IsDroppedDown

Determina se o menu pop-up é exibida.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Chamado pela estrutura para determinar se um usuário pode abrir um submenu de item de menu selecionado.

CMFCToolBarMenuButton::IsExclusive

Determina se o botão está no modo exclusivo, isto é, se o menu pop-up permanece aberto mesmo quando o usuário move o ponteiro sobre outra barra de ferramentas ou botão.

CMFCToolBarMenuButton::IsMenuPaletteMode

Determina se o menu pop-up estiver no modo de paleta.

CMFCToolBarMenuButton::IsQuickMode

 

CMFCToolBarMenuButton::IsTearOffMenu

Determina se o menu pop-up tem uma barra de rasgo - fora.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

 

CMFCToolBarMenuButton::OnBeforeDrag

Especifica se o botão pode ser arrastado. Overrides ( CMFCToolBarButton::OnBeforeDrag.)

CMFCToolBarMenuButton::OnCalculateSize

Chamado pela estrutura para calcular o tamanho do botão para o contexto de dispositivo e o estado de encaixe especificados. Overrides ( CMFCToolBarButton::OnCalculateSize.)

CMFCToolBarMenuButton::OnCancelMode

Chamado pela estrutura para manipular a mensagem de WM_CANCELMODE . Overrides ( CMFCToolBarButton::OnCancelMode.)

CMFCToolBarMenuButton::OnChangeParentWnd

Chamado pela estrutura quando o botão é inserido em uma nova barra de ferramentas. Overrides ( CMFCToolBarButton::OnChangeParentWnd.)

CMFCToolBarMenuButton::OnClick

Chamado pela estrutura quando o usuário clica no botão do mouse. Overrides ( CMFCToolBarButton::OnClick.)

CMFCToolBarMenuButton::OnClickMenuItem

Chamado pela estrutura quando o usuário seleciona um item no menu pop-up.

CMFCToolBarMenuButton::OnContextHelp

Chamado pela estrutura quando a barra de ferramentas pai manipular uma mensagem de WM_HELPHITTEST . Overrides ( CMFCToolBarButton::OnContextHelp.)

CMFCToolBarMenuButton::OnDraw

Chamado pela estrutura para desenhar o botão usando os estilos e opções especificadas. Overrides ( CMFCToolBarButton::OnDraw.)

CMFCToolBarMenuButton::OnDrawOnCustomizeList

Chamado pela estrutura para desenhar o botão no painel de Comandos da caixa de diálogo de Personalizar . Overrides ( CMFCToolBarButton::OnDrawOnCustomizeList.)

CMFCToolBarMenuButton::OpenPopupMenu

Chamado pela estrutura quando o usuário abra o menu pop-up.

CMFCToolBarMenuButton::ResetImageToDefault

Defina o valor padrão a imagem que está associada com o botão. Overrides ( CMFCToolBarButton::ResetImageToDefault.)

CMFCToolBarMenuButton::SaveBarState

Salvar o estado do botão da barra de ferramentas. Overrides ( CMFCToolBarButton::SaveBarState.)

CMFCToolBarMenuButton::Serialize

Este objeto ler de um arquivo ou neutro o grava em um arquivo neutro. Overrides ( CMFCToolBarButton::Serialize.)

CMFCToolBarMenuButton::SetACCData

Preenche o objeto fornecido de CAccessibilityData com dados de acessibilidade do botão da barra de ferramentas. Overrides ( CMFCToolBarButton::SetACCData.)

CMFCToolBarMenuButton::SetMenuOnly

Especifica se o botão pode ser adicionado a uma barra de ferramentas.

CMFCToolBarMenuButton::SetMenuPaletteMode

Especifica se o menu pop-up estiver no modo de paleta.

CMFCToolBarMenuButton::SetMessageWnd

 

CMFCToolBarMenuButton::SetRadio

Força o botão de menu da barra de ferramentas para exibir um ícone que indica que está selecionado.

CMFCToolBarMenuButton::SetTearOff

Especifica uma identificação de barra de rasgo - fora do menu pop-up.

Métodos protegidos

Nome

Descrição

CMFCToolBarMenuButton::DrawDocumentIcon

Desenha um ícone no botão de menu.

Membros de dados

Nome

Descrição

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Se TRUE, a estrutura chama sempre CFrameWndEx::OnDrawMenuImage quando um botão é desenhado.

Comentários

CMFCToolBarMenuButton pode aparecer como um menu, um item de menu que tenha um submenu, um botão que executa um comando ou exibir um menu, ou um botão que exibe somente um menu. Você determina o comportamento e a aparência do botão de menu especificando parâmetros como a imagem, texto, o identificador do menu, e a identificação de comando que está associado com o botão no construtor CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Uma classe personalizada derivada da classe de CMFCToolbarMenuButton deve usar a macro de DECLARE_SERIAL . A macro de DECLARE_DYNCREATE gera um erro quando o aplicativo for fechado.

Exemplo

O exemplo a seguir demonstra como configurar um objeto de CMFCToolBarMenuButton . O código a seguir ilustra como especificar que o menu drop-down estiver no modo de paleta, e especificar a identificação para a barra de rasgo - fora que é criado quando o usuário arrasta o botão de menu fora de uma barra de menus. Este trecho de código é parte de Exemplo de preenchimento da palavra.

    pBorderType->SetMenuPaletteMode (TRUE, 2 /* Rows number */);
    pBorderType->SetTearOff (ID_BORDER_TEAROFF);

Hierarquia de herança

CObject

   CMFCToolBarButton

      CMFCToolBarMenuButton

Requisitos

Cabeçalho: afxtoolbarmenubutton.h

Consulte também

Referência

Gráfico da hierarquia

Classe CMFCToolBarButton

Classe CMFCToolBar

Classe CMFCPopupMenu

Outros recursos

Classes MFC