IMenuCommandService.AddCommand(MenuCommand) Metodo

Definizione

Aggiunge al menu il comando di menu standard specificato.Adds the specified standard menu command to the 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)

Parametri

command
MenuCommand

Oggetto MenuCommand da aggiungere.The MenuCommand to add.

Eccezioni

L'oggetto CommandID dell'oggetto MenuCommand specificato è già presente in un menu.The CommandID of the specified MenuCommand is already present on a menu.

Commenti

Le MenuCommands enumerazioni e StandardCommands contengono CommandID gli identificatori per i comandi standard predefiniti e i comandi di menu che sono già associati a un percorso in un menu specifico.The MenuCommands and StandardCommands enumerations contain CommandID identifiers for predefined standard commands and menu commands that are already associated with a location on a particular menu.

Nota

Un tentativo di aggiungere un comando di menu con un oggetto CommandID già esistente genererà un' InvalidOperationExceptionoperazione.An attempt to add a menu command with an already existing CommandID will throw an InvalidOperationException. Quando si aggiunge un comando di menu, verificare che non sia già presente in un menu che utilizza il FindCommand metodo oppure utilizzare la gestione delle eccezioni in modo oculato.When adding a menu command, be sure to check that it is not already on a menu using the FindCommand method, or use exception handling wisely.

È possibile associare un gestore eventi a un comando di menu predefinito con la seguente procedura:You can attach an event handler to a predefined menu command with the following procedure:

  1. Se il comando di menu da collegare a un gestore eventi è stato aggiunto a un menu oppure si trova con il FindCommand metodo, valutare se si desidera ripristinare questo comando di menu in un secondo momento e se si desidera richiamare il gestore eventi corrente dal nuovo gestore eventi.If the menu command to link with an event handler has been added to a menu, or is located with the FindCommand method, consider whether you wish to restore this menu command later, and whether you want to invoke the current event handler from your new event handler. Se il codice potrebbe ripristinare il comando di menu o concatenare la chiamata di gestori eventi, assicurarsi di archiviare un riferimento al comando di menu in un punto qualsiasi.If your code might restore the menu command or chain the invocation of event handlers, be sure to store a reference to the menu command somewhere.

  2. Assicurarsi che qualsiasi comando di menu precedentemente esistente con lo CommandID stesso sia stato rimosso dal menu usando il RemoveCommand metodo.Ensure that any previously existing menu command with the same CommandID has been removed from the menu using the RemoveCommand method.

  3. Creare un nuovo MenuCommand oggetto e specificare il gestore eventi nel costruttore, insieme a un CommandID oggetto che rappresenta il comando da aggiungere.Create a new MenuCommand and specify your event handler in the constructor, along with a CommandID representing the command to add. Ogni comando di menu standard è associato a una posizione di menu predefinita a cui viene aggiunto.Each standard menu command is associated with a predefined menu location where it is added to. Gli ID di comando supportati sono definiti nelle StandardCommands enumerazioni e MenuCommands .The supported command IDs are defined in the StandardCommands and MenuCommands enumerations.

  4. Se si desidera richiamare qualsiasi gestore eventi preesistente per il comando di menu, chiamare Invoke il metodo del comando di menu sostituito dal gestore eventi che gestisce l'evento Invoke del comando di menu.If you want to invoke any preexisting event handler for the menu command, call the Invoke method of the menu command you have replaced on the menu from the event handler that handles the invoke event of your menu command.

  5. Se si è interessati a ripristinare il gestore eventi di un comando di menu preesistente che è stato sostituito, aggiungere il comando di menu archiviato e preesistente dopo aver rimosso il comando di menu sostitutivo creato.If you are interested in restoring the event handler of a preexisting menu command that you have replaced, add the stored, preexisting menu command after you remove the replacement menu command you created. Potrebbe essere necessario aggiungere questo comportamento al Dispose metodo per il tipo.You may want to add this behavior to the Dispose method for your type.

Si applica a

Vedi anche