Share via

CMFCToolBarMenuButton-klasse

Opmerking

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

Een werkbalkknop met een snelmenu. Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

Syntaxis

class CMFCToolBarMenuButton : public CMFCToolBarButton

Leden

Openbare constructors

Naam Description
CMFCToolBarMenuButton::CMFCToolBarMenuButton Maakt een CMFCToolBarMenuButton object.

Openbare methoden

Naam Description
CMFCToolBarMenuButton::CompareWith Vergelijkt dit exemplaar met het opgegeven CMFCToolBarButton object. (Hiermee overschrijft u CMFCToolBarButton::CompareWith.)
CMFCToolBarMenuButton::CopyFrom Hiermee kopieert u de eigenschappen van een andere werkbalkknop naar de huidige knop. (Hiermee overschrijft u CMFCToolBarButton::CopyFrom.)
CMFCToolBarMenuButton::CreateFromMenu Initialiseert het werkbalkmenu vanuit een Windows-menugreep.
CMFCToolBarMenuButton::CreateMenu Hiermee maakt u een Windows-menu dat bestaat uit de opdrachten in het werkbalkmenu. Retourneert een ingang naar het Windows-menu.
CMFCToolBarMenuButton::CreatePopupMenu Hiermee maakt u een pop-upmenuobject ( CMFCPopupMenu Class) om het werkbalkmenu weer te geven.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands Geeft alleen-lezen toegang tot de lijst met opdrachten in het werkbalkmenu.
CMFCToolBarMenuButton::GetImageRect Hiermee haalt u de begrenzingsrechthoek voor de knopafbeelding op.
CMFCToolBarMenuButton::GetPaletteRows Retourneert het aantal rijen in het snelmenu wanneer het menu zich in de paletmodus bevindt.
CMFCToolBarMenuButton::GetPopupMenu Hiermee wordt een aanwijzer geretourneerd naar het snelmenuobject dat aan de knop is gekoppeld.
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder Bepaalt of een rand van de knop wordt weergegeven wanneer een gebruiker de knop selecteert. (Hiermee wordt CMFCToolBarButton::HaveHotBorder overschreven.)
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown Bepaalt of het snelmenu wordt weergegeven.
CMFCToolBarMenuButton::IsEmptyMenuAllowed Aangeroepen door het framework om te bepalen of een gebruiker een submenu kan openen vanuit het geselecteerde menu-item.
CMFCToolBarMenuButton::IsExclusive Bepaalt of de knop zich in de exclusieve modus bevindt, dat wil gezegd, of het snelmenu geopend blijft, zelfs wanneer de gebruiker de aanwijzer over een andere werkbalk of knop verplaatst.
CMFCToolBarMenuButton::IsMenuPaletteMode Bepaalt of het pop-upmenu zich in de paletmodus bevindt.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu Bepaalt of het snelmenu een scheurbalk heeft.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag Hiermee geeft u op of de knop kan worden gesleept. (Overschrijft CMFCToolBarButton::OnBeforeDrag.)
CMFCToolBarMenuButton::OnCalculateSize Aangeroepen door het framework om de grootte van de knop voor de opgegeven apparaatcontext en dockingstatus te berekenen. (Hiermee wordt CMFCToolBarButton::OnCalculateSize overschreven.)
CMFCToolBarMenuButton::OnCancelMode Wordt aangeroepen door het framework om het WM_CANCELMODE bericht af te handelen. (Hiermee wordt CMFCToolBarButton::OnCancelMode overschreven.)
CMFCToolBarMenuButton::OnChangeParentWnd Aangeroepen door het framework wanneer de knop wordt ingevoegd in een nieuwe werkbalk. (Hiermee wordt CMFCToolBarButton::OnChangeParentWnd overschreven.)
CMFCToolBarMenuButton::OnClick Aangeroepen door het framework wanneer de gebruiker op de muisknop klikt. (Hiermee overschrijft u CMFCToolBarButton::OnClick.)
CMFCToolBarMenuButton::OnClickMenuItem Aangeroepen door het framework wanneer de gebruiker een item selecteert in het snelmenu.
CMFCToolBarMenuButton::OnContextHelp Aangeroepen door het framework wanneer de bovenliggende werkbalk een WM_HELPHITTEST bericht verwerkt. (Hiermee wordt CMFCToolBarButton::OnContextHelp overschreven.)
CMFCToolBarMenuButton::OnDraw Aangeroepen door het framework om de knop te tekenen met behulp van de opgegeven stijlen en opties. (Hiermee wordt CMFCToolBarButton::OnDraw overschreven.)
CMFCToolBarMenuButton::OnDrawOnCustomizeList Aangeroepen door het framework om de knop te tekenen in het deelvenster Opdrachten van het dialoogvenster Aanpassen . (Overschrijft CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCToolBarMenuButton::OpenPopupMenu Aangeroepen door het framework wanneer de gebruiker het pop-upmenu opent.
CMFCToolBarMenuButton::ResetImageToDefault Hiermee stelt u de standaardwaarde in voor de afbeelding die aan de knop is gekoppeld. (Hiermee wordt CMFCToolBarButton::ResetImageToDefault overschreven.)
CMFCToolBarMenuButton::SaveBarState Hiermee wordt de status van de werkbalkknop opgeslagen. (Hiermee wordt CMFCToolBarButton::SaveBarState overschreven.)
CMFCToolBarMenuButton::Serialize Leest dit object uit een archief of schrijft het naar een archief. (Hiermee wordt CMFCToolBarButton::Serialize overschreven.)
CMFCToolBarMenuButton::SetACCData Hiermee wordt het opgegeven CAccessibilityData object gevuld met toegankelijkheidsgegevens via de werkbalkknop. (Hiermee wordt CMFCToolBarButton::SetACCData overschreven.)
CMFCToolBarMenuButton::SetMenuOnly Hiermee geeft u op of de knop kan worden toegevoegd aan een werkbalk.
CMFCToolBarMenuButton::SetMenuPaletteMode Hiermee geeft u op of het snelmenu zich in de paletmodus bevindt.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio Hiermee dwingt u de menuknop van de werkbalk om een pictogram weer te geven dat aangeeft dat het is geselecteerd.
CMFCToolBarMenuButton::SetTearOff Hiermee geeft u een tear-off bar-id voor het snelmenu.

Beveiligde methoden

Naam Description
CMFCToolBarMenuButton::D rawDocumentIcon Hiermee tekent u een pictogram op de menuknop.

Gegevensleden

Naam Description
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw Als WAAR is, roept het framework altijd CFrameWndEx::OnDrawMenuImage aan wanneer een knop wordt getekend.

Opmerkingen

Een CMFCToolBarMenuButton kan worden weergegeven als een menu, een menu-item met een submenu, een knop die een opdracht uitvoert of een menu weergeeft, of een knop die alleen een menu weergeeft. U bepaalt het gedrag en het uiterlijk van de menuknop door parameters op te geven, zoals de afbeelding, tekst, menugreep en opdracht-id die is gekoppeld aan de knop in de constructor CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Een aangepaste klasse die is afgeleid van de CMFCToolbarMenuButton klasse, moet de DECLARE_SERIAL macro gebruiken. De DECLARE_DYNCREATE macro genereert een fout wanneer de toepassing wordt gesloten.

Example

In het volgende voorbeeld ziet u hoe u een CMFCToolBarMenuButton object configureert. De code laat zien hoe u kunt opgeven dat de vervolgkeuzelijst zich in de paletmodus bevindt en de id voor de scheurbalk opgeeft die wordt gemaakt wanneer de gebruiker de menuknop van een menubalk versleept. Dit codefragment maakt deel uit van het Word Pad-voorbeeld.

pBorderType->SetMenuPaletteMode(TRUE, 2 /* Rows number */);
pBorderType->SetTearOff(ID_BORDER_TEAROFF);

Overnamehiërarchie

CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Requirements

Koptekst: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Maakt een CMFCToolBarMenuButton object.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parameterwaarden

Src
[in] Een bestaand CMFCToolBarMenuButton object dat naar dit CMFCToolBarMenuButton object moet worden gekopieerd.

uiID
[in] De id van de opdracht die moet worden uitgevoerd wanneer een gebruiker op de knop klikt; of (UINT)-1 voor een menuknop die geen opdracht rechtstreeks uitvoert.

hMenu
[in] Een ingang naar een menu; of NULL als de knop geen menu heeft.

iImage
[in] Index van de afbeelding voor de knop; of -1 als deze knop geen pictogram heeft of het pictogram gebruikt voor de opdracht die is opgegeven door uiID. De index is hetzelfde voor elk CMFCToolBarImages object in uw toepassing.

lpszText
[in] De tekst van de werkbalkmenuknop.

bUserButton
[in] WAAR als op de knop een door de gebruiker gedefinieerde afbeelding wordt weergegeven; ONWAAR als op de knop een vooraf gedefinieerde afbeelding wordt weergegeven die is gekoppeld aan de opdracht die is opgegeven door uiID.

Opmerkingen

Als uiID een geldige opdracht-id is, voert de knop die opdracht uit wanneer de gebruiker erop klikt. Als hMenu een geldige menugreep is, bevat de knop een vervolgkeuzemenu wanneer het wordt weergegeven in een werkbalk of submenu wanneer het wordt weergegeven in een menu. Als zowel uiID als hMenu geldig zijn, is de knop een splitsknop met een gedeelte waarmee de opdracht wordt uitgevoerd wanneer de gebruiker erop klikt en een gedeelte met een pijl-omlaag waarmee een menu wordt weergegeven wanneer de gebruiker erop klikt. Als hMenu echter geldig is, kan een gebruiker niet op de knop klikken om een opdracht uit te voeren wanneer de knop in een menu wordt ingevoegd.

Example

In het volgende voorbeeld ziet u hoe u een object van de CMFCToolBarMenuButton klasse maakt. Dit codefragment maakt deel uit van het Word Pad-voorbeeld.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parameterwaarden

[in] Andere

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameterwaarden

[in] Src

Opmerkingen

CMFCToolBarMenuButton::CreateFromMenu

Initialiseert het werkbalkmenu vanuit een Windows-menugreep.

virtual void CreateFromMenu(HMENU hMenu);

Parameterwaarden

hMenu
[in] Een greep naar een menu.

Opmerkingen

Een menuknop op de werkbalk kan een vervolgkeuzemenu weergeven.

In het framework wordt deze methode aangeroepen om de opdrachten in het submenu te initialiseren vanuit een menu.

CMFCToolBarMenuButton::CreateMenu

Hiermee maakt u een menu dat bestaat uit de opdrachten in het werkbalkmenu. Retourneert een ingang naar het menu.

virtual HMENU CreateMenu() const;

Retourwaarde

Een ingang naar het menu als het lukt. NULL als de lijst met opdrachten die zijn gekoppeld aan de werkbalkmenuknop leeg is.

Opmerkingen

U kunt deze methode in een afgeleide klasse overschrijven om de manier aan te passen waarop het menu wordt gegenereerd.

CMFCToolBarMenuButton::CreatePopupMenu

Hiermee maakt u een CMFCPopupMenu object om het werkbalkmenu weer te geven.

virtual CMFCPopupMenu* CreatePopupMenu();

Retourwaarde

Een aanwijzer naar een CMFCPopupMenu object dat de vervolgkeuzelijst weergeeft die is gekoppeld aan de werkbalkmenuknop.

Opmerkingen

Deze methode wordt aangeroepen door het framework om de weergave van de vervolgkeuzelijst die aan de knop is gekoppeld, voor te bereiden.

De standaard implementatie bouwt en retourneert een nieuw CMFCPopupMenu object. Overschrijf deze methode als u een afgeleid type CMFCPopupMenu-klasse wilt gebruiken of als u extra initialisatie wilt uitvoeren.

CMFCToolBarMenuButton::D rawDocumentIcon

Hiermee tekent u een documentpictogram op de menuknop.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parameterwaarden

Pdc
[in] Een aanwijzer naar de apparaatcontext.

rectImage
[in] Coördinaten van de begrenzingsrechthoek van de afbeelding.

hIcon
[in] Een greep naar het pictogram.

Opmerkingen

Deze methode gebruikt een documentpictogram en tekent het op de menuknop, gecentreerd in het gebied dat is opgegeven door rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Opmerkingen

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::GetCommands

Geeft alleen-lezen toegang tot de lijst met opdrachten in het werkbalkmenu.

const CObList& GetCommands() const;

Retourwaarde

Een const-verwijzing naar een CObList Class-object , dat een verzameling CMFCToolBarButton Class-objecten bevat.

Opmerkingen

Een werkbalkmenuknop kan een submenu weergeven. U kunt de lijst met opdrachten opgeven in het submenu in de constructor of in CMFCToolBarMenuButton::CreateFromMenu als een greep naar een menu (HMENU). Het menu wordt geconverteerd naar een lijst met objecten die zijn afgeleid van CMFCToolBarButton Class en zijn opgeslagen in het interne CObList object. U kunt deze lijst openen door deze methode aan te roepen.

CMFCToolBarMenuButton::GetImageRect

Hiermee haalt u de begrenzingsrechthoek voor de knopafbeelding op.

void GetImageRect(CRect& rectImage);

Parameterwaarden

rectImage
[uit] Een verwijzing naar een CRect object dat de coördinaten van de begrenzingsrechthoek van de afbeelding ontvangt.

CMFCToolBarMenuButton::GetPaletteRows

Retourneert het aantal rijen in de vervolgkeuzelijst wanneer het menu zich in de paletmodus bevindt.

int GetPaletteRows() const;

Retourwaarde

Het aantal rijen in het palet.

Opmerkingen

Wanneer de menuknop is ingesteld op de paletmodus, worden menu-items weergegeven in meerdere kolommen met slechts een beperkt aantal rijen. Roep deze methode aan om het aantal rijen te verkrijgen. U kunt de paletmodus in- of uitschakelen en het aantal rijen opgeven met behulp van CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Retourneert een aanwijzer naar het CMFCPopupMenu Class-object dat de vervolgkeuzelijst van de knop vertegenwoordigt.

CMFCPopupMenu* GetPopupMenu() const;

Retourwaarde

Een aanwijzer naar een CMFCPopupMenu Class-object dat is gemaakt toen het framework het submenu van de knop werkbalkmenu tekende; NULL als er geen submenu wordt weergegeven.

Opmerkingen

Wanneer een werkbalkmenuknop een vervolgkeuzemenu weergeeft, maakt de knop een CMFCPopupMenu Class-object om het menu weer te geven. Roep deze methode aan om een aanwijzer naar het CMFCPopupMenu object te verkrijgen. Sla de geretourneerde aanwijzer niet op, omdat deze tijdelijk is en ongeldig wordt wanneer de gebruiker de vervolgkeuzelijst sluit.

CMFCToolBarMenuButton::IsDroppedDown

Hiermee wordt aangegeven of het snelmenu momenteel wordt weergegeven.

virtual BOOL IsDroppedDown() const;

Retourwaarde

WAAR als het submenu van de werkbalkknop wordt weergegeven; anders ONWAAR.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Hiermee geeft u op of in menu-items lege submenu's worden weergegeven.

virtual BOOL IsEmptyMenuAllowed() const;

Retourwaarde

TRUE als het framework een submenu opent vanuit het geselecteerde menu-item, zelfs wanneer het submenu leeg is; anders ONWAAR.

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer een gebruiker het submenu probeert te openen vanuit het geselecteerde menu-item. Als het submenu leeg is en IsEmptyMenuAllowed ONWAAR retourneert, wordt het submenu niet geopend.

De standaard implementatie retourneert FALSE. Overschrijf deze methode om dit gedrag aan te passen.

CMFCToolBarMenuButton::IsExclusive

Geeft aan of de knop zich in de exclusieve modus bevindt.

virtual BOOL IsExclusive() const;

Retourwaarde

WAAR als de knop in de exclusieve modus werkt; anders ONWAAR.

Opmerkingen

Wanneer een gebruiker een pop-upmenu voor een knop opent en vervolgens de muisaanwijzer over een andere werkbalk of menuknop beweegt, wordt het pop-upmenu gesloten, tenzij de knop in de exclusieve modus staat.

De standaard implementatie retourneert altijd FALSE. Overschrijf deze methode in een afgeleide klasse als u de exclusieve modus wilt inschakelen.

CMFCToolBarMenuButton::IsMenuPaletteMode

Bepaalt of de vervolgkeuzelijst zich in de paletmodus bevindt.

BOOL IsMenuPaletteMode() const;

Retourwaarde

WAAR als de paletmodus is ingeschakeld, anders ONWAAR.

Opmerkingen

Wanneer de menuknop is ingesteld op de paletmodus, worden menu-items weergegeven in meerdere kolommen met slechts een beperkt aantal rijen. Roep deze methode aan om het aantal rijen te verkrijgen. U kunt de paletmodus in- of uitschakelen door CMFCToolBarMenuButton::SetMenuPaletteMode aan te roepen.

CMFCToolBarMenuButton::IsTearOffMenu

Geeft aan of het vervolgkeuzemenu een scheurbalk heeft.

virtual BOOL IsTearOffMenu() const;

Retourwaarde

WAAR als de werkbalkmenuknop een scheurbalk heeft; anders ONWAAR.

Opmerkingen

Als u de scheurfunctie wilt inschakelen en de staaf-id wilt instellen, roept u CMFCToolBarMenuButton::SetTearOff aan.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Hiermee geeft u op of het framework altijd CFrameWndEx::OnDrawMenuImage aanroept wanneer een knop wordt getekend.

static BOOL m_bAlwaysCallOwnerDraw;

Opmerkingen

Wanneer deze lidvariabele is ingesteld op TRUE, roept de knop altijd de methode CFrameWndEx::OnDrawMenuImage aan om de afbeelding op de knop weer te geven. Wanneer m_bAlwaysCallOwnerDraw onwaar is, tekent de knop zelf de afbeelding als de afbeelding vooraf is gedefinieerd. Anders wordt het aanroepen OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Opmerkingen

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::OnCalculateSize

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parameterwaarden

[in] Pdc
[in] sizeDefault
[in] bHorz

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Opmerkingen

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameterwaarden

[in] pWndParent

Opmerkingen

CMFCToolBarMenuButton::OnClick

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parameterwaarden

[in] pWnd
[in] bDelay

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::OnClickMenuItem

Aangeroepen door het framework wanneer de gebruiker een item selecteert in de vervolgkeuzelijst.

virtual BOOL OnClickMenuItem();

Retourwaarde

ONWAAR als het framework de standaardverwerking van menu-items moet voortzetten; anders WAAR. De standaard implementatie retourneert altijd FALSE.

Opmerkingen

Wanneer de gebruiker op een menu-item klikt, voert het framework een opdracht uit die aan dat item is gekoppeld.

Als u de verwerking van menu-items wilt aanpassen, overschrijft OnClickMenuItem u deze in een klasse die is afgeleid van CMFCToolBarMenuButton de klasse. U moet ook CFrameWndEx::OnShowPopupMenu overschrijven en de menuknoppen vervangen die speciale verwerking vereisen met exemplaren van de afgeleide klasse.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parameterwaarden

[in] pWnd

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::OnDraw

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parameterwaarden

[in] Pdc
[in] Rect
[in] pImages
[in] bHorz
[in] bCustomizeMode
[in] bHighlight
[in] bDrawBorder
[in] bGrayDisabledButtons

Opmerkingen

CMFCToolBarMenuButton::OnDrawOnCustomizeList

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parameterwaarden

[in] Pdc
[in] Rect
[in] bSelected

Retourwaarde

Opmerkingen

CMFCToolBarMenuButton::OpenPopupMenu

Aangeroepen door het framework wanneer de gebruiker de vervolgkeuzelijst van een werkbalkmenuknop opent.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parameterwaarden

pWnd
[in] Hiermee geeft u het venster op dat de vervolgkeuzelijstopdrachten ontvangt. Het kan alleen NULL zijn als de knop werkbalkmenu een bovenliggend venster heeft.

Retourwaarde

TRUE wanneer een CMFCPopupMenu Class-object is gemaakt en geopend; anders ONWAAR.

Opmerkingen

Deze functie wordt aangeroepen door het framework wanneer de gebruiker een vervolgkeuzelijst opent vanuit een werkbalkmenuknop.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Opmerkingen

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Opmerkingen

In het framework wordt deze methode aangeroepen wanneer er een werkbalkknop wordt gemaakt als gevolg van een slepen-en-neerzetten-bewerking. Met deze methode wordt de methode CMFCPopupMenu::SaveState van het snelmenu op het hoogste niveau aangeroepen, waardoor de bovenliggende knop van het snelmenu opnieuw wordt gemaakt.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parameterwaarden

[in] Ar

Opmerkingen

CMFCToolBarMenuButton::SetACCData

Hiermee stelt u de toegankelijkheidsgegevens voor het lintelement in.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parameterwaarden

pParent
Het bovenliggende venster voor het lintelement.

gegevens
De toegankelijkheidsgegevens voor het lintelement.

Retourwaarde

Retourneert altijd WAAR.

Opmerkingen

Deze methode stelt standaard de toegankelijkheidsgegevens voor het lintelement in en retourneert altijd TRUE. Overschrijf deze methode om de toegankelijkheidsgegevens in te stellen en een waarde te retourneren die aangeeft dat deze is geslaagd of mislukt.

CMFCToolBarMenuButton::SetMenuOnly

Hiermee geeft u op of de knop wordt getekend als een menuknop of een splitsknop wanneer deze zowel een geldige opdracht-id als een submenu heeft.

void SetMenuOnly(BOOL bMenuOnly);

Parameterwaarden

bMenuOnly
[in] TRUE om deze knop weer te geven als menuknop wanneer deze zowel een geldige opdracht-id als een submenu heeft, ONWAAR om deze knop weer te geven als een splitsknop wanneer deze zowel een geldige opdracht-id als een submenu heeft.

Opmerkingen

Wanneer een menuknop op de werkbalk zowel een submenu als een opdracht-id bevat, lijkt het menu een splitsknop te zijn met een hoofdknop en een gekoppelde pijl-omlaag. Als u deze methode aanroept en bMenuOnly WAAR is, lijkt de knop in plaats daarvan één menuknop te zijn met een pijl-omlaag in de knop. Wanneer de gebruiker in beide modus op de pijl klikt, wordt het submenu geopend en wanneer de gebruiker op het niet-pijlgedeelte van de knop klikt in beide modus, voert het framework de opdracht uit.

CMFCToolBarMenuButton::SetMenuPaletteMode

Hiermee geeft u op of de vervolgkeuzelijst zich in de paletmodus bevindt.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parameterwaarden

bMenuPaletteMode
[in] Hiermee geeft u op of de vervolgkeuzelijst zich in de paletmodus bevindt.

nPaletteRows
[in] Aantal rijen in palet.

Opmerkingen

In de paletmodus worden alle menu-items weergegeven als een palet met meerdere kolommen. U geeft het aantal rijen op met behulp van nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parameterwaarden

[in] pWndMessage

Opmerkingen

CMFCToolBarMenuButton::SetRadio

Hiermee stelt u de werkbalkmenuknop in om een pictogram van een keuzerondje weer te geven wanneer deze is ingeschakeld.

virtual void SetRadio();

Opmerkingen

Wanneer de menuknop wordt getekend terwijl deze is ingeschakeld, wordt CMFCVisualManager::OnDrawMenuCheck aanroepen om een vinkje te tekenen. OnDrawMenuCheck Standaard vraagt de huidige visualbeheerder een vinkje in de stijl van het selectievakje op de menuknop. Nadat u deze methode hebt aangeroepen, tekent de huidige visualmanager in plaats daarvan een vinkje in de stijl van een keuzerondje op de menuknop. Deze wijziging kan niet ongedaan worden gemaakt.

Wanneer u deze methode aanroept en de menuknop momenteel wordt weergegeven, wordt deze vernieuwd.

CMFCToolBarMenuButton::SetTearOff

Hiermee geeft u de id van de scheurbalk voor de vervolgkeuzelijst op.

virtual void SetTearOff(UINT uiBarID);

Parameterwaarden

uiBarID
[in] Hiermee geeft u een nieuwe losloopbalk-id op.

Opmerkingen

Roep deze methode aan om de id op te geven voor de scheurbalk die wordt gemaakt wanneer de gebruiker de menuknop van een menubalk sleept. Als de parameter uiBarID 0 is, kan de gebruiker de menuknop niet verwijderen.

Roep CWinAppEx::EnableTearOffMenus aan om de menufunctie in te schakelen in uw toepassing.

Zie ook

Hiërarchiegrafiek
Klassen
Klasse CMFCToolBarButton
CMFCToolBar-klasse
CmFCPopupMenu-klasse

  • Last updated on