Funzione CheckMenuItem (winuser.h)

Articolo
08/27/2023

[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_BYCOMMAND né MF_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)