CmFCPopupMenu-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Hiermee wordt de functionaliteit van het pop-upmenu van Windows geïmplementeerd en uitgebreid door functies zoals menu's en knopinfo toe te voegen. Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMFCPopupMenu : public CMiniFrameWnd

Leden

Beveiligde constructors

Naam	Description
CMFCPopupMenu::CMFCPopupMenu	Maakt een `CMFCPopupMenu` object.

Openbare methoden

Naam	Description
CMFCPopupMenu::ActivatePopupMenu
CMFCPopupMenu::AlwaysShowEmptyToolsEntry	Hiermee stelt u in of een snelmenu is ingeschakeld om lege vermeldingen weer te geven voor door de gebruiker gedefinieerde hulpprogramma's.
CMFCPopupMenu::AreAllCommandsShown
CMFCPopupMenu::CheckArea	Bepaalt de locatie van een punt ten opzichte van het snelmenu.
CMFCPopupMenu::CloseMenu
CMFCPopupMenu::Maken	Hiermee maakt u een snelmenu en koppelt u het aan het `CMFCPopupMenu` object.
CMFCPopupMenu::D efaultMouseClickOnClose
CMFCPopupMenu::EnableMenuLogo	Initialiseert het logo voor een snelmenu.
CMFCPopupMenu::EnableMenuSound	Hiermee schakelt u menugeluid in.
CMFCPopupMenu::EnableResize
CMFCPopupMenu::EnableScrolling
CMFCPopupMenu::EnableVertResize
CMFCPopupMenu::FindSubItemByCommand
CMFCPopupMenu::GetActiveMenu	Retourneert het huidige actieve menu.
CMFCPopupMenu::GetAnimationSpeed	Retourneert de animatiesnelheid voor pop-upmenu's.
CMFCPopupMenu::GetAnimationType	Retourneert het huidige type pop-upmenuanimatie.
CMFCPopupMenu::GetDropDirection
CMFCPopupMenu::GetForceMenuFocus	Hiermee wordt aangegeven of de focus wordt teruggezet naar de menubalk wanneer een snelmenu wordt weergegeven.
CMFCPopupMenu::GetForceShadow
CMFCPopupMenu::GetHMenu	Retourneert een ingang naar de gekoppelde menuresource.
CMFCPopupMenu::MenuBalk Ophalen	Retourneert de CMFCPopupMenuBar die is ingesloten in het snelmenu.
CMFCPopupMenu::MenuItem ophalen	Retourneert een aanwijzer naar het menu-item in de opgegeven index.
CMFCPopupMenu::GetMenuItemCount	Retourneert het aantal items in een pop-upmenu.
CMFCPopupMenu::GetMessageWnd	Retourneert een aanwijzer naar het venster waarin het framework de pop-upmenuberichten routeert.
CMFCPopupMenu::GetParentArea
CMFCPopupMenu::GetParentButton	Retourneert een aanwijzer naar de knop bovenliggende werkbalk.
CMFCPopupMenu::GetParentPopupMenu	Retourneert een aanwijzer naar het bovenliggende snelmenu.
CMFCPopupMenu::GetParentRibbonElement
CMFCPopupMenu::GetParentToolBar	Retourneert een aanwijzer naar de bovenliggende werkbalk.
CMFCPopupMenu::GetQuickCustomizeType
CMFCPopupMenu::GetSelItem	Hiermee wordt een aanwijzer geretourneerd naar de geselecteerde menuopdracht.
CMFCPopupMenu::HasBeenResized
CMFCPopupMenu::HideRarelyUsedCommands	Hiermee wordt aangegeven of het snelmenu zelden gebruikte opdrachten kan verbergen.
CMFCPopupMenu::InCommand
CMFCPopupMenu::InsertItem	Hiermee voegt u een nieuw item in het snelmenu op de opgegeven locatie in.
CMFCPopupMenu::InsertSeparator	Hiermee voegt u een scheidingsteken in het snelmenu op de opgegeven locatie in.
CMFCPopupMenu::IsAlwaysClose
CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry
CMFCPopupMenu::IsCustomizePane	Hiermee wordt aangegeven of het snelmenu functioneert als een QuickCustomizePane.
CMFCPopupMenu::IsEscClose
CMFCPopupMenu::IsIdle	Hiermee wordt aangegeven of een pop-upmenu momenteel niet actief is.
CMFCPopupMenu::IsMenuSound
CMFCPopupMenu::IsQuickCustomize	Bepaalt of de bijbehorende CMFCToolBarMenuButton-klasse zich in de modus QuickCustomize bevindt.
CMFCPopupMenu::IsResizeble
CMFCPopupMenu::IsRightAlign	Geeft aan of het menu rechts of links is uitgelijnd.
CMFCPopupMenu::IsScrollable
CMFCPopupMenu::IsSendMenuSelectMsg	Geeft aan of het framework het bovenliggende frame aangeeft wanneer de gebruiker een opdracht selecteert in het snelmenu.
CMFCPopupMenu::IsShown	Hiermee wordt aangegeven of het snelmenu momenteel zichtbaar is.
CMFCPopupMenu::MoveTo
CMFCPopupMenu::OnCmdMsg	(Onderdrukkingen `CFrameWnd::OnCmdMsg`.)
CMFCPopupMenu::P ostCommand
CMFCPopupMenu::P reTranslateMessage	(Onderdrukkingen `CFrameWnd::PreTranslateMessage`.)
CMFCPopupMenu::HercalcLayout	Aangeroepen door het framework wanneer de standaard besturingsbalken worden in- of uitgeschakeld of wanneer het framevenster wordt gewijzigd. (Overschrijft CFrameWnd::RecalcLayout.)
CMFCPopupMenu::RemoveAllItems	Hiermee worden alle items uit een snelmenu gewist.
CMFCPopupMenu::RemoveItem	Hiermee verwijdert u het opgegeven item uit een snelmenu.
CMFCPopupMenu::SaveState
CMFCPopupMenu::SetAnimationSpeed	Hiermee stelt u de animatiesnelheid voor pop-upmenu's in.
CMFCPopupMenu::SetAnimationType	Hiermee stelt u het animatietype in voor het snelmenu.
CMFCPopupMenu::SetAutoDestroy
CMFCPopupMenu::SetDefaultItem	Hiermee stelt u de standaardopdracht in voor het snelmenu.
CMFCPopupMenu::SetForceMenuFocus	Hiermee wordt de invoerfocus gedwongen terug te keren naar de menubalk wanneer een snelmenu wordt weergegeven.
CMFCPopupMenu::SetForceShadow	Dwingt het framework om menuschaduwen te tekenen wanneer pop-upmenu's buiten het hoofdframe worden weergegeven.
CMFCPopupMenu::SetMaxWidth	Stel de maximale breedte in voor het snelmenu.
CMFCPopupMenu::SetMessageWnd
CMFCPopupMenu::SetParentRibbonElement
CMFCPopupMenu::SetQuickCustomizeType
CMFCPopupMenu::SetQuickMode
CMFCPopupMenu::SetRightAlign	Hiermee stelt u de menu-uitlijning in voor pop-upmenu's.
CMFCPopupMenu::SetSendMenuSelectMsg	Hiermee stelt u een vlag in waarmee wordt bepaald of het pop-upmenu het bovenliggende frame aangeeft wanneer de gebruiker een opdracht selecteert.
CMFCPopupMenu::ShowAllCommands	Hiermee dwingt u het snelmenu om alle opdrachten weer te geven.
CMFCPopupMenu::TriggerResize
CMFCPopupMenu::UpdateAllShadows	Hiermee worden de schaduwen bijgewerkt voor alle geopende pop-upmenu's.
CMFCPopupMenu::UpdateShadow	Hiermee werkt u de schaduw voor het snelmenu bij.

Beveiligde methoden

Naam	Description
CMFCPopupMenu::CreateTearOffBar
CMFCPopupMenu::OnChangeHot
CMFCPopupMenu::OnChooseItem

Opmerkingen

Normaal gesproken maakt MFC automatisch pop-upmenu's. Als u handmatig een object wilt maken, wijst u er een CMFCPopupMenu toe aan de heap en roept u vervolgens CMFCPopupMenu::Create aan.

Example

In het volgende voorbeeld ziet u hoe u een pop-upmenuobject configureert. In het voorbeeld ziet u hoe u het logo en het geluid van het snelmenu instelt, de animatiesnelheid en het type instelt, menuschaduwen tekent wanneer het snelmenu buiten het hoofdframe wordt weergegeven, de maximale breedte instelt en de rechtermenu-uitlijning van het snelmenu instelt. Dit codefragment maakt deel uit van het voorbeeld aangepaste pagina's.

// 30 is the size of the logo in pixels.
pPopupMenu->EnableMenuLogo(30);
pPopupMenu->EnableMenuSound();
// 500 is the animation speed in milliseconds.
pPopupMenu->SetAnimationSpeed(500);
pPopupMenu->SetAnimationType(CMFCPopupMenu::SLIDE);
pPopupMenu->SetForceShadow(true);
// 200 is the maximum width of the pop-up menu in pixels.
pPopupMenu->SetMaxWidth(200);
pPopupMenu->SetRightAlign();
pPopupMenu->InsertSeparator();

Overnamehiërarchie

CMFCPopupMenu

Requirements

Koptekst: afxpopupmenu.h

CMFCPopupMenu::ActivatePopupMenu

static BOOL __stdcall ActivatePopupMenu(
    CFrameWnd* pTopFrame,
    CMFCPopupMenu* pPopupMenu);

Parameterwaarden

[in] pTopFrame
[in] pPopupMenu

Retourwaarde

Opmerkingen

CMFCPopupMenu::AlwaysShowEmptyToolsEntry

Hiermee stelt u in of een snelmenu is ingeschakeld om lege vermeldingen weer te geven voor door de gebruiker gedefinieerde hulpprogramma's.

static void AlwaysShowEmptyToolsEntry(BOOL bShow = TRUE);

Parameterwaarden

bShow
[in] WAAR als in het snelmenu lege vermeldingen kunnen worden weergegeven; ANDERS ONWAAR.

CMFCPopupMenu::AreAllCommandsShown

BOOL AreAllCommandsShown() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::CheckArea

Bepaalt de locatie van een punt ten opzichte van het snelmenu.

MENUAREA_TYPE CheckArea(const CPoint& ptScreen) const;

Parameterwaarden

ptScreen
[in] Een punt, in schermcoördinaten.

Retourwaarde

Een MENUAREA_TYPE parameter die aangeeft waar het punt ten opzichte van het snelmenu is.

Opmerkingen

Een MENUAREA_TYPE parameter kan een van de volgende waarden hebben.

BUITEN - ptScreen bevindt zich buiten het snelmenu.
LOGO - ptScreen bevindt zich boven een logogebied.
TEAROFF_CAPTION - ptScreen is boven het ondertiteling voor scheuren.
SHADOW_BOTTOM - ptScreen bevindt zich boven de onderste schaduw van het snelmenu.
SHADOW_RIGHT - ptScreen bevindt zich boven de rechterschaduw van het snelmenu.
MENU - ptScreen is over een opdracht.

CMFCPopupMenu::CloseMenu

void CloseMenu(BOOL bSetFocusToBar = FALSE);

Parameterwaarden

[in] bSetFocusToBar

Opmerkingen

CMFCPopupMenu::CMFCPopupMenu

Maakt een CMFCPopupMenu-object .

CMFCPopupMenu(
    CMFCToolBarsMenuPropertyPage* pCustPage,
    LPCTSTR lpszTitle);

Parameterwaarden

pCustPage
[in] Een aanwijzer naar een aanpassingspagina.

lpszTitle
[in] Een tekenreeks die het menubijschrift bevat.

Opmerkingen

Met deze methode worden de resources voor een CMFCPopupMenu. Als u het snelmenu-item wilt maken, roept u CMFCPopupMenu::Create aan.

CMFCPopupMenu::Maken

Hiermee maakt u een snelmenu en koppelt u het aan een CMFCPopupMenu-object .

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    HMENU hMenu,
    BOOL bLocked = FALSE,
    BOOL bOwnMessage = FALSE);

Parameterwaarden

pWndParent
[in] Het bovenliggende venster voor de CMFCPopupMenu.

x
[in] De horizontale schermcoördinaat voor de locatie van het snelmenu

y
[in] De verticale schermcoördinaat voor de locatie van het pop-menu.

hMenu
[in] Een ingang naar een menuresource.

Geblokkeerd
[in] Een Booleaanse parameter die aangeeft of het menu kan worden aangepast. FALSE geeft aan dat het snelmenu aanpasbaar is.

bOwnMessage
[in] Een Booleaanse parameter die aangeeft hoe het framework de menuberichten routeert. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

Als bOwnMessage TRUE is, stuurt het framework alle menuberichten naar pWndParent. pWndParent mag niet NULL zijn als bOwnMessage WAAR is. Als bOwnMessage ONWAAR is, stuurt het framework de menuberichten naar het bovenliggende snelmenu.

Example

In het volgende voorbeeld ziet u hoe u de Create methode van de CMFCPopuMenu klasse gebruikt. Dit codefragment maakt deel uit van het voorbeeld aangepaste pagina's.

CMFCPopupMenu *pPopupMenu = new CMFCPopupMenu;
// CPoint point
// CMenu* pPopup
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
pPopupMenu->Create(this, point.x, point.y, pPopup->Detach());

CMFCPopupMenu::CreateTearOffBar

virtual CPane* CreateTearOffBar(
    CFrameWnd* pWndMain,
    UINT uiID,
    LPCTSTR lpszName);

Parameterwaarden

[in] pWndMain
[in] uiID
[in] lpszName

Retourwaarde

Opmerkingen

CMFCPopupMenu::D efaultMouseClickOnClose

virtual BOOL DefaultMouseClickOnClose() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::EnableMenuLogo

Initialiseert het logo voor een snelmenu.

void EnableMenuLogo(
    int iLogoSize,
    LOGO_LOCATION nLogoLocation = MENU_LOGO_LEFT);

Parameterwaarden

iLogoSize
[in] De grootte van het logo, in pixels.

nLogoLocation
[in] Een geïnventariseerd gegevenstype dat de locatie van het logo aangeeft.

Opmerkingen

Als u het logo wilt weergeven, implementeert u de methode CFrameWndEx::OnDrawMenuLogo in het hoofdframevenster.

De mogelijke waarden voor nLogoLocation zijn MENU_LOGO_LEFT, MENU_LOGO_RIGHT, MENU_LOGO_TOP en MENU_LOGO_BOTTOM.

CMFCPopupMenu::EnableMenuSound

Hiermee schakelt u menugeluid in.

static void EnableMenuSound(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
[in] WAAR om geluid in te schakelen, anders ONWAAR.

Opmerkingen

Als u geluid inschakelt, roept het framework de PlaySound-methode aan wanneer een gebruiker een snelmenu opent of een menuopdracht selecteert. Deze functie is standaard ingeschakeld.

CMFCPopupMenu::EnableResize

void EnableResize(CSize sizeMinResize);

Parameterwaarden

[in] sizeMinResize

Opmerkingen

CMFCPopupMenu::EnableScrolling

void EnableScrolling(BOOL = TRUE);

Parameterwaarden

[in] BOOL

Opmerkingen

CMFCPopupMenu::EnableVertResize

void EnableVertResize(int nMinResize);

Parameterwaarden

[in] nMinResize

Opmerkingen

CMFCPopupMenu::FindSubItemByCommand

CMFCToolBarMenuButton* FindSubItemByCommand(UINT uiCmd) const;

Parameterwaarden

[in] uiCmd

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetActiveMenu

Retourneert het huidige actieve menu.

static CMFCPopupMenu* GetActiveMenu();

Retourwaarde

Een aanwijzer naar het actieve snelmenu of NULL als er momenteel geen pop-upmenu actief is.

Opmerkingen

Elke toepassing kan maximaal één actief snelmenu hebben.

CMFCPopupMenu::GetAnimationSpeed

Retourneert de animatiesnelheid voor pop-upmenu's.

static UINT GetAnimationSpeed();

Retourwaarde

Een geheel getal dat de tijd aangeeft, in milliseconden, dat een pop-upmenuanimatie moet voltooien.

Opmerkingen

De animatiesnelheid is een globale waarde. Gebruik CMFCPopupMenu::SetAnimationSpeed om de animatiesnelheid voor pop-upmenu's te wijzigen.

CMFCPopupMenu::GetAnimationType

Retourneert het huidige type pop-upanimatie.

static CMFCPopupMenu::ANIMATION_TYPE GetAnimationType(BOOL bNoSystem = FALSE);

Parameterwaarden

bNoSystem
[in] Een Booleaanse parameter die aangeeft of deze methode de globale waarde controleert. FALSE als u wilt dat deze methode de animatiestijl voor dit exemplaar van de klasse CMFCPopupMenu retourneert.

Retourwaarde

Een opgesomde waarde die het animatietype beschrijft.

Opmerkingen

De animatiestijl voor pop-upmenu's is globaal voor uw toepassing. Gebruik CMFCPopupMenu::SetAnimationType om de animatiestijl in te stellen.

De volgende tabel bevat de mogelijke animatietypen.

Waarde	Description
NO_ANIMATION	Het snelmenu is niet geanimeerd en wordt onmiddellijk weergegeven.
ONTVOUWEN	Het framework toont het snelmenu in de linkerbovenhoek naar de rechterbenedenhoek.
DIA	Het snelmenu wordt van boven naar beneden verplaatst.
FADE	Het snelmenu verschijnt eerst transparant en solidift geleidelijk.

CMFCPopupMenu::GetDropDirection

DROP_DIRECTION GetDropDirection() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetForceMenuFocus

Hiermee wordt aangegeven of de focus wordt teruggezet naar de menubalk wanneer een snelmenu wordt weergegeven.

static BOOL GetForceMenuFocus();

Retourwaarde

WAAR als de invoerfocus wordt geretourneerd naar de menubalk wanneer een snelmenu wordt weergegeven; ONWAAR als het snelmenu de focus behoudt.

Opmerkingen

Standaard krijgt uw toepassing de focus niet terug naar de menubalk. Als u deze instelling wilt wijzigen, gebruikt u CMFCPopupMenu::SetForceMenuFocus.

CMFCPopupMenu::GetForceShadow

static BOOL __stdcall GetForceShadow();

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetHMenu

Retourneert een ingang naar de gekoppelde menuresource.

HMENU GetHMenu();

CMFCPopupMenu::MenuBalk Ophalen

Retourneert de CMFCPopupMenuBar die is ingesloten in het snelmenu.

virtual CMFCPopupMenuBar* GetMenuBar();

Retourwaarde

Een aanwijzer naar de ingesloten CMFCPopupMenuBar.

Opmerkingen

Het snelmenu bevat een ingesloten CMFCPopupMenuBar object. U moet deze methode in een afgeleide klasse overschrijven als u een andere ingesloten klasse gebruikt.

CMFCPopupMenu::MenuItem ophalen

Retourneert een aanwijzer naar het menu-item in de opgegeven index.

CMFCToolBarMenuButton* GetMenuItem(int iIndex) const;

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van een menu-item.

Retourwaarde

Een aanwijzer naar een menu-item. NULL als de index ongeldig is.

Opmerkingen

Menu-items worden vertegenwoordigd door de klasse CMFCToolBarMenuButton. Wanneer u deze methode aanroept, wordt er een aanwijzer naar de juiste CMFCToolBarMenuButtongeretourneerd.

CMFCPopupMenu::GetMenuItemCount

Retourneert het aantal items in een snelmenu.

int GetMenuItemCount() const;

Retourwaarde

Het aantal items in het menu.

CMFCPopupMenu::GetMessageWnd

Retourneert een aanwijzer naar het venster waarin het framework de pop-upmenuberichten routeert.

CWnd* GetMessageWnd() const;

Retourwaarde

Een aanwijzer naar het venster dat de pop-upmenuberichten ontvangt; NULL als er geen venster is.

Opmerkingen

Wanneer u de methode CMFCPopupMenu::Create gebruikt om een snelmenu te maken, geeft u op welk venster de menuberichten worden ontvangen.

CMFCPopupMenu::GetParentArea

virtual CWnd* GetParentArea(CRect& rectParentBtn);

Parameterwaarden

[in] rectParentBtn

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetParentButton

Retourneert een aanwijzer naar de knop bovenliggende werkbalk.

CMFCToolBarMenuButton* GetParentButton() const;

Retourwaarde

Een aanwijzer naar de knop bovenliggende werkbalk. NULL als het snelmenu geen knop bovenliggende werkbalk heeft.

Opmerkingen

Een CMFCPopupMenu kan worden gekoppeld aan een knop in het menu. In dit scenario wordt het snelmenu weergegeven wanneer een gebruiker de knop bovenliggende werkbalk selecteert.

Als het snelmenu een snelmenu is, heeft het geen knop bovenliggende werkbalk.

CMFCPopupMenu::GetParentPopupMenu

Retourneert een aanwijzer naar het bovenliggende snelmenu.

CMFCPopupMenu* GetParentPopupMenu() const;

Retourwaarde

Een aanwijzer naar het bovenliggende CMFCPopupMenu object; NULL als er geen bovenliggend snelmenu is.

Opmerkingen

Een snelmenu heeft alleen een bovenliggend CMFCPopupMenu object als het een submenu is.

CMFCPopupMenu::GetParentRibbonElement

CMFCRibbonBaseElement* GetParentRibbonElement() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetParentToolBar

Retourneert een aanwijzer naar de bovenliggende werkbalk.

CMFCToolBar* GetParentToolBar() const;

Retourwaarde

Een aanwijzer naar de bovenliggende werkbalk. NULL als het snelmenu geen bovenliggende werkbalk heeft.

Opmerkingen

Als het CMFCPopupMenu een snelmenu is, heeft het geen bovenliggende werkbalk.

CMFCPopupMenu::GetQuickCustomizeType

QUICK_CUSTOMIZE_TYPE GetQuickCustomizeType() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetSelItem

Hiermee wordt een aanwijzer geretourneerd naar de geselecteerde menuopdracht.

CMFCToolBarMenuButton* GetSelItem();

Retourwaarde

Een aanwijzer naar de geselecteerde menuopdracht; NULL als er geen item is geselecteerd.

Opmerkingen

De menuopdrachten in een snelmenu worden vertegenwoordigd door de CMFCToolBarMenuButton-klasse of een klasse die is afgeleid van CMFCToolBarMenuButton.

CMFCPopupMenu::HasBeenResized

BOOL HasBeenResized() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::HideRarelyUsedCommands

Hiermee wordt aangegeven of het snelmenu zelden gebruikte opdrachten kan verbergen.

BOOL HideRarelyUsedCommands() const;

Retourwaarde

WAAR als het snelmenu de zelden gebruikte opdrachten kan verbergen; anders ONWAAR.

Opmerkingen

Met deze methode wordt alleen aangegeven of een snelmenu zelden gebruikte opdrachten kan verbergen, niet als die configuratie is ingeschakeld. Een snelmenu kan zelden gebruikte opdrachten verbergen als deze een bovenliggende knop heeft en het bovenliggende venster is afgeleid van de KLASSE CMFCMenuBar. Gebruik CMFCMenuBar::SetRecentlyUsedMenus om deze functie en CMFCMenuBar::IsRecentlyUsedMenus in te schakelen om te bepalen of deze functie momenteel is ingeschakeld. U moet beide methoden aanroepen voor het bovenliggende venster.

CMFCPopupMenu::InCommand

virtual BOOL InCommand();

Retourwaarde

Opmerkingen

CMFCPopupMenu::InsertItem

Hiermee voegt u een nieuw item in het snelmenu op de opgegeven locatie in.

int InsertItem(
    const CMFCToolBarMenuButton& button,
    int iInsertA = -1);

Parameterwaarden

Knop
[in] Een verwijzing naar het menu-item dat u wilt toevoegen.

iInsertAt
[in] De op nul gebaseerde index voor het nieuwe item. Als iInsertAt -1 is, wordt het item toegevoegd aan het einde van het menu.

Retourwaarde

De op nul gebaseerde index van de positie waar het item is ingevoegd. -1 als de methode mislukt.

Opmerkingen

Deze methode mislukt als u een ongeldige waarde opgeeft voor iInsertAt, zoals een geheel getal dat groter is dan het aantal items dat zich momenteel in het snelmenu bevindt.

CMFCPopupMenu::InsertSeparator

Hiermee voegt u een scheidingsteken in het snelmenu op de opgegeven locatie in.

int InsertSeparator(int iInsertAt = -1);

Parameterwaarden

iInsertAt
[in] De op nul gebaseerde index van de positie waar deze methode het scheidingsteken invoegt.

Retourwaarde

De op nul gebaseerde index van de positie waar het scheidingsteken is ingevoegd. -1 als deze methode mislukt.

Opmerkingen

Een waarde van -1 voor iInsertAt betekent dat met deze methode het scheidingsteken wordt toegevoegd aan het einde van het snelmenu.

Deze methode mislukt als iInsertAt een ongeldige waarde is.

CMFCPopupMenu::IsAlwaysClose

virtual BOOL IsAlwaysClose() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry

static BOOL __stdcall IsAlwaysShowEmptyToolsEntry();

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsCustomizePane

Hiermee wordt aangegeven of het snelmenu functioneert als een QuickCustomizePane.

BOOL IsCustomizePane();

Retourwaarde

WAAR als het pop-upvenster een QuckCustomizePane is; anders ONWAAR.

Opmerkingen

Gebruik de QuickCustomizePane om de gebruiker in staat te stellen het snelmenu rechtstreeks aan te passen. De QuickCustomizePane is een CMFCPopupMenu functie die wordt weergegeven wanneer de gebruiker op een werkbalkknop klikt om deze rechtstreeks te bewerken.

Uw toepassing moet deze methode aanroepen tijdens CMDIFrameWndEx::OnShowCustomizePane.

CMFCPopupMenu::IsEscClose

BOOL IsEscClose();

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsIdle

Hiermee wordt aangegeven of een pop-upmenu momenteel niet actief is.

virtual BOOL IsIdle() const;

Retourwaarde

WAAR als het pop-upmenu zich in de niet-actieve modus bevindt; anders ONWAAR.

Opmerkingen

Standaard bevindt een snelmenu zich in de niet-actieve modus als de weergaveanimatie is voltooid en de gebruiker niet door het snelmenu schuift.

CMFCPopupMenu::IsMenuSound

static UINT __stdcall IsMenuSound();

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsQuickCustomize

Bepaalt of de bijbehorende CMFCToolBarMenuButton-klasse zich in de modus QuickCustomize bevindt.

BOOL IsQuickCustomize();

Retourwaarde

WAAR als de gekoppelde menuknop zich in de modus QuickCustomize bevindt; anders ONWAAR. Deze methode retourneert ook FALSE als het snelmenu niet is gekoppeld aan een CMFCToolBarMenuButton.

Opmerkingen

In de modus QuickCustomize selecteert de gebruiker een knop op een werkbalk om de knop rechtstreeks aan te passen.

CMFCPopupMenu::IsResizeble

BOOL IsResizeble() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsRightAlign

Geeft aan of het menu rechts of links is uitgelijnd.

BOOL IsRightAlign() const;

Retourwaarde

WAAR als het menu rechts is uitgelijnd; ONWAAR als het menu links is uitgelijnd.

Opmerkingen

U kunt CMFCPopupMenu::SetRightAlign gebruiken om de menuuitlijning in te stellen. Pop-upmenu's maken standaard gebruik van linkeruitlijning.

Menu-uitlijning is geen globale instelling en kan variëren tussen pop-upmenu's.

CMFCPopupMenu::IsScrollable

BOOL IsScrollable() const;

Retourwaarde

Opmerkingen

CMFCPopupMenu::IsSendMenuSelectMsg

Geeft aan of het framework het bovenliggende frame aangeeft wanneer de gebruiker een opdracht selecteert in het snelmenu.

static BOOL IsSendMenuSelectMsg();

Retourwaarde

WAAR als het framework het bovenliggende frame op de hoogte stelt; anders ONWAAR.

Opmerkingen

Het framework meldt het bovenliggende frame door het WM_MENUSELECT bericht te verzenden wanneer een gebruikt een menuopdracht selecteert.

CMFCPopupMenu::IsShown

Hiermee wordt aangegeven of het snelmenu momenteel zichtbaar is.

BOOL IsShown() const;

Retourwaarde

WAAR als een snelmenu zichtbaar is; anders ONWAAR.

CMFCPopupMenu::MoveTo

void MoveTo(const CPoint& pt);

Parameterwaarden

[in] Pt

Opmerkingen

CMFCPopupMenu::OnChangeHot

virtual void OnChangeHot(int nHot);

Parameterwaarden

[in] nHot

Opmerkingen

CMFCPopupMenu::OnChooseItem

virtual void OnChooseItem(UINT uidCmdID);

Parameterwaarden

[in] uidCmdID

Opmerkingen

CMFCPopupMenu::OnCmdMsg

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parameterwaarden

[in] Nid
[in] nCode
[in] pExtra
[in] pHandlerInfo

Retourwaarde

Opmerkingen

CMFCPopupMenu::P ostCommand

BOOL PostCommand(UINT uiCommandID);

Parameterwaarden

[in] uiCommandID

Retourwaarde

Opmerkingen

CMFCPopupMenu::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameterwaarden

[in] pMsg

Retourwaarde

Opmerkingen

CMFCPopupMenu::HercalcLayout

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameterwaarden

[in] bNotify

Opmerkingen

CMFCPopupMenu::RemoveAllItems

Hiermee worden alle items uit een snelmenu gewist.

void RemoveAllItems();

CMFCPopupMenu::RemoveItem

Hiermee verwijdert u het opgegeven item uit het snelmenu.

BOOL RemoveItem(int iIndex);

Parameterwaarden

iIndex
[in] De op nul gebaseerde index van het item dat moet worden verwijderd.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

Deze methode rangschikt automatisch scheidingstekens die worden beïnvloed door het verwijderen van een item. Zie CMFCToolBar::RemoveButton voor meer informatie over hoe het framework scheidingstekens opnieuw rangschikt.

CMFCPopupMenu::SaveState

virtual void SaveState();

Opmerkingen

CMFCPopupMenu::SetAnimationSpeed

Hiermee stelt u de animatiesnelheid voor pop-upmenu's in.

static void SetAnimationSpeed(UINT nElapse);

Parameterwaarden

nElapse
[in] De nieuwe animatiesnelheid, in milliseconden.

Opmerkingen

De animatiesnelheid is een globale waarde en is van invloed op alle pop-upmenu's in de toepassing. Deze waarde geeft aan hoe lang het duurt voordat de animatie is voltooid voordat een snelmenu is voltooid.

Deze parameter is standaard ingesteld op 30 milliseconden. Het bereik van geldige waarden voor nElapse is van 0 tot 200.

CMFCPopupMenu::SetAnimationType

Hiermee stelt u het animatietype voor dit snelmenu in.

static void SetAnimationType(CMFCPopupMenu::ANIMATION_TYPE type);

Parameterwaarden

type
[in] Een geïnventariseerd gegevenstype dat het type animatie aangeeft.

Opmerkingen

Zie CMFCPopupMenu::GetAnimationType voor een lijst met geldige waarden voor het type.

CMFCPopupMenu::SetAutoDestroy

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parameterwaarden

[in] bAutoDestroy

Opmerkingen

CMFCPopupMenu::SetDefaultItem

Hiermee stelt u de standaardopdracht in voor het snelmenu.

void SetDefaultItem(UINT uiCmd);

Parameterwaarden

uiCmd
[in] De menuopdracht-id van de nieuwe standaardopdracht.

Opmerkingen

De standaardopdracht in het snelmenu is de opdracht die is geselecteerd wanneer het snelmenu wordt weergegeven.

CMFCPopupMenu::SetForceMenuFocus

Hiermee wordt de invoerfocus gedwongen terug te keren naar de menubalk wanneer een snelmenu wordt weergegeven.

static void SetForceMenuFocus(BOOL bValue);

Parameterwaarden

bValue
[in] WAAR als u wilt dat het framework de invoerfocus naar de menubalk dwingt wanneer er een pop-upmenu wordt weergegeven. ONWAAR als u wilt dat het snelmenu de focus behoudt.

Opmerkingen

Met deze methode wordt een vlag ingesteld die globaal is voor alle pop-upmenu's in de toepassing. Deze functie is standaard niet ingeschakeld.

CMFCPopupMenu::SetForceShadow

Dwingt het framework om menuschaduwen te tekenen wanneer pop-upmenu's buiten het hoofdframe worden weergegeven.

static void SetForceShadow(BOOL bValue);

Parameterwaarden

bValue
[in] WAAR als u wilt dat het framework menuschaduwen tekent, anders ONWAAR.

Opmerkingen

Wanneer u deze methode aanroept, wordt er een globale vlag in uw toepassing ingesteld. Deze vlag is van invloed op alle pop-upmenu's in uw toepassing.

CMFCPopupMenu::SetMaxWidth

Stel de maximale breedte in voor het snelmenu.

void SetMaxWidth(int iMaxWidth);

Parameterwaarden

iMaxWidth
[in] De maximale breedte voor het snelmenu, in pixels.

Opmerkingen

Als de tekst die is gekoppeld aan een menuopdracht niet in de maximale breedte past, wordt deze afgekapt en wordt het deel dat niet past, vervangen door drie puntjes.

CMFCPopupMenu::SetMessageWnd

void SetMessageWnd(CWnd* pMsgWnd);

Parameterwaarden

[in] pMsgWnd

Opmerkingen

CMFCPopupMenu::SetParentRibbonElement

void SetParentRibbonElement(CMFCRibbonBaseElement* pElem);

Parameterwaarden

[in] pElem

Opmerkingen

CMFCPopupMenu::SetQuickCustomizeType

void SetQuickCustomizeType(QUICK_CUSTOMIZE_TYPE Type);

Parameterwaarden

[in] Type

Opmerkingen

CMFCPopupMenu::SetQuickMode

void SetQuickMode();

Opmerkingen

CMFCPopupMenu::SetRightAlign

Hiermee stelt u de menu-uitlijning in voor pop-upmenu's.

void SetRightAlign(BOOL bRightAlign = TRUE);

Parameterwaarden

bRightAlign
[in] Een Booleaanse waarde die de uitlijning van het menu aangeeft. TRUE geeft rechtsuitlijning aan, ONWAAR geeft linkse uitlijning aan.

Opmerkingen

Standaard worden alle pop-upmenu's links uitgelijnd.

CMFCPopupMenu::SetSendMenuSelectMsg

Hiermee stelt u een vlag in waarmee wordt bepaald of het pop-upmenu het bovenliggende frame aangeeft wanneer de gebruiker een opdracht selecteert.

static void SetSendMenuSelectMsg(BOOL bSet = TRUE);

Parameterwaarden

bSet
[in] WAAR als het pop-upmenu het bovenliggende frame aangeeft, anders ONWAAR.

Opmerkingen

Dit is een globale optie voor alle pop-upmenu's in een toepassing. Als deze optie is ingeschakeld, verzenden de pop-upmenu's een WM_MENUSELECT bericht naar het bovenliggende frame wanneer de gebruiker een opdracht selecteert.

CMFCPopupMenu::ShowAllCommands

Hiermee dwingt u het snelmenu om alle opdrachten weer te geven.

void ShowAllCommands();

Opmerkingen

Dit is geen globale instelling en is alleen van invloed op het huidige snelmenu.

CMFCPopupMenu::TriggerResize

void TriggerResize();

Opmerkingen

CMFCPopupMenu::UpdateAllShadows

Hiermee worden de schaduwen bijgewerkt voor alle geopende pop-upmenu's.

static void UpdateAllShadows(LPRECT lprectScreen = NULL);

Parameterwaarden

lprectScreen
[in] Een rechthoek met de regio die moet worden bijgewerkt, in schermcoördinaten.

Opmerkingen

Deze methode is handig wanneer pop-upmenu's worden weergegeven via besturingselementen met animatie of andere vensters met dynamische inhoud.

CMFCPopupMenu::UpdateShadow

Hiermee werkt u de schaduw voor het snelmenu bij.

void UpdateShadow(LPRECT lprectScreen = NULL);

Parameterwaarden

lprectScreen
[in] Een rechthoek, in schermcoördinaten, die de grenzen van de regio aangeeft die moeten worden bijgewerkt.

Opmerkingen

Roep deze methode aan wanneer een snelmenu met een schaduw een geanimeerde afbeelding overlapt.

Zie ook

Hiërarchiegrafiek
Klassen
Klasse CMFCPopupMenuBar

Feedback

Is deze pagina nuttig?

Last updated on 2026-02-23

Share via

CmFCPopupMenu-klasse

Syntaxis

Leden

Beveiligde constructors

Openbare methoden

Beveiligde methoden

Opmerkingen

Example

Overnamehiërarchie

Requirements

CMFCPopupMenu::ActivatePopupMenu

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCPopupMenu::AlwaysShowEmptyToolsEntry

Parameterwaarden

CMFCPopupMenu::AreAllCommandsShown

Retourwaarde

Opmerkingen

CMFCPopupMenu::CheckArea

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCPopupMenu::CloseMenu

Parameterwaarden

Opmerkingen

CMFCPopupMenu::CMFCPopupMenu

Parameterwaarden

Opmerkingen

CMFCPopupMenu::Maken

Parameterwaarden

Retourwaarde

Opmerkingen

Example

CMFCPopupMenu::CreateTearOffBar

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCPopupMenu::D efaultMouseClickOnClose

Retourwaarde

Opmerkingen

CMFCPopupMenu::EnableMenuLogo

Parameterwaarden

Opmerkingen

CMFCPopupMenu::EnableMenuSound

Parameterwaarden

Opmerkingen

CMFCPopupMenu::EnableResize

Parameterwaarden

Opmerkingen

CMFCPopupMenu::EnableScrolling

Parameterwaarden

Opmerkingen

CMFCPopupMenu::EnableVertResize

Parameterwaarden

Opmerkingen

CMFCPopupMenu::FindSubItemByCommand

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetActiveMenu

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetAnimationSpeed

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetAnimationType

Parameterwaarden

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetDropDirection

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetForceMenuFocus

Retourwaarde

Opmerkingen

CMFCPopupMenu::GetForceShadow

Retourwaarde

Opmerkingen