CMenu::EnableMenuItem

UINT EnableMenuItem ( UINT nIDEnableItem, UINT nEnable );

Valeur de retour

État antérieur (MF_DISABLED, MF_ENABLEDou MF_GRAYED) ou – 1 si non valide.

Paramètres

nIDEnableItem

Spécifie l'élément de menu est activé, tel que déterminé par nEnable. Ce paramètre peut spécifier les éléments de menu contextuel ainsi que des éléments de menu standard.

nEnable

Spécifie l'action à entreprendre. Il peut être une combinaison de MF_DISABLED, MF_ENABLEDou MF_GRAYED, avec MF_BYCOMMAND ou MF_BYPOSITION. Ces valeurs peuvent être combinées à l'aide de l'opérateur de bits OR. Ces valeurs ont les significations suivantes:

• MF_BYCOMMA&NDnbsp ;  Spécifie que le paramètre donne l'ID de commande de l'élément de menu existant. C'est la valeur par défaut.
  
  
• MF_BYPOSITIO&Nnbsp ;  Spécifie que le paramètre donne la position de l'élément de menu existant. Le premier élément est à la position 0.
  
  
• MF_DISABLED  ;  Désactive l'élément de menu afin qu'il ne peut pas être sélectionné, mais ne pas dim il.
  
  
• MF_E&NABLEDnbsp ;  Permet à l'élément de menu pour qu'il peut être sélectionné et il restaure à partir de son état est estompé.
  
  
• MF_GRAYED  ;  Désactive l'élément de menu pour qu'il ne peut pas être sélectionné et il efface.

Remarques

Active, désactive ou efface un élément de menu. Les fonctions de membre de CreateMenu, InsertMenu, ModifyMenuet LoadMenuIndirect peuvent également définir l'État (activé, désactivé ou grisé) d'un élément de menu.

À l'aide de la valeur MF_BYPOSITION exige une application d'utiliser la bonne CMenu. Si le CMenu de la barre de menu est utilisé, un élément de menu de niveau supérieur (un élément dans la barre de menu) est touché. Pour définir l'état d'un élément dans un menu contextuel pop-up ou imbriqué par position, une application doit spécifier le CMenu du menu contextuel.

Lorsqu'une application spécifie l'indicateur MF_BYCOMMAND , Windows vérifie tous les éléments de menu contextuel qui sont subordonnées à la CMenu; donc, à moins que les éléments de menu en double sont présents, à l'aide de la CMenu de la barre de menu est suffisante.

Aperçu des CMenu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CMenu::GetMenuState, :: EnableMenuItem