CheckMenuItem, fonction (winuser.h)

Article
08/27/2023

[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)