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