CMFCMenuBar-klass

Artikel
02/04/2025

En menyrad som implementerar dockning. Mer information finns i källkoden i mappen VC\atlmfc\src\mfc i Visual Studio-installationen.

Syntax

class CMFCMenuBar : public CMFCToolbar

Medlemmar

Offentliga metoder

Namn	Beskrivning
CMFCMenuBar::AdjustLocations	(Åsidosätter `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Anger om textetiketter kan visas under bilder i verktygsfältsknapparna. (Åsidosätter CMFCToolBar::AllowChangeTextLabels.)
CMFCMenuBar::AllowShowOnPaneMenu	(Åsidosätter `CPane::AllowShowOnPaneMenu`.)
CMFCMenuBar::CalcFixedLayout	Beräknar verktygsfältets vågräta storlek. (Åsidosätter CMFCToolBar::CalcFixedLayout.)
CMFCMenuBar::CalcLayout	(Åsidosätter `CMFCToolBar::CalcLayout`.)
CMFCMenuBar::CalcMaxButtonHeight	Beräknar den maximala höjden på knapparna i verktygsfältet. (Åsidosätter CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Anger om en användare kan stänga verktygsfältet. (Åsidosätter CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Avgör om systemet kan återställa ett verktygsfält till sitt ursprungliga tillstånd efter anpassningen. (Åsidosätter CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Skapa	Skapar en menykontroll och kopplar den till ett `CMFCMenuBar` objekt.
CMFCMenuBar::CreateEx	Skapar ett `CMFCMenuBar` objekt med ytterligare formatalternativ.
CMFCMenuBar::CreateFromMenu	Initierar ett `CMFCMenuBar` objekt. Accepterar en HMENU-parameter som fungerar som en mall för en ifylld `CMFCMenuBar`.
CMFCMenuBar::EnableHelpCombobox	Aktiverar en Hjälp kombinationsruta som finns till höger i menyraden.
CMFCMenuBar::EnableMenuShadows	Anger om skuggor ska visas för popup-menyer.
CMFCMenuBar::GetAvailableExpandSize	(Åsidosätter CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Returnerar bredden på verktygsfältsknapparna. (Åsidosätter CMFCToolBar::GetColumnWidth.)
CMFCMenuBar::GetDefaultMenu	Returnerar ett handtag till den ursprungliga menyn i resursfilen.
CMFCMenuBar::GetDefaultMenuResId	Returnerar resursidentifieraren för den ursprungliga menyn i resursfilen.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	Returnerar en pekare till kombinationsrutan Hjälp.
CMFCMenuBar::GetHMenu	Returnerar handtaget till den meny som är kopplad till `CMFCMenuBar`-objektet.
CMFCMenuBar::GetMenuFont	Returnerar det aktuella globala teckensnittet för menyobjekt.
CMFCMenuBar::GetMenuItem	Returnerar verktygsfältsknappen som är associerad med det angivna objektindexet.
CMFCMenuBar::GetRowHeight	Returnerar höjden på verktygsfältsknapparna. (Åsidosätter CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Anger om inaktiverade menyalternativ är markerade.
CMFCMenuBar::IsButtonExtraSizeAvailable	Avgör om verktygsfältet kan visa knappar som har utökade kantlinjer. (Åsidosätter CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Anger om inaktiverade objekt är markerade.
CMFCMenuBar::IsMenuShadows	Anger om skuggor ritas för popup-menyer.
CMFCMenuBar::IsRecentlyUsedMenus	Anger om nyligen använda menykommandon visas på menyraden.
CMFCMenuBar::IsShowAllCommands	Anger om popup-menyer visar alla kommandon.
CMFCMenuBar::IsShowAllCommandsDelay	Anger om menyerna visar alla kommandon efter en kort fördröjning.
CMFCMenuBar::LoadState	Läser in tillståndet för det `CMFCMenuBar` objektet från registret.
CMFCMenuBar::OnChangeHot	Anropas av ramverket när en användare väljer en knapp i verktygsfältet. (Åsidosätter CMFCToolBar::OnChangeHot.)
CMFCMenuBar::OnDefaultMenuLoaded	Anropas av ramverket när ett ramfönster läser in standardmenyn från resursfilen.
CMFCMenuBar::OnSendCommand	(Åsidosätter `CMFCToolBar::OnSendCommand`.)
CMFCMenuBar::OnSetDefaultButtonText	Anropas av ramverket när en meny är i anpassningsläge och användaren ändrar ett menyalternativs text.
CMFCMenuBar::OnToolHitTest	(Åsidosätter `CMFCToolBar::OnToolHitTest`.)
CMFCMenuBar::P reTranslateMessage	(Åsidosätter `CMFCToolBar::PreTranslateMessage`.)
CMFCMenuBar::RestoreOriginalstate	Anropas av ramverket när en meny är i anpassningsläge och användaren väljer Återställ för en menyrad.
CMFCMenuBar::SaveState	Sparar tillståndet för `CMFCMenuBar`-objektet i registret.
CMFCMenuBar::SetDefaultMenuResId	Anger den ursprungliga menyn i resursfilen.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	Anropas av ramverket när ett underordnat MDI-fönster ändrar visningsläget. Om det underordnade MDI-fönstret nyligen har maximerats eller inte längre är maximerat uppdaterar den här metoden menyraden.
CMFCMenuBar::SetMenuButtonRTC	Anger den körningsklassinformation som genereras när användaren dynamiskt skapar menyknappar.
CMFCMenuBar::SetMenuFont	Anger teckensnittet för alla menyer i programmet.
CMFCMenuBar::SetRecentlyUsedMenus	Anger om en menyrad visar nyligen använda menykommandon.
CMFCMenuBar::SetShowAllCommands	Anger om menyraden visar alla kommandon.

Anmärkningar

Klassen CMFCMenuBar är en menyrad som implementerar dockningsfunktioner. Det liknar ett verktygsfält, även om det inte kan stängas – det visas alltid.

CMFCMenuBar stöder alternativet att visa nyligen använda menyobjektobjekt. Om det här alternativet är aktiverat visar CMFCMenuBar endast en delmängd av de tillgängliga kommandona vid första visningen. Därefter visas nyligen använda kommandon tillsammans med den ursprungliga delmängden av kommandon. Dessutom kan användaren alltid expandera menyn för att visa alla tillgängliga kommandon. Därför är varje tillgängligt kommando konfigurerat att visas hela tiden, eller att endast visas om det nyligen har valts.

Om du vill använda ett CMFCMenuBar objekt bäddar du in det i huvudfönstrets ramobjekt. När du bearbetar WM_CREATE-meddelandet anropar du CMFCMenuBar::Create eller CMFCMenuBar::CreateEx. Oavsett vilken create-funktion du använder skickar du en pekare till huvudramsfönstret. Aktivera sedan dockning genom att anropa CFrameWndEx::EnableDocking. Docka den här menyn genom att anropa CFrameWndEx::D ockPane.

Exempel

I följande exempel visas hur du använder olika metoder i klassen CMFCMenuBar. Exemplet visar hur du anger formatmallen för fönstret, aktiverar knappen Anpassa, aktiverar en hjälpruta, aktiverar skuggor för popup-menyer och uppdaterar menyraden. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

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);

Arvshierarki

CMFCMenuBar

Krav

Rubrik: afxmenubar.h

CMFCMenuBar::AdjustLocations

Justerar menyalternativens positioner på menyraden.

virtual void AdjustLocations();

Anmärkningar

CMFCMenuBar::AllowChangeTextLabels

Avgör om textetiketter tillåts under bilder i menyraden.

virtual BOOL AllowChangeTextLabels() const;

Returvärde

Returnerar TRUE om användaren kan välja att visa textetiketter under bilder.

Anmärkningar

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Returvärde

Anmärkningar

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametrar

[in] bStretch

[i] bHorz

Returvärde

Anmärkningar

CMFCMenuBar::CalcLayout

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

Parametrar

[in] dwMode

[i] nLength

Returvärde

Anmärkningar

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Returvärde

Anmärkningar

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Returvärde

Anmärkningar

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Returvärde

Anmärkningar

CMFCMenuBar::Skapa

Skapar en menykontroll och kopplar den till ett CMFCMenuBar- objekt.

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

Parametrar

pParentWnd
[i] Pekare mot det överordnade fönstret för det nya CMFCMenuBar objektet.

dwStyle
[i] Stilen på den nya menyraden.

nID
[i] ID:t för det underordnade fönstret i menyraden.

Returvärde

SANT om det lyckas; annars FALSKT.

Anmärkningar

När du har skapat ett CMFCMenuBar objekt måste du anropa Create. Den här metoden skapar CMFCMenuBar-kontrollen och kopplar den till CMFCMenuBar-objektet.

Mer information om verktygsfältsformat finns i CBasePane::SetPaneStyle.

CMFCMenuBar::CreateEx

Skapar ett CMFCMenuBar- objekt med angivna utökade formatmallar.

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);

Parametrar

pParentWnd
[i] Pekare mot det överordnade fönstret för det nya CMFCMenuBar objektet.

dwCtrlStyle
[i] Ytterligare format för den nya menyraden.

dwStyle
[i] Huvudformatet för den nya menyraden.

rcBorders
[i] En CRect parameter som anger storlekarna för kantlinjerna för det CMFCMenuBar objektet.

nID
[i] ID:t för det underordnade fönstret i menyraden.

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Du bör använda den här funktionen i stället för CMFCMenuBar::Skapa när du vill ange formatmallar utöver verktygsfältsformatet. Några vanliga ytterligare formatmallar är TBSTYLE_TRANSPARENT och CBRS_TOP.

Listor över ytterligare format finns i Verktygsfältskontroll och knappformat, vanliga kontrollformatoch vanliga fönsterformat.

Exempel

I följande exempel visas hur du använder CreateEx-metoden för klassen CMFCMenuBar. Det här kodfragmentet är en del av IE Demo-exempelexemplet.

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

Initierar ett CMFCMenuBar- objekt. Den här metoden modellerar det CMFCMenuBar objektet efter en HMENU-parameter.

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

Parametrar

hMenu
[i] Ett handtag till en menyresurs. CreateFromMenu använder den här resursen som en mall för CMFCMenuBar.

bDefaultMenu
[i] Ett booleskt värde som anger om den nya menyn är standardmenyn.

bForceUpdate
[i] Ett booleskt värde som anger om den här metoden tvingar fram en menyuppdatering.

Anmärkningar

Använd den här metoden om du vill att en menykontroll ska ha samma menyalternativ som en menyresurs. Du anropar den här metoden när du anropar antingen CMFCMenuBar::Create eller CMFCMenuBar::CreateEx.

CMFCMenuBar::EnableHelpCombobox

Aktiverar en Hjälp kombinationsruta som finns till höger i menyraden.

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

Parametrar

uiID
[i] Kommando-ID:t för knappen i kombinationsrutan Hjälp.

lpszPrompt
[i] En sträng som innehåller den text som ramverket visar i kombinationsrutan om den är tom och inte aktiv. Till exempel "Ange texten här".

nComboBoxWidth
[i] Knappens bredd för kombinationsrutan i bildpunkter.

Anmärkningar

Kombinationsrutan Hjälp liknar kombinationsrutan Hjälp i menyraden i Microsoft Word.

När du anropar den här metoden med uiID inställd på 0 döljer den här metoden kombinationsrutan. I annat fall visar den här metoden kombinationsrutan automatiskt till höger i menyraden. När du har anropat den här metoden anropar du CMFCMenuBar::GetHelpCombobox för att hämta en pekare till det infogade CMFCToolBarComboBoxButton--objektet.

CMFCMenuBar::EnableMenuShadows

Aktiverar skuggor för popup-menyer.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parametrar

bEnable
[i] En boolesk parameter som anger om skuggor ska aktiveras för popup-menyer.

Anmärkningar

Algoritmen som den här metoden använder är komplex och kan minska programmets prestanda på långsammare system.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Returvärde

Anmärkningar

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Returvärde

Anmärkningar

CMFCMenuBar::GetDefaultMenu

Hämtar ett handtag till den ursprungliga menyn. Ramverket läser in den ursprungliga menyn från resursfilen.

HMENU GetDefaultMenu() const;

Returvärde

Ett handtag till en menyresurs.

Anmärkningar

Om ditt program anpassar en meny kan du använda den här metoden för att hämta ett handtag till den ursprungliga menyn.

CMFCMenuBar::GetDefaultMenuResId

Hämtar resursidentifieraren för standardmenyn.

UINT GetDefaultMenuResId() const;

Returvärde

En menyresursidentifierare.

Anmärkningar

Ramverket läser in standardmenyn för CMFCMenuBar-objektet från resursfilen.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Parametrar

[in] pButton

Returvärde

Anmärkningar

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Returvärde

Anmärkningar

CMFCMenuBar::GetHelpCombobox

Returnerar en pekare till kombinationsrutan Hjälp.

CMFCToolBarComboBoxButton* GetHelpCombobox();

Returvärde

En pekare till kombinationsrutan Hjälp. NULL om kombinationsrutan Hjälp är dold eller inte aktiverad.

Anmärkningar

Kombinationsrutan Hjälp finns till höger i menyraden. Anropa metoden CMFCMenuBar::EnableHelpCombobox för att aktivera den här kombinationsrutan.

CMFCMenuBar::GetHMenu

Hämtar handtaget till den meny som är kopplad till CMFCMenuBar-objektet.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Hämtar det aktuella menyteckensnittet.

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

Parametrar

bHorz
[i] En boolesk parameter som anger om det vågräta eller lodräta teckensnittet ska returneras. TRUE anger det vågräta teckensnittet.

Returvärde

En pekare till en CFont parameter som innehåller det aktuella menyradsteckensnittet.

Anmärkningar

Det returnerade teckensnittet är en global parameter för programmet. Två globala teckensnitt underhålls för alla CMFCMenuBar objekt. Dessa separata teckensnitt används för vågräta och lodräta menyrader.

CMFCMenuBar::GetMenuItem

Hämtar ett CMFCToolBarButton- objekt på en menyrad baserat på objektindexet.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parametrar

iItem
[i] Indexet för menyalternativet som ska returneras.

Returvärde

En pekare till det CMFCToolBarButton objekt som matchar indexet som anges av iItem. NULL om indexet är ogiltigt.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Returvärde

Anmärkningar

CMFCMenuBar::GetSystemButton

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

Parametrar

[in] uiBtn

[in] bByCommand

Returvärde

Anmärkningar

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Returvärde

Anmärkningar

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Returvärde

Anmärkningar

CMFCMenuBar::HighlightDisabledItems

Styr om ramverket markerar inaktiverade menyalternativ.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parametrar

bHighlight
[i] En boolesk parameter som anger om ramverket markerar otillgängliga menyalternativ.

Anmärkningar

Ramverket markerar som standard inte otillgängliga menyobjekt när användaren placerar muspekaren över dem.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Returvärde

Anmärkningar

CMFCMenuBar::IsHighlightDisabledItems

Anger om ramverket markerar otillgängliga menyobjekt.

static BOOL IsHighlightDisabledItems();

Returvärde

SANT om otillgängliga menyalternativ är markerade. annars FALSKT.

Anmärkningar

Ramverket markerar som standard inte otillgängliga menyobjekt när användaren placerar muspekaren över dem. Använd metoden CMFCMenuBar::HighlightDisabledItems för att aktivera den här funktionen.

CMFCMenuBar::IsMenuShadows

Anger om ramverket ritar skuggor för popup-menyer.

static BOOL IsMenuShadows();

Returvärde

SANT om ramverket ritar menyskugga; annars FALSKT.

Anmärkningar

Använd metoden CMFCMenuBar::EnableMenuShadows för att aktivera eller inaktivera den här funktionen.

CMFCMenuBar::IsRecentlyUsedMenus

Anger om nyligen använda menykommandon visas på menyraden.

static BOOL IsRecentlyUsedMenus();

Returvärde

Nonzero om CMFCMenuBar-objektet visar nyligen använda menykommandon. annars 0.

Anmärkningar

Använd funktionen CMFCMenuBar::SetRecentlyUsedMenus för att styra om menyraden visar nyligen använda menykommandon.

CMFCMenuBar::IsShowAllCommands

Anger om menyer visar alla kommandon.

static BOOL IsShowAllCommands();

Returvärde

Nonzero om CMFCMenuBar visar alla kommandon; annars 0.

Anmärkningar

Ett CMFCMenuBar objekt kan konfigureras för att antingen visa alla kommandon eller bara visa en delmängd kommandon. Mer information om den här funktionen finns i CMFCMenuBar Class.

IsShowAllCommands visar hur den här funktionen har konfigurerats för CMFCMenuBar-objektet. Om du vill styra vilka menykommandon som visas använder du metoderna CMFCMenuBar::SetShowAllCommands och CMFCMenuBar::SetRecentlyUsedMenus.

CMFCMenuBar::IsShowAllCommandsDelay

Anger om objektet CMFCMenuBar visar alla kommandon efter en kort fördröjning.

static BOOL IsShowAllCommandsDelay();

Returvärde

Nonzero om menyraden visar fullständiga menyer efter en kort fördröjning; annars 0.

Anmärkningar

När du konfigurerar en menyrad för att visa nyligen använda objekt visar menyraden hela menyn på något av två sätt:

Visa den fullständiga menyn efter en programmerad fördröjning från när användaren hovrar markören över pilen längst ned på menyn.
Visa den fullständiga menyn när användaren klickar på pilen längst ned på menyn.

Som standard använder alla CMFCMenuBar objekt alternativet för att visa hela menyn efter en kort fördröjning. Det här alternativet kan inte ändras programmatiskt i klassen CMFCMenuBar. En användare kan dock ändra beteendet under anpassningen av verktygsfältet med hjälp av dialogrutan Anpassa.

CMFCMenuBar::LoadState

Läser in status för menyraden från Windows-registret.

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

Parametrar

lpszProfileName
[i] En sträng som innehåller sökvägen till en Windows-registernyckel.

nIndex
[i] Kontroll-ID för menyraden.

uiID
[i] Ett reserverat värde.

Returvärde

TRUE om metoden lyckades. annars FALSKT.

Anmärkningar

Använd metoden CMFCMenuBar::SaveState för att spara status för menyraden i registret. Den sparade informationen innehåller menyalternativen, dockningstillståndet och menyradens position.

I de flesta fall anropar inte programmet LoadState. Ramverket anropar den här metoden när den initierar arbetsytan.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parametrar

[in] iHot

Anmärkningar

CMFCMenuBar::OnDefaultMenuLoaded

Ramverket anropar den här metoden när den läser in menyresursen från resursfilen.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Parametrar

hMenu
[i] Handtaget för den meny som är kopplad till objektet CMFCMenuBar.

Anmärkningar

Standardimplementeringen av den här funktionen gör ingenting. Åsidosätt den här funktionen för att köra anpassad kod när ramverket har läst in en menyresurs från resursfilen.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametrar

[in] pButton

Returvärde

Anmärkningar

CMFCMenuBar::OnSetDefaultButtonText

Ramverket anropar den här metoden när användaren ändrar texten för ett objekt i menyraden.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametrar

pButton
[i] En pekare till CMFCToolBarButton objekt som användaren vill anpassa.

Returvärde

TRUE om ramverket tillämpar användarändringarna på menyraden. annars FALSKT.

Anmärkningar

Standardimplementeringen för den här metoden ändrar knappens text till texten som användaren tillhandahåller.

CMFCMenuBar::OnToolHitTest

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

Parametrar

[i] punkt

[in] pTI-

Returvärde

Anmärkningar

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametrar

[in] pMsg

Returvärde

Anmärkningar

CMFCMenuBar::RestoreOriginalstate

Anropas av ramverket när användaren väljer Återställ i dialogrutan Anpassa.

virtual BOOL RestoreOriginalstate();

Returvärde

Nonzero om metoden lyckas; annars 0.

Anmärkningar

Den här metoden anropas när användaren väljer Återställ från anpassningsmenyn. Du kan också anropa den här metoden manuellt för att programmatiskt återställa menyradens tillstånd. Den här metoden läser in det ursprungliga tillståndet från resursfilen.

Åsidosätt den här metoden om du vill utföra någon bearbetning när användaren väljer alternativet Återställ.

CMFCMenuBar::SaveState

Sparar tillståndet för CMFCMenuBar-objektet i Windows-registret.

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

Parametrar

lpszProfileName
[i] En sträng som innehåller sökvägen till en Windows-registernyckel.

nIndex
[i] Kontroll-ID för menyraden.

uiID
[i] Ett reserverat värde.

Returvärde

SANT om det lyckas; annars FALSKT;

Anmärkningar

Programmet anropar vanligtvis inte SaveState. Ramverket anropar den här metoden när arbetsytan serialiseras. Mer information finns i CWinAppEx::SaveState.

Den sparade informationen innehåller menyalternativen, dockningstillståndet och menyradens position.

CMFCMenuBar::SetDefaultMenuResId

Anger standardmenyn för ett CMFCMenuBar- objekt baserat på resurs-ID:t.

void SetDefaultMenuResId(UINT uiResId);

Parametrar

uiResId
[i] Resurs-ID:t för den nya standardmenyn.

Anmärkningar

Metoden CMFCMenuBar::RestoreOriginalstate återställer standardmenyn från resursfilen.

Använd metoden CMFCMenuBar::GetDefaultMenuResId för att hämta standardmenyn utan att återställa den.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Parametrar

[in] bValue

Anmärkningar

CMFCMenuBar::SetMaximizeMode

Ramverket anropar den här metoden när en MDI ändrar visningsläget och menyraden måste uppdateras.

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

Parametrar

bMax
[i] Ett booleskt värde som anger läget. Mer information finns i avsnittet Kommentarer.

pWnd
[i] En pekare till det underordnade MDI-fönstret som ändras.

bRecalcLayout
[i] Ett booleskt värde som anger om menyradens layout ska beräknas om omedelbart.

Anmärkningar

När ett underordnat MDI-fönster maximeras visas systemmenyn och Minimera, Maximera och Stäng knapparna Maximera och Stäng. Om bMax är TRUE och pWnd inte är NULL, maximeras MDI-underfönstret och menyraden måste innehålla de extra kontrollerna. Annars återgår menyraden till sitt normala tillstånd.

CMFCMenuBar::SetMenuButtonRTC

Anger den runtime-klassinformation som ramverket använder när användaren skapar menyknappar.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parametrar

pMenuButtonRTC
[i] CRuntimeClass information för en klass som härleds från CMFCMenuButton Class.

Anmärkningar

När en användare lägger till nya knappar i menyraden skapar ramverket knapparna dynamiskt. Som standard skapas CMFCMenuButton objekt. Åsidosätt den här metoden för att ändra typen av knappobjekt som ramverket skapar.

CMFCMenuBar::SetMenuFont

Anger teckensnittet för alla menyrader i programmet.

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

Parametrar

lpLogFont
[i] En pekare till en LOGFONT struktur som definierar teckensnittet som ska anges.

bHorz
[i] SANT om du vill att parametern lpLogFont ska användas för det lodräta teckensnittet FALSE om du vill att den ska användas för horisontellt teckensnitt.

Returvärde

TRUE om metoden lyckades. annars FALSKT.

Anmärkningar

Två teckensnitt används för alla CMFCMenuBar objekt. Dessa separata teckensnitt används för vågräta och lodräta menyrader.

Teckensnittsinställningarna är globala variabler och påverkar alla CMFCMenuBar objekt.

CMFCMenuBar::SetRecentlyUsedMenus

Styr om en menyrad visar nyligen använda menykommandon.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Parametrar

bOn
[i] Ett booleskt värde som styr om nyligen använda menykommandon ska visas.

CMFCMenuBar::SetShowAllCommands

Styr om en meny visar alla tillgängliga kommandon.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Parametrar

bShowAllCommands
[i] En boolesk parameter som anger om popup-menyn visar alla menykommandon.

Anmärkningar

Om en meny inte visar alla menykommandon döljs de kommandon som sällan används. Mer information om hur du visar menykommandon finns i CMFCMenuBar Class.

Se även

hierarkidiagram
klasser
CMFCToolBar-klass

Dela via

CMFCMenuBar-klass

Syntax

Medlemmar

Offentliga metoder

Anmärkningar

Exempel

Arvshierarki

Krav

CMFCMenuBar::AdjustLocations

Anmärkningar

CMFCMenuBar::AllowChangeTextLabels

Returvärde

Anmärkningar

CMFCMenuBar::AllowShowOnPaneMenu

Returvärde

Anmärkningar

CMFCMenuBar::CalcFixedLayout

Parametrar

Returvärde

Anmärkningar

CMFCMenuBar::CalcLayout

Parametrar

Returvärde

Anmärkningar

CMFCMenuBar::CalcMaxButtonHeight

Returvärde

Anmärkningar

CMFCMenuBar::CanBeClosed

Returvärde

Anmärkningar

CMFCMenuBar::CanBeRestored

Returvärde

Anmärkningar

CMFCMenuBar::Skapa

Parametrar

Returvärde

Anmärkningar

CMFCMenuBar::CreateEx

Parametrar

Returvärde

Anmärkningar

Exempel

CMFCMenuBar::CreateFromMenu

Parametrar

Anmärkningar

CMFCMenuBar::EnableHelpCombobox

Parametrar

Anmärkningar

CMFCMenuBar::EnableMenuShadows

Parametrar

Anmärkningar

CMFCMenuBar::GetAvailableExpandSize

Returvärde

Anmärkningar

CMFCMenuBar::GetColumnWidth

Returvärde

Anmärkningar

CMFCMenuBar::GetDefaultMenu

Returvärde

Anmärkningar

CMFCMenuBar::GetDefaultMenuResId

Returvärde

Anmärkningar

CMFCMenuBar::GetFloatPopupDirection

Parametrar

Returvärde

Anmärkningar

CMFCMenuBar::GetForceDownArrows

Returvärde

Anmärkningar

CMFCMenuBar::GetHelpCombobox

Returvärde

Anmärkningar

CMFCMenuBar::GetHMenu

CMFCMenuBar::GetMenuFont

Parametrar

Returvärde

Anmärkningar

CMFCMenuBar::GetMenuItem