Méthode DoCmd.SetMenuItem (Access)

La méthode SetMenuItem exécute l'action DéfinirElémentMenu dans Visual Basic.

Syntaxe

expression. SetMenuItem (MenuIndex, CommandIndex, SubcommandIndex, Flag)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom Requis/Facultatif Type de données Description
MenuIndex Obligatoire Variant Un entier, à partir de 0, correspondant à l’index valide d’un menu de la barre de menus personnalisée ou de la barre de menus globale de la fenêtre active, tel que défini dans la macro de la barre de menus de la barre de menus personnalisée ou de la barre de menus globale.

Si vous sélectionnez un menu avec cet argument et laissez les arguments CommandIndex et SubcommandIndex vides (ou définissez-les sur 1), vous pouvez activer ou désactiver le nom du menu lui-même. Toutefois, vous ne pouvez pas cocher ou décocher une case activée un nom de menu (Microsoft Access ignore les paramètres acMenuCheck et acMenuUncheck pour l’argument Indicateur pour les noms de menu).
CommandIndex Facultatif Variant Un entier, à compter de 0, correspondant à l’index valide d’une commande du menu sélectionné par l’argument MenuIndex , tel que défini dans le groupe de macros qui définit le menu sélectionné pour la barre de menus personnalisée ou la barre de menus globale pour la fenêtre active.
SubcommandIndex Facultatif Variant Un entier, à compter de 0, qui correspond à l’index valide d’une sous-commande du sous-menu sélectionné par l’argument CommandIndex , tel que défini dans le groupe de macros qui définit le sous-menu sélectionné pour la barre de menus personnalisée ou la barre de menus globale pour la fenêtre active.
Flag Facultatif Variant État que vous voulez attribuer à la commande ou à la sous-commande. Il peut s’agir de l’une des constantes suivantes :
  • acMenuCheck
  • acMenuGray
  • acMenuUncheck
  • acMenuUngray (valeur par défaut)

Remarques

Utilisez la méthode SetMenuItem pour définir l’état des éléments de menu (activés ou désactivés, cochés ou décochés) dans la barre de menus personnalisée ou la barre de menus globale pour la fenêtre active.

Remarque

[!REMARQUE] La méthode SetMenuItem fonctionne uniquement avec des barres de menus et barres de menus globales créées à l'aide des macros de barre de menus. La méthode SetMenuItem est incluse dans cette version d’Access uniquement pour des raisons de compatibilité avec les versions antérieures à Access 97. Elle ne fonctionne pas avec la nouvelle fonctionnalité de barres de commandes.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.