AppendMenu

AppendMenu -funksjonen føyer til et nytt element på slutten av den angitte menylinjen, miste-ned meny, undermeny eller hurtigmenyen. Du kan bruke denne funksjonen til å angi innhold, utseendet og virkemåten til menyelementet.

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

 BOOL AppendMenu) HMENU  hMenu, / / håndtere til menyen endresUINTuFlags, / / flags menyelementUINTuIDNewItem, / / menyelementet identifikator eller å miste-ned meny eller undermenyLPCTSTRlpNewItem / / innhold menyelementet);

Parametere

hMenu

Håndtere til menylinjen, miste-ned meny, undermeny eller hurtigmenyen endres.

uFlags

Angir flagg for å bestemme utseendet på og virkemåten til det nye menyelementet. Denne parameteren kan være en kombinasjon av verdier som er oppført i delen for følgende merknader.

uIDNewItem

Angir identifikatoren til det nye menyelementet eller, hvis uFlags -parameteren er satt til MF_POPUP, 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_MEASURE eller WM_DRAWITEM-melding sendes når menyen opprettes eller oppdateres utseendet.
MF_STRING	Inneholder en peker til en null-terminert streng.

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.

For å få tastatur gasspedalene å arbeide med punktgrafikk eller eieren trukket menyelementer, må eieren av menyen behandle meldingen WM_MENUCHAR. Hvis du vil ha mer informasjon, se Owner-Drawn menyer og WM_MENUCHAR meldingen.

De følgende flaggene 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, dette flagget viser haken punktgrafikk ved siden av menyelementet.
MF_DISABLED	Deaktiverer menyelementet slik at det kan ikke velges, men flagget gray ikke det.
MF_ENABLED	Gjør det mulig for menyelementet slik at den 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 en menylinje) 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 et menyelement som å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 elementet (standard). Hvis programmet leverer hake punktgrafikk (se SetMenuItemBitmaps), viser dette flagget ukontrollert punktgrafikk ved siden av menyelementet.

Følgende rapportgrupper notatflagg kan ikke brukes sammen:

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

Windows CE: Følgende flagg støttes ikke for fuFlags -parameteren

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED kan brukes i stedet for MF_DISABLED og MFS_GRAYED.

Windows CE 1.0 støtter ikke gjennomgripende menyer. Hvis du bruker Windows CE 1.0, du kan ikke sette inn en MF_POPUP-menyen i en annen lokalmenyen.

I Windows CE 1.0 støttes ikke følgende flagg:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Disse flaggene støttes i Windows CE versjon 2.0 og senere. Undermenyer støttes også.

Se også

Oversikt over menyene, Menyfunksjoner, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index