MENUITEMINFO

MENUITEMINFO -strukturen inneholder informasjon om et menyelement.

typeDef struct tagMENUITEMINFO {
    UINT cbSize; 
    UINT fMask; 
    UINT fType; 
    UINT fState; 
    UINT wID; 
    HMENU hSubMenu; 
    HBITMAP hbmpChecked; 
    HBITMAP hbmpUnchecked; 
    DWORD dwItemData; 
    LPTSTR dwTypeData; 
    UINT cch; 
} MENUITEMINFO, LANGT * LPMENUITEMINFO 

 

Medlemmer

cbSize

Størrelsen på strukturen, i byte.

fMask

Medlemmer kan hente eller angi. Dette medlemmet kan være en eller flere av disse verdiene:

Verdi	Betydning
MIIM_CHECKMARKS	Henter eller angir en hbmpChecked og hbmpUnchecked -medlemmer.
MIIM_DATA	Henter eller angir medlemmet dwItemData.
MIIM_ID	Henter eller angir medlemmet wID.
MIIM_STATE	Henter eller angir medlemmet fState.
MIIM_SUBMENU	Henter eller angir medlemmet hSubMenu.
MIIM_TYPE	Henter eller angir fType og dwTypeData -medlemmer.

fType

Menyen varetype. Dette medlemmet kan være en eller flere av disse verdiene:

Verdi	Betydning
MFT_BITMAP	Viser menyelementet ved hjelp av punktgrafikk. Signifikante ordet av medlemmet dwTypeData er bitmap håndtak og cch -medlemmet ignoreres.
MFT_MENUBARBREAK	Plasserer menyelementet på en ny linje (for en menylinje) eller i en ny kolonne (for en miste-ned meny, undermeny eller hurtigmeny). For en miste-ned meny, undermeny eller hurtigmeny skiller en loddrett linje den nye kolonnen fra gamle.
MFT_MENUBREAK	Plasserer menyelementet på en ny linje (for en menylinje) eller i en ny kolonne (for en miste-ned meny, undermeny eller hurtigmeny). For en miste-ned meny, undermeny eller hurtigmeny, er kolonnene ikke atskilt med en loddrett linje.
MFT_OWNERDRAW	Tilordner ansvar for å tegne menyelementet til vinduet som eier på menyen. Vinduet mottar en WM_MEASUREITEM melding før menyen vises for første gang, og en WM_DRAWITEM -melding når utseendet til menyelementet må oppdateres. Hvis denne verdien er angitt, inneholder dwTypeData -medlem en programdefinert 32-biters verdi.
MFT_RADIOCHECK	Viser sjekket menyelementer med en radio-knapp merke i stedet for en hake hvis det hbmpChecked er NULL.
MFT_RIGHTJUSTIFY	Høyrejusterer menyelementet og påfølgende elementer. Denne verdien er bare gyldig hvis menyelementet er i en menylinje.
MFT_RIGHTORDER	Windows 95, Windows NT 5.0 og senere:Angir at menyene kaskadekonfigurasjon høyre-mot-venstre (standard er venstre mot høyre). Dette brukes til å støtte høyre-mot-venstre-språk, for eksempel arabisk og hebraisk. `
MFT_SEPARATOR	Angir at menyelementet er et skilletegn. En menyskillelinje for elementet vises som en vannrette delelinjen. DwTypeData og cch medlemmene ignoreres. Denne verdien er gyldig bare i en miste-ned meny, undermeny eller hurtigmeny.
MFT_STRING	Viser menyelementet ved hjelp av en tekststreng. Det dwTypeData er pekeren til en null-terminert streng, og det cch er lengden på strengen.

Verdiene for MFT_BITMAP, MFT_SEPARATOR og MFT_STRING kan ikke kombineres med hverandre.

fState

Menyen elementet tilstand. Dette medlemmet kan være en eller flere av disse verdiene:

Verdi	Betydning
MFS_CHECKED	Kontrollerer menyelementet. Hvis du vil ha mer informasjon om avmerkede menyelementer, kan du se hbmpChecked -medlem.
MFS_DEFAULT	Angir at menyelementet er standard. En meny kan inneholde bare én standard-menyelementet, som vises i fet skrift.
MFS_DISABLED	Deaktiverer menyelementet slik at det kan ikke velges, men ikke grå det.
MFS_ENABLED	Aktiverer menyelementet slik at det kan velges. Dette er Standardstatus.
MFS_GRAYED	Deaktiverer menyelementet og grays det slik at det ikke kan velges.
MFS_HILITE	Uthever menyelementet.
MFS_UNCHECKED	Unchecks menyelementet. Hvis du vil ha mer informasjon om ukontrollert menyelementer, kan du se hbmpUnchecked -medlem.
MFS_UNHILITE	Fjerne uthevingen fra en meny-innstilling. Dette er Standardstatus.

wID

Programdefinert 16-biters verdi som identifiserer menyelementet.

hSubMenu

Håndtere å miste-ned meny eller undermeny knyttet til menyelementet. Hvis menyelementet ikke er et element som åpner en miste-ned meny eller undermeny, er dette medlemmet NULL.

hbmpChecked

Håndtere til punktgrafikkbildet som skal vises ved siden av elementet, hvis det er merket av. Hvis dette medlemmet er NULL, brukes standard punktgrafikk. Hvis type-verdien for MFT_RADIOCHECK er angitt, er standard-punktgrafikk et punkt. Ellers er det en hake.

hbmpUnchecked

Håndtere til punktgrafikkbildet som skal vises ved siden av elementet, hvis det ikke er merket. Hvis dette medlemmet er NULL, brukes ingen punktgrafikk.

dwItemData

Programdefinert verdi tilknyttet menyelementet.

dwTypeData

Innholdet i en meny-innstilling. Denne egenskapen brukes bare hvis flagget MIIM_TYPE er angitt i fMask -medlem.

Før du kaller GetMenuItemInfo, må programmet setter dette medlemmet til å peke til en buffer med lengden som er angitt av medlemmet cch. Hvis menyelementet hentede er av typen MFT_STRING, så GetMenuItemInfo kopierer elementteksten menyen til bufferen. Hvis menyelementet hentede er av en annen type, deretter angir GetMenuItemInfo medlemmet dwTypeData til en verdi som typen som er angitt av medlemmet fType.

Når du bruker med funksjonen SetMenuItemInfo , bør dette medlemmet inneholder en verdi som typen som er angitt av medlemmet fType.

cch

Lengden på elementteksten menyen når du mottar informasjon om et menyelement av typen MFT_STRING. Denne egenskapen brukes bare hvis flagget MIIM_TYPE er angitt i fMask -medlem og null ellers. Dette medlemmet ignoreres når innholdet i et menyelement angis ved å kalle SetMenuItemInfo.

Før du kaller GetMenuItemInfo, må programmet setter dette medlemmet til lengden på bufferen som koblingen leder til dwTypeData -medlem. Hvis menyelementet hentede er av typen MFT_STRING (som angitt av medlemmet fType ), deretter angir GetMenuItemInfo cch til lengden på strengen hentede. Hvis menyelementet hentede er av en annen type, angir GetMenuItemInfo cch -feltet til null.

Merknader

MENUITEMINFO -struktur brukes med funksjonene GetMenuItemInfo, InsertMenuItemog SetMenuItemInfo.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 4.0 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Unicode:Definert som Unicode- og ANSI-strukturer.

Se også

Oversikt over menyene, menyen strukturer, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM