IMenuCommandService.AddCommand(MenuCommand) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.ComponentModel.Design
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Aggiunge al menu il comando di menu standard specificato.

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.

Eccezioni

InvalidOperationException

L'oggetto CommandID dell'oggetto MenuCommand specificato è già presente in un menu.

Commenti

Le MenuCommands enumerazioni e StandardCommands contengono CommandID identificatori per i comandi standard predefiniti e i comandi di menu già associati a una posizione in un menu specifico.

Nota

Un tentativo di aggiungere un comando di menu con un oggetto già esistente CommandID genererà un'eccezione InvalidOperationException. Quando si aggiunge un comando di menu, assicurarsi di verificare che non sia già presente in un menu usando il FindCommand metodo o usare la gestione delle eccezioni in modo saggio.

È possibile collegare un gestore eventi a un comando di menu predefinito con la procedura seguente:

  1. Se il comando di menu da collegare a un gestore eventi è stato aggiunto a un menu o si trova con il FindCommand metodo , valutare se si vuole ripristinare questo comando di menu in un secondo momento e se si desidera richiamare il gestore eventi corrente dal nuovo gestore eventi. Se il codice potrebbe ripristinare il comando di menu o concatenare la chiamata dei gestori eventi, assicurarsi di archiviare un riferimento al comando di menu in un punto qualsiasi.

  2. Assicurarsi che qualsiasi comando di menu esistente in precedenza con lo stesso CommandID sia stato rimosso dal menu usando il RemoveCommand metodo .

  3. Creare un nuovo MenuCommand e specificare il gestore eventi nel costruttore, insieme a un CommandID oggetto che rappresenta il comando da aggiungere. Ogni comando di menu standard è associato a un percorso di menu predefinito a cui viene aggiunto. Gli ID dei comandi supportati sono definiti nelle StandardCommandsMenuCommands enumerazioni .

  4. Se si desidera richiamare un gestore eventi preesistente per il comando di menu, chiamare il Invoke metodo del comando di menu sostituito dal gestore eventi che gestisce l'evento invoke del comando di menu.

  5. Se si è interessati a ripristinare il gestore eventi di un comando di menu preesistente sostituito, aggiungere il comando di menu archiviato e esistente dopo aver rimosso il comando di menu di sostituzione creato. È possibile aggiungere questo comportamento al metodo per il Dispose tipo.

Si applica a

Vedi anche