MENUITEMINFO

La struttura MENUITEMINFO contiene informazioni su una voce di menu.

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; 
} GRAN LUNGA MENUITEMINFO, * LPMENUITEMINFO 
 

Membri

cbSize
Dimensioni della struttura, in byte.
fMask
Membri per recuperare o impostare. Questo membro pu essere una o pi di questi valori:
Valore Significato
MIIM_CHECKMARKS Recupera o imposta i membri hbmpChecked e hbmpUnchecked.
MIIM_DATA Recupera o imposta il membro dwItemData.
MIIM_ID Recupera o imposta il membro wID.
MIIM_STATE Recupera o imposta il membro fState.
MIIM_SUBMENU Recupera o imposta il membro hSubMenu.
MIIM_TYPE Recupera o imposta i membri fType e dwTypeData.

fType
Tipo di elemento di men. Questo membro pu essere una o pi di questi valori:
Valore Significato
MFT_BITMAP Viene visualizzata la voce di menu utilizzando un'immagine bitmap. La parola di ordine inferiore del membro dwTypeData l'handle di bitmap e viene ignorato il membro cch.
MFT_MENUBARBREAK Pone la voce di menu in una nuova riga (per una barra dei menu) o in una nuova colonna (per un menu a discesa, sottomenu o menu di scelta rapida). Per un menu a discesa, sottomenu o menu di scelta rapida, una linea verticale separa la nuova colonna dalla vecchia.
MFT_MENUBREAK Pone la voce di menu in una nuova riga (per una barra dei menu) o in una nuova colonna (per un menu a discesa, sottomenu o menu di scelta rapida). Per un menu a discesa, sottomenu o menu di scelta rapida, le colonne non sono separate da una linea verticale.
MFT_OWNERDRAW Assegna responsabilit per disegnare la voce di menu nella finestra che possiede il menu. La finestra riceve un messaggio WM_MEASUREITEM prima che il menu viene visualizzato per la prima volta e un messaggio WM_DRAWITEM ogni volta che l'aspetto della voce di menu deve essere aggiornato. Se viene specificato questo valore, il membro dwTypeData contiene un valore definito dall'applicazione a 32 bit.
MFT_RADIOCHECK Display controllato le voci di menu utilizzando un pulsante di opzione segnano invece di un segno di spunta se il membro hbmpChecked NULL.
MFT_RIGHTJUSTIFY Allinea a destra la voce di menu e gli eventuali elementi successivi. Questo valore valido solo se la voce di menu in una barra dei menu.
MFT_RIGHTORDER Windows 95, Windows NT 5.0 e pi tardi:Specifica che menu a cascata da destra a sinistra (il valore predefinito da sinistra a destra). Questo viene utilizzato per supportare le lingue destra-sinistra, come l'arabo e l'ebraico. `
MFT_SEPARATOR Specifica che la voce di menu un separatore. Un separatore di voce di menu viene visualizzata come una linea di divisione orizzontale. I membri dwTypeData e cch vengono ignorati. Questo valore valido solo in un menu a discesa, sottomenu o menu di scelta rapida.
MFT_STRING Viene visualizzata la voce di menu utilizzando una stringa di testo. Il membro dwTypeData il puntatore a una stringa null-terminated, e il membro cch la lunghezza della stringa.

I valori MFT_BITMAP, MFT_SEPARATOR e MFT_STRING non possono essere combinati con l'altra.

fState
Stato di elemento dal menu. Questo membro pu essere una o pi di questi valori:
Valore Significato
MFS_CHECKED Controlla la voce di menu. Per ulteriori informazioni sulle voci di menu, vedere il membro hbmpChecked.
MFS_DEFAULT Specifica che la voce di menu l'impostazione predefinita. Un menu pu contenere solo una voce di menu predefinito, che viene visualizzata in grassetto.
MFS_DISABLED Disabilita la voce di menu, in modo che esso non pu essere selezionato, ma esso non grigio.
MFS_ENABLED Attiva la voce di menu che possono essere selezionato. Questo stato di default.
MFS_GRAYED Consente di disattivare la voce di menu e grigi esso cos che esso non pu essere selezionata.
MFS_HILITE Mette in evidenza la voce di menu.
MFS_UNCHECKED Deseleziona la voce di menu. Per ulteriori informazioni sulle voci di menu non controllato, vedere il membro hbmpUnchecked.
MFS_UNHILITE Rimuove il clou dalla voce di menu. Questo stato di default.

wID
Valore di 16 bit definito dall'applicazione che identifica la voce di menu.
hSubMenu
Gestire al menu a discesa menu o sottomenu associato con la voce di menu. Se la voce di menu non un elemento che si apre un menu a discesa menu o sottomenu, questo membro NULL.
hbmpChecked
Gestire alla bitmap per visualizzare accanto all'elemento se si selezionata. Se questo membro NULL, viene utilizzata una bitmap predefinito. Se viene specificato il valore del tipo MFT_RADIOCHECK, immagine bitmap predefinita un proiettile. In caso contrario, un segno di spunta.
hbmpUnchecked
Gestire alla bitmap per visualizzare accanto all'elemento se non si verificata. Se questo membro NULL, non viene utilizzato alcun bitmap.
dwItemData
Valore definito dall'applicazione associati con la voce di menu.
dwTypeData
Contenuto della voce di menu. Questo membro viene utilizzato solo se il flag MIIM_TYPE impostato nel membro fMask.

Prima di chiamare GetMenuItemInfo, l'applicazione deve impostare questo membro per puntare a un buffer la cui lunghezza specificato dal membro cch. Se la voce di menu recuperati del tipo MFT_STRING, poi GetMenuItemInfo copia il testo dell'elemento dal menu nel buffer. Se la voce di menu recuperati di un altro tipo, quindi GetMenuItemInfo imposta il membro dwTypeData su un valore il cui tipo specificato dal membro fType.

Quando si utilizza con la funzione di SetMenuItemInfo , questo membro dovrebbe contiene un valore il cui tipo specificato dal membro fType.

cch
Lunghezza del testo dal menu elemento alla ricezione di informazioni su una voce di menu di tipo MFT_STRING. Questo membro viene utilizzato solo se il flag MIIM_TYPE impostato nel membro fMask ed uguale a zero, in caso contrario. Questo membro viene ignorato quando il contenuto di una voce di menu viene impostato chiamando SetMenuItemInfo.

Prima di chiamare GetMenuItemInfo, l'applicazione deve impostare questo membro alla lunghezza del buffer a cui puntata il membro dwTypeData . Se la voce di menu recuperati di tipo MFT_STRING (come indicato dal membro fType ), GetMenuItemInfo imposta cch alla lunghezza della stringa recuperata. Se la voce di menu recuperati di un altro tipo, GetMenuItemInfo imposta il campo cch a zero.

Osservazioni

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

Descrizione

nbsp;Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Unicode:Definito come strutture di Unicode e ANSI.

Vedi anche

Panoramica di menu, Menu strutture, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM