MENUITEMINFO

Structura MENUITEMINFO conţine informaţii despre un element de meniu.

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, ÎN PREZENT * LPMENUITEMINFO 

 

Membrii

cbSize

Dimensiunea structurii, în octeţi.

fMask

Membrii pentru a prelua sau set. Acest membru poate fi una sau mai multe din aceste valori:

Valoarea	Sensul
MIIM_CHECKMARKS	Preia sau seturi de membrii hbmpChecked şi hbmpUnchecked.
MIIM_DATA	Preia sau seturi de membru dwItemData.
MIIM_ID	Preia sau seturi de membru wID.
MIIM_STATE	Preia sau seturi de membru fState.
MIIM_SUBMENU	Preia sau seturi de membru hSubMenu.
MIIM_TYPE	Preia sau seturi de membrii fType şi dwTypeData.

fType

Tipul de element de meniu. Acest membru poate fi una sau mai multe din aceste valori:

Valoarea	Sensul
MFT_BITMAP	Afişează elementul de meniu folosind un bitmap. Cuvântul low-ordinea de membru dwTypeData este ghidajul bitmap, şi membru cch este ignorat.
MFT_MENUBARBREAK	Plasează elementul de meniu de pe o linie nouă (pentru o bară de meniu) sau într-o coloană nou (pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide). Pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide, o linie verticală care separă coloana nou de vechi.
MFT_MENUBREAK	Plasează elementul de meniu de pe o linie nouă (pentru o bară de meniu) sau într-o coloană nou (pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide). Pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide, coloanele nu sunt separate de o linie verticală.
MFT_OWNERDRAW	Atribuie responsabilitatea pentru elementul de meniu de desen la fereastra care deţine meniul. Fereastra primeşte un mesaj de WM_MEASUREITEM înainte de meniul este afişat pentru prima dată, şi un mesaj WM_DRAWITEM , ori de câte ori aspectul elementul de meniu trebuie să fie actualizate. Dacă această valoare este specificat, membru dwTypeData conţine o valoare de 32-bit definite de aplicare.
MFT_RADIOCHECK	Afişează verifică elementele de meniu folosind un radio-buton marca în loc de un marcaj de selectare dacă hbmpChecked este NULL.
MFT_RIGHTJUSTIFY	Aliniază la dreapta pe elementul de meniu şi orice elemente ulterioare. Această valoare este valabilă numai dacă elementul de meniu este o bară de meniu.
MFT_RIGHTORDER	Windows 95, Windows NT 5.0, şi mai târziu:Specifică că meniuri cascadă la stânga la dreapta (implicit este stânga-la-dreapta). Acest lucru este folosit pentru a sprijini limbi-la-dreapta-la-stânga, precum arabă şi ebraică. `
MFT_SEPARATOR	Precizează că elementul de meniu este un separator. Un separator de element de meniu apare ca o linie despărţitoare orizontală. Membrii dwTypeData şi cch sunt ignorate. Această valoare este validă numai într-un drop-jos meniu, submeniu, sau meniul de comenzi rapide.
MFT_STRING	Afişează elementul de meniu utilizând un şir de text. DwTypeData este indicatorul la un şir null-terminated şi cch este lungimea şirului.

Valorile MFT_BITMAP, MFT_SEPARATOR, şi MFT_STRING nu pot fi combinate cu unul pe altul.

fState

Meniul element de stat. Acest membru poate fi una sau mai multe din aceste valori:

Valoarea	Sensul
MFS_CHECKED	Verifică elementul de meniu. Pentru mai multe informaţii despre elementele de meniu verificate, vede?i membru hbmpChecked.
MFS_DEFAULT	Precizează că elementul de meniu este implicit. Un meniu poate conţine numai un element de meniu implicite, care se afişează în aldin.
MFS_DISABLED	Dezactivează elementul de meniu, astfel încât aceasta nu poate fi selectată, dar nu gri a.
MFS_ENABLED	Permite elementul de meniu, astfel încât poate fi selectat. Aceasta este starea implicită.
MFS_GRAYED	Dezactivează elementul de meniu şi Crawley Town este astfel încât poate fi selectat.
MFS_HILITE	Subliniază elementul de meniu.
MFS_UNCHECKED	Unchecks elementul de meniu. Pentru mai multe informaţii despre elementele de meniu neînregistrat, vezi membre hbmpUnchecked.
MFS_UNHILITE	Elimină evidenţia la elementul de meniu. Aceasta este starea implicită.

wID

Cerere-16-bit valoare definită care identifică elementul de meniu.

hSubMenu

Ocupa de la drop-jos meniu sau submeniu asociate cu elementul de meniu. Dacă elementul de meniu nu este un articol care deschide un drop-jos meniu sau submeniu, acest membru este NULL.

hbmpChecked

Ocupa în bitmap pentru a afişa lângă elementul dacă acesta este verificat. Dacă acest membru este nul, este utilizat un bitmap implicit. Dacă este specificată valoarea de tip MFT_RADIOCHECK, bitmap-ul implicit este un glonţ. În caz contrar, acesta este un marcaj.

hbmpUnchecked

Ocupa în bitmap pentru a afişa lângă elementul dacă nu este bifată. Dacă acest membru este NULL, nici un bitmap este folosit.

dwItemData

Definite de aplicarea valorii asociate cu elementul de meniu.

dwTypeData

Conţinutul elementului de meniu. Acest membru este utilizat numai în cazul în care pavilion MIIM_TYPE este setat membru fMask.

Înainte de apel GetMenuItemInfo, cererea trebuie să setaţi acest membru pentru a indica spre un tampon a căror lungime este specificat de membru cch. Dacă elementul de meniu accesat este de tip MFT_STRING, atunci GetMenuItemInfo copiază textul de element de meniu în zona-tampon. Dacă elementul de meniu accesat este un alt tip, apoi GetMenuItemInfo setează membru dwTypeData o valoare al căror tip este specificat de membru fType.

Atunci când se utilizează cu funcţia de SetMenuItemInfo , acest membru ar conţine o valoare al căror tip este specificat de membru fType.

cch

Lungimea textului de element de meniu când este primit informaţii despre un element de meniu de tip MFT_STRING. Acest membru este utilizat numai în cazul în care pavilion MIIM_TYPE este stabilit în membre fMask şi este zero. Acest membru este ignorată atunci când conţinutul de un element de meniu este stabilită de asteptare SetMenuItemInfo.

Înainte de asteptare GetMenuItemInfo, cererea trebuie să setaţi acest membru la lungimea tamponului a subliniat de către dwTypeData . Dacă elementul de meniu accesat este de tip MFT_STRING (a?a cum indică membre fType ), apoi GetMenuItemInfo setează cch lungimea şirului regăsite. Dacă elementul de meniu accesat este un alt tip, GetMenuItemInfo setează câmpul cch la zero.

Observaţii

Structura MENUITEMINFO este folosit cu funcţiile GetMenuItemInfo, InsertMenuItemşi SetMenuItemInfo.

QuickInfo

nbsp; Windows &NT: necesită versiunea 4.0 sau ulterioară.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Unicode:Definit ca structurile Unicode şi ANSI.

A se vedea, de asemenea

Meniurile privire de ansamblu, meniul structuri, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM