Partager via


IMenuCommandService.AddCommand(MenuCommand) Méthode

Définition

Ajoute la commande de menu standard spécifiée au menu.

public:
 void AddCommand(System::ComponentModel::Design::MenuCommand ^ command);
public void AddCommand (System.ComponentModel.Design.MenuCommand command);
abstract member AddCommand : System.ComponentModel.Design.MenuCommand -> unit
Public Sub AddCommand (command As MenuCommand)

Paramètres

command
MenuCommand

MenuCommand à ajouter.

Exceptions

Le CommandID du MenuCommand spécifié figure déjà dans un menu.

Remarques

Les MenuCommands énumérations et StandardCommands contiennent CommandID des identificateurs pour les commandes de menu et les commandes de menu standard prédéfinies qui sont déjà associées à un emplacement dans un menu particulier.

Notes

Une tentative d’ajout d’une commande de menu avec un existant CommandID lève un InvalidOperationException. Lorsque vous ajoutez une commande de menu, veillez à case activée qu’elle ne figure pas déjà dans un menu à l’aide de la méthode , ou utilisez judicieusement la FindCommand gestion des exceptions.

Vous pouvez attacher un gestionnaire d’événements à une commande de menu prédéfinie à l’aide de la procédure suivante :

  1. Si la commande de menu à lier à un gestionnaire d’événements a été ajoutée à un menu ou se trouve avec la FindCommand méthode , déterminez si vous souhaitez restaurer cette commande de menu ultérieurement et si vous souhaitez appeler le gestionnaire d’événements actuel à partir de votre nouveau gestionnaire d’événements. Si votre code peut restaurer la commande de menu ou chaîner l’appel de gestionnaires d’événements, veillez à stocker une référence à la commande de menu quelque part.

  2. Vérifiez que toute commande de menu existante avec la même CommandID a été supprimée du menu à l’aide de la RemoveCommand méthode .

  3. Créez un nouveau MenuCommand et spécifiez votre gestionnaire d’événements dans le constructeur, ainsi qu’un CommandID représentant la commande à ajouter. Chaque commande de menu standard est associée à un emplacement de menu prédéfini auquel elle est ajoutée. Les ID de commande pris en charge sont définis dans les StandardCommands énumérations et MenuCommands .

  4. Si vous souhaitez appeler un gestionnaire d’événements préexistant pour la commande de menu, appelez la Invoke méthode de la commande de menu que vous avez remplacée dans le menu à partir du gestionnaire d’événements qui gère l’événement invoke de votre commande de menu.

  5. Si vous souhaitez restaurer le gestionnaire d’événements d’une commande de menu préexistante que vous avez remplacée, ajoutez la commande de menu stockée préexistante après avoir supprimé la commande de menu de remplacement que vous avez créée. Vous pouvez ajouter ce comportement à la Dispose méthode pour votre type.

S’applique à

Voir aussi