IMenuCommandService.AddCommand(MenuCommand) Méthode

Définition

Espace de noms:
System.ComponentModel.Design
Assembly:
System.dll
Assembly:
netstandard.dll

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

InvalidOperationException

L’élément CommandID spécifié MenuCommand est déjà présent dans un menu.

Remarques

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

Note

Une tentative d’ajout d’une commande de menu avec un élément déjà existant CommandID lève un InvalidOperationException. Lorsque vous ajoutez une commande de menu, veillez à vérifier qu’elle n’est pas déjà dans un menu à l’aide de la FindCommand méthode ou utilisez la gestion des exceptions de manière judicieuse.

Vous pouvez attacher un gestionnaire d’événements à une commande de menu prédéfinie avec 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 des 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 commande a été supprimée du menu à l’aide de la RemoveCommand méthode.

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

  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 d’appel 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 et 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 de votre type.

S’applique à

Voir aussi