Partager via


CMenu::CheckMenuItem

Ajoute des coches à ou supprime des coches des éléments de menu dans le menu contextuel.

UINT CheckMenuItem(
   UINT nIDCheckItem,
   UINT nCheck 
);

Paramètres

  • nIDCheckItem
    Spécifie l'élément de menu à vérifier, tel que déterminé par nCheck.

  • nCheck
    Indique comment contrôler l'élément de menu et comment déterminer la position de l'élément dans le menu.Le paramètre d' nCheck peut être une combinaison de MF_CHECKED ou de MF_UNCHECKED avec les balises de MF_BYPOSITION ou de MF_BYCOMMAND .Ces indicateurs peuvent être combinées à l'aide de l'opérateur de bits OR.Elles ont les significations suivantes :

    • MF_BYCOMMAND spécifie que le paramètre permet l'ID de commande de l'élément de menu existant.Valeur par défaut.

    • MF_BYPOSITION spécifie que le paramètre permet la position de l'élément de menu existant.Le premier élément est à la position 0.

    • MF_CHECKED agit comme toggle avec MF_UNCHECKED pour définir la coche par défaut en regard de l'élément.

    • MF_UNCHECKED agit comme toggle avec MF_CHECKED pour supprimer une coche en regard de l'élément.

Valeur de retour

l'état précédent de l'élément : MF_CHECKED ou MF_UNCHECKED, ou 0xFFFFFFFF si l'élément de menu n'existait pas.

Notes

Le paramètre d' nIDCheckItem spécifie l'élément à modifier.

Le paramètre d' nIDCheckItem peut identifier un élément de menu contextuel ainsi qu'un élément de menu.Aucune étape particulière n'est requise pour contrôler un élément de menu contextuel.Les éléments de menu de niveau supérieur ne peuvent pas être archivés.Un élément de menu contextuel doit être contrôlé par position étant donné qu'il n'est pas un identificateur d'élément de menu associé.

Exemple

Consultez l'exemple pour CMenu::GetMenuState.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

Classe de CMenu

Graphique de la hiérarchie

CMenu::GetMenuState

CheckMenuItem

CMenu::CheckMenuRadioItem