Classe CMFCToolBarMenuButton

Artigo
08/04/2024

Um botão de barra de ferramentas que contém um menu pop-up. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCToolBarMenuButton : public CMFCToolBarButton

Membros

Construtores públicos

Nome	Descrição
CMFCToolBarMenuButton::CMFCToolBarMenuButton	Constrói um objeto `CMFCToolBarMenuButton`.

Métodos públicos

Nome	Descrição
CMFCToolBarMenuButton::CompareWith	Compara essa instância com o objeto `CMFCToolBarButton` fornecido. (Substitui CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom	Copia as propriedades de outro botão de barra de ferramentas para o botão atual. (Substitui CMFCToolBarButton::CopyFrom.)
CMFCToolBarMenuButton::CreateFromMenu	Inicializa o menu da barra de ferramentas de um identificador de 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 menu 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 menu pop-up associado ao botão.
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder	Determina se uma borda do botão é exibida quando um usuário seleciona o botão. (Substitui CMFCToolBarButton::HaveHotBorder.)
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown	Determina se o menu pop-up é exibido.
CMFCToolBarMenuButton::IsEmptyMenuAllowed	Chamado pela estrutura para determinar se um usuário pode abrir um submenu no item de menu selecionado.
CMFCToolBarMenuButton::IsExclusive	Determina se o botão está no modo exclusivo, ou seja, 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 está no modo de paleta.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu	Determina se o menu pop-up tem uma barra de extração.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag	Especifica se o botão pode ser arrastado. (Substitui CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize	Chamado pela estrutura para calcular o tamanho do botão para o contexto do dispositivo e o estado de encaixe especificados. (Substitui CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarMenuButton::OnCancelMode	Chamado pela estrutura para lidar com a mensagem WM_CANCELMODE. (Substitui CMFCToolBarButton::OnCancelMode.)
CMFCToolBarMenuButton::OnChangeParentWnd	Chamado pela estrutura quando o botão é inserido em uma nova barra de ferramentas. (Substitui CMFCToolBarButton::OnChangeParentWnd.)
CMFCToolBarMenuButton::OnClick	Chamado pela estrutura quando o usuário clica no botão do mouse. (Substitui 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 manipula uma mensagem WM_HELPHITTEST. (Substitui CMFCToolBarButton::OnContextHelp.)
CMFCToolBarMenuButton::OnDraw	Chamado pela estrutura para desenhar o botão usando os estilos e as opções especificados. (Substitui CMFCToolBarButton::OnDraw.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList	Chamado pela estrutura para desenhar o botão no painel Comandos da caixa de diálogo Personalizar. (Substitui CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarMenuButton::OpenPopupMenu	Chamado pela estrutura quando o usuário abre o menu pop-up.
CMFCToolBarMenuButton::ResetImageToDefault	Define como o valor padrão a imagem associada ao botão. (Substitui CMFCToolBarButton::ResetImageToDefault.)
CMFCToolBarMenuButton::SaveBarState	Salva o estado do botão de barra de ferramentas. (Substitui CMFCToolBarButton::SaveBarState.)
CMFCToolBarMenuButton::Serialize	Lê esse objeto de um arquivo morto ou grava-o em um arquivo morto. (Substitui CMFCToolBarButton::Serialize.)
CMFCToolBarMenuButton::SetACCData	Preenche o objeto `CAccessibilityData` fornecido com os dados de acessibilidade do botão de barra de ferramentas. (Substitui 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 está no modo de paleta.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio	Força o botão de menu da barra de ferramentas a exibir um ícone que indica que ele está selecionado.
CMFCToolBarMenuButton::SetTearOff	Especifica uma ID da barra de extração para o 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 sempre chamará CFrameWndEx::OnDrawMenuImage quando um botão for desenhado.

Comentários

Um CMFCToolBarMenuButton pode aparecer como um menu, um item de menu que tem um submenu, um botão que executa um comando ou exibe um menu ou um botão que exibe apenas um menu. Você determina o comportamento e a aparência do botão de menu especificando parâmetros como a imagem, o texto, o identificador de menu e a ID de comando associada ao botão no construtor CMFCToolbarMenuButton::CMFCToolbarMenuButton.

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

Exemplo

O exemplo a seguir demonstra como configurar um objeto CMFCToolBarMenuButton. O código ilustra como especificar que o menu suspenso está no modo de paleta e especificar a ID da barra de extração criada quando o usuário arrastar o botão de menu para fora de uma barra de menus. Este snippet de código faz parte do exemplo do Word Pad.

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

Hierarquia de herança

CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Requisitos

Cabeçalho: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Constrói um objeto CMFCToolBarMenuButton.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parâmetros

src
[in] Um objeto CMFCToolBarMenuButton a ser copiado para este objeto CMFCToolBarMenuButton.

uiID
[in] A ID do comando a ser executado quando um usuário clica no botão; ou (UINT)-1 para um botão de menu que não executa diretamente um comando.

hMenu
[in] Um identificador para um menu; ou NULL se o botão não tiver um menu.

iImage
[in] Índice da imagem para o botão; ou -1 se este botão não tiver um ícone ou usar o ícone para o comando especificado por uiID. O índice é o mesmo para cada objeto CMFCToolBarImages em seu aplicativo.

lpszTexto
[in] O texto do botão de menu da barra de ferramentas.

bUserButton
[in] TRUE se o botão exibir uma imagem definida pelo usuário; FALSE se o botão exibir uma imagem predefinida associada ao comando especificado por uiID.

Comentários

Se uiID for uma ID de comando válida, o botão executará esse comando quando o usuário clicar nele. Se hMenu for um identificador de menu válido, o botão fornecerá um menu suspenso quando ele aparecer em uma barra de ferramentas ou em um submenu quando ele aparecer em um menu. Se uiID e hMenu forem válidos, o botão será um botão dividido com uma parte que executará o comando quando o usuário clicar nele e uma parte com uma seta para baixo que soltará um menu quando o usuário clicar nele. No entanto, se hMenu for válido, um usuário não poderá clicar no botão para executar um comando quando o botão for inserido em um menu.

Exemplo

O exemplo a seguir demonstra como construir um objeto da classe CMFCToolBarMenuButton. Este snippet de código faz parte do exemplo do Word Pad.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parâmetros

[in] other

Valor de retorno

Comentários

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parâmetros

[in] src

Comentários

CMFCToolBarMenuButton::CreateFromMenu

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

virtual void CreateFromMenu(HMENU hMenu);

Parâmetros

hMenu
[in] Um identificador para um menu.

Comentários

Um botão de menu da barra de ferramentas pode exibir um submenu suspenso.

A estrutura chama esse método para inicializar os comandos no submenu de um menu.

CMFCToolBarMenuButton::CreateMenu

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

virtual HMENU CreateMenu() const;

Valor de retorno

Um identificador para o menu se tiver êxito. NULL se a lista de comandos associados ao botão de menu da barra de ferramentas estiver vazia.

Comentários

Você pode substituir esse método em uma classe derivada para personalizar como o menu é gerado.

CMFCToolBarMenuButton::CreatePopupMenu

Cria um objeto CMFCPopupMenu para exibir o menu da barra de ferramentas.

virtual CMFCPopupMenu* CreatePopupMenu();

Valor de retorno

Um ponteiro para um objeto CMFCPopupMenu que exibe o menu suspenso associado ao botão de menu da barra de ferramentas.

Comentários

Esse método é chamado pela estrutura para preparar a exibição do menu suspenso associado ao botão.

A implementação padrão apenas constrói e retorna um novo objeto CMFCPopupMenu. Substitua esse método se você quiser usar um tipo derivado da Classe CMFCPopupMenu ou para executar uma inicialização adicional.

CMFCToolBarMenuButton::DrawDocumentIcon

Desenha um ícone de documento no botão de menu.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parâmetros

pDC
[in] Um ponteiro para o contexto do dispositivo.

rectImage
[in] Coordenadas do retângulo delimitador de imagem.

hIcon
[in] Um identificador para o ícone.

Comentários

Esse método usa um ícone de documento e o desenha no botão de menu, centralizado na área especificada por rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Comentários

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Valor de retorno

Comentários

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Valor de retorno

Comentários

CMFCToolBarMenuButton::GetCommands

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

const CObList& GetCommands() const;

Valor de retorno

Uma referência const a um objeto da Classe CObList, que contém uma coleção de objetos da Classe CMFCToolBarButton.

Comentários

Um botão de menu da barra de ferramentas pode exibir um submenu. Você pode fornecer a lista de comandos no submenu no construtor ou em CMFCToolBarMenuButton::CreateFromMenu como um identificador para um menu (HMENU). O menu é convertido em uma lista de objetos derivados da Classe CMFCToolBarButton e armazenados no objeto interno CObList. É possível acessar esta lista chamando esse método.

CMFCToolBarMenuButton::GetImageRect

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

void GetImageRect(CRect& rectImage);

Parâmetros

rectImage
[out] Uma referência a um objeto CRect que recebe as coordenadas do retângulo delimitador de imagem.

CMFCToolBarMenuButton::GetPaletteRows

Retorna o número de linhas no menu suspenso quando o menu está no modo de paleta.

int GetPaletteRows() const;

Valor de retorno

O número de linhas na paleta.

Comentários

Quando o botão de menu estiver definido como modo de paleta, os itens de menu aparecerão em várias colunas com apenas um número limitado de linhas. Chame esse método para obter o número de linhas. Você pode habilitar ou desabilitar o modo de paleta e especificar o número de linhas usando CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Retorna um ponteiro para o objeto Classe CMFCPopupMenu que representa o menu suspenso do botão.

CMFCPopupMenu* GetPopupMenu() const;

Valor de retorno

Um ponteiro para um objeto Classe CMFCPopupMenu criado quando a estrutura desenhou o submenu do botão de menu da barra de ferramentas; NULL se nenhum submenu for exibido.

Comentários

Quando um botão de menu da barra de ferramentas exibe um menu suspenso, o botão cria um objeto Classe CMFCPopupMenu para representar o menu. Chame esse método para obter um ponteiro para o objeto CMFCPopupMenu. Você não deve armazenar o ponteiro retornado, pois ele é temporário e se torna inválido quando o usuário fecha o menu suspenso.

CMFCToolBarMenuButton::IsDroppedDown

Indica se o menu pop-up é exibido no momento.

virtual BOOL IsDroppedDown() const;

Valor de retorno

TRUE se o botão de menu da barra de ferramentas exibir seu submenu; caso contrário, FALSE.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Especifica se os itens de menu mostram submenus vazios.

virtual BOOL IsEmptyMenuAllowed() const;

Valor de retorno

TRUE se a estrutura abrir um submenu do item de menu selecionado no momento mesmo quando o submenu estiver vazio; caso contrário, FALSE.

Comentários

A estrutura chama esse método quando um usuário tenta abrir o submenu do item de menu selecionado no momento. Se o submenu estiver vazio e IsEmptyMenuAllowed retornar FALSE, o submenu não será aberto.

A implementação padrão retorna FALSE. Substitua esse método para personalizar o comportamento.

CMFCToolBarMenuButton::IsExclusive

Indica se o botão está em um modo exclusivo.

virtual BOOL IsExclusive() const;

Valor de retorno

TRUE se o botão estiver funcionando no modo exclusivo; caso contrário, FALSE.

Comentários

Quando um usuário abre um menu pop-up para um botão e então mover o ponteiro do mouse sobre outra barra de ferramentas ou botão de menu, o menu pop-up se fechará, a menos que o botão esteja no modo exclusivo.

A implementação padrão sempre retorna FALSE. Substitua esse método em uma classe derivada se você quiser ativar o modo exclusivo.

CMFCToolBarMenuButton::IsMenuPaletteMode

Determina se o menu suspenso está no modo de paleta.

BOOL IsMenuPaletteMode() const;

Valor de retorno

TRUE se o modo de paleta estiver habilitado, caso contrário, FALSE.

Comentários

Quando o botão de menu é definido como modo de paleta, os itens de menu aparecem em várias colunas com apenas um número limitado de linhas. Chame esse método para obter o número de linhas. Você pode habilitar ou desabilitar o modo de paleta chamando CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Indica se o menu suspenso tem uma barra de extração.

virtual BOOL IsTearOffMenu() const;

Valor de retorno

TRUE se o botão de menu da barra de ferramentas tiver uma barra de extração; caso contrário, FALSE.

Comentários

Para habilitar o recurso de extração e definir a ID da barra de extração, chame CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Especifica se a estrutura sempre chama CFrameWndEx::OnDrawMenuImage quando um botão é desenhado.

static BOOL m_bAlwaysCallOwnerDraw;

Comentários

Quando essa variável de membro é definida como TRUE, o botão sempre chama o método CFrameWndEx::OnDrawMenuImage para exibir a imagem no botão. Quando m_bAlwaysCallOwnerDraw for FALSE, o botão em si desenhará a imagem se a imagem for predefinida. Caso contrário, ela chamará OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Comentários

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Valor de retorno

Comentários

CMFCToolBarMenuButton::OnCalculateSize

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parâmetros

[in] pDC
[in] sizeDefault
[in] bHorz

Valor de retorno

Comentários

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Comentários

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parâmetros

[in] pWndParent

Comentários

CMFCToolBarMenuButton::OnClick

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parâmetros

[in] pWnd
[in] bDelay

Valor de retorno

Comentários

CMFCToolBarMenuButton::OnClickMenuItem

Chamado pela estrutura quando o usuário seleciona um item no menu suspenso.

virtual BOOL OnClickMenuItem();

Valor de retorno

FALSE se a estrutura deve continuar o processamento de item de menu padrão; caso contrário, TRUE. A implementação padrão sempre retorna FALSE.

Comentários

Quando o usuário clica em um item de menu, a estrutura executa um comando associado a esse item.

Para personalizar o processamento de item de menu, substitua OnClickMenuItem em uma classe derivada da classe CMFCToolBarMenuButton. Você também deve substituir CFrameWndEx::OnShowPopupMenu e substituir os botões de menu que exigem processamento especial por instâncias da classe derivada.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parâmetros

[in] pWnd

Valor de retorno

Comentários

CMFCToolBarMenuButton::OnDraw

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parâmetros

[in] pDC
[in] rect
[in] pImages
[in] bHorz
[in] bCustomizeMode
[in] bHighlight
[in] bDrawBorder
[in] bGrayDisabledButtons

Comentários

CMFCToolBarMenuButton::OnDrawOnCustomizeList

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parâmetros

[in] pDC
[in] rect
[in] bSelected

Valor de retorno

Comentários

CMFCToolBarMenuButton::OpenPopupMenu

Chamado pela estrutura quando o usuário abre o menu suspenso de um botão de menu da barra de ferramentas.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parâmetros

pWnd
[in] Especifica a janela que recebe os comandos de menu suspenso. Ele só poderá ser NULL se o botão de menu da barra de ferramentas tiver uma janela pai.

Valor de retorno

TRUE quando um objeto Classe CMFCPopupMenu foi criado e aberto com êxito; caso contrário, FALSE.

Comentários

Essa função é chamada pela estrutura quando o usuário abre um menu suspenso de um botão de menu da barra de ferramentas.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Comentários

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Comentários

A estrutura chama esse método quando cria um botão de barra de ferramentas como resultado de uma operação do tipo "arrastar e soltar". Esse método chama o método CMFCPopupMenu::SaveState do menu pop-up de nível superior, o que faz com que o botão pai do menu pop-up recrie seu menu.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parâmetros

[in] ar

Comentários

CMFCToolBarMenuButton::SetACCData

Define os dados de acessibilidade para o elemento de faixa de opções.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parâmetros

pParent
A janela pai do elemento de faixa de opções.

data
Os dados de acessibilidade para o elemento de faixa de opções.

Valor de retorno

Sempre retorna TRUE.

Comentários

Por padrão, esse método define os dados de acessibilidade para o elemento de faixa de opções e sempre retorna TRUE. Substitua esse método para definir os dados de acessibilidade e retornar um valor que indique êxito ou falha.

CMFCToolBarMenuButton::SetMenuOnly

Especifica se o botão é desenhado como um botão de menu ou um botão de divisão quando ele tem uma ID de comando válida e um submenu.

void SetMenuOnly(BOOL bMenuOnly);

Parâmetros

bMenuOnly
[in] TRUE para mostrar esse botão como um botão de menu quando ele tem uma ID de comando válida e um submenu; FALSE para mostrar esse botão como um botão de divisão quando ele tem uma ID de comando válida e um submenu.

Comentários

Normalmente, quando um botão de menu da barra de ferramentas tem um submenu e uma ID de comando, o menu parece ser um botão de divisão que tem um botão principal e um botão de seta para baixo anexado. Se você chamar esse método e bMenuOnly for TRUE, o botão parecerá ser um único botão de menu com uma seta para baixo no botão. Quando o usuário clica na seta em qualquer modo, o submenu é aberto; quando o usuário clica na parte de não seta do botão em qualquer modo, a estrutura executa o comando.

CMFCToolBarMenuButton::SetMenuPaletteMode

Especifica se o menu suspenso está no modo de paleta.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parâmetros

bMenuPaletteMode
[in] Especifica se o menu suspenso está no modo de paleta.

nPaletteRows
[in] Número de linhas na paleta.

Comentários

No modo de paleta, todos os itens de menu são exibidos como uma paleta de várias colunas. Especifique o número de linhas usando nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parâmetros

[in] pWndMessage

Comentários

CMFCToolBarMenuButton::SetRadio

Define o botão de menu da barra de ferramentas para exibir um ícone de estilo de botão de opção quando ele é verificado.

virtual void SetRadio();

Comentários

Quando o botão de menu é desenhado enquanto está marcado, ele chama CMFCVisualManager::OnDrawMenuCheck para desenhar um ícone de marca de seleção. Por padrão, OnDrawMenuCheck solicita que o gerenciador visual atual desmarque uma marca de seleção de estilo de caixa de seleção no botão de menu. Depois de chamar esse método, o gerenciador visual atual desenha uma marca de seleção de estilo de botão de opção no botão de menu. Essa alteração não pode ser desfeita.

Quando você chamar esse método e o botão de menu estiver sendo exibido no momento, ele será atualizado.

CMFCToolBarMenuButton::SetTearOff

Especifica a ID da barra de extração para o menu suspenso.

virtual void SetTearOff(UINT uiBarID);

Parâmetros

uiBarID
[in] Especifica uma nova ID da barra de extração.

Comentários

Chame esse método para especificar a ID da barra de extração criada quando o usuário arrastar o botão de menu para fora de uma barra de menus. Se o parâmetro uiBarID for 0, o usuário não poderá extrair o botão de menu.

Chame CWinAppEx::EnableTearOffMenus para habilitar o recurso de menu de extração em seu aplicativo.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBarButton
Classe CMFCToolBar
Classe CMFCPopupMenu

Partilhar via

Classe CMFCToolBarMenuButton

Sintaxe

Membros

Construtores públicos

Métodos públicos

Métodos protegidos

Membros de dados

Comentários

Exemplo

Hierarquia de herança

Requisitos

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Parâmetros

Comentários

Exemplo

CMFCToolBarMenuButton::CompareWith

Parâmetros

Valor de retorno

Comentários

CMFCToolBarMenuButton::CopyFrom

Parâmetros

Comentários

CMFCToolBarMenuButton::CreateFromMenu

Parâmetros

Comentários

CMFCToolBarMenuButton::CreateMenu

Valor de retorno

Comentários

CMFCToolBarMenuButton::CreatePopupMenu

Valor de retorno

Comentários

CMFCToolBarMenuButton::DrawDocumentIcon

Parâmetros

Comentários

CMFCToolBarMenuButton::EnableQuickCustomize

Comentários

CMFCToolBarMenuButton::HasButton

Valor de retorno

Comentários

CMFCToolBarMenuButton::HaveHotBorder

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsBorder

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsClickedOnMenu

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsQuickMode

Valor de retorno

Comentários

CMFCToolBarMenuButton::GetCommands

Valor de retorno

Comentários

CMFCToolBarMenuButton::GetImageRect

Parâmetros

CMFCToolBarMenuButton::GetPaletteRows

Valor de retorno

Comentários

CMFCToolBarMenuButton::GetPopupMenu

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsDroppedDown

Valor de retorno

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsExclusive

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsMenuPaletteMode

Valor de retorno

Comentários

CMFCToolBarMenuButton::IsTearOffMenu

Valor de retorno

Comentários

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Comentários

CMFCToolBarMenuButton::OnAfterCreatePopupMenu