CMFCMenuBar – třída

Článek
10/12/2023

Řádek nabídek, který implementuje ukotvení Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCMenuBar : public CMFCToolbar

Členové

Veřejné metody

Jméno	popis
CMFCMenuBar::AdjustLocations	(Přepsání `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Určuje, jestli se popisky textu dají zobrazit pod obrázky na tlačítkách panelu nástrojů. (Přepsání CMFCToolBar::AllowChangeTextLabels.)
CMFCMenuBar::AllowShowOnPaneMenu	(Přepsání `CPane::AllowShowOnPaneMenu`.)
CMFCMenuBar::CalcFixedLayout	Vypočítá vodorovnou velikost panelu nástrojů. (Přepsání CMFCToolBar::CalcFixedLayout.)
CMFCMenuBar::CalcLayout	(Přepsání `CMFCToolBar::CalcLayout`.)
CMFCMenuBar::CalcMaxButtonHeight	Vypočítá maximální výšku tlačítek na panelu nástrojů. (Přepsání CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Určuje, jestli uživatel může panel nástrojů zavřít. (Přepsání CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Určuje, zda systém může obnovit panel nástrojů do původního stavu po přizpůsobení. (Přepsání CMFCToolBar::CanBeRestored.)
CMFCMenuBar::Create	Vytvoří ovládací prvek nabídky a připojí ho k objektu `CMFCMenuBar` .
CMFCMenuBar::CreateEx	`CMFCMenuBar` Vytvoří objekt s dalšími možnostmi stylu.
CMFCMenuBar::CreateFromMenu	Inicializuje `CMFCMenuBar` objekt. Přijímá parametr HMENU, který funguje jako šablona pro vyplněný `CMFCMenuBar`.
CMFCMenuBar::EnableHelpCombobox	Povolí pole se seznamem Nápovědy umístěné na pravé straně řádku nabídek.
CMFCMenuBar::EnableMenuShadows	Určuje, jestli se mají zobrazovat stíny pro místní nabídky.
CMFCMenuBar::GetAvailableExpandSize	(Přepsání CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Vrátí šířku tlačítek panelu nástrojů. (Přepsání CMFCToolBar::GetColumnWidth.)
CMFCMenuBar::GetDefaultMenu	Vrátí popisovač původní nabídky v souboru prostředků.
CMFCMenuBar::GetDefaultMenuResId	Vrátí identifikátor prostředku pro původní nabídku v souboru prostředku.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	Vrátí ukazatel na pole se seznamem Nápověda .
CMFCMenuBar::GetHMenu	Vrátí popisovač do nabídky, která je připojena k objektu `CMFCMenuBar` .
CMFCMenuBar::GetMenuFont	Vrátí aktuální globální písmo pro objekty nabídky.
CMFCMenuBar::GetMenuItem	Vrátí tlačítko panelu nástrojů přidružené k zadanému indexu položky.
CMFCMenuBar::GetRowHeight	Vrátí výšku tlačítek panelu nástrojů. (Přepsání CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Označuje, jestli jsou zakázané položky nabídky zvýrazněné.
CMFCMenuBar::IsButtonExtraSizeAvailable	Určuje, zda panel nástrojů může zobrazovat tlačítka s rozšířenými ohraničeními. (Přepsání CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Označuje, jestli jsou zakázané položky zvýrazněné.
CMFCMenuBar::IsMenuShadows	Určuje, zda jsou stíny vykresleny pro místní nabídky.
CMFCMenuBar::IsRecentlyUsedMenus	Určuje, jestli se nedávno použité příkazy nabídek zobrazují na řádku nabídek.
CMFCMenuBar::IsShowAllCommands	Určuje, jestli místní nabídky zobrazují všechny příkazy.
CMFCMenuBar::IsShowAllCommandsDelay	Určuje, zda nabídky zobrazují všechny příkazy po krátké prodlevě.
CMFCMenuBar::LoadState	Načte stav objektu `CMFCMenuBar` z registru.
CMFCMenuBar::OnChangeHot	Volá se rozhraním, když uživatel vybere tlačítko na panelu nástrojů. (Přepsání CMFCToolBar::OnChangeHot.)
CMFCMenuBar::OnDefaultMenuLoaded	Volá se rozhraním, když okno rámce načte výchozí nabídku ze souboru prostředků.
CMFCMenuBar::OnSendCommand	(Přepsání `CMFCToolBar::OnSendCommand`.)
CMFCMenuBar::OnSetDefaultButtonText	Volá se rozhraním, když je nabídka v režimu přizpůsobení a uživatel změní text položky nabídky.
CMFCMenuBar::OnToolHitTest	(Přepsání `CMFCToolBar::OnToolHitTest`.)
CMFCMenuBar::P reTranslateMessage	(Přepsání `CMFCToolBar::PreTranslateMessage`.)
CMFCMenuBar::RestoreOriginalstate	Volá se podle architektury, když je nabídka v režimu přizpůsobení a uživatel vybere Resetovat pro řádek nabídek.
CMFCMenuBar::SaveState	Uloží stav `CMFCMenuBar` objektu do registru.
CMFCMenuBar::SetDefaultMenuResId	Nastaví původní nabídku v souboru prostředků.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	Volá se rozhraním, když podřízené okno MDI změní režim zobrazení. Pokud je podřízené okno MDI nově maximalizované nebo už není maximalizované, tato metoda aktualizuje řádek nabídek.
CMFCMenuBar::SetMenuButtonRTC	Nastaví informace o třídě modulu runtime, které se generují, když uživatel dynamicky vytváří tlačítka nabídky.
CMFCMenuBar::SetMenuFont	Nastaví písmo pro všechny nabídky v aplikaci.
CMFCMenuBar::SetRecentlyUsedMenus	Určuje, jestli řádek nabídek zobrazuje naposledy použité příkazy nabídky.
CMFCMenuBar::SetShowAllCommands	Určuje, jestli řádek nabídek zobrazuje všechny příkazy.

Poznámky

Třída CMFCMenuBar je řádek nabídek, který implementuje dokovací funkce. Podobá se panelu nástrojů, i když jej nelze zavřít – vždy se zobrazí.

CMFCMenuBar podporuje možnost zobrazení naposledy použitých objektů položek nabídky. Pokud je tato možnost povolená, CMFCMenuBar zobrazí se při prvním zobrazení jenom podmnožina dostupných příkazů. Následně se společně s původní podmnožinou příkazů zobrazí naposledy použité příkazy. Kromě toho může uživatel nabídku kdykoli rozbalit, aby zobrazil všechny dostupné příkazy. Každý dostupný příkaz je tedy nakonfigurovaný tak, aby se zobrazoval neustále nebo aby se zobrazil pouze v případě, že byl nedávno vybrán.

Pokud chcete objekt použít CMFCMenuBar , vložte ho do hlavního objektu rámečku okna. Při zpracování WM_CREATE zprávy zavolejte CMFCMenuBar::Create nebo CMFCMenuBar::CreateEx. Bez ohledu na to, kterou funkci vytvoření použijete, předejte ukazatel do okna hlavního rámce. Potom povolte dokování voláním CFrameWndEx::EnableDocking. Ukotvit tuto nabídku voláním CFrameWndEx::D ockPane.

Příklad

Následující příklad ukazuje, jak používat různé metody ve CMFCMenuBar třídě. Příklad ukazuje, jak nastavit styl podokna, povolit tlačítko přizpůsobit, povolit pole nápovědy, povolit stíny pro místní nabídky a aktualizovat řádek nabídek. Tento fragment kódu je součástí ukázky IE Demo.

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

Hierarchie dědičnosti

CMFCMenuBar

Požadavky

Záhlaví: afxmenubar.h

CMFCMenuBar::AdjustLocations

Upraví pozice položek nabídky na řádku nabídek.

virtual void AdjustLocations();

Poznámky

CMFCMenuBar::AllowChangeTextLabels

Určuje, zda jsou popisky textu povoleny pod obrázky na řádku nabídek.

virtual BOOL AllowChangeTextLabels() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud se uživatel může rozhodnout zobrazit textové popisky v obrázcích.

Poznámky

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

[v] bStretch

[v] bHorz

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcLayout

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

Parametry

[v] dwMode

[v] nLength

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Vrácená hodnota

Poznámky

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::Create

Vytvoří ovládací prvek nabídky a připojí ho k objektu CMFCMenuBar .

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

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno pro nový CMFCMenuBar objekt.

dwStyle
[v] Styl nového řádku nabídek

Nid
[v] ID podřízeného okna řádku nabídek.

Vrácená hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

Po vytvoření objektu CMFCMenuBar je nutné volat Create. Tato metoda vytvoří CMFCMenuBar ovládací prvek a připojí ho k objektu CMFCMenuBar .

Další informace o stylech panelu nástrojů naleznete v tématu CBasePane::SetPaneStyle.

CMFCMenuBar::CreateEx

Vytvoří OBJEKT CMFCMenuBar se zadanými rozšířenými styly.

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

Parametry

pParentWnd
[v] Ukazatel na nadřazené okno nového CMFCMenuBar objektu.

dwCtrlStyle
[v] Další styly pro nový řádek nabídek

dwStyle
[v] Hlavní styl nového řádku nabídek.

RcBorders
[v] Parametr CRect , který určuje velikosti ohraničení objektu CMFCMenuBar .

Nid
[v] ID podřízeného okna řádku nabídek.

Vrácená hodnota

Nenulové, pokud je metoda úspěšná; jinak 0.

Poznámky

Tuto funkci byste měli použít místo CMFCMenuBar::Create , pokud chcete kromě stylu panelu nástrojů zadat styly. Některé často používané další styly jsou TBSTYLE_TRANSPARENT a CBRS_TOP.

Seznam dalších stylů najdete v tématu Ovládací prvky panelu nástrojů a Styly tlačítek, běžné styly ovládacích prvků a běžné styly oken.

Příklad

Následující příklad ukazuje, jak použít CreateEx metodu CMFCMenuBar třídy. Tento fragment kódu je součástí ukázky IE Demo.

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

Inicializuje CMFCMenuBar objektu. Tato metoda modeluje CMFCMenuBar objekt za parametrem HMENU.

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

Parametry

hMenu
[v] Popisovač prostředku nabídky. CreateFromMenupoužívá tento prostředek jako šablonu pro .CMFCMenuBar

bDefaultMenu
[v] Logická hodnota označující, jestli je nová nabídka výchozí nabídkou.

bForceUpdate
[v] Logická hodnota, která označuje, zda tato metoda vynutí aktualizaci nabídky.

Poznámky

Tuto metodu použijte, pokud chcete, aby ovládací prvek nabídky měl stejné položky nabídky jako prostředek nabídky. Tuto metodu voláte po volání CMFCMenuBar::Create nebo CMFCMenuBar::CreateEx.

CMFCMenuBar::EnableHelpCombobox

Povolí pole se seznamem Nápovědy umístěné na pravé straně řádku nabídek.

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

Parametry

UIID
[v] ID příkazu pro tlačítko pole se seznamem Nápověda .

lpszPrompt
[v] Řetězec obsahující text zobrazený v poli se seznamem, pokud je prázdný a není aktivní. Zadejte například text sem.

nComboBoxWidth
[v] Šířka tlačítka pole se seznamem v pixelech.

Poznámky

Pole se seznamem Nápověda se podobá poli se seznamem Nápověda v řádku nabídek aplikace Microsoft Word.

Při volání této metody s uiID nastavena na 0, tato metoda skryje pole se seznamem. V opačném případě tato metoda automaticky zobrazí pole se seznamem na pravé straně řádku nabídek. Po volání této metody, volání CMFCMenuBar::GetHelpCombobox získat ukazatel na vložený CMFCToolBarComboBoxButton objektu.

CMFCMenuBar::EnableMenuShadows

Povolí stíny pro místní nabídky.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parametry

bEnable
[v] Logický parametr, který označuje, jestli mají být pro místní nabídky povolené stíny.

Poznámky

Algoritmus, který tato metoda používá, je složitý a může snížit výkon aplikace v pomalejších systémech.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::GetDefaultMenu

Načte popisovač do původní nabídky. Architektura načte původní nabídku ze souboru prostředků.

HMENU GetDefaultMenu() const;

Vrácená hodnota

Popisovač prostředku nabídky.

Poznámky

Pokud vaše aplikace přizpůsobí nabídku, můžete pomocí této metody načíst popisovač do původní nabídky.

CMFCMenuBar::GetDefaultMenuResId

Načte identifikátor prostředku pro výchozí nabídku.

UINT GetDefaultMenuResId() const;

Vrácená hodnota

Identifikátor prostředku nabídky.

Poznámky

Architektura načte výchozí nabídku objektu CMFCMenuBar ze souboru prostředků.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Parametry

[v] pButton

Vrácená hodnota

Poznámky

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Vrácená hodnota

Poznámky

CMFCMenuBar::GetHelpCombobox

Vrátí ukazatel na pole se seznamem Nápověda .

CMFCToolBarComboBoxButton* GetHelpCombobox();

Vrácená hodnota

Ukazatel na pole se seznamem Nápověda . HODNOTA NULL, pokud je pole se seznamem Nápověda skryté nebo není povoleno.

Poznámky

Pole se seznamem Nápověda se nachází na pravé straně řádku nabídek. Volání metody CMFCMenuBar::EnableHelpCombobox povolit toto pole se seznamem.

CMFCMenuBar::GetHMenu

Načte popisovač do nabídky připojené k CMFCMenuBar objektu.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Načte aktuální písmo nabídky.

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

Parametry

bHorz
[v] Logický parametr, který určuje, jestli se má vrátit vodorovné nebo svislé písmo. Hodnota TRUE označuje vodorovné písmo.

Vrácená hodnota

Ukazatel na parametr CFont , který obsahuje aktuální písmo řádku nabídek.

Poznámky

Vrácené písmo je globální parametr aplikace. Pro všechny CMFCMenuBar objekty jsou zachována dvě globální písma. Tato samostatná písma se používají pro vodorovné a svislé pruhy nabídek.

CMFCMenuBar::GetMenuItem

Načte objekt CMFCToolBarButton na řádku nabídek na základě indexu položky.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parametry

iItem
[v] Index položky nabídky, která se má vrátit.

Vrácená hodnota

Ukazatel na CMFCToolBarButton objekt, který odpovídá indexu určenému iItem. Hodnota NULL, pokud je index neplatný.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::GetSystemButton

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

Parametry

[v] uiBtn

[v] bByCommand

Vrácená hodnota

Poznámky

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::HighlightDisabledItems

Určuje, jestli architektura zvýrazňuje zakázané položky nabídky.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parametry

bHighlight
[v] Logický parametr, který označuje, jestli architektura zvýrazňuje nedostupné položky nabídky.

Poznámky

Ve výchozím nastavení architektura nezvýrazňuje nedostupné položky nabídky, když uživatel umístí ukazatel myši na ně.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Vrácená hodnota

Poznámky

CMFCMenuBar::IsHighlightDisabledItems

Určuje, jestli architektura zvýrazňuje nedostupné položky nabídky.

static BOOL IsHighlightDisabledItems();

Vrácená hodnota

TRUE, pokud jsou zvýrazněny nedostupné položky nabídky; jinak NEPRAVDA.

Poznámky

Ve výchozím nastavení architektura nezvýrazňuje nedostupné položky nabídky, když uživatel umístí ukazatel myši na ně. Tuto funkci povolíte pomocí metody CMFCMenuBar::HighlightDisabledItems.

CMFCMenuBar::IsMenuShadows

Určuje, jestli architektura vykreslí stíny pro místní nabídky.

static BOOL IsMenuShadows();

Vrácená hodnota

TRUE, pokud architektura vykresluje stíny nabídky; jinak NEPRAVDA.

Poznámky

K povolení nebo zakázání této funkce použijte metodu CMFCMenuBar::EnableMenuShadows .

CMFCMenuBar::IsRecentlyUsedMenus

Určuje, jestli se nedávno použité příkazy nabídek zobrazují na řádku nabídek.

static BOOL IsRecentlyUsedMenus();

Vrácená hodnota

Nenulové, pokud objekt CMFCMenuBar zobrazuje nedávno použité příkazy nabídky; jinak 0.

Poznámky

Pomocí funkce CMFCMenuBar::SetRecentlyUsedMenus můžete určit, zda řádek nabídek zobrazuje naposledy použité příkazy nabídky.

CMFCMenuBar::IsShowAllCommands

Určuje, zda nabídky zobrazují všechny příkazy.

static BOOL IsShowAllCommands();

Vrácená hodnota

Nenulové, pokud se CMFCMenuBar zobrazí všechny příkazy; jinak 0.

Poznámky

Objekt CMFCMenuBar lze nakonfigurovat tak, aby zobrazoval všechny příkazy nebo zobrazoval pouze podmnožinu příkazů. Další informace o této funkci naleznete v tématu CMFCMenuBar – třída.

IsShowAllCommands vám řekne, jak je tato funkce pro objekt nakonfigurována CMFCMenuBar . Chcete-li určit, které příkazy nabídky jsou zobrazeny, použijte metody CMFCMenuBar::SetShowAllCommands a CMFCMenuBar::SetRecentlyUsedMenus.

CMFCMenuBar::IsShowAllCommandsDelay

Určuje, zda CMFCMenuBar objekt zobrazí všechny příkazy po krátké prodlevě.

static BOOL IsShowAllCommandsDelay();

Vrácená hodnota

Nenulové, pokud řádek nabídek zobrazuje úplné nabídky po krátké prodlevě; jinak 0.

Poznámky

Když nakonfigurujete řádek nabídek tak, aby zobrazoval naposledy použité položky, řádek nabídek zobrazí celou nabídku jedním ze dvou způsobů:

Zobrazte celou nabídku po naprogramované prodlevě od okamžiku, kdy uživatel najede kurzorem na šipku v dolní části nabídky.
Zobrazte celou nabídku po kliknutí na šipku v dolní části nabídky.

Ve výchozím nastavení používají všechny CMFCMenuBar objekty možnost zobrazit celou nabídku po krátké prodlevě. Tuto možnost nelze změnit programově ve CMFCMenuBar třídě. Uživatel však může změnit chování během přizpůsobení panelu nástrojů pomocí dialogového okna Přizpůsobit ..

CMFCMenuBar::LoadState

Načte stav řádku nabídek z registru Systému Windows.

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

Parametry

lpszProfileName
[v] Řetězec, který obsahuje cestu klíče registru Systému Windows.

nIndex
[v] ID ovládacího prvku pro řádek nabídek.

UIID
[v] Rezervovaná hodnota.

Vrácená hodnota

TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.

Poznámky

Pomocí CMFCMenuBar::SaveState metoda uložit stav řádku nabídek do registru. Uložené informace zahrnují položky nabídky, stav doku a umístění řádku nabídek.

Ve většině případů aplikace nevolá LoadState. Architektura volá tuto metodu při inicializaci pracovního prostoru.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parametry

[v] iHot

Poznámky

CMFCMenuBar::OnDefaultMenuLoaded

Architektura volá tuto metodu, když načte prostředek nabídky ze souboru prostředku.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Parametry

hMenu
[v] Popisovač nabídky připojené k objektu CMFCMenuBar .

Poznámky

Výchozí implementace této funkce nic nedělá. Tuto funkci přepište tak, aby po načtení prostředku nabídky ze souboru prostředku spustila vlastní kód.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametry

[v] pButton

Vrácená hodnota

Poznámky

CMFCMenuBar::OnSetDefaultButtonText

Architektura volá tuto metodu, když uživatel změní text položky na řádku nabídek.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametry

pButton
[v] Ukazatel na CMFCToolBarButton objekt, který chce uživatel přizpůsobit.

Vrácená hodnota

TRUE, pokud architektura použije změny uživatele na řádek nabídek; jinak NEPRAVDA.

Poznámky

Výchozí implementace této metody změní text tlačítka na text, který uživatel poskytuje.

CMFCMenuBar::OnToolHitTest

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

Parametry

[v] Bod

[v] Pti

Vrácená hodnota

Poznámky

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

[v] pMsg

Vrácená hodnota

Poznámky

CMFCMenuBar::RestoreOriginalstate

Volá se rozhraním, když uživatel vybere Resetovat z dialogového okna Přizpůsobit .

virtual BOOL RestoreOriginalstate();

Vrácená hodnota

Nenulové, pokud je metoda úspěšná; jinak 0.

Poznámky

Tato metoda je volána, když uživatel vybere Reset z nabídky přizpůsobení. Můžete také ručně volat tuto metodu a programově resetovat stav řádku nabídek. Tato metoda načte původní stav ze souboru prostředků.

Tuto metodu přepište, pokud chcete provést jakékoli zpracování, když uživatel vybere možnost Reset.

CMFCMenuBar::SaveState

Uloží stav objektu CMFCMenuBar do registru Windows.

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

Parametry

lpszProfileName
[v] Řetězec, který obsahuje cestu klíče registru Systému Windows.

nIndex
[v] ID ovládacího prvku pro řádek nabídek.

UIID
[v] Rezervovaná hodnota.

Vrácená hodnota

TRUE v případě úspěchu; jinak NEPRAVDA;

Poznámky

Aplikace obvykle nevolá SaveState. Architektura volá tuto metodu při serializaci pracovního prostoru. Další informace naleznete v tématu CWinAppEx::SaveState.

Uložené informace zahrnují položky nabídky, stav doku a umístění řádku nabídek.

CMFCMenuBar::SetDefaultMenuResId

Nastaví výchozí nabídku pro objekt CMFCMenuBar na základě ID prostředku.

void SetDefaultMenuResId(UINT uiResId);

Parametry

uiResId
[v] ID prostředku pro novou výchozí nabídku.

Poznámky

CMFCMenuBar ::RestoreOriginalstate metoda obnoví výchozí nabídku ze souboru prostředků.

Pomocí cmFCMenuBar::GetDefaultMenuResId metoda načíst výchozí nabídku bez obnovení.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Parametry

[v] bValue

Poznámky

CMFCMenuBar::SetMaximizeMode

Architektura volá tuto metodu, když MDI změní režim zobrazení a řádek nabídek musí být aktualizován.

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

Parametry

bMax
[v] Logická hodnota, která určuje režim. Další informace naleznete v části Poznámky.

pWnd
[v] Ukazatel na podřízené okno MDI, které se mění.

bRecalcLayout
[v] Logická hodnota, která určuje, jestli se má rozložení řádku nabídek okamžitě přepočítat.

Poznámky

Když je podřízené okno MDI maximalizované, řádek nabídek připojený k hlavnímu rámečku MDI okno zobrazí systémovou nabídku a tlačítka Minimalizovat, Maximalizovat a Zavřít . Pokud bMax je PRAVDA a pWnd není NULL, podřízené okno MDI je maximalizováno a řádek nabídek musí obsahovat další ovládací prvky. V opačném případě se řádek nabídek vrátí do normálního stavu.

CMFCMenuBar::SetMenuButtonRTC

Nastaví informace o třídě modulu runtime, které architektura používá, když uživatel vytvoří tlačítka nabídky.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parametry

pMenuButtonRTC
[v] CRuntimeClass informace pro třídu odvozené z CMFCMenuButton Třída.

Poznámky

Když uživatel přidá nová tlačítka na řádek nabídek, architektura vytvoří tlačítka dynamicky. Ve výchozím nastavení vytváří CMFCMenuButton objekty. Přepsat tuto metodu změnit typ button objekty, které rozhraní vytvoří.

CMFCMenuBar::SetMenuFont

Nastaví písmo pro všechny pruhy nabídek ve vaší aplikaci.

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

Parametry

lpLogFont
[v] Ukazatel na strukturu LOGFONT , která definuje písmo, které se má nastavit.

bHorz
[v] TRUE, pokud chcete , aby byl parametr lpLogFont použit pro svislé písmo, NEPRAVDA, pokud ho chcete použít pro vodorovné písmo.

Vrácená hodnota

TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.

Poznámky

Pro všechny CMFCMenuBar objekty se používají dvě písma. Tato samostatná písma se používají pro vodorovné a svislé pruhy nabídek.

Nastavení písma jsou globální proměnné a ovlivňují všechny CMFCMenuBar objekty.

CMFCMenuBar::SetRecentlyUsedMenus

Určuje, jestli řádek nabídek zobrazuje naposledy použité příkazy nabídky.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Parametry

Bon
[v] Logická hodnota, která určuje, jestli se zobrazují nedávno použité příkazy nabídky.

CMFCMenuBar::SetShowAllCommands

Určuje, jestli nabídka zobrazuje všechny dostupné příkazy.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Parametry

bShowAllCommands
[v] Logický parametr, který určuje, jestli místní nabídka zobrazuje všechny příkazy nabídky.

Poznámky

Pokud nabídka nezobrazí všechny příkazy nabídky, skryje zřídka používané příkazy. Další informace o zobrazení příkazů nabídky naleznete v CMFCMenuBar Třída.

Viz také

Graf hierarchie
Třídy
CMFCToolBar – třída

Sdílet prostřednictvím

CMFCMenuBar – třída

Syntaxe

Členové

Veřejné metody

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCMenuBar::AdjustLocations

Poznámky

CMFCMenuBar::AllowChangeTextLabels

Vrácená hodnota

Poznámky

CMFCMenuBar::AllowShowOnPaneMenu

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcFixedLayout

Parametry

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcLayout

Parametry

Vrácená hodnota

Poznámky

CMFCMenuBar::CalcMaxButtonHeight

Vrácená hodnota

Poznámky

CMFCMenuBar::CanBeClosed

Vrácená hodnota

Poznámky

CMFCMenuBar::CanBeRestored

Vrácená hodnota

Poznámky

CMFCMenuBar::Create

Parametry

Vrácená hodnota

Poznámky

CMFCMenuBar::CreateEx

Parametry

Vrácená hodnota

Poznámky

Příklad

CMFCMenuBar::CreateFromMenu

Parametry

Poznámky

CMFCMenuBar::EnableHelpCombobox

Parametry

Poznámky

CMFCMenuBar::EnableMenuShadows

Parametry

Poznámky

CMFCMenuBar::GetAvailableExpandSize

Vrácená hodnota

Poznámky

CMFCMenuBar::GetColumnWidth

Vrácená hodnota

Poznámky

CMFCMenuBar::GetDefaultMenu

Vrácená hodnota

Poznámky

CMFCMenuBar::GetDefaultMenuResId

Vrácená hodnota

Poznámky

CMFCMenuBar::GetFloatPopupDirection

Parametry

Vrácená hodnota

Poznámky

CMFCMenuBar::GetForceDownArrows

Vrácená hodnota

Poznámky

CMFCMenuBar::GetHelpCombobox

Vrácená hodnota

Poznámky

CMFCMenuBar::GetHMenu

CMFCMenuBar::GetMenuFont

Parametry

Vrácená hodnota

Poznámky

CMFCMenuBar::GetMenuItem