CMFCMenuBar-klasse

Artikel
02/04/2025

Een menubalk die docking implementeert. Zie de broncode in de map VC\atlmfc\src\mfc map van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMFCMenuBar : public CMFCToolbar

Leden

Openbare methoden

Naam	Beschrijving
CMFCMenuBalk::AdjustLocations	(Overschrijft `CMFCToolBar::AdjustLocations`.)
CMFCMenuBar::AllowChangeTextLabels	Hiermee geeft u op of tekstlabels kunnen worden weergegeven onder afbeeldingen op de werkbalkknoppen. (Overschrijft CMFCToolBar::AllowChangeTextLabels.)
CMFCMenuBar::AllowShowOnPaneMenu	(Overschrijft `CPane::AllowShowOnPaneMenu`.)
CMFCMenuBar::CalcFixedLayout-	Berekent de horizontale grootte van de werkbalk. (Overschrijft CMFCToolBar::CalcFixedLayout.)
CMFCMenuBar::CalcLayout	(Overschrijft `CMFCToolBar::CalcLayout`.)
CMFCMenuBar::CalcMaxButtonHeight	Berekent de maximale hoogte van knoppen op de werkbalk. (Overschrijft CMFCToolBar::CalcMaxButtonHeight.)
CMFCMenuBar::CanBeClosed	Hiermee geeft u op of een gebruiker de werkbalk kan sluiten. (Onderdrukkingen CMFCToolBar::CanBeClosed.)
CMFCMenuBar::CanBeRestored	Bepaalt of het systeem na aanpassing een werkbalk naar de oorspronkelijke staat kan herstellen. (Overschrijft CMFCToolBar::CanBeRestored.)
CMFCMenuBalk:: maken	Hiermee maakt u een menu-besturingselement en koppelt u dit aan een `CMFCMenuBar`-object.
CMFCMenuBar::CreateEx	Hiermee maakt u een `CMFCMenuBar`-object met extra stijlopties.
CMFCMenuBalk::CreateFromMenu	Initialiseert een `CMFCMenuBar`-object. Accepteert een HMENU-parameter die fungeert als een sjabloon voor een gevulde `CMFCMenuBar`.
CMFCMenuBar::EnableHelpCombobox	Hiermee schakelt u een Help- keuzelijst met invoervak in die zich aan de rechterkant van de menubalk bevindt.
CMFCMenuBalk::EnableMenuShadows	Hiermee geeft u op of schaduwen voor pop-upmenu's moeten worden weergegeven.
CMFCMenuBar::GetAvailableExpandSize	(Overschrijft CPane::GetAvailableExpandSize.)
CMFCMenuBar::GetColumnWidth	Retourneert de breedte van de werkbalkknoppen. (Overschrijft CMFCToolBar::GetColumnWidth.)
CMFCMenuBar::GetDefaultMenu	Retourneert een ingang naar het oorspronkelijke menu in het resourcebestand.
CMFCMenuBar::GetDefaultMenuResId	Retourneert de resource-id voor het oorspronkelijke menu in het resourcebestand.
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	Hiermee wordt een aanwijzer geretourneerd naar de Help- keuzelijst met invoervak.
CMFCMenuBar::GetHMenu	Retourneert de greep naar het menu dat is gekoppeld aan het `CMFCMenuBar`-object.
CMFCMenuBar::GetMenuFont	Retourneert het huidige algemene lettertype voor menuobjecten.
CMFCMenuBar::GetMenuItem	Retourneert de werkbalkknop die is gekoppeld aan de opgegeven itemindex.
CMFCMenuBar::GetRowHeight	Retourneert de hoogte van werkbalkknoppen. (Overschrijft CMFCToolBar::GetRowHeight.)
CMFCMenuBar::GetSystemButton
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	Hiermee wordt aangegeven of uitgeschakelde menu-items zijn gemarkeerd.
CMFCMenuBar::IsButtonExtraSizeAvailable	Bepaalt of de werkbalk knoppen met uitgebreide randen kan weergeven. (Overschrijft CMFCToolBar::IsButtonExtraSizeAvailable.)
CMFCMenuBar::IsHighlightDisabledItems	Hiermee wordt aangegeven of uitgeschakelde items zijn gemarkeerd.
CMFCMenuBar::IsMenuShadows	Hiermee wordt aangegeven of schaduwen worden getekend voor pop-upmenu's.
CMFCMenuBar::IsRecentlyUsedMenus	Hiermee wordt aangegeven of onlangs gebruikte menuopdrachten worden weergegeven op de menubalk.
CMFCMenuBalk::IsShowAllCommands	Geeft aan of in pop-upmenu's alle opdrachten worden weergegeven.
CMFCMenuBar::IsShowAllCommandsDelay	Geeft aan of menu's alle opdrachten na een korte vertraging weergeven.
CMFCMenuBar::LoadState	Laadt de status van het `CMFCMenuBar`-object uit het register.
CMFCMenuBar::OnChangeHot	Aangeroepen door het framework wanneer een gebruiker een knop op de werkbalk selecteert. (Overschrijft CMFCToolBar::OnChangeHot.)
CMFCMenuBar::OnDefaultMenuLoaded	Aangeroepen door het framework wanneer een framevenster het standaardmenu uit het resourcebestand laadt.
CMFCMenuBar::OnSendCommand	(Overschrijft `CMFCToolBar::OnSendCommand`.)
CMFCMenuBar::OnSetDefaultButtonText	Aangeroepen door het framework wanneer een menu zich in de aanpassingsmodus bevindt en de gebruiker de tekst van een menu-item wijzigt.
CMFCMenuBar::OnToolHitTest	(Overschrijft `CMFCToolBar::OnToolHitTest`.)
CMFCMenuBar::P reTranslateMessage	(Overschrijft `CMFCToolBar::PreTranslateMessage`.)
CMFCMenuBar::RestoreOriginalstate	Aangeroepen door het framework wanneer een menu zich in de aanpassingsmodus bevindt en de gebruiker opnieuw instellen selecteert voor een menubalk.
CMFCMenuBar::SaveState	Hiermee wordt de status van het `CMFCMenuBar`-object opgeslagen in het register.
CMFCMenuBar::SetDefaultMenuResId	Hiermee stelt u het oorspronkelijke menu in het resourcebestand in.
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	Aangeroepen door het framework wanneer een onderliggend MDI-venster de weergavemodus wijzigt. Als het onderliggende MDI-venster nieuw is gemaximaliseerd of niet meer is gemaximaliseerd, wordt met deze methode de menubalk bijgewerkt.
CMFCMenuBar::SetMenuButtonRTC-	Hiermee stelt u de runtimeklassegegevens in die worden gegenereerd wanneer de gebruiker dynamisch menuknoppen maakt.
CMFCMenuBar::SetMenuFont	Hiermee stelt u het lettertype in voor alle menu's in de toepassing.
CMFCMenuBar::SetRecentlyUsedMenus	Hiermee geeft u op of op een menubalk onlangs gebruikte menuopdrachten worden weergegeven.
CMFCMenuBar::SetShowAllCommands	Hiermee geeft u op of op de menubalk alle opdrachten worden weergegeven.

Opmerkingen

De CMFCMenuBar-klasse is een menubalk waarmee dockingfunctionaliteit wordt geïmplementeerd. Deze lijkt op een werkbalk, hoewel deze niet kan worden gesloten. Deze wordt altijd weergegeven.

CMFCMenuBar ondersteunt de optie voor het weergeven van onlangs gebruikte menu-itemobjecten. Als deze optie is ingeschakeld, geeft de CMFCMenuBar alleen een subset van de beschikbare opdrachten weer bij de eerste weergave. Daarna worden onlangs gebruikte opdrachten samen met de oorspronkelijke subset van opdrachten weergegeven. Bovendien kan de gebruiker het menu altijd uitvouwen om alle beschikbare opdrachten weer te geven. Daarom is elke beschikbare opdracht zo geconfigureerd dat deze constant wordt weergegeven of alleen wordt weergegeven als deze onlangs is geselecteerd.

Als u een CMFCMenuBar object wilt gebruiken, sluit u het in het hoofdvensterframeobject in. Wanneer u het WM_CREATE bericht verwerkt, roept u CMFCMenuBar::Create of CMFCMenuBar::CreateExaan. Geef een aanwijzer door aan het hoofdframevenster, ongeacht welke functie u gebruikt. Schakel vervolgens docking in door CFrameWndEx::EnableDockingaan te roepen. Dock dit menu door CFrameWndEx::D ockPaneaan te roepen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u verschillende methoden gebruikt in de klasse CMFCMenuBar. In het voorbeeld ziet u hoe u de stijl van het deelvenster instelt, de knop Aanpassen inschakelt, een Help-vak inschakelt, schaduwen inschakelt voor pop-upmenu's en de menubalk bijwerkt. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Overnamehiërarchie

CMFCMenuBar

Eisen

koptekst: afxmenubar.h

CMFCMenuBar::AdjustLocations

Hiermee past u de posities van de menu-items op de menubalk aan.

virtual void AdjustLocations();

Opmerkingen

CMFCMenuBar::AllowChangeTextLabels

Bepaalt of tekstlabels zijn toegestaan onder afbeeldingen in de menubalk.

virtual BOOL AllowChangeTextLabels() const;

Retourwaarde

Retourneert TRUE als de gebruiker ervoor kan kiezen om tekstlabels onder afbeeldingen weer te geven.

Opmerkingen

CMFCMenuBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameters

[in]

[in] bHorz-

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcLayout

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

Parameters

[in] dwMode

[in] nLength

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcMaxButtonHeight

virtual int CalcMaxButtonHeight();

Retourwaarde

Opmerkingen

CMFCMenuBar::CanBeClosed

virtual BOOL CanBeClosed() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::CanBeRestored

virtual BOOL CanBeRestored() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::Maken

Hiermee maakt u een menu-besturingselement en koppelt u dit aan een CMFCMenuBar object.

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

Parameters

pParentWnd
[in] Aanwijzer naar het bovenliggende venster voor het nieuwe CMFCMenuBar-object.

dwStyle-
[in] De stijl van de nieuwe menubalk.

nID-
[in] De id voor het onderliggende venster van de menubalk.

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

Opmerkingen

Nadat u een CMFCMenuBar-object hebt gemaakt, moet u Createaanroepen. Met deze methode maakt u het besturingselement CMFCMenuBar en koppelt u dit aan het CMFCMenuBar-object.

Zie CBasePane::SetPaneStylevoor meer informatie over werkbalkstijlen.

CMFCMenuBar::CreateEx

Hiermee maakt u een CMFCMenuBar object met opgegeven uitgebreide stijlen.

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

Parameters

pParentWnd
[in] Aanwijzer naar het bovenliggende venster van het nieuwe CMFCMenuBar-object.

dwCtrlStyle-
[in] Extra stijlen voor de nieuwe menubalk.

dwStyle-
[in] De hoofdstijl van de nieuwe menubalk.

rcBorders-
[in] Een CRect parameter waarmee de grootten voor de randen van het CMFCMenuBar-object worden opgegeven.

nID-
[in] De id voor het onderliggende venster van de menubalk.

Retourwaarde

Niet-nul als de methode is geslaagd; anders 0.

Opmerkingen

Gebruik deze functie in plaats van CMFCMenuBar::Maak als u stijlen wilt opgeven naast de werkbalkstijl. Enkele veelgebruikte extra stijlen zijn TBSTYLE_TRANSPARENT en CBRS_TOP.

Zie voor lijsten met extra stijlen werkbalk en knopstijlen, algemene besturingsstijlenen algemene vensterstijlen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de CreateEx methode van de klasse CMFCMenuBar gebruikt. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Initialiseert een CMFCMenuBar object. Met deze methode wordt het CMFCMenuBar-object na een HMENU-parameter gemodelleerd.

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

Parameters

hMenu-
[in] Een ingang naar een menuresource. CreateFromMenu gebruikt deze resource als sjabloon voor de CMFCMenuBar.

bDefaultMenu
[in] Een Booleaanse waarde die aangeeft of het nieuwe menu het standaardmenu is.

bForceUpdate-
[in] Een Booleaanse waarde die aangeeft of deze methode een menu-update dwingt.

Opmerkingen

Gebruik deze methode als u wilt dat een menubesturing dezelfde menu-items heeft als een menuresource. U roept deze methode aan nadat u CMFCMenuBar::Create of CMFCMenuBar::CreateExhebt aangeroepen.

CMFCMenuBar::EnableHelpCombobox

Hiermee schakelt u een Help- keuzelijst met invoervak in die zich aan de rechterkant van de menubalk bevindt.

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

Parameters

uiID-
[in] De opdracht-id voor de knop van de Help keuzelijst met invoervak.

lpszPrompt-
[in] Een tekenreeks die de tekst bevat die het framework weergeeft in de keuzelijst met invoervak als deze leeg is en niet actief is. Voer bijvoorbeeld 'Voer hier de tekst in'.

nComboBoxWidth-
[in] De breedte van de knop voor de keuzelijst met invoervak in pixels.

Opmerkingen

De Help- keuzelijst met invoervak lijkt op de keuzelijst met invoervak in de menubalk van Microsoft Word.

Wanneer u deze methode aanroept met uiID ingesteld op 0, verbergt deze methode de keuzelijst met invoervak. Anders wordt met deze methode de keuzelijst met invoervak automatisch aan de rechterkant van de menubalk weergegeven. Nadat u deze methode hebt aangeroepen, roept u CMFCMenuBar::GetHelpCombobox aan om een aanwijzer te verkrijgen naar het ingevoegde CMFCToolBarComboBoxButton-object.

CMFCMenuBar::EnableMenuShadows

Hiermee schakelt u schaduwen in voor pop-upmenu's.

static void EnableMenuShadows(BOOL bEnable = TRUE);

Parameters

bEnable-
[in] Een Booleaanse parameter die aangeeft of schaduwen moeten worden ingeschakeld voor pop-upmenu's.

Opmerkingen

Het algoritme dat door deze methode wordt gebruikt, is complex en kan de prestaties van uw toepassing op tragere systemen verminderen.

CMFCMenuBar::GetAvailableExpandSize

virtual int GetAvailableExpandSize() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::GetColumnWidth

virtual int GetColumnWidth() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::GetDefaultMenu

Hiermee wordt een ingang naar het oorspronkelijke menu opgehaald. Het framework laadt het oorspronkelijke menu uit het resourcebestand.

HMENU GetDefaultMenu() const;

Retourwaarde

Een ingang naar een menuresource.

Opmerkingen

Als uw toepassing een menu aanpast, kunt u deze methode gebruiken om een ingang op te halen naar het oorspronkelijke menu.

CMFCMenuBar::GetDefaultMenuResId

Haalt de resource-id voor het standaardmenu op.

UINT GetDefaultMenuResId() const;

Retourwaarde

Een menuresource-id.

Opmerkingen

Het framework laadt het standaardmenu voor het CMFCMenuBar-object uit het resourcebestand.

CMFCMenuBar::GetFloatPopupDirection

int GetFloatPopupDirection(CMFCToolBarMenuButton* pButton);

Parameters

[in] pButton

Retourwaarde

Opmerkingen

CMFCMenuBar::GetForceDownArrows

BOOL GetForceDownArrows();

Retourwaarde

Opmerkingen

CMFCMenuBar::GetHelpCombobox

Hiermee wordt een aanwijzer geretourneerd naar de Help- keuzelijst met invoervak.

CMFCToolBarComboBoxButton* GetHelpCombobox();

Retourwaarde

Een aanwijzer naar de Help keuzelijst met invoervak. NULL als de Help- keuzelijst met invoervak is verborgen of niet is ingeschakeld.

Opmerkingen

De Help- keuzelijst met invoervak bevindt zich aan de rechterkant van de menubalk. Roep de methode CMFCMenuBar::EnableHelpCombobox aan om deze keuzelijst met invoervak in te schakelen.

CMFCMenuBar::GetHMenu

Hiermee haalt u de greep op het menu dat is gekoppeld aan de CMFCMenuBar object.

HMENU GetHMenu() const;

CMFCMenuBar::GetMenuFont

Hiermee haalt u het huidige menulettertype op.

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

Parameters

bHorz-
[in] Een Booleaanse parameter die aangeeft of het horizontale of verticale lettertype moet worden geretourneerd. TRUE geeft het horizontale lettertype aan.

Retourwaarde

Een aanwijzer naar een CFont parameter die het huidige lettertype van de menubalk bevat.

Opmerkingen

Het geretourneerde lettertype is een globale parameter voor de toepassing. Er worden twee globale lettertypen bijgehouden voor alle CMFCMenuBar objecten. Deze afzonderlijke lettertypen worden gebruikt voor horizontale en verticale menubalken.

CMFCMenuBar::GetMenuItem

Hiermee wordt een CMFCToolBarButton object opgehaald op een menubalk op basis van de itemindex.

CMFCToolBarButton* GetMenuItem(int iItem) const;

Parameters

iItem-
[in] De index van het menu-item dat moet worden geretourneerd.

Retourwaarde

Een aanwijzer naar het CMFCToolBarButton-object dat overeenkomt met de index die is opgegeven door iItem-. NULL als de index ongeldig is.

CMFCMenuBar::GetRowHeight

virtual int GetRowHeight() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::GetSystemButton

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

Parameters

[in] uiBtn-

[in] bByCommand-

Retourwaarde

Opmerkingen

CMFCMenuBar::GetSystemButtonsCount

int GetSystemButtonsCount() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::GetSystemMenu

CMFCToolBarSystemMenuButton* GetSystemMenu() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::HighlightDisabledItems

Hiermee bepaalt u of het framework uitgeschakelde menu-items markeert.

static void HighlightDisabledItems(BOOL bHighlight = TRUE);

Parameters

bHighlight
[in] Een Booleaanse parameter die aangeeft of het framework niet-beschikbare menu-items markeert.

Opmerkingen

Standaard markeert het framework geen niet-beschikbare menu-items wanneer de gebruiker de muisaanwijzer erop plaatst.

CMFCMenuBar::IsButtonExtraSizeAvailable

virtual BOOL IsButtonExtraSizeAvailable() const;

Retourwaarde

Opmerkingen

CMFCMenuBar::IsHighlightDisabledItems

Geeft aan of het framework niet-beschikbare menu-items markeert.

static BOOL IsHighlightDisabledItems();

Retourwaarde

WAAR als niet-beschikbare menu-items zijn gemarkeerd; anders ONWAAR.

Opmerkingen

Standaard markeert het framework geen niet-beschikbare menu-items wanneer de gebruiker de muisaanwijzer erop plaatst. Gebruik de methode CMFCMenuBar::HighlightDisabledItems om deze functie in te schakelen.

CMFCMenuBar::IsMenuShadows

Geeft aan of het framework schaduwen tekent voor pop-upmenu's.

static BOOL IsMenuShadows();

Retourwaarde

WAAR als het framework menuschaduwen tekent; anders ONWAAR.

Opmerkingen

Gebruik de methode CMFCMenuBar::EnableMenuShadows om deze functie in of uit te schakelen.

CMFCMenuBar::IsRecentlyUsedMenus

Hiermee wordt aangegeven of onlangs gebruikte menuopdrachten worden weergegeven op de menubalk.

static BOOL IsRecentlyUsedMenus();

Retourwaarde

Niet-nul als het CMFCMenuBar object onlangs gebruikte menuopdrachten weergeeft; anders 0.

Opmerkingen

Gebruik de functie CMFCMenuBar::SetRecentlyUsedMenus om te bepalen of op de menubalk onlangs gebruikte menuopdrachten worden weergegeven.

CMFCMenuBar::IsShowAllCommands

Geeft aan of menu's alle opdrachten weergeven.

static BOOL IsShowAllCommands();

Retourwaarde

Niet-nul als de CMFCMenuBar alle opdrachten weergeeft; anders 0.

Opmerkingen

Een CMFCMenuBar-object kan worden geconfigureerd om alle opdrachten weer te geven of alleen een subset met opdrachten weer te geven. Zie CMFCMenuBar Classvoor meer informatie over deze functie.

IsShowAllCommands laat zien hoe deze functie is geconfigureerd voor het CMFCMenuBar-object. Als u wilt bepalen welke menuopdrachten worden weergegeven, gebruikt u de methoden CMFCMenuBar::SetShowAllCommands en CMFCMenuBar::SetRecentlyUsedMenus.

CMFCMenuBar::IsShowAllCommandsDelay

Geeft aan of de CMFCMenuBar object alle opdrachten weergeeft na een korte vertraging.

static BOOL IsShowAllCommandsDelay();

Retourwaarde

Nietzero als de menubalk volledige menu's weergeeft na een korte vertraging; anders 0.

Opmerkingen

Wanneer u een menubalk configureert om onlangs gebruikte items weer te geven, wordt op de menubalk het volledige menu op twee manieren weergegeven:

Het volledige menu weergeven na een geprogrammeerde vertraging vanaf wanneer de gebruiker de cursor boven de pijl onder aan het menu beweegt.
Het volledige menu weergeven nadat de gebruiker op de pijl onderaan het menu klikt.

Standaard gebruiken alle CMFCMenuBar objecten de optie om het volledige menu na een korte vertraging weer te geven. Deze optie kan niet programmatisch worden gewijzigd in de klasse CMFCMenuBar. Een gebruiker kan het gedrag echter wijzigen tijdens het aanpassen van de werkbalk met behulp van het dialoogvenster aanpassen.

CMFCMenuBar::LoadState

Laadt de status van de menubalk uit het Windows-register.

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

Parameters

lpszProfileName
[in] Een tekenreeks die het pad van een Windows-registersleutel bevat.

nIndex
[in] De besturings-id voor de menubalk.

uiID-
[in] Een gereserveerde waarde.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

Gebruik de methode CMFCMenuBar::SaveState om de status van de menubalk op te slaan in het register. De opgeslagen informatie bevat de menu-items, de dockstatus en de positie van de menubalk.

In de meeste gevallen roept uw toepassing geen LoadStateaan. In het framework wordt deze methode aangeroepen wanneer de werkruimte wordt geïnitialiseerd.

CMFCMenuBar::OnChangeHot

virtual void OnChangeHot(int iHot);

Parameters

[in] iHot-

Opmerkingen

CMFCMenuBar::OnDefaultMenuLoaded

In het framework wordt deze methode aangeroepen wanneer de menuresource uit het resourcebestand wordt geladen.

virtual void OnDefaultMenuLoaded(HMENU hMenu);

Parameters

hMenu-
[in] De greep voor het menu dat is gekoppeld aan het CMFCMenuBar-object.

Opmerkingen

De standaard implementatie van deze functie doet niets. Overschrijf deze functie om aangepaste code uit te voeren nadat in het framework een menuresource uit het resourcebestand is geladen.

CMFCMenuBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parameters

[in] pButton

Retourwaarde

Opmerkingen

CMFCMenuBar::OnSetDefaultButtonText

Dit framework roept deze methode aan wanneer de gebruiker de tekst van een item op de menubalk wijzigt.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parameters

pButton-
[in] Een aanwijzer naar het CMFCToolBarButton object dat de gebruiker wil aanpassen.

Retourwaarde

WAAR als het framework de gebruiker wijzigingen toepast op de menubalk; anders ONWAAR.

Opmerkingen

De standaard implementatie voor deze methode wijzigt de tekst van de knop in de tekst die de gebruiker biedt.

CMFCMenuBar::OnToolHitTest

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

Parameters

[in] punt

[in] pTI-

Retourwaarde

Opmerkingen

CMFCMenuBar::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameters

[in] pMsg-

Retourwaarde

Opmerkingen

CMFCMenuBar::RestoreOriginalstate

Aangeroepen door het framework wanneer de gebruiker opnieuw instellen selecteert in het dialoogvenster aanpassen.

virtual BOOL RestoreOriginalstate();

Retourwaarde

Niet-nul als de methode is geslaagd; anders 0.

Opmerkingen

Deze methode wordt aangeroepen wanneer de gebruiker Reset selecteert in het aanpassingsmenu. U kunt deze methode ook handmatig aanroepen om de status van de menubalk programmatisch opnieuw in te stellen. Met deze methode wordt de oorspronkelijke status uit het resourcebestand geladen.

Overschrijf deze methode als u bewerkingen wilt uitvoeren wanneer de gebruiker de optie Opnieuw instellen selecteert.

CMFCMenuBar::SaveState

Hiermee wordt de status van de CMFCMenuBar object opgeslagen in het Windows-register.

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

Parameters

lpszProfileName
[in] Een tekenreeks die het pad van een Windows-registersleutel bevat.

nIndex
[in] De besturings-id voor de menubalk.

uiID-
[in] Een gereserveerde waarde.

Retourwaarde

WAAR indien geslaagd; anders ONWAAR;

Opmerkingen

Meestal roept uw toepassing geen SaveStateaan. Dit framework roept deze methode aan wanneer de werkruimte wordt geserialiseerd. Zie CWinAppEx::SaveStatevoor meer informatie.

De opgeslagen informatie bevat de menu-items, de dockstatus en de positie van de menubalk.

CMFCMenuBar::SetDefaultMenuResId

Hiermee stelt u het standaardmenu in voor een CMFCMenuBar object op basis van de resource-id.

void SetDefaultMenuResId(UINT uiResId);

Parameters

uiResId-
[in] De resource-id voor het nieuwe standaardmenu.

Opmerkingen

De CMFCMenuBar::RestoreOriginalstate methode herstelt het standaardmenu uit het resourcebestand.

Gebruik de methode CMFCMenuBar::GetDefaultMenuResId om het standaardmenu op te halen zonder het te herstellen.

CMFCMenuBar::SetForceDownArrows

void SetForceDownArrows(BOOL bValue);

Parameters

[in] bValue

Opmerkingen

CMFCMenuBar::SetMaximizeMode

Het framework roept deze methode aan wanneer een MDI de weergavemodus wijzigt en de menubalk moet worden bijgewerkt.

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

Parameters

bMax-
[in] Een Booleaanse waarde die de modus aangeeft. Zie de sectie Opmerkingen voor meer informatie.

[in] Een aanwijzer naar het onderliggende MDI-venster dat wordt gewijzigd.

bRecalcLayout-
[in] Een Booleaanse waarde die aangeeft of de indeling van de menubalk onmiddellijk opnieuw moet worden berekend.

Opmerkingen

Wanneer een onderliggend MDI-venster is gemaximaliseerd, geeft een menubalk die is gekoppeld aan het hoofdframevenster van MDI het systeemmenu weer en de Minimaliseren van, Maximaliseren en knoppen sluiten. Als bMax- TRUE is en pWnd niet NULL is, wordt het onderliggende MDI-venster gemaximaliseerd en moet de menubalk de extra besturingselementen bevatten. Anders keert de menubalk terug naar de normale status.

CMFCMenuBar::SetMenuButtonRTC

Hiermee stelt u de runtimeklasse-informatie in die door het framework wordt gebruikt wanneer de gebruiker menuknoppen maakt.

void SetMenuButtonRTC(CRuntimeClass* pMenuButtonRTC);

Parameters

pMenuButtonRTC-
[in] De CRuntimeClass informatie voor een klasse die is afgeleid van de CMFCMenuButton Class.

Opmerkingen

Wanneer een gebruiker nieuwe knoppen toevoegt aan de menubalk, worden de knoppen dynamisch gemaakt. Standaard worden CMFCMenuButton objecten gemaakt. Overschrijf deze methode om het type knopobjecten te wijzigen dat door het framework wordt gemaakt.

CMFCMenuBar::SetMenuFont

Hiermee stelt u het lettertype in voor alle menubalken in uw toepassing.

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

Parameters

lpLogFont-
[in] Een aanwijzer naar een LOGFONT structuur waarmee het lettertype wordt gedefinieerd dat moet worden ingesteld.

bHorz-
[in] WAAR als u wilt dat de parameter lpLogFont wordt gebruikt voor het verticale lettertype, FALSE als u deze wilt gebruiken voor horizontaal lettertype.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

Er worden twee lettertypen gebruikt voor alle CMFCMenuBar objecten. Deze afzonderlijke lettertypen worden gebruikt voor horizontale en verticale menubalken.

De lettertype-instellingen zijn globale variabelen en zijn van invloed op alle CMFCMenuBar objecten.

CMFCMenuBar::SetRecentlyUsedMenus

Hiermee bepaalt u of op een menubalk onlangs gebruikte menuopdrachten worden weergegeven.

static void SetRecentlyUsedMenus (BOOL bOn = TRUE);

Parameters

[in] Een Booleaanse waarde die bepaalt of onlangs gebruikte menuopdrachten worden weergegeven.

CMFCMenuBar::SetShowAllCommands

Hiermee bepaalt u of in een menu alle beschikbare opdrachten worden weergegeven.

static void SetShowAllCommands(BOOL bShowAllCommands = TRUE);

Parameters

bShowAllCommands
[in] Een Booleaanse parameter die aangeeft of in het snelmenu alle menuopdrachten worden weergegeven.

Opmerkingen

Als in een menu niet alle menuopdrachten worden weergegeven, worden de opdrachten verborgen die zelden worden gebruikt. Zie CMFCMenuBar Classvoor meer informatie over het weergeven van menuopdrachten.

Zie ook

Hiërarchiegrafiek
klassen
CMFCToolBar-klasse

Delen via

CMFCMenuBar-klasse

Syntaxis

Leden

Openbare methoden

Opmerkingen

Voorbeeld

Overnamehiërarchie

Eisen

CMFCMenuBar::AdjustLocations

Opmerkingen

CMFCMenuBar::AllowChangeTextLabels

Retourwaarde

Opmerkingen

CMFCMenuBar::AllowShowOnPaneMenu

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcFixedLayout

Parameters

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcLayout

Parameters

Retourwaarde

Opmerkingen

CMFCMenuBar::CalcMaxButtonHeight

Retourwaarde

Opmerkingen

CMFCMenuBar::CanBeClosed

Retourwaarde

Opmerkingen

CMFCMenuBar::CanBeRestored

Retourwaarde

Opmerkingen

CMFCMenuBar::Maken

Parameters

Retourwaarde

Opmerkingen

CMFCMenuBar::CreateEx

Parameters

Retourwaarde

Opmerkingen

Voorbeeld

CMFCMenuBar::CreateFromMenu

Parameters

Opmerkingen

CMFCMenuBar::EnableHelpCombobox

Parameters

Opmerkingen

CMFCMenuBar::EnableMenuShadows

Parameters

Opmerkingen

CMFCMenuBar::GetAvailableExpandSize

Retourwaarde

Opmerkingen

CMFCMenuBar::GetColumnWidth

Retourwaarde

Opmerkingen

CMFCMenuBar::GetDefaultMenu

Retourwaarde

Opmerkingen

CMFCMenuBar::GetDefaultMenuResId

Retourwaarde

Opmerkingen

CMFCMenuBar::GetFloatPopupDirection

Parameters

Retourwaarde

Opmerkingen

CMFCMenuBar::GetForceDownArrows

Retourwaarde

Opmerkingen

CMFCMenuBar::GetHelpCombobox

Retourwaarde

Opmerkingen

CMFCMenuBar::GetHMenu

CMFCMenuBar::GetMenuFont

Parameters

Retourwaarde

Opmerkingen

CMFCMenuBar::GetMenuItem