MENUITEMINFO

Struktura MENUITEMINFO zawiera informacje o pozycji menu.

element 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, ZNACZNIE * LPMENUITEMINFO 

 

Członkowie

cbSize
Rozmiar struktury, w bajtach.
fMask
Członkom pobrać lub ustawić. Ten element może być jeden lub więcej z tych wartości:
Wartość Znaczenie
MIIM_CHECKMARKS Pobiera lub ustawia członków hbmpChecked i hbmpUnchecked.
MIIM_DATA Pobiera lub ustawia Państwa dwItemData.
MIIM_ID Pobiera lub ustawia Członkowskie wID.
MIIM_STATE Pobiera lub ustawia Państwa fState.
MIIM_SUBMENU Pobiera lub ustawia Państwa hSubMenu.
MIIM_TYPE Pobiera lub ustawia członków fType i dwTypeData.

fType
Typ elementu menu. Ten element może być jeden lub więcej z tych wartości:
Wartość Znaczenie
MFT_BITMAP Wyświetla element menu za pomocą mapy bitowej. Słowo znaczący element dwTypeData jest dojściem bitmapy, a Członkowskie cch jest ignorowany.
MFT_MENUBARBREAK Umieszcza element menu w nowym wierszu (na pasku menu) lub w nowej kolumnie (w menu rozwijanym, podmenu lub menu skrótów). W menu rozwijanym, podmenu lub menu skrótów linię pionową oddziela nową kolumnę ze starego.
MFT_MENUBREAK Umieszcza element menu w nowym wierszu (na pasku menu) lub w nowej kolumnie (w menu rozwijanym, podmenu lub menu skrótów). W menu rozwijanym, podmenu lub menu skrótów kolumny nie zostaną rozdzielone linią pionową.
MFT_OWNERDRAW Przypisuje odpowiedzialność za zwrócenie element menu Okno, w którym posiada menu. Okno odbiera wiadomość WM_MEASUREITEM przed menu jest wyświetlane po raz pierwszy, a wiadomość WM_DRAWITEM zawsze wygląd elementu menu musi być uaktualniany. Jeśli ta wartość jest określona, członek dwTypeData zawiera zdefiniowane przez aplikację 32-bitowa wartość.
MFT_RADIOCHECK Wyświetla skontrolowanych elementy menu za pomocą przycisk radiowy znak zamiast znacznik wyboru, jeśli element hbmpChecked ma wartość NULL.
MFT_RIGHTJUSTIFY Uzasadnia prawo elementu menu i wszelkie kolejne elementy. Wartość ta jest prawidłowa tylko wtedy, gdy element menu jest w pasku menu.
MFT_RIGHTORDER Systemu Windows 95, Windows NT 5.0 i nowsze:Określa, że menu kaskadowe prawej do lewej (domyślnie jest od lewej do prawej). To jest używany do obsługi języków prawej do lewej, takich jak arabski i hebrajski. `
MFT_SEPARATOR Określa, że element menu separator. Separator elementu menu pojawia się jako poziomą linię podziału. Członkowie dwTypeData i cch są ignorowane. Wartość ta jest prawidłowa tylko w rozwijanym menu, podmenu lub menu skrótów.
MFT_STRING Wyświetla elementu menu, przy użyciu ciągu tekstowego. Element dwTypeData jest wskaźnik na ciąg zakończony wartością zerową i członek cch jest długość ciągu.

Wartości MFT_BITMAP, MFT_SEPARATOR i MFT_STRING nie mogą być połączone ze sobą.

fState
Menu elementu członkowskiego. Ten element może być jeden lub więcej z tych wartości:
Wartość Znaczenie
MFS_CHECKED Sprawdza elementu menu. Aby uzyskać więcej informacji na temat elementy zaznaczone menu zobacz Państwa hbmpChecked.
MFS_DEFAULT Określa, że element menu jest domyślnie. Menu może zawierać tylko jeden element menu domyślny, który jest wyświetlany czcionką pogrubioną.
MFS_DISABLED Wyłącza elementu menu, aby nie może być wybrany, ale nie szary.
MFS_ENABLED Umożliwia elementu menu, tak aby można było wybierać. Jest to domyślny stan.
MFS_GRAYED Wyłącza elementu menu i grays, tak aby nie można było wybierać.
MFS_HILITE Podświetla elementu menu.
MFS_UNCHECKED Usuwa zaznaczenie elementu menu. Aby uzyskać więcej informacji na temat elementów menu niezaznaczone zobacz element hbmpUnchecked.
MFS_UNHILITE Usuwa wyróżnienie z elementu menu. Jest to domyślny stan.

wID
Zdefiniowane przez aplikację 16-bitową wartość, która identyfikuje element menu.
hSubMenu
Dojście do okna rozwijanego menu lub podmenu skojarzony element menu. Jeśli element menu nie jest element, który otwiera menu rozwijane lub podmenu, członek ten ma wartość NULL.
hbmpChecked
Dojście do mapy bitowej do wyświetlania obok elementu, jeśli jest zaznaczone. Jeśli ten element ma wartość NULL, używana jest domyślna mapa bitowa. Jeżeli określono wartość typu MFT_RADIOCHECK, domyślną mapę bitową się punktor. W przeciwnym wypadku jest znacznik wyboru.
hbmpUnchecked
Dojście do mapy bitowej do wyświetlania obok elementu, jeśli nie jest zaznaczone. Jeśli ten element ma wartość NULL, nie bitmapy jest używany.
dwItemData
Wartość zdefiniowanych przez aplikację skojarzoną z elementu menu.
dwTypeData
Zawartość elementu menu. Ten element jest używane tylko wtedy, gdy element fMask jest ustawiona flaga MIIM_TYPE.

Przed wywołaniem metody GetMenuItemInfo, aplikacja musi ustawić tego członka do buforu, których długość jest określony przez członka cch. Jeśli element menu pobierane jest typu MFT_STRING, a następnie GetMenuItemInfo kopiuje tekst elementu menu do buforu. Jeśli element menu pobrane z innych typów, następnie GetMenuItemInfo ustawia Państwa dwTypeData na wartości, której typem jest określony przez członka fType.

Podczas korzystania z funkcji SetMenuItemInfo , członek ten powinien zawiera wartości, której typem jest określony przez członka fType.

cch
Długość tekstu elementu menu, po otrzymaniu informacji o pozycji menu typu MFT_STRING. Ten element jest używane tylko wtedy, gdy flaga MIIM_TYPE jest ustawiona w elemencie fMask i inaczej wynosi zero. Członek ten jest ignorowany, gdy zawartość elementu menu jest ustawiony przez wywołanie SetMenuItemInfo.

Przed wywołaniem metody GetMenuItemInfo, aplikacja musi ustawić tego członka do długości buforu wskazywanego przez członka dwTypeData . Jeśli element menu pobierane jest typu MFT_STRING (wskazywane przez członka fType ), następnie GetMenuItemInfo ustawia cch długość ciągu pobrane. Jeśli element menu pobrane z innych typów, GetMenuItemInfo ustawia w polu cch zero.

Uwagi

Struktura MENUITEMINFO jest używana w funkcji GetMenuItemInfo, InsertMenuItemi SetMenuItemInfo.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Unicode:Zdefiniowane jako struktur Unicode i ANSI.

Zobacz też

Omówienie menu, Menu struktur, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM