CheckMenuItem

La funzione CheckMenuItem imposta lo stato dell'attributo segno di spunta dell'elemento menu specificata per sia selezionata o deselezionata.

La funzione CheckMenuItem è stata sostituita dalla funzione SetMenuItemInfo . È comunque possibile utilizzare CheckMenuItem, tuttavia, se non è necessario le funzionalità estese di SetMenuItemInfo.

(DWORD CheckMenuItem HMENU  hmenu, / / handle al menuUINTuIDCheckItem, / / la voce del menu per selezionare o deselezionareUINTuCheck / / voce di menu flags);
 

Parametri

hmenu
Gestire il menu di interesse.
uIDCheckItem
Specifica la voce di menu cui spunta attributo deve essere impostato, come determinato dal parametro uCheck.
uCheck
Specifica i flag che controllano l'interpretazione del parametro uIDCheckItem e lo stato dell'attributo spunta della voce di menu. Questo parametro può essere una combinazione di MF_BYCOMMAND, o MF_BYPOSITION e MF_CHECKED o MF_UNCHECKED.
Valore Significato
MF_BYCOMMAND Indica che il parametro uIDCheckItem dà l'identificatore della voce di menu. La bandiera MF_BYCOMMAND è l'impostazione predefinita, se viene specificato il flag MF_BYCOMMAND né MF_BYPOSITION.
MF_BYPOSITION Indica che il parametro uIDCheckItem dà la posizione relativa in base zero della voce di menu.
MF_CHECKED Imposta l'attributo di segno di spunta sullo stato selezionato.
MF_UNCHECKED Imposta l'attributo spunta allo stato non selezionato.

Valori restituiti

Il valore restituito specifica lo stato precedente della voce di menu (MF_CHECKED o MF_UNCHECKED). Se la voce di menu non esiste, il valore restituito è 0xFFFFFFFF.

Osservazioni

Un elemento in una barra dei menu non può avere un segno di spunta.

Il parametro uIDCheckItem identifica un elemento che apre un sottomenu o un elemento di comando. Per una voce che apre un sottomenu, il parametro uIDCheckItem deve specificare la posizione dell'elemento. Per un elemento di comando, il parametro uIDCheckItem possibile specificare la posizione dell'elemento o relativo identificatore.

Vedi anche

Panoramica di menu, Menu funzioni, EnableMenuItem, GetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index