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