Classe CMFCMenuBar

Artigo
02/04/2025

Uma barra de menus que implementa o encaixe. Para obter mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da instalação do Visual Studio.

Sintaxe

class CMFCMenuBar : public CMFCToolbar

Membros

Métodos Públicos

Designação	Descrição
CMFCMenuBar::AdjustLocations	(Substitui `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Especifica se os rótulos de texto podem ser mostrados em 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 uma barra de ferramentas para seu estado original após a personalização. (Substitui CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Criar	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 Ajuda do 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 Ajuda do.
CMFCMenuBar::GetHMenu	Retorna o identificador para o menu que está anexado ao objeto `CMFCMenuBar`.
CMFCMenuBar::GetMenuFont	Retorna a fonte global atual para objetos de menu.
CMFCMenuBar::GetMenuItem	Retorna o botão da 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 desativados estão realçados.
CMFCMenuBar::IsButtonExtraSizeDisponível	Determina se a barra de ferramentas pode exibir botões com 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 pequeno 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::P reTranslateMessage	(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 MDI for recentemente maximizada ou não for mais maximizada, esse método atualizará a barra de menus.
CMFCMenuBar::SetMenuButtonRTC	Define as informações de classe de tempo de execução que são 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 - é sempre exibida.

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

Para usar um objeto CMFCMenuBar, incorpore-o no objeto do quadro da janela principal. Ao processar a mensagem WM_CREATE, ligue para CMFCMenuBar::Create ou CMFCMenuBar::CreateEx. Independentemente da função de criação usada, passe um ponteiro para a janela do quadro principal. Em seguida, habilite o encaixe chamando CFrameWndEx::EnableDocking. Encaixe este menu chamando CFrameWndEx::D ockPane.

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 trecho 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

CObject

CCmdTarget

CMFCMenuBar

Requerimentos

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 sob 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

[em] bStretch

[em] bHorz

Valor de retorno

Comentários

CMFCMenuBar::CalcLayout

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

Parâmetros

[em] dwMode

[em] 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::Criar

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
[em] Ponteiro para a janela pai do novo objeto CMFCMenuBar.

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

nID
[em] O ID da janela filho da barra de menus.

Valor de retorno

VERDADEIRO se bem sucedido; caso contrário, FALSE.

Comentários

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

Para obter mais informações sobre estilos de barra de ferramentas, consulte 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
[em] Ponteiro para a janela pai do novo objeto CMFCMenuBar.

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

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

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

nID
[em] O ID da janela filho da barra de menus.

Valor de retorno

Diferente de zero se o método for bem-sucedido; 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, consulte de Controle da Barra de Ferramentas e Estilos de Botão , Estilos de controle comunse Estilos de janela comuns.

Exemplo

O exemplo a seguir demonstra como usar o método CreateEx da classe CMFCMenuBar. Este trecho 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. Este 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
[em] Um identificador para um recurso de menu. CreateFromMenu usa esse recurso como um modelo para o CMFCMenuBar.

bDefaultMenu
[em] Um booleano que indica se o novo menu é o menu padrão.

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

Comentários

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

CMFCMenuBar::EnableHelpCombobox

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

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

Parâmetros

uiID
[em] O ID de comando para o botão da caixa de combinação Ajuda do.

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

nComboBoxWidth
[em] 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 de CMFCToolBarComboBoxButton inserido.

CMFCMenuBar::EnableMenuShadows

Ativa sombras para menus pop-up.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parâmetros

bAtivar
[em] Um parâmetro booleano que indica se as sombras devem ser habilitadas para menus pop-up.

Comentários

O algoritmo que este método utiliza é complexo e pode diminuir o desempenho da sua aplicação 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 para o 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 seu aplicativo personaliza um menu, você pode usar esse método para recuperar um identificador para o 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

[em] 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 Ajuda do.

CMFCToolBarComboBoxButton* GetHelpCombobox();

Valor de retorno

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

Comentários

A caixa de combinação Ajuda do 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 para o menu anexado ao objeto CMFCMenuBar.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Recupera a fonte do menu atual.

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

Parâmetros

bHorz
[em] Um parâmetro booleano 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 atual da barra de menus.

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 do item.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parâmetros

iItem
[em] O índice do item de menu a ser retornado.

Valor de retorno

Um ponteiro para o objeto CMFCToolBarButton que corresponde ao índice especificado por 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

[em] uiBtn

[em] 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 desativados.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parâmetros

bDestaque
[em] Um parâmetro booleano que indica se a estrutura destaca 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::IsButtonExtraSizeDisponível

virtual BOOL IsButtonExtraSizeAvailable() const;

Valor de retorno

Comentários

CMFCMenuBar::IsHighlightDisabledItems

Indica se a estrutura destaca itens de menu indisponíveis.

static BOOL IsHighlightDisabledItems();

Valor de retorno

TRUE se os itens de menu indisponíveis forem 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

Diferente de 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

Diferente de zero se o CMFCMenuBar exibir todos os comandos; 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 obter mais informações sobre esse recurso, consulte CMFCMenuBar Class.

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 pequeno atraso.

static BOOL IsShowAllCommandsDelay();

Valor de retorno

Diferente de 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:

Exiba o menu completo após um atraso programado a partir de quando o usuário passa o cursor sobre a seta na parte inferior do menu.
Exiba 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. Esta 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
[em] Uma cadeia de caracteres que contém o caminho de uma chave do Registro do Windows.

nIndex
[em] O ID de controle para a barra de menus.

uiID
[em] 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 do dock 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 espaço de trabalho.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parâmetros

[em] 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
[em] O identificador do menu anexado ao objeto CMFCMenuBar.

Comentários

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

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parâmetros

[em] 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
[em] Um ponteiro para o CMFCToolBarButton objeto que o usuário deseja personalizar.

Valor de retorno

TRUE se a estrutura aplica as alterações do usuário na 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

[em] ponto

[em] pTI

Valor de retorno

Comentários

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parâmetros

[em] 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

Diferente de zero se o método for bem-sucedido; 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 programaticamente o estado da barra de menus. Este método carrega o estado original do arquivo de recurso.

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

CMFCMenuBar::SaveState

Salva o estado do objeto de CMFCMenuBar no registro do Windows.

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

Parâmetros

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

nIndex
[em] O ID de controle para a barra de menus.

uiID
[em] Um valor reservado.

Valor de retorno

VERDADEIRO se bem sucedido; caso contrário, FALSO;

Comentários

Normalmente, seu aplicativo não chama SaveState. A estrutura chama esse método quando o espaço de trabalho é serializado. Para obter mais informações, consulte CWinAppEx::SaveState.

As informações salvas incluem os itens de menu, o estado do dock 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
[em] 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

[em] bValor

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
[em] Um booleano que especifica o modo. Consulte a seção Comentários para obter mais informações.

pWnd
[em] Um ponteiro para a janela filho MDI que está mudando.

bRecalcLayout
[em] Um booleano 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 MDI exibe o menu do sistema e os botões Minimizar, Maximizar e Fechar. Se bMax for TRUE e pWnd não for NULL, a janela filho MDI será maximizada e a barra de menus deverá incorporar os controles extras. Caso contrário, a barra de menus retornará ao seu estado normal.

CMFCMenuBar::SetMenuButtonRTC

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

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parâmetros

pMenuButtonRTC
[em] O CRuntimeClass informações para uma classe derivada do CMFCMenuButton Class.

Comentários

Quando um usuário adiciona novos botões à barra de menus, a estrutura cria os botões dinamicamente. Por padrão, ele cria CMFCMenuButton objetos. Substitua esse método para alterar o tipo de objetos button 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
[em] Um ponteiro para uma LOGFONT estrutura que define a fonte a ser definida.

bHorz
[em] TRUE se você quiser que o parâmetro lpLogFont seja usado para a fonte vertical, FALSE se quiser que ele seja usado para a 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
[em] Um booleano 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
[em] Um parâmetro booleano que especifica se o menu pop-up mostra todos os comandos de menu.

Comentários

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

Ver também

Gráfico de Hierarquia
Aulas
CMFCToolBar Classe

Partilhar via

Classe CMFCMenuBar

Sintaxe

Membros

Métodos Públicos

Comentários

Exemplo

Hierarquia de herança

Requerimentos

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::Criar

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