Partager via


CheckMenuItem, fonction (winuser.h)

[CheckMenuItem peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt SetMenuItemInfo. ]

Définit l’état de l’attribut de marque case activée de l’élément de menu spécifié sur sélectionné ou désactivé.

Syntaxe

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

Paramètres

[in] hMenu

Type : HMENU

Handle pour le menu d’intérêt.

[in] uIDCheckItem

Type : UINT

Élément de menu dont l’attribut case activée-mark doit être défini, comme déterminé par le paramètre uCheck.

[in] uCheck

Type : UINT

Indicateurs qui contrôlent l’interprétation du paramètre uIDCheckItem et l’état de l’attribut de marque case activée de l’élément de menu. Ce paramètre peut être une combinaison de MF_BYCOMMAND, MF_BYPOSITION et MF_CHECKED ou MF_UNCHECKED.

Valeur Signification
MF_BYCOMMAND
0x00000000L
Indique que le paramètre uIDCheckItem donne l’identificateur de l’élément de menu. L’indicateur MF_BYCOMMAND est la valeur par défaut si ni l’indicateur MF_BYCOMMAND ni MF_BYPOSITION n’est spécifié.
MF_BYPOSITION
0x00000400L
Indique que le paramètre uIDCheckItem donne la position relative de base zéro de l’élément de menu.
MF_CHECKED
0x00000008L
Définit l’attribut case activée-mark à l’état sélectionné.
MF_UNCHECKED
0x00000000L
Définit l’attribut case activée-mark à l’état clear.

Valeur retournée

Type : DWORD

La valeur de retour spécifie l’état précédent de l’élément de menu ( MF_CHECKED ou MF_UNCHECKED). Si l’élément de menu n’existe pas, la valeur de retour est –1.

Remarques

Un élément d’une barre de menus ne peut pas avoir de marque case activée.

Le paramètre uIDCheckItem identifie un élément qui ouvre un sous-menu ou un élément de commande. Pour un élément qui ouvre un sous-menu, le paramètre uIDCheckItem doit spécifier la position de l’élément. Pour un élément de commande, le paramètre uIDCheckItem peut spécifier la position de l’élément ou son identificateur.

Exemples

Pour obtenir un exemple, consultez Simulation de cases à cocher dans un menu.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-menu-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

EnableMenuItem

GetMenuItemID

Menus

Référence

SetMenuItemBitmaps

SetMenuItemInfo