CheckMenuItem, fonction (winuser.h)

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

Définit l’état de l’attribut de coche 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

Poignée du menu d’intérêt.

[in] uIDCheckItem

Type : UINT

Élément de menu dont l’attribut de coche doit être défini, tel que 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 coche de l’élément de menu. Ce paramètre peut être une combinaison de MF_BYCOMMAND, de MF_BYPOSITION et de MF_CHECKED ou de MF_UNCHECKED.

Valeur Sens
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 l’indicateur 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 de coche à l’état sélectionné.
MF_UNCHECKED
0x00000000L
 Définit l’attribut de coche à l’état clair.

Valeur renvoyé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 UINT_MAX.

Remarques

Un élément d’une barre de menus ne peut pas avoir de coche.

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.

Exigences

Requirement Valeur
Client minimum requis 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 (include 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

conceptuelle

EnableMenuItem

GetMenuItemID

menus

Référence

SetMenuItemBitmaps

SetMenuItemInfo

  • Last updated on