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:

MF_DISABLED, MF_ENABLED en MF_GRAYED
MF_BITMAP, MF_STRING en MF_OWNERDRAW
MF_MENUBARBREAK en MF_MENUBREAK
MF_CHECKED en MF_UNCHECKED

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