Struttura MENUITEMINFOA (winuser.h)

Contiene informazioni su una voce di menu.

Sintassi

typedef struct tagMENUITEMINFOA {
  UINT      cbSize;
  UINT      fMask;
  UINT      fType;
  UINT      fState;
  UINT      wID;
  HMENU     hSubMenu;
  HBITMAP   hbmpChecked;
  HBITMAP   hbmpUnchecked;
  ULONG_PTR dwItemData;
  LPSTR     dwTypeData;
  UINT      cch;
  HBITMAP   hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;

Membri

cbSize

Tipo: UINT

Dimensione della struttura, in byte. Il chiamante deve impostare questo membro su sizeof(MENUITEMINFO).

fMask

Tipo: UINT

Indica i membri da recuperare o impostare. Questo membro può essere uno o più dei valori seguenti.

fType

Tipo: UINT

Tipo di voce di menu. Questo membro può essere uno o più dei valori seguenti.

I valori MFT_BITMAP, MFT_SEPARATORe MFT_STRING non possono essere combinati tra loro. Impostare fMask su MIIM_TYPE per usare fType.

fType viene usato solo se fMask ha un valore MIIM_FTYPE.

fState

Tipo: UINT

Stato della voce di menu. Questo membro può essere uno o più di questi valori. Impostare fMask su MIIM_STATE per usare fState.

wID

Tipo: UINT

Valore definito dall'applicazione che identifica la voce di menu. Impostare fMask su MIIM_ID per usare wID.

hSubMenu

Tipo: HMENU

Handle del menu a discesa o del sottomenu associato alla voce di menu. Se la voce di menu non è una voce che apre un menu a discesa o un sottomenu, questo membro viene NULL. Impostare fMask su MIIM_SUBMENU per usare hSubMenu.

hbmpChecked

Tipo: HBITMAP

Handle per la bitmap da visualizzare accanto all'elemento, se selezionato. Se questo membro è NULL, viene usata una bitmap predefinita. Se viene specificato il valore del tipo MFT_RADIOCHECK, la bitmap predefinita è un punto elenco. In caso contrario, è un segno di spunta. Impostare fMask su MIIM_CHECKMARKS per usare hbmpChecked.

hbmpUnchecked

Tipo: HBITMAP

Handle per la bitmap da visualizzare accanto all'elemento, se non è selezionato. Se questo membro è NULL, non viene usata alcuna bitmap. Impostare fMask su MIIM_CHECKMARKS per usare hbmpUnchecked.

dwItemData

Tipo: ULONG_PTR

Valore definito dall'applicazione associato alla voce di menu. Impostare fMask su MIIM_DATA per usare dwItemData.

dwTypeData

Tipo: LPTSTR

Contenuto della voce di menu. Il significato di questo membro dipende dal valore di fType e viene utilizzato solo se il flag MIIM_TYPE è impostato nel membro maschera.

Per recuperare una voce di menu di tipo MFT_STRING, individuare prima le dimensioni della stringa impostando il membro dwTypeData di MENUITEMINFO su NULL e quindi chiamando GetMenuItemInfo. Il valore di cch+1 è la dimensione necessaria. Allocare quindi un buffer di questa dimensione, posizionare il puntatore al buffer in dwTypeData, incrementare cche chiamare GetMenuItemInfo di nuovo per riempire il buffer con la stringa. Se la voce di menu recuperata è di un altro tipo, GetMenuItemInfo imposta il membro dwTypeData su un valore il cui tipo è specificato dal membro fType .

Quando si usa con la funzione SetMenuItemInfo, questo membro deve contenere un valore il cui tipo è specificato dal membro fType .

dwTypeData viene usato solo se il flag di MIIM_STRING è impostato nel membro fMask

cch

Tipo: UINT

Lunghezza del testo della voce di menu, in caratteri, quando si ricevono informazioni su una voce di menu del tipo MFT_STRING. Tuttavia, cch viene usato solo se il flag MIIM_TYPE è impostato nel membro fMask e è zero in caso contrario. Inoltre, cch viene ignorato quando il contenuto di una voce di menu viene impostato chiamando SetMenuItemInfo.

Si noti che, prima di chiamare GetMenuItemInfo, l'applicazione deve impostare cch sulla lunghezza del buffer a cui punta il membro dwTypeData. Se la voce di menu recuperata è di tipo MFT_STRING (come indicato dal membro fType ), GetMenuItemInfo cambia cch alla lunghezza del testo della voce di menu. Se la voce di menu recuperata è di un altro tipo, GetMenuItemInfo imposta il campo cch su zero.

Il membro cch viene utilizzato quando il flag MIIM_STRING viene impostato nel membro fMask.

hbmpItem

Tipo: HBITMAP

Handle per la bitmap da visualizzare oppure può essere uno dei valori nella tabella seguente. Viene usato quando il flag MIIM_BITMAP viene impostato nel membro fMask.

Osservazioni

La struttura MENUITEMINFO viene utilizzata con le funzioni GetMenuItemInfo, InsertMenuIteme SetMenuItemInfo.

Il menu può visualizzare voci usando testo, bitmap o entrambi.

Fabbisogno

Vedere anche

concettuale

GetMenuItemInfo

insertMenuItem

menu

riferimento

SetMenuItemInfo

WM_DRAWITEM

WM_MEASUREITEM