Condividi tramite


Funzione CheckMenuItem (winuser.h)

[CheckMenuItem è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece SetMenuItemInfo. ]

Imposta lo stato dell'attributo check-mark della voce di menu specificato su selezionato o deselezionato.

Sintassi

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

Parametri

[in] hMenu

Tipo: HMENU

Handle al menu di interesse.

[in] uIDCheckItem

Tipo: UINT

Voce di menu il cui attributo check-mark deve essere impostato, come determinato dal parametro uCheck .

[in] uCheck

Tipo: UINT

Flag che controllano l'interpretazione del parametro uIDCheckItem e lo stato dell'attributo check-mark della voce di menu. Questo parametro può essere una combinazione di MF_BYCOMMANDo MF_BYPOSITION e MF_CHECKED o MF_UNCHECKED.

Valore Significato
MF_BYCOMMAND
0x00000000L
Indica che il parametro uIDCheckItem fornisce l'identificatore della voce di menu. Il flag MF_BYCOMMAND è il valore predefinito, se non viene specificato né il flag MF_BYCOMMANDMF_BYPOSITION .
MF_BYPOSITION
0x00000400L
Indica che il parametro uIDCheckItem fornisce la posizione relativa in base zero della voce di menu.
MF_CHECKED
0x00000008L
Imposta l'attributo check-mark sullo stato selezionato.
MF_UNCHECKED
0x00000000L
Imposta l'attributo check-mark sullo stato di cancellazione.

Valore restituito

Tipo: DWORD

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 è -1.

Commenti

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 un elemento che apre un sottomenu, il parametro uIDCheckItem deve specificare la posizione dell'elemento. Per un elemento di comando, il parametro uIDCheckItem può specificare la posizione dell'elemento o il relativo identificatore.

Esempio

Per un esempio, vedere Simulare caselle di controllo in un menu.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-menu-l1-1-0 (introdotto in Windows 8)

Vedi anche

Informazioni concettuali

EnableMenuItem

GetMenuItemID

Menu

Riferimento

SetMenuItemBitmaps

SetMenuItemInfo