AppendMenu

De functie AppendMenu wordt een nieuw item toegevoegd aan het einde van de opgegeven menubalk, drop-down menu, submenu of snelmenu. U kunt deze functie gebruiken om op te geven van de inhoud, uiterlijk en gedrag van het menu-item.

De functie AppendMenu is vervangen door de InsertMenuItem functie. U kunt nog steeds AppendMenu, echter, als u niet een van de uitgebreide kenmerken van InsertMenuItem hoeft.

 BOOL AppendMenu ()  HMENU  hMenu, / / ingang naar menu worden gewijzigdUINTuFlags, / / menu-item vlaggenUINTuIDNewItem, / / menu-item-id of handvat naar drop-down menu of vervolgmenuLPCTSTRlpNewItem / / menu-item inhoud);
 

Parameters

hMenu
Ingang naar de menubalk, drop-down menu, submenu of snelmenu worden gewijzigd.
uFlags
Geeft de vlaggen te bepalen de weergave en het gedrag van het nieuwe menu-item. Deze parameter kan bestaan uit een combinatie van de waarden vermeld in de volgende sectie opmerkingen.
uIDNewItem
Hiermee geeft u op of de id van de nieuwe menu-item of, als de parameter uFlags is ingesteld op MF_POPUP, de greep naar de drop-down menu of vervolgmenu.
lpNewItem
Hiermee geeft u de inhoud van het nieuwe menu-item. Afhankelijk van de interpretatie van lpNewItem of de uFlags -parameter als volgt de MF_BITMAP, MF_OWNERDRAW, of MF_STRING vlag, omvat:
Waarde Beschrijving
MF_BITMAP Bevat een ingang bitmap.
MF_OWNERDRAW Een 32-bits waarde geleverd door de toepassing die kan worden gebruikt om aanvullende gegevens met betrekking tot het menu-item bevat. De waarde is in de itemData lid van de structuur waarnaar door de parameter lparam van de WM_MEASURE of WM_DRAWITEM-bericht wordt verzonden wanneer het menu is gemaakt of het uiterlijk is bijgewerkt.
MF_STRING Een verwijzing naar een op null eindigende tekenreeks bevat.

Retourwaarden

Als de functie slaagt, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De toepassing moet aanroepen van de functie DrawMenuBar wanneer een menu verandert, of of het menu niet in een venster weergegeven is.

Om sneltoetsen te werken met bitmap of eigenaar getekende menu-items, moet de eigenaar van het menu het bericht WM_MENUCHAR verwerken. Voor meer informatie, Zie Owner-Drawn menu's en het WM_MENUCHAR bericht.

De volgende vlaggen kunnen worden ingesteld in de uFlags -parameter:

Waarde Beschrijving
MF_BITMAP Een bitmap gebruikt als het menu-item. De parameter lpNewItem bevat de ingang voor de bitmap.
MF_CHECKED Hiermee plaatst u een vinkje naast de menuopdracht. Als de toepassing vinkje bitmaps biedt (Zie SetMenuItemBitmaps, deze vlag geeft het vinkje naast de menuopdracht bitmap.
MF_DISABLED Het menu-item wordt uitgeschakeld, dus het kan niet worden geselecteerd, maar de vlag doet het niet grijs.
MF_ENABLED Hiermee schakelt u het menu-item zodat het kan worden geselecteerd, en herstelt u het uit de grijze staat.
MF_GRAYED Grays het zodat het niet kan worden geselecteerd en het menu-item uitgeschakeld.
MF_MENUBARBREAK Functies hetzelfde als de MF_MENUBREAK vlag voor een menubalk. Voor een drop-down menu, submenu of snelmenu, wordt de nieuwe kolom van de oude kolom gescheiden door een verticale lijn.
MF_MENUBREAK Plaatst het item op een nieuwe regel (voor een menubalk) of in een nieuwe kolom (voor een drop-down menu, submenu of snelmenu) zonder te scheiden van kolommen.
MF_OWNERDRAW Hiermee geeft u aan dat het item een item eigenaar getrokken is. Voordat het menu wordt weergegeven voor de eerste keer, ontvangt het venster dat eigenaar is van het menu een bericht van de WM_MEASUREITEM op te halen de breedte en hoogte van het menu-item. Het WM_DRAWITEM bericht is vervolgens doorgegeven aan de procedure venster van de eigenaar-venster wanneer de weergave van het menu-item moet worden bijgewerkt.
MF_POPUP Hiermee geeft u aan dat het menu-item een drop-down menu of submenu opent. De parameter uIDNewItem geeft de ingang naar het drop-down menu of submenu. Deze vlag wordt gebruikt een menunaam toevoegen aan de menubalk, of een menu-item dat wordt geopend een submenu naar een drop-down menu, submenu of snelmenu.
MF_SEPARATOR Vestigt een horizontale scheidingslijn. Deze vlag wordt alleen gebruikt in een drop-down menu, submenu of snelmenu. De regel kan niet worden grijs weergegeven, uitgeschakeld of gemarkeerd. De lpNewItem en uIDNewItem parameters worden genegeerd.
MF_STRING Hiermee geeft u aan dat het menu-item een tekenreeks is; de parameter lpNewItem wijst naar de tekenreeks.
MF_UNCHECKED Plaatst niet een vinkje naast het item (standaard). Als de toepassing levert vinkje bitmaps (Zie SetMenuItemBitmaps), deze vlag wordt de ongecontroleerde bitmap naast het menu-item weergegeven.

De volgende groepen van vlaggen kunnen niet samen worden gebruikt:

Windows CE: De volgende vlaggen worden niet ondersteund voor de parameter fuFlags

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED kan worden gebruikt in plaats van MF_DISABLED en MFS_GRAYED.

Windows CE 1.0 ondersteunt geen trapsgewijze menu's. Als u Windows CE 1.0 gebruikt, kunt u een MF_POPUP menu invoegen in een andere pop-up menu.

In Windows CE 1.0, worden de volgende vlaggen niet ondersteund:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

In Windows CE versie 2.0 en hoger, worden deze vlaggen ondersteund. Trapsgewijze menu's worden ook ondersteund.

Zie ook

Overzicht van de menu's, menufuncties, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index