Partager via


SetMenuItem, action de macro

S’applique à : Access 2013, Office 2013

Vous pouvez utiliser l'action DéfinirElémentMenu pour définir l'état des éléments de menu (activé, désactivé, sélectionné ou non sélectionné) dans les menus globaux ou personnalisés de l'onglet Compléments.

Remarque

[!REMARQUE] L'action DéfinirElémentMenu fonctionne uniquement avec les menus personnalisés et globaux générés à l'aide de macros de menu. L'action DéfinirElémentMenu est incluse dans Microsoft Access à la seule fin de compatibilité avec les versions antérieures. Il ne fonctionne pas avec les fonctionnalités de la barre de commandes. Vous pouvez toutefois utiliser les propriétés Enabled et State dans un module Visual Basic pour Applications (VBA) afin de désactiver, d’activer, de sélectionner ou de désélectionner des éléments des menus contextuels ou des menus personnalisés ou globaux.

Setting

L’action DéfinirElémentMenu accepte les arguments suivants.

Argument de l’action

Description

Index de menu

Index du menu qui contient la commande dont vous voulez définir l’état. Entrez une valeur entière, à partir de 0, pour l’index du menu souhaité dans le menu personnalisé ou global. Entrez la valeur d’index dans la zone Index de menu de la section Arguments de l’action du volet Générateur de macro. L’index est relatif à la position du menu dans la macro de menu du menu personnalisé ou global (position de l’action AjouterMenu de ce menu dans la macro de menu, à partir de 0. L’affichage du menu peut être légèrement différent dans la mesure où vous pouvez utiliser des expressions conditionnelles dans la macro de menu pour masquer ou afficher des éléments de menu personnalisés. Cet argument est obligatoire. Si vous sélectionnez un menu avec cet argument et laissez les arguments Index de commande et Index de sous-commande vides, vous pouvez activer ou désactiver le nom de menu lui-même. En revanche, vous ne pouvez pas sélectionner ou désélectionner un nom de menu (Access ignore les paramètres Coché et Non coché de l’argument Indicateur pour les noms de menu).

Index de commande

Index de la commande dont vous souhaitez définir l’état. Entrez une valeur entière, à partir de 0, pour l’index de la commande souhaitée dans le menu sélectionné par l’argument Index de menu. L’index est relatif à la position de la commande dans le groupe de macros qui définit le menu sélectionné pour le menu personnalisé ou global (position de la macro de cette commande dans le groupe de macros, à partir de 0). L’affichage du menu peut être légèrement différent dans la mesure où vous pouvez utiliser des expressions conditionnelles dans le groupe de macros du menu pour masquer ou afficher les commandes de menu personnalisées.

Index de sous-commande

Index de la sous-commande dont vous souhaitez définir l’état. Cet argument n’est applicable qu’à partir du moment où la commande souhaitée possède un sous-menu. Entrez une valeur entière, à partir de 0, pour l’index de la sous-commande requise dans le sous-menu sélectionné par l’argument Index de commande. L’index est relatif à la position de la sous-commande dans le groupe de macros qui définit le sous-menu sélectionné pour le menu personnalisé ou global (position de la macro de cette sous-commande dans le groupe de macros, à partir de 0).

Indicateur

État à affecter à la commande ou à la sous-commande. Cliquez sur Grisé (pour désactiver la commande qui apparaît estompée), Non grisé (pour l’activer), Coché (pour placer une coche en regard de la commande, ce qui indique en général qu’elle a été sélectionnée) ou Non coché (pour supprimer la coche). La valeur par défaut est Non grisé.

Remarques

L'action DéfinirElémentMenu fonctionne uniquement avec un menu personnalisé ou global. Si la fenêtre active ne possède pas de menu personnalisé ou global, l'exécution d'une macro contenant l'action DéfinirElémentMenu provoque une erreur d'exécution.

Vous pouvez utiliser cette action pour définir l'état des commandes et sous-commandes de menu, mais non des sous-commandes de sous-commandes.

Pour exécuter l'action DéfinirÉlémentMenu dans un module Visual Basic pour Applications (VBA), utilisez la méthode SetMenuItem de l'objet DoCmd.