Funzione CheckMenuItem (winuser.h)

[CheckMenuItem è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. Usare invece SetMenuItemInfo. ]

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

Sintassi

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

Parameters

[in] hMenu

Tipo: HMENU

Handle per il 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_BYCOMMAND o MF_BYPOSITION e MF_CHECKED o MF_UNCHECKED.

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

Osservazioni:

Una voce 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.

Esempi

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

Requisiti

Vedere anche

Concettuale

EnableMenuItem

GetMenuItemID

Menu

Riferimento

SetMenuItemBitmaps

SetMenuItemInfo