InsertMenu

Funksjonen InsertMenu setter inn et nytt menyelement på en meny, flytte andre elementer-menyen.

Funksjonen InsertMenu har blitt erstattet av funksjonen InsertMenuItem . Du kan fortsatt bruke InsertMenu, men hvis du ikke trenger noen av det utbygget vise egenskaper av InsertMenuItem.

BOOL InsertMenu) HMENU  hMenu, / / håndtere-menyenUINTuPosition, / / menyen vare at ny meny kommer foran elementetUINTuFlags, / / menyelementet flagsUINTuIDNewItem, / / menyen element identifikator eller håndtere å miste-ned / / meny eller undermenyLPCTSTRlpNewItem / / menyen vare innhold);
 

Parametere

hMenu
Håndtere til menyen endres.
uPosition
Angir menyelement før som det nye menyobjektet er som skal settes inn, i hennhold til parameteren uFlags.
uFlags
Angir flaggene som kontrollerer tolkningen av parameteren uPosition og innhold, utseendet og virkemåten til det nye menyelementet. Denne parameteren må være en kombinasjon av en av følgende nødvendige verdier og minst én av verdiene som er oppført i delen for følgende merknader.
Verdi Beskrivelse
MF_BYCOMMAND Angir at uPosition -parameteren gir identifikator for menyelementet. MF_BYCOMMAND-flagget er standard hvis verken MF_BYCOMMAND eller MF_BYPOSITION-flagget er angitt.
MF_BYPOSITION Angir at parameteren uPosition gir den nullbasert relative plasseringen av det nye menyobjektet. Hvis uPosition er 0xFFFFFFFF, er det nye menyobjektet lagt til på slutten av menyen.

uIDNewItem
Angir identifikatoren til det nye menyelementet, eller hvis parameteren uFlags har MF_POPUP-flagg satt, håndtaket for å miste-ned meny eller undermeny.
lpNewItem
Angir innholdet i det nye menyobjektet. Tolkningen av lpNewItem , avhenger av om parameteren uFlags inkluderer MF_BITMAP, MF_OWNERDRAW eller MF_STRING-flagget som følger:
Verdi Beskrivelse
MF_BITMAP Inneholder en bitmap håndtak.
MF_OWNERDRAW Inneholder en 32-biters verdien som angis av programmet som kan brukes til å vedlikeholde tilleggsdata som er relatert til menyelementet. Verdien er i itemData -medlem av strukturen som vises til i lparam -parameteren for WM_MEASUREITEM eller WM_DRAWITEM -melding sendes når menyelementet opprettes eller oppdateres utseendet.
MF_STRING Inneholder en peker til en null-terminert streng (standard).

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

Hvis funksjonen mislykkes, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Programmet må kalle funksjonen DrawMenuBar hver gang endringer på en meny, og om menyen er i vindumodus viste.

Listen nedenfor beskriver flaggene som kan angis i parameteren uFlags:

Verdi Beskrivelse
MF_BITMAP Bruker et punktgrafikkbilde som menyelementet. LpNewItem -parameteren inneholder håndtaket til bitmap.
MF_CHECKED Hvis du setter en hake ved siden av menyelementet. Hvis applikasjonen også hake punktgrafikk (se SetMenuItemBitmaps), viser dette flagget punktgrafikken hake ved siden av menyelementet.
MF_DISABLED Deaktiverer menyelementet slik at det kan ikke velges, men ikke grå det.
MF_ENABLED Aktiverer menyelementet slik at det kan velges, og gjenoppretter det fra den grå tilstanden.
MF_GRAYED Deaktiverer menyelementet og grays det slik at det ikke kan velges.
MF_MENUBARBREAK Funksjoner den samme som MF_MENUBREAK flagg for en menylinje. For en miste-ned meny, undermeny eller hurtigmeny, er den nye kolonnen atskilt fra kolonnen gammelt med en loddrett linje.
MF_MENUBREAK Plasserer elementet på en ny linje (for menylinjer) eller i en ny kolonne (for en miste-ned meny, undermeny eller hurtigmeny) uten å skille kolonner.
MF_OWNERDRAW Angir at elementet er en vare som eier-tegnet. Før-menyen vises for første gang, vinduet som eier på menyen, mottar du en WM_MEASUREITEM -melding til å hente bredden og høyden på menyelementet. WM_DRAWITEM meldingen sendes deretter i vinduet prosedyren i eier-vinduet hver gang utseendet til menyelementet må oppdateres.
MF_POPUP Angir at menyelementet, åpnes en miste-ned meny eller undermeny. UIDNewItem -parameteren angir du håndtaket for å miste-ned meny eller undermeny. Dette flagget brukes til å legge til et menynavn på en menylinje eller en meny artikkel det åpnes en undermeny til en miste-ned meny, undermeny eller hurtigmeny.
MF_SEPARATOR Tegner en vannrette delelinjen. Dette flagget brukes bare i en miste-ned meny, undermeny eller hurtigmeny. Linjen kan ikke være grå, deaktivert eller uthevet. Parameterne lpNewItem og uIDNewItem ignoreres.
MF_STRING Angir at menyelementet er en tekststreng, parameteren lpNewItem peker til strengen.
MF_UNCHECKED Ikke Plasser en hake ved siden av menyelementet (standard). Hvis programmet leverer hake punktgrafikk (se funksjonen SetMenuItemBitmaps ), viser dette flagget ukontrollert punktgrafikk ved siden av menyelementet.

Følgende rapportgrupper notatflagg kan ikke brukes sammen:

Windows CE: Windows CE støtter ikke MF_BITMAP-flagg eller MF_DISABLED flagg i uFlags -parameteren. Menyelementer kan ikke deaktiveres uten å være grå. Hvis du vil deaktivere et menyelement bruker flagget MF_GRAYED.

Windows CE versjon 1.0 støtter ikke gjennomgripende menyer. Hvis du bruker Windows CE 1.0, kan du ikke sette en MF_POPUP meny til en annen-lokalmenyen. Hvis du bruker Windows CE 2.0 eller senere, kan du.

Se også

Oversikt over menyene, Menyfunksjoner, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index