CMFCMenuBar osztály

Cikk
02/04/2025

A dokkolást megvalósító menüsáv. További részletekért lásd a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szintaxis

class CMFCMenuBar : public CMFCToolbar

Tagok

Nyilvános metódusok

Név	Leírás
CMFCMenuBar::AdjustLocations	(Felülbírálások `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Megadja, hogy a szövegfeliratok megjeleníthetők-e a képek alatt az eszköztárgombokon. (Felülbírálások CMFCToolBar::AllowChangeTextLabels.)
CMFCMenuBar::AllowShowOnPaneMenu	(Felülbírálások `CPane::AllowShowOnPaneMenu`.)
CMFCMenuBar::CalcFixedLayout	Kiszámítja az eszköztár vízszintes méretét. (Felülbírálások CMFCToolBar::CalcFixedLayout.)
CMFCMenuBar::CalcLayout	(Felülbírálások `CMFCToolBar::CalcLayout`.)
CMFCMenuBar::CalcMaxButtonHeight	Kiszámítja az eszköztár gombjainak maximális magasságát. (Felülbírálások CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Megadja, hogy egy felhasználó bezárhatja-e az eszköztárat. (Felülbírálások CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Meghatározza, hogy a rendszer visszaállíthat-e egy eszköztárat az eredeti állapotára a testreszabás után. (Felülbírálások CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Create	Létrehoz egy menüvezérlőt, és csatolja egy `CMFCMenuBar` objektumhoz.
CMFCMenuBar::CreateEx	Létrehoz egy `CMFCMenuBar` objektumot további stílusbeállításokkal.
CMFCMenuBar::CreateFromMenu	Inicializál egy `CMFCMenuBar` objektumot. Olyan HMENU-paramétert fogad el, amely sablonként szolgál egy feltöltött `CMFCMenuBar`.
CMFCMenuBar::EnableHelpCombobox	Engedélyezi a menüsáv jobb oldalán található Súgó kombinált listát.
CMFCMenuBar::EnableMenuShadows	Megadja, hogy megjelenjenek-e az előugró menük árnyékai.
CMFCMenuBar::GetAvailableExpandSize	(Felülbírálások CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Az eszköztárgombok szélességét adja vissza. (Felülbírálások CMFCToolBar::GetColumnWidth.)
CMFCMenuBar::GetDefaultMenu	Egy leírót ad vissza az erőforrásfájl eredeti menüjéhez.
CMFCMenuBar::GetDefaultMenuResId	Az erőforrásfájlban lévő eredeti menü erőforrás-azonosítójának visszaadása.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	A Súgó kombinált listára mutató mutatót ad vissza.
CMFCMenuBar::GetHMenu	A `CMFCMenuBar` objektumhoz csatolt menü fogópontját adja vissza.
CMFCMenuBar::GetMenuFont	A menüobjektumok aktuális globális betűtípusát adja vissza.
CMFCMenuBar::GetMenuItem	A megadott elemindexhez társított eszköztárgombot adja vissza.
CMFCMenuBar::GetRowHeight	Az eszköztárgombok magasságát adja vissza. (Felülbírálások CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Azt jelzi, hogy a letiltott menüelemek ki vannak-e emelve.
CMFCMenuBar::IsButtonExtraSizeAvailable	Meghatározza, hogy az eszköztár megjeleníthet-e kiterjesztett szegélyű gombokat. (Felülbírálások CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Azt jelzi, hogy a letiltott elemek ki vannak-e emelve.
CMFCMenuBar::IsMenuShadows	Azt jelzi, hogy az előugró menük árnyékokat rajzolnak-e.
CMFCMenuBar::IsRecentlyUsedMenus	Azt jelzi, hogy a legutóbb használt menüparancsok megjelennek-e a menüsávon.
CMFCMenuBar::IsShowAllCommands	Azt jelzi, hogy az előugró menük megjelenítik-e az összes parancsot.
CMFCMenuBar::IsShowAllCommandsDelay	Azt jelzi, hogy a menük rövid késleltetés után megjelenítik-e az összes parancsot.
CMFCMenuBar::LoadState	Betölti az `CMFCMenuBar` objektum állapotát a beállításjegyzékből.
CMFCMenuBar::OnChangeHot	A keretrendszer meghívja, amikor egy felhasználó kiválaszt egy gombot az eszköztáron. (Felülbírálások CMFCToolBar::OnChangeHot.)
CMFCMenuBar::OnDefaultMenuLoaded	A keretrendszer meghívja, amikor egy keretablak betölti az alapértelmezett menüt az erőforrásfájlból.
CMFCMenuBar::OnSendCommand	(Felülbírálások `CMFCToolBar::OnSendCommand`.)
CMFCMenuBar::OnSetDefaultButtonText	A keretrendszer meghívja, ha egy menü testreszabási módban van, és a felhasználó módosítja a menüelem szövegét.
CMFCMenuBar::OnToolHitTest	(Felülbírálások `CMFCToolBar::OnToolHitTest`.)
CMFCMenuBar::P reTranslateMessage	(Felülbírálások `CMFCToolBar::PreTranslateMessage`.)
CMFCMenuBar::RestoreOriginalstate	A keretrendszer meghívja, amikor egy menü testreszabási módban van, és a felhasználó kiválasztja Visszaállítás menüsávhoz.
CMFCMenuBar::SaveState	Menti az `CMFCMenuBar` objektum állapotát a beállításjegyzékbe.
CMFCMenuBar::SetDefaultMenuResId	Beállítja az eredeti menüt az erőforrásfájlban.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	A keretrendszer meghívta, amikor egy MDI gyermekablak megváltoztatja a megjelenítési módját. Ha az MDI gyermekablaka újonnan teljes méretű, vagy már nem teljes, ez a módszer frissíti a menüsávot.
CMFCMenuBar::SetMenuButtonRTC	Beállítja azokat a futtatókörnyezeti osztályadatokat, amelyek akkor jönnek létre, amikor a felhasználó dinamikusan hoz létre menügombokat.
CMFCMenuBar::SetMenuFont	Beállítja az alkalmazás összes menüjének betűtípusát.
CMFCMenuBar::SetRecentlyUsedMenus	Megadja, hogy egy menüsáv megjeleníti-e a legutóbb használt menüparancsokat.
CMFCMenuBar::SetShowAllCommands	Megadja, hogy a menüsávon megjelenjen-e az összes parancs.

Megjegyzések

A CMFCMenuBar osztály egy menüsáv, amely megvalósítja a dokkoló funkciót. Hasonlít egy eszköztárra, bár nem zárható be – mindig megjelenik.

CMFCMenuBar támogatja a legutóbb használt menüelem-objektumok megjelenítését. Ha ez a beállítás engedélyezve van, a CMFCMenuBar csak az elérhető parancsok egy részét jeleníti meg az első megtekintéskor. Ezt követően a legutóbb használt parancsok a parancsok eredeti részhalmazával együtt jelennek meg. Emellett a felhasználó bármikor kibonthatja a menüt az összes elérhető parancs megtekintéséhez. Így minden elérhető parancs konfigurálva van, hogy folyamatosan jelenjen meg, vagy csak akkor jelenjen meg, ha nemrég lett kiválasztva.

Ha CMFCMenuBar objektumot szeretne használni, ágyazza be a fő ablakkeret objektumba. A WM_CREATE üzenet feldolgozásakor hívja meg CMFCMenuBar::Create vagy CMFCMenuBar::CreateEx. Függetlenül attól, hogy melyik létrehozási függvényt használja, vigyen egy mutatót a fő keretablakba. Ezután engedélyezze a dokkolást CFrameWndEx::EnableDockinghívásával. A menü rögzítése CFrameWndEx::D ockPanemeghívásával.

Példa

Az alábbi példa bemutatja, hogyan használhat különböző metódusokat a CMFCMenuBar osztályban. A példa bemutatja, hogyan állíthatja be a panel stílusát, hogyan engedélyezheti a testreszabás gombot, hogyan engedélyezheti a súgódobozt, hogyan engedélyezheti az árnyékokat az előugró menükhöz, és hogyan frissítheti a menüsávot. Ez a kódrészlet a IE Demo mintarésze.

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

Öröklési hierarchia

CMFCMenuBar

Követelmények

fejléc: afxmenubar.h

CMFCMenuBar::AdjustLocations

A menüsor menüelemeinek pozícióit módosítja.

virtual void AdjustLocations();

Megjegyzések

CMFCMenuBar::AllowChangeTextLabels

Meghatározza, hogy a szövegfeliratok engedélyezve legyenek-e a menüsáv képei alatt.

virtual BOOL AllowChangeTextLabels() const;

Visszaadott érték

IGAZ értéket ad vissza, ha a felhasználó választhatja, hogy szövegfeliratokat jelenít meg a képek alatt.

Megjegyzések

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paraméterek

[in] bStretch

[in] bHorz

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcLayout

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

Paraméterek

[in] dwMode

[in] nLength

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Visszaadott érték

Megjegyzések

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::Létrehozás

Létrehoz egy menüvezérlőt, és egy CMFCMenuBar objektumhoz csatolja.

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

Paraméterek

pParentWnd
[in] Mutasson az új CMFCMenuBar objektum szülőablakára.

dwStyle
[in] Az új menüsáv stílusa.

nID
[in] A menüsáv gyermekablakának azonosítója.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

Miután létrehoz egy CMFCMenuBar objektumot, meg kell hívnia Create. Ez a metódus létrehozza a CMFCMenuBar vezérlőt, és a CMFCMenuBar objektumhoz csatolja.

További információ az eszköztárstílusokról: CBasePane::SetPaneStyle.

CMFCMenuBar::CreateEx

Létrehoz egy CMFCMenuBar objektumot a megadott kiterjesztett stílusokkal.

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

Paraméterek

pParentWnd
[in] Mutasson az új CMFCMenuBar objektum szülőablakára.

dwCtrlStyle
[in] További stílusok az új menüsávhoz.

dwStyle
[in] Az új menüsáv fő stílusa.

rcBorders
[in] Egy CRect paraméter, amely meghatározza a CMFCMenuBar objektum szegélyeinek méretét.

nID
[in] A menüsáv gyermekablakának azonosítója.

Visszaadott érték

Nonzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

A CMFCMenuBar::Create helyett ezt a függvényt kell használnia, ha az eszköztárstílus mellett stílusokat is meg szeretne adni. Néhány gyakran használt további stílus TBSTYLE_TRANSPARENT és CBRS_TOP.

További stílusok listáját az Eszköztár- és gombstílusok, gyakori vezérlőstílusok, valamint gyakori ablakstílusokcímű témakörben talál.

Példa

Az alábbi példa a CMFCMenuBar osztály CreateEx metódusának használatát mutatja be. Ez a kódrészlet a IE Demo mintarésze.

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

Inicializál egy CMFCMenuBar objektumot. Ez a metódus egy HMENU-paraméter után modellozza a CMFCMenuBar objektumot.

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

Paraméterek

hMenu
[in] Egy menüerőforrás leírója. CreateFromMenu ezt az erőforrást használja sablonként a CMFCMenuBar.

bDefaultMenu
[in] Logikai érték, amely azt jelzi, hogy az új menü az alapértelmezett menü-e.

bForceUpdate
[in] Logikai érték, amely azt jelzi, hogy ez a módszer kényszeríti-e a menüfrissítést.

Megjegyzések

Ezt a módszert akkor használja, ha azt szeretné, hogy egy menüvezérlő ugyanazokat a menüelemeket tartalmazza, mint egy menüerőforrás. Ezt a metódust azután hívja meg, hogy CMFCMenuBar::Create vagy CMFCMenuBar::CreateEx.

CMFCMenuBar::EnableHelpCombobox

Engedélyezi a menüsáv jobb oldalán található Súgó kombinált listát.

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

Paraméterek

uiID
[in] A Súgó kombinált lista gombjának parancsazonosítója.

lpszPrompt
[in] Egy sztring, amely azt a szöveget tartalmazza, amelyet a keretrendszer megjelenít a kombinált listában, ha üres, és nem aktív. Például: "Írja be a szöveget itt".

nComboBoxWidth
[in] A kombinált lista gombjának szélessége képpontban.

Megjegyzések

A Súgó kombinált lista a Microsoft Word menüsávjában található Súgó kombinált listához hasonlít.

Ha ezt a metódust uiID 0 értékre állítva hívja meg, ez a metódus elrejti a kombinált listát. Ellenkező esetben ez a módszer automatikusan megjeleníti a kombinált listát a menüsor jobb oldalán. Miután meghívta ezt a metódust, hívja meg CMFCMenuBar::GetHelpCombobox a beszúrt CMFCToolBarComboBoxButton objektumra mutató mutató lekéréséhez.

CMFCMenuBar::EnableMenuShadows

Árnyékok engedélyezése előugró menükhöz.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Logikai paraméter, amely azt jelzi, hogy engedélyezni kell-e az árnyékokat az előugró menükben.

Megjegyzések

A metódus által használt algoritmus összetett, és csökkentheti az alkalmazás teljesítményét a lassabb rendszereken.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetDefaultMenu

Lekéri a fogópontot az eredeti menübe. A keretrendszer betölti az eredeti menüt az erőforrásfájlból.

HMENU GetDefaultMenu() const;

Visszaadott érték

Egy menüerőforrás leírója.

Megjegyzések

Ha az alkalmazás testre szab egy menüt, ezzel a módszerrel lekérhet egy leírót az eredeti menübe.

CMFCMenuBar::GetDefaultMenuResId

Az alapértelmezett menü erőforrás-azonosítójának lekérése.

UINT GetDefaultMenuResId() const;

Visszaadott érték

Egy menüerőforrás-azonosító.

Megjegyzések

A keretrendszer betölti a CMFCMenuBar objektum alapértelmezett menüjét az erőforrásfájlból.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Paraméterek

[in] pButton

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetHelpCombobox

A Súgó kombinált listára mutató mutatót ad vissza.

CMFCToolBarComboBoxButton* GetHelpCombobox();

Visszaadott érték

Mutató a Súgó kombinált listára. NULL érték, ha a súgó kombinált lista rejtett vagy nincs engedélyezve.

Megjegyzések

A Súgó kombinált lista a menüsáv jobb oldalán található. Hívja meg a CMFCMenuBar::EnableHelpCombobox metódust a kombinált lista engedélyezéséhez.

CMFCMenuBar::GetHMenu

Lekéri a fogópontot a CMFCMenuBar objektumhoz csatolt menübe.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Lekéri az aktuális menü betűtípusát.

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

Paraméterek

bHorz
[in] Logikai paraméter, amely meghatározza, hogy a vízszintes vagy a függőleges betűtípust adja vissza. A TRUE a vízszintes betűtípust jelöli.

Visszaadott érték

Mutató egy CFont paraméterre, amely az aktuális menüsáv betűtípusát tartalmazza.

Megjegyzések

A visszaadott betűtípus az alkalmazás globális paramétere. Az összes CMFCMenuBar objektumhoz két globális betűtípus van fenntartva. Ezek a különálló betűtípusok vízszintes és függőleges menüsávokhoz használhatók.

CMFCMenuBar::GetMenuItem

Lekéri a CMFCToolBarButton objektumot egy menüsávon az elemindex alapján.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Paraméterek

iItem
[in] A visszaadni kívánt menüelem indexe.

Visszaadott érték

Mutató a CMFCToolBarButton objektumra, amely megfelel a iItemáltal megadott indexnek. NULL érték, ha az index érvénytelen.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetSystemButton

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

Paraméterek

[in] uiBtn

[in] bByCommand

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::HighlightDisabledItems

Azt szabályozza, hogy a keretrendszer kiemeli-e a letiltott menüelemeket.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Paraméterek

bHighlight
[in] Logikai paraméter, amely jelzi, hogy a keretrendszer kiemeli-e a nem elérhető menüelemeket.

Megjegyzések

Alapértelmezés szerint a keretrendszer nem emeli ki a nem elérhető menüelemeket, amikor a felhasználó az egérmutatót föléjük helyezi.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Visszaadott érték

Megjegyzések

CMFCMenuBar::IsHighlightDisabledItems

Azt jelzi, hogy a keretrendszer kiemeli-e a nem elérhető menüelemeket.

static BOOL IsHighlightDisabledItems();

Visszaadott érték

IGAZ, ha a nem elérhető menüelemek ki vannak emelve; egyéb esetben HAMIS.

Megjegyzések

Alapértelmezés szerint a keretrendszer nem emeli ki a nem elérhető menüelemeket, amikor a felhasználó az egérmutatót föléjük helyezi. A funkció engedélyezéséhez használja a CMFCMenuBar::HighlightDisabledItems metódust.

CMFCMenuBar::IsMenuShadows

Azt jelzi, hogy a keretrendszer árnyékot rajzol-e előugró menükhöz.

static BOOL IsMenuShadows();

Visszaadott érték

IGAZ, ha a keretrendszer menüárnyékokat rajzol; egyéb esetben HAMIS.

Megjegyzések

A funkció engedélyezéséhez vagy letiltásához használja a CMFCMenuBar::EnableMenuShadows metódust.

CMFCMenuBar::IsRecentlyUsedMenus

Azt jelzi, hogy a legutóbb használt menüparancsok megjelennek-e a menüsávon.

static BOOL IsRecentlyUsedMenus();

Visszaadott érték

Nonzero, ha a CMFCMenuBar objektum a legutóbb használt menüparancsokat jeleníti meg; egyéb esetben 0.

Megjegyzések

A CMFCMenuBar::SetRecentlyUsedMenus függvénnyel szabályozhatja, hogy a menüsáv megjeleníti-e a legutóbb használt menüparancsokat.

CMFCMenuBar::IsShowAllCommands

Azt jelzi, hogy a menük megjelenítik-e az összes parancsot.

static BOOL IsShowAllCommands();

Visszaadott érték

Nonzero, ha a CMFCMenuBar az összes parancsot megjeleníti; egyéb esetben 0.

Megjegyzések

Egy CMFCMenuBar objektum konfigurálható úgy, hogy az összes parancsot megjelenítse, vagy csak a parancsok egy részhalmazát jelenítse meg. A funkcióval kapcsolatos további információkért lásd CMFCMenuBar osztály.

IsShowAllCommands bemutatja, hogyan van konfigurálva ez a funkció a CMFCMenuBar objektumhoz. A megjelenő menüparancsok szabályozásához használja a CMFCMenuBar::SetShowAllCommands és CMFCMenuBar::SetRecentlyUsedMenusmetódus okat.

CMFCMenuBar::IsShowAllCommandsDelay

Azt jelzi, hogy a CMFCMenuBar objektum rövid késleltetés után megjeleníti-e az összes parancsot.

static BOOL IsShowAllCommandsDelay();

Visszaadott érték

Nonzero, ha a menüsáv rövid késleltetés után teljes menüket jelenít meg; egyéb esetben 0.

Megjegyzések

Amikor egy menüsávot úgy konfigurál, hogy a legutóbb használt elemek jelenjenek meg, a menüsáv kétféleképpen jeleníti meg a teljes menüt:

A teljes menü megjelenítése programozott késleltetés után, amikor a felhasználó a kurzort a menü alján lévő nyílra viszi.
A teljes menü megjelenítése, miután a felhasználó a menü alján lévő nyílra kattint.

Alapértelmezés szerint az összes CMFCMenuBar objektum a teljes menü rövid késleltetés után történő megjelenítésére használható. Ez a beállítás programozott módon nem módosítható a CMFCMenuBar osztályban. A felhasználók azonban módosíthatják a viselkedést az eszköztár testreszabása során a Testreszabás párbeszédpanelen.

CMFCMenuBar::LoadState

Betölti a menüsáv állapotát a Windows beállításjegyzékéből.

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

Paraméterek

lpszProfileName
[in] Egy Windows beállításkulcs elérési útját tartalmazó sztring.

nIndex
[in] A menüsáv vezérlőazonosítója.

uiID
[in] Fenntartott érték.

Visszaadott érték

IGAZ, ha a módszer sikeres volt; egyéb esetben HAMIS.

Megjegyzések

A CMFCMenuBar::SaveState metódus használatával mentse a menüsáv állapotát a beállításjegyzékbe. A mentett információk közé tartoznak a menüelemek, a dokkolás állapota és a menüsáv helyzete.

A legtöbb esetben az alkalmazás nem hívja meg LoadState. A keretrendszer ezt a metódust hívja meg a munkaterület inicializálásakor.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Paraméterek

[in] iHot

Megjegyzések

CMFCMenuBar::OnDefaultMenuLoaded

A keretrendszer ezt a metódust hívja meg, amikor betölti a menüerőforrást az erőforrásfájlból.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Paraméterek

hMenu
[in] A CMFCMenuBar objektumhoz csatolt menü leírója.

Megjegyzések

A függvény alapértelmezett implementációja nem végez semmit. A függvény felülbírálása egyéni kód végrehajtásához, miután a keretrendszer betölt egy menüerőforrást az erőforrásfájlból.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Paraméterek

[in] pButton

Visszaadott érték

Megjegyzések

CMFCMenuBar::OnSetDefaultButtonText

A keretrendszer meghívja ezt a metódust, amikor a felhasználó módosítja egy elem szövegét a menüsávon.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Paraméterek

pButton
[in] Mutató a CMFCToolBarButton objektumra, amelyet a felhasználó testre szeretne szabni.

Visszaadott érték

IGAZ, ha a keretrendszer a felhasználó módosításait alkalmazza a menüsávra; egyéb esetben HAMIS.

Megjegyzések

A metódus alapértelmezett implementációja a gomb szövegét a felhasználó által megadott szövegre módosítja.

CMFCMenuBar::OnToolHitTest

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

Paraméterek

[in] pont

[in] pTI

Visszaadott érték

Megjegyzések

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Paraméterek

[in] pMsg

Visszaadott érték

Megjegyzések

CMFCMenuBar::RestoreOriginalstate

A keretrendszer meghívja, amikor a felhasználó a Testreszabás párbeszédpanelen kiválasztja Alaphelyzetbe állítás lehetőséget.

virtual BOOL RestoreOriginalstate();

Visszaadott érték

Nonzero, ha a módszer sikeres; egyéb esetben 0.

Megjegyzések

Ezt a metódust akkor hívja meg a rendszer, ha a felhasználó a testreszabási menü Visszaállítás lehetőséget választja. Ezt a metódust manuálisan is meghívhatja a menüsáv állapotának programozott alaphelyzetbe állításához. Ez a metódus betölti az eredeti állapotot az erőforrásfájlból.

Bírálja felül ezt a módszert, ha bármilyen feldolgozást szeretne végezni, amikor a felhasználó a Visszaállítás lehetőséget választja.

CMFCMenuBar::SaveState

Menti a CMFCMenuBar objektum állapotát a Windows beállításjegyzékbe.

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

Paraméterek

lpszProfileName
[in] Egy Windows beállításkulcs elérési útját tartalmazó sztring.

nIndex
[in] A menüsáv vezérlőazonosítója.

uiID
[in] Fenntartott érték.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS;

Megjegyzések

Az alkalmazás általában nem hívja meg SaveState. A keretrendszer ezt a metódust hívja meg a munkaterület szerializálásakor. További információ: CWinAppEx::SaveState.

A mentett információk közé tartoznak a menüelemek, a dokkolás állapota és a menüsáv helyzete.

CMFCMenuBar::SetDefaultMenuResId

Beállítja egy CMFCMenuBar objektum alapértelmezett menüjét az erőforrás-azonosító alapján.

void SetDefaultMenuResId(UINT uiResId);

Paraméterek

uiResId
[in] Az új alapértelmezett menü erőforrás-azonosítója.

Megjegyzések

A CMFCMenuBar::RestoreOriginalstate metódus visszaállítja az alapértelmezett menüt az erőforrásfájlból.

A CMFCMenuBar::GetDefaultMenuResId metódussal visszaállítás nélkül lekérheti az alapértelmezett menüt.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Paraméterek

[in] bValue

Megjegyzések

CMFCMenuBar::SetMaximizeMode

A keretrendszer meghívja ezt a metódust, amikor egy MDI megváltoztatja a megjelenítési módját, és a menüsávot frissíteni kell.

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

Paraméterek

bMax
[in] A módot meghatározó logikai érték. További információért tekintse meg a Megjegyzések szakaszt.

pWnd
[in] A változó MDI gyermekablakra mutató mutató.

bRecalcLayout
[in] Logikai érték, amely meghatározza, hogy a menüsáv elrendezését azonnal újra kell-e számítani.

Megjegyzések

Ha az MDI gyermekablaka teljes méretű, az MDI főkeret ablakához csatolt menüsáv megjeleníti a rendszermenüt és a Kis méret, és bezárása gombot. Ha bMax IGAZ, és pWnd nem NULL, az MDI gyermekablaka teljes méretű, és a menüsávnak tartalmaznia kell a további vezérlőket. Ellenkező esetben a menüsáv visszatér a normál állapotához.

CMFCMenuBar::SetMenuButtonRTC

Beállítja azokat a futtatókörnyezeti osztályadatokat, amelyeket a keretrendszer használ, amikor a felhasználó menügombokat hoz létre.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Paraméterek

pMenuButtonRTC
[in] A CRuntimeClass CMFCMenuButton osztály.

Megjegyzések

Amikor egy felhasználó új gombokat ad hozzá a menüsávhoz, a keretrendszer dinamikusan hozza létre a gombokat. Alapértelmezés szerint CMFCMenuButton objektumokat hoz létre. A metódus felülbírálása a keretrendszer által létrehozott gombobjektumok típusának módosításához.

CMFCMenuBar::SetMenuFont

Beállítja az alkalmazás összes menüsávjának betűtípusát.

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

Paraméterek

lpLogFont
[in] Mutató egy LOGFONT szerkezetre, amely meghatározza a beállított betűtípust.

bHorz
[in] IGAZ, ha azt szeretné, hogy az lpLogFont paramétert használja a függőleges betűtípushoz, hamis, ha vízszintes betűtípushoz szeretné használni.

Visszaadott érték

IGAZ, ha a módszer sikeres volt; egyéb esetben HAMIS.

Megjegyzések

Két betűtípust használ az összes CMFCMenuBar objektumhoz. Ezek a különálló betűtípusok vízszintes és függőleges menüsávokhoz használhatók.

A betűtípus-beállítások globális változók, és minden CMFCMenuBar objektumra hatással vannak.

CMFCMenuBar::SetRecentlyUsedMenus

Azt szabályozza, hogy egy menüsáv megjeleníti-e a legutóbb használt menüparancsokat.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Paraméterek

bOn
[in] Logikai érték, amely azt szabályozza, hogy megjelennek-e a legutóbb használt menüparancsok.

CMFCMenuBar::SetShowAllCommands

Azt szabályozza, hogy egy menü megjeleníti-e az összes elérhető parancsot.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Paraméterek

bShowAllCommands
[in] Logikai paraméter, amely meghatározza, hogy az előugró menü megjeleníti-e az összes menüparancsot.

Megjegyzések

Ha egy menü nem jeleníti meg az összes menüparancsot, elrejti a ritkán használt parancsokat. További információ a menüparancsok megjelenítéséről: CMFCMenuBar osztály.

Lásd még:

hierarchiadiagram
osztályok
CMFCToolBar osztály

Megosztás a következőn keresztül:

CMFCMenuBar osztály

Szintaxis

Tagok

Nyilvános metódusok

Megjegyzések

Példa

Öröklési hierarchia

Követelmények

CMFCMenuBar::AdjustLocations

Megjegyzések

CMFCMenuBar::AllowChangeTextLabels

Visszaadott érték

Megjegyzések

CMFCMenuBar::AllowShowOnPaneMenu

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcFixedLayout

Paraméterek

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcLayout

Paraméterek

Visszaadott érték

Megjegyzések

CMFCMenuBar::CalcMaxButtonHeight

Visszaadott érték

Megjegyzések

CMFCMenuBar::CanBeClosed

Visszaadott érték

Megjegyzések

CMFCMenuBar::CanBeRestored

Visszaadott érték

Megjegyzések

CMFCMenuBar::Létrehozás

Paraméterek

Visszaadott érték

Megjegyzések

CMFCMenuBar::CreateEx

Paraméterek

Visszaadott érték

Megjegyzések

Példa

CMFCMenuBar::CreateFromMenu

Paraméterek

Megjegyzések

CMFCMenuBar::EnableHelpCombobox

Paraméterek

Megjegyzések

CMFCMenuBar::EnableMenuShadows

Paraméterek

Megjegyzések

CMFCMenuBar::GetAvailableExpandSize

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetColumnWidth

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetDefaultMenu

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetDefaultMenuResId

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetFloatPopupDirection

Paraméterek

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetForceDownArrows

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetHelpCombobox

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetHMenu

CMFCMenuBar::GetMenuFont

Paraméterek

Visszaadott érték

Megjegyzések

CMFCMenuBar::GetMenuItem