Classe CMFCMenuBar

Artigo
08/04/2024

Uma barra de menus que implementa o encaixe. 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 CMFCMenuBar : public CMFCToolbar

Membros

Métodos públicos

Nome	Descrição
CMFCMenuBar::AdjustLocations	(Substitui `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Especifica se os rótulos de texto podem ser mostrados abaixo das imagens nos botões da barra de ferramentas. (Substitui CMFCToolBar::AllowChangeTextLabels.)
CMFCMenuBar::AllowShowOnPaneMenu	(Substitui `CPane::AllowShowOnPaneMenu`.)
CMFCMenuBar::CalcFixedLayout	Calcula o tamanho horizontal da barra de ferramentas. (Substitui CMFCToolBar::CalcFixedLayout.)
CMFCMenuBar::CalcLayout	(Substitui `CMFCToolBar::CalcLayout`.)
CMFCMenuBar::CalcMaxButtonHeight	Calcula a altura máxima dos botões na barra de ferramentas. (Substitui CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Especifica se um usuário pode fechar a barra de ferramentas. (Substitui CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Determina se o sistema pode restaurar o estado original de uma barra de ferramentas após a personalização. (Substitui CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Create	Cria um controle de menu e o anexa a um objeto `CMFCMenuBar`.
CMFCMenuBar::CreateEx	Cria um objeto `CMFCMenuBar` com opções de estilo adicionais.
CMFCMenuBar::CreateFromMenu	Inicializa um objeto `CMFCMenuBar`. Aceita um parâmetro HMENU que atua como um modelo para um `CMFCMenuBar` preenchido.
CMFCMenuBar::EnableHelpCombobox	Habilita uma caixa de combinação de Ajuda localizada no lado direito da barra de menus.
CMFCMenuBar::EnableMenuShadows	Especifica se as sombras devem ser exibidas para menus pop-up.
CMFCMenuBar::GetAvailableExpandSize	(Substitui CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Retorna a largura dos botões da barra de ferramentas. (Substitui CMFCToolBar::GetColumnWidth.)
CMFCMenuBar::GetDefaultMenu	Retorna um identificador para o menu original no arquivo de recurso.
CMFCMenuBar::GetDefaultMenuResId	Retorna o identificador de recurso para o menu original no arquivo de recurso.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	Retorna um ponteiro para a caixa de combinação de Ajuda.
CMFCMenuBar::GetHMenu	Retorna o identificador para o menu anexado ao objeto `CMFCMenuBar`.
CMFCMenuBar::GetMenuFont	Retorna a fonte global atual para objetos de menu.
CMFCMenuBar::GetMenuItem	Retorna o botão de barra de ferramentas associado ao índice de item fornecido.
CMFCMenuBar::GetRowHeight	Retorna a altura dos botões da barra de ferramentas. (Substitui CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Indica se os itens de menu desabilitados estão realçados.
CMFCMenuBar::IsButtonExtraSizeAvailable	Determina se a barra de ferramentas pode exibir botões que têm bordas estendidas. (Substitui CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Indica se os itens desabilitados estão realçados.
CMFCMenuBar::IsMenuShadows	Indica se as sombras são desenhadas para menus pop-up.
CMFCMenuBar::IsRecentlyUsedMenus	Indica se os comandos de menu usados recentemente são exibidos na barra de menus.
CMFCMenuBar::IsShowAllCommands	Indica se os menus pop-up exibem todos os comandos.
CMFCMenuBar::IsShowAllCommandsDelay	Indica se os menus exibem todos os comandos após um breve atraso.
CMFCMenuBar::LoadState	Carrega o estado do objeto `CMFCMenuBar` do Registro.
CMFCMenuBar::OnChangeHot	Chamado pela estrutura quando um usuário seleciona um botão na barra de ferramentas. (Substitui CMFCToolBar::OnChangeHot.)
CMFCMenuBar::OnDefaultMenuLoaded	Chamado pela estrutura quando uma janela de quadro carrega o menu padrão do arquivo de recurso.
CMFCMenuBar::OnSendCommand	(Substitui `CMFCToolBar::OnSendCommand`.)
CMFCMenuBar::OnSetDefaultButtonText	Chamado pela estrutura quando um menu está no modo de personalização e o usuário altera o texto de um item de menu.
CMFCMenuBar::OnToolHitTest	(Substitui `CMFCToolBar::OnToolHitTest`.)
CMFCMenuBar::PreTranslateMessage	(Substitui `CMFCToolBar::PreTranslateMessage`.)
CMFCMenuBar::RestoreOriginalstate	Chamado pela estrutura quando um menu está no modo de personalização e o usuário seleciona Redefinir para uma barra de menus.
CMFCMenuBar::SaveState	Salva o estado do objeto `CMFCMenuBar` no Registro.
CMFCMenuBar::SetDefaultMenuResId	Define o menu original no arquivo de recurso.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	Chamado pela estrutura quando uma janela filho MDI altera seu modo de exibição. Se a janela filho do MDI for maximizada recentemente ou não for mais maximizada, esse método atualizará a barra de menus.
CMFCMenuBar::SetMenuButtonRTC	Define as informações de classe de runtime geradas quando o usuário cria dinamicamente botões de menu.
CMFCMenuBar::SetMenuFont	Define a fonte para todos os menus no aplicativo.
CMFCMenuBar::SetRecentlyUsedMenus	Especifica se uma barra de menus exibe comandos de menu usados recentemente.
CMFCMenuBar::SetShowAllCommands	Especifica se a barra de menus mostra todos os comandos.

Comentários

A classe CMFCMenuBar é uma barra de menus que implementa a funcionalidade de encaixe. Assemelha-se a uma barra de ferramentas, embora não possa ser fechada, ela é sempre exibida.

CMFCMenuBar dá suporte à opção de exibir objetos de item de menu usados recentemente. Se essa opção estiver habilitada, CMFCMenuBar exibirá apenas um subconjunto dos comandos disponíveis na primeira exibição. Depois disso, os comandos usados recentemente são exibidos junto com o subconjunto original de comandos. Além disso, o usuário sempre pode expandir o menu para exibir todos os comandos disponíveis. Assim, cada comando disponível é configurado para exibição constante ou para exibição somente se tiver sido selecionado recentemente.

Para usar um objeto CMFCMenuBar, insira-o no objeto de quadro de janela principal. Ao processar a mensagem WM_CREATE, chame CMFCMenuBar::Create ou CMFCMenuBar::CreateEx. Independentemente de qual função de criação você usa, passe um ponteiro para a janela de quadro principal. Então habilite o encaixe chamando CFrameWndEx::EnableDocking. Encaixe esse menu chamando CFrameWndEx::DockPane.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCMenuBar. O exemplo mostra como definir o estilo do painel, habilitar o botão personalizar, habilitar uma caixa de Ajuda, habilitar sombras para menus pop-up e atualizar a barra de menus. Este snippet de código faz parte do exemplo de demonstração do IE.

CMFCMenuBar m_wndMenuBar;

m_wndMenuBar.SetPaneStyle(m_wndMenuBar.GetPaneStyle() | CBRS_SIZE_DYNAMIC);
m_wndMenuBar.EnableCustomizeButton(TRUE, -1, _T(""));
// first parameter is the command ID for the button of the Help combo box
// third parameter is the width of the button for the combo box in pixels.
m_wndMenuBar.EnableHelpCombobox(1, _T("enter text here"), 30);
m_wndMenuBar.EnableMenuShadows();
m_wndMenuBar.SetMaximizeMode(true);

Hierarquia de herança

CMFCMenuBar

Requisitos

Cabeçalho: afxmenubar.h

CMFCMenuBar::AdjustLocations

Ajusta as posições dos itens de menu na barra de menus.

virtual void AdjustLocations();

Comentários

CMFCMenuBar::AllowChangeTextLabels

Determina se os rótulos de texto são permitidos em imagens na barra de menus.

virtual BOOL AllowChangeTextLabels() const;

Valor de retorno

Retorna TRUE se o usuário puder optar por mostrar rótulos de texto em imagens.

Comentários

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Valor de retorno

Comentários

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parâmetros

[in] bStretch

[in] bHorz

Valor de retorno

Comentários

CMFCMenuBar::CalcLayout

virtual CSize CalcLayout(
    DWORD dwMode,
    int nLength = -1);

Parâmetros

[in] dwMode

[in] nLength

Valor de retorno

Comentários

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Valor de retorno

Comentários

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Valor de retorno

Comentários

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Valor de retorno

Comentários

CMFCMenuBar::Create

Cria um controle de menu e o anexa a um objeto CMFCMenuBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID = AFX_IDW_MENUBAR);

Parâmetros

pParentWnd
[in] Ponteiro para a janela pai para o novo objeto CMFCMenuBar.

dwStyle
[in] O estilo da nova barra de menus.

Nid
[in] A ID da janela filho da barra de menus.

Valor de retorno

TRUE se tiver êxito; caso contrário, FALSE.

Comentários

Depois de construir um objeto CMFCMenuBar, você deve chamar Create. Esse método cria o controle CMFCMenuBar e o anexa ao objeto CMFCMenuBar.

Para mais informações sobre estilos de barra de ferramentas, confira CBasePane::SetPaneStyle.

CMFCMenuBar::CreateEx

Cria um objeto CMFCMenuBar com estilos estendidos especificados.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = TBSTYLE_FLAT,
    DWORD dwStyle = AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders = CRect(1,
    1,
    1,
    1),
    UINT nID =AFX_IDW_MENUBAR);

Parâmetros

pParentWnd
[in] Ponteiro para a janela pai do novo objeto CMFCMenuBar.

dwCtrlStyle
[in] Estilos adicionais para a nova barra de menus.

dwStyle
[in] O estilo principal da nova barra de menus.

rcBorders
[in] Um parâmetro CRect que especifica os tamanhos das bordas do objeto CMFCMenuBar.

Nid
[in] A ID da janela filho da barra de menus.

Valor de retorno

Um valor diferente de zero, se o método tiver êxito. Caso contrário, 0.

Comentários

Você deve usar essa função em vez de CMFCMenuBar::Create quando quiser especificar estilos além do estilo da barra de ferramentas. Alguns estilos adicionais usados com frequência são TBSTYLE_TRANSPARENT e CBRS_TOP.

Para obter listas de estilos adicionais, confira Controle de Barra de Ferramentas e Estilos de Botão, Estilos de Controle Comuns e Estilos de Janela Comuns.

Exemplo

O exemplo a seguir demonstra como usar o método CreateEx da classe CMFCMenuBar. Este snippet de código faz parte do exemplo de demonstração do IE.

CMFCMenuBar m_wndMenuBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndMenuBar.CreateEx(this, TBSTYLE_TRANSPARENT))
{
   TRACE0("Failed to create menubar\n");
   return -1; // fail to create
}

CMFCMenuBar::CreateFromMenu

Inicializa um objeto CMFCMenuBar. Esse método modela o objeto CMFCMenuBar após um parâmetro HMENU.

virtual void CreateFromMenu(
    HMENU hMenu,
    BOOL bDefaultMenu = FALSE,
    BOOL bForceUpdate = FALSE);

Parâmetros

hMenu
[in] Um identificador para um recurso de menu. CreateFromMenu usa esse recurso como um modelo para o CMFCMenuBar.

bDefaultMenu
[in] Um booliano que indica se o novo menu é o menu padrão.

bForceUpdate
[in] Um booliano que indica se esse método força uma atualização de menu.

Comentários

Use esse método se quiser que um controle de menu tenha os mesmos itens de menu que um recurso de menu. Chame esse método depois de chamar CMFCMenuBar::Create ou CMFCMenuBar::CreateEx.

CMFCMenuBar::EnableHelpCombobox

Habilita uma caixa de combinação de Ajuda localizada no lado direito da barra de menus.

void EnableHelpCombobox(
    UINT uiID,
    LPCTSTR lpszPrompt = NULL,
    int nComboBoxWidth = 150);

Parâmetros

uiID
[in] A ID de comando para o botão da caixa de combinação Ajuda.

lpszPrompt
[in] Uma cadeia de caracteres que contém o texto que a estrutura exibe na caixa de combinação se ela estiver vazia e não estiver ativa. Por exemplo, "Insira o texto aqui".

nComboBoxWidth
[in] A largura do botão para a caixa de combinação em pixels.

Comentários

A caixa de combinação Ajuda é semelhante à caixa de combinação Ajuda na barra de menus do Microsoft Word.

Quando você chama esse método com uiID definido como 0, esse método oculta a caixa de combinação. Caso contrário, esse método exibe a caixa de combinação automaticamente no lado direito da barra de menus. Depois de chamar esse método, chame CMFCMenuBar::GetHelpCombobox para obter um ponteiro para o objeto CMFCToolBarComboBoxButton inserido.

CMFCMenuBar::EnableMenuShadows

Habilita sombras para menus pop-up.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parâmetros

bEnable
[in] Um parâmetro booliano que indica se as sombras devem ser habilitadas para menus pop-up.

Comentários

O algoritmo usado por esse método é complexo e pode diminuir o desempenho do aplicativo em sistemas mais lentos.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Valor de retorno

Comentários

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Valor de retorno

Comentários

CMFCMenuBar::GetDefaultMenu

Recupera um identificador no menu original. A estrutura carrega o menu original do arquivo de recurso.

HMENU GetDefaultMenu() const;

Valor de retorno

Um identificador para um recurso de menu.

Comentários

Se o aplicativo personalizar um menu, você poderá usar esse método para recuperar um identificador no menu original.

CMFCMenuBar::GetDefaultMenuResId

Recupera o identificador de recurso para o menu padrão.

UINT GetDefaultMenuResId() const;

Valor de retorno

Um identificador de recurso de menu.

Comentários

A estrutura carrega o menu padrão para o objeto CMFCMenuBar do arquivo de recurso.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Parâmetros

[in] pButton

Valor de retorno

Comentários

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Valor de retorno

Comentários

CMFCMenuBar::GetHelpCombobox

Retorna um ponteiro para a caixa de combinação de Ajuda.

CMFCToolBarComboBoxButton* GetHelpCombobox();

Valor de retorno

Um ponteiro para a caixa de combinação Ajuda. NULL se a caixa de combinação Ajuda estiver oculta ou não estiver habilitada.

Comentários

A caixa de combinação Ajuda está localizada no lado direito da barra de menus. Chame o método CMFCMenuBar::EnableHelpCombobox para habilitar essa caixa de combinação.

CMFCMenuBar::GetHMenu

Recupera o identificador no menu anexado ao objeto CMFCMenuBar.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Recupera a fonte de menu atual.

static const CFont& GetMenuFont(BOOL bHorz = TRUE);

Parâmetros

bHorz
[in] Um parâmetro booliano que especifica se a fonte horizontal ou vertical deve ser retornada. TRUE indica a fonte horizontal.

Valor de retorno

Um ponteiro para um parâmetro CFont que contém a fonte da barra de menus atual.

Comentários

A fonte retornada é um parâmetro global para o aplicativo. Duas fontes globais são mantidas para todos os objetos CMFCMenuBar. Essas fontes separadas são usadas para barras de menu horizontais e verticais.

CMFCMenuBar::GetMenuItem

Recupera um objeto CMFCToolBarButton em uma barra de menus com base no índice de item.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parâmetros

iItem
[in] O índice do item de menu a retornar.

Valor de retorno

Um ponteiro para o objeto CMFCToolBarButton que corresponde ao índice especificado pelo iItem. NULL se o índice for inválido.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Valor de retorno

Comentários

CMFCMenuBar::GetSystemButton

CMFCToolBarMenuButtonsButton* GetSystemButton(
    UINT uiBtn,
    BOOL bByCommand = TRUE) const;

Parâmetros

[in] uiBtn

[in] bByCommand

Valor de retorno

Comentários

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Valor de retorno

Comentários

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Valor de retorno

Comentários

CMFCMenuBar::HighlightDisabledItems

Controla se a estrutura realça itens de menu desabilitados.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parâmetros

bHighlight
[in] Um parâmetro booliano que indica se a estrutura realça itens de menu indisponíveis.

Comentários

Por padrão, a estrutura não realça itens de menu indisponíveis quando o usuário posiciona o ponteiro do mouse sobre eles.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Valor de retorno

Comentários

CMFCMenuBar::IsHighlightDisabledItems

Indica se a estrutura realça itens de menu indisponíveis.

static BOOL IsHighlightDisabledItems();

Valor de retorno

TRUE se itens de menu indisponíveis estiverem realçados; caso contrário, FALSE.

Comentários

Por padrão, a estrutura não realça itens de menu indisponíveis quando o usuário posiciona o ponteiro do mouse sobre eles. Use o método CMFCMenuBar::HighlightDisabledItems para habilitar esse recurso.

CMFCMenuBar::IsMenuShadows

Indica se a estrutura desenha sombras para menus pop-up.

static BOOL IsMenuShadows();

Valor de retorno

TRUE se a estrutura desenha sombras de menu; caso contrário, FALSE.

Comentários

Use o método CMFCMenuBar::EnableMenuShadows para habilitar ou desabilitar esse recurso.

CMFCMenuBar::IsRecentlyUsedMenus

Indica se os comandos de menu usados recentemente são exibidos na barra de menus.

static BOOL IsRecentlyUsedMenus();

Valor de retorno

Não zero se o objeto CMFCMenuBar mostrar comandos de menu usados recentemente; caso contrário, 0.

Comentários

Use a função CMFCMenuBar::SetRecentlyUsedMenus para controlar se a barra de menus mostra comandos de menu usados recentemente.

CMFCMenuBar::IsShowAllCommands

Indica se os menus exibem todos os comandos.

static BOOL IsShowAllCommands();

Valor de retorno

Não zero se o comando CMFCMenuBar for exibido; caso contrário, 0.

Comentários

Um objeto CMFCMenuBar pode ser configurado para mostrar todos os comandos ou mostrar apenas um subconjunto de comandos. Para mais informações sobre esse recurso, confira Classe CMFCMenuBar.

IsShowAllCommands informará como esse recurso está configurado para o objeto CMFCMenuBar. Para controlar quais comandos de menu são mostrados, use os métodos CMFCMenuBar::SetShowAllCommands e CMFCMenuBar::SetRecentlyUsedMenus.

CMFCMenuBar::IsShowAllCommandsDelay

Indica se o objeto CMFCMenuBar exibe todos os comandos após um curto atraso.

static BOOL IsShowAllCommandsDelay();

Valor de retorno

Não zero se a barra de menus exibir menus completos após um pequeno atraso; caso contrário, 0.

Comentários

Quando você configura uma barra de menus para exibir itens usados recentemente, a barra de menus exibe o menu completo de uma das duas maneiras:

Exibir o menu completo após um atraso programado de quando o usuário passa o cursor sobre a seta na parte inferior do menu.
Exibir o menu completo depois que o usuário clicar na seta na parte inferior do menu.

Por padrão, todos os objetos CMFCMenuBar usam a opção para exibir o menu completo após um pequeno atraso. Essa opção não pode ser alterada programaticamente na classe CMFCMenuBar. No entanto, um usuário pode alterar o comportamento durante a personalização da barra de ferramentas usando a caixa de diálogo Personalizar.

CMFCMenuBar::LoadState

Carrega o estado da barra de menus do Registro do Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT)-1);

Parâmetros

lpszProfileName
[in] Uma cadeia de caracteres que contém o caminho de uma chave do Registro do Windows.

nIndex
[in] A ID de controle da barra de menus.

uiID
[in] Um valor reservado.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE.

Comentários

Use o método CMFCMenuBar::SaveState para salvar o estado da barra de menus no Registro. As informações salvas incluem os itens de menu, o estado de encaixe e a posição da barra de menus.

Na maioria dos casos, seu aplicativo não chama LoadState. A estrutura chama esse método quando inicializa o workspace.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parâmetros

[in] iHot

Comentários

CMFCMenuBar::OnDefaultMenuLoaded

A estrutura chama esse método quando carrega o recurso de menu do arquivo de recurso.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Parâmetros

hMenu
[in] O identificador do menu anexado ao objeto CMFCMenuBar.

Comentários

A implementação padrão dessa função não faz nada. Substitua essa função para executar o código personalizado depois que a estrutura carregar um recurso de menu do arquivo de recurso.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parâmetros

[in] pButton

Valor de retorno

Comentários

CMFCMenuBar::OnSetDefaultButtonText

A estrutura chama esse método quando o usuário altera o texto de um item na barra de menus.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parâmetros

pButton
[in] Um ponteiro para o objeto CMFCToolBarButton que o usuário deseja personalizar.

Valor de retorno

TRUE se a estrutura aplicar as alterações do usuário à barra de menus; caso contrário, FALSE.

Comentários

A implementação padrão para esse método altera o texto do botão para o texto que o usuário fornece.

CMFCMenuBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Parâmetros

[in] point

[in] pTI

Valor de retorno

Comentários

CMFCMenuBar::PreTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

[in] pMsg

Valor de retorno

Comentários

CMFCMenuBar::RestoreOriginalstate

Chamado pela estrutura quando o usuário seleciona Redefinir na caixa de diálogo Personalizar.

virtual BOOL RestoreOriginalstate();

Valor de retorno

Um valor diferente de zero, se o método tiver êxito. Caso contrário, 0.

Comentários

Esse método é chamado quando o usuário seleciona Redefinir no menu de personalização. Você também pode chamar manualmente esse método para redefinir o estado da barra de menus de modo programático. Esse método carrega o estado original do arquivo de recursos.

Substitua esse método se você quiser fazer qualquer processamento quando o usuário selecionar a opção Redefinir.

CMFCMenuBar::SaveState

Salva o estado do objeto CMFCMenuBar no Registro do Windows.

virtual BOOL SaveState (
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT)-1);

Parâmetros

lpszProfileName
[in] Uma cadeia de caracteres que contém o caminho de uma chave do Registro do Windows.

nIndex
[in] A ID de controle da barra de menus.

uiID
[in] Um valor reservado.

Valor de retorno

TRUE se bem-sucedido, caso contrário, FALSE;

Comentários

Normalmente, seu aplicativo não chama SaveState. A estrutura chama esse método quando o workspace é serializado. Para mais informações, confira CWinAppEx::SaveState.

As informações salvas incluem os itens de menu, o estado de encaixe e a posição da barra de menus.

CMFCMenuBar::SetDefaultMenuResId

Define o menu padrão para um objeto CMFCMenuBar com base na ID do recurso.

void SetDefaultMenuResId(UINT uiResId);

Parâmetros

uiResId
[in] A ID do recurso para o novo menu padrão.

Comentários

O método CMFCMenuBar::RestoreOriginalstate restaura o menu padrão do arquivo de recurso.

Use o método CMFCMenuBar::GetDefaultMenuResId para recuperar o menu padrão sem restaurá-lo.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Parâmetros

[in] bValue

Comentários

CMFCMenuBar::SetMaximizeMode

A estrutura chama esse método quando um MDI altera seu modo de exibição e a barra de menus deve ser atualizada.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL,
    BOOL bRecalcLayout = TRUE);

Parâmetros

bMax
[in] Um booliano que especifica o modo. Confira a seção Comentários para obter mais informações.

pWnd
[in] Um ponteiro para a janela filho do MDI que está sendo alterada.

bRecalcLayout
[in] Um booliano que especifica se o layout da barra de menus deve ser recalculado imediatamente.

Comentários

Quando uma janela filho MDI é maximizada, uma barra de menus anexada à janela do quadro principal do MDI exibe o menu de sistema e os botões Minimizar, Maximizar e Fechar. Se bMax for TRUE e pWnd não for NULL, a janela filho do MDI será maximizada e a barra de menus deverá incorporar os controles extras. Caso contrário, a barra de menus retornará ao seu estado regular.

CMFCMenuBar::SetMenuButtonRTC

Define as informações de classe de runtime que a estrutura usa quando o usuário cria botões de menu.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parâmetros

pMenuButtonRTC
[in] As informações de CRuntimeClass para uma classe derivada da Classe CMFCMenuButton.

Comentários

Quando um usuário adiciona novos botões à barra de menus, a estrutura cria os botões dinamicamente. Por padrão, ela cria objetos CMFCMenuButton. Substitua esse método para alterar o tipo de objetos de botão que a estrutura cria.

CMFCMenuBar::SetMenuFont

Define a fonte para todas as barras de menu em seu aplicativo.

static BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz = TRUE);

Parâmetros

lpLogFont
[in] Um ponteiro para uma estrutura LOGFONT que define a fonte a ser definida.

bHorz
[in] TRUE se você quiser que o parâmetro lpLogFont seja usado para a fonte vertical; FALSE se quiser que ele seja usado para fonte horizontal.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE.

Comentários

Duas fontes são usadas para todos os objetos CMFCMenuBar. Essas fontes separadas são usadas para barras de menu horizontais e verticais.

As configurações de fonte são variáveis globais e afetam todos os objetos CMFCMenuBar.

CMFCMenuBar::SetRecentlyUsedMenus

Controla se uma barra de menus exibe comandos de menu usados recentemente.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Parâmetros

bOn
[in] Um booliano que controla se os comandos de menu usados recentemente são exibidos.

CMFCMenuBar::SetShowAllCommands

Controla se um menu mostra todos os comandos disponíveis.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Parâmetros

bShowAllCommands
[in] Um parâmetro booliano que especifica se o menu pop-up mostra todos os comandos do menu.

Comentários

Se um menu não exibir todos os comandos de menu, ele ocultará os comandos que raramente são usados. Para mais informações sobre como exibir comandos de menu, confira Classe CMFCMenuBar.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBar

Partilhar via

Classe CMFCMenuBar

Sintaxe

Membros

Métodos públicos

Comentários

Exemplo

Hierarquia de herança

Requisitos

CMFCMenuBar::AdjustLocations

Comentários

CMFCMenuBar::AllowChangeTextLabels

Valor de retorno

Comentários

CMFCMenuBar::AllowShowOnPaneMenu

Valor de retorno

Comentários

CMFCMenuBar::CalcFixedLayout

Parâmetros

Valor de retorno

Comentários

CMFCMenuBar::CalcLayout

Parâmetros

Valor de retorno

Comentários

CMFCMenuBar::CalcMaxButtonHeight

Valor de retorno

Comentários

CMFCMenuBar::CanBeClosed

Valor de retorno

Comentários

CMFCMenuBar::CanBeRestored

Valor de retorno

Comentários

CMFCMenuBar::Create

Parâmetros

Valor de retorno

Comentários

CMFCMenuBar::CreateEx

Parâmetros

Valor de retorno

Comentários

Exemplo

CMFCMenuBar::CreateFromMenu

Parâmetros

Comentários

CMFCMenuBar::EnableHelpCombobox

Parâmetros

Comentários

CMFCMenuBar::EnableMenuShadows

Parâmetros

Comentários

CMFCMenuBar::GetAvailableExpandSize

Valor de retorno

Comentários

CMFCMenuBar::GetColumnWidth

Valor de retorno

Comentários

CMFCMenuBar::GetDefaultMenu

Valor de retorno

Comentários

CMFCMenuBar::GetDefaultMenuResId

Valor de retorno

Comentários

CMFCMenuBar::GetFloatPopupDirection

Parâmetros

Valor de retorno

Comentários

CMFCMenuBar::GetForceDownArrows

Valor de retorno

Comentários

CMFCMenuBar::GetHelpCombobox

Valor de retorno

Comentários

CMFCMenuBar::GetHMenu

CMFCMenuBar::GetMenuFont

Parâmetros

Valor de retorno

Comentários

CMFCMenuBar::GetMenuItem