InsertMenu

De functie InsertMenu voegt een nieuw menu-item in een menu, andere items onderaan het menu verplaatsen.

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

BOOL InsertMenu ()  HMENU  hMenu, / / ingang naar menuUINTuPosition, / / menu-item dat nieuwe menu item voorafgaat aanUINTuFlags, / / menu-item vlaggenUINTuIDNewItem, / / menu item id of ingang naar drop-down / / menu of submenuLPCTSTRlpNewItem / / menu-item inhoud);

Parameters

hMenu
Ingang naar het menu worden gewijzigd.
uPosition
Hiermee geeft u het menu-item waarvoor het nieuwe menu-item is moet worden ingevoegd, zoals bepaald door de parameter uFlags.
uFlags
Specificeert de vlaggen die de interpretatie van de uPosition -parameter en de inhoud, uiterlijk en gedrag van het nieuwe menu-item bepalen. Deze parameter moet een combinatie zijn van een van de volgende vereiste waarden en ten minste één van de waarden vermeld in de volgende sectie opmerkingen.
Waarde Beschrijving
MF_BYCOMMAND Geeft aan dat de parameter uPosition de id van het menu-item geeft. De vlag MF_BYCOMMAND is de standaard als de MF_BYCOMMAND noch de MF_BYPOSITION vlag is opgegeven.
MF_BYPOSITION Geeft aan dat de parameter uPosition de op nul gebaseerde relatieve positie van de nieuwe menu-item geeft. Als uPosition 0xFFFFFFFF is, is de nieuwe menu-item toegevoegd aan het einde van het menu.

uIDNewItem
Hiermee geeft u op of de id van de nieuwe menu-item of, als de parameter uFlags heeft de MF_POPUP vlag instellen, 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_MEASUREITEM of WM_DRAWITEM -bericht wordt verzonden wanneer het menu-item wordt gemaakt of de weergave wordt bijgewerkt.
MF_STRING Bevat een pointer naar een op null eindigende tekenreeks (de standaardwaarde).

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.

De volgende lijst beschrijft de vlaggen die 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 biedt vinkje bitmaps (Zie SetMenuItemBitmaps), deze vlag wordt de bitmap vinkje naast de menuopdracht weergegeven.
MF_DISABLED Het menu-item wordt uitgeschakeld, zodat het niet kan worden geselecteerd, maar het doet niet grijs.
MF_ENABLED Laat het menu-item zodat het kan worden geselecteerd en het herstelt van zijn 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 menubalken) 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 om toe te voegen een menunaam op 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 de menuopdracht (standaard). Als de toepassing levert vinkje bitmaps (Zie de functie van SetMenuItemBitmaps ), deze vlag wordt de ongecontroleerde bitmap naast het menu-item weergegeven.

De volgende groepen van vlaggen kunnen niet samen worden gebruikt:

Windows CE: Windows CE ondersteunt niet de vlag MF_BITMAP of de MF_DISABLED vlag in de parameter uFlags . Menu-items kunnen niet worden uitgeschakeld zonder wordt grijs weergegeven. Een menu-item gebruiken om te schakelen de vlag MF_GRAYED.

Windows CE versie 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-upmenu. Als met Windows CE 2.0 of hoger, kunt u.

Zie ook

Overzicht van de menu's, menufuncties, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index