Classe CMFCMenuBar
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.