IMenuCommandService.AddCommand(MenuCommand) Método

Definição

Namespace:
System.ComponentModel.Design
Assembly:
System.dll
Assembly:
netstandard.dll

Adiciona o comando de menu padrão especificado ao 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)

Parâmetros

command
MenuCommand

O MenuCommand para adicionar.

Exceções

InvalidOperationException

O CommandID do especificado MenuCommand já está presente em um menu.

Comentários

As MenuCommands enumerações StandardCommands contêm CommandID identificadores para comandos padrão predefinidos e comandos de menu que já estão associados a um local em um menu específico.

Note

Uma tentativa de adicionar um comando de menu com um já existente CommandID gerará um InvalidOperationException. Ao adicionar um comando de menu, verifique se ele ainda não está em um menu usando o FindCommand método ou use o tratamento de exceções com sabedoria.

Você pode anexar um manipulador de eventos a um comando de menu predefinido com o seguinte procedimento:

  1. Se o comando de menu a ser vinculado a um manipulador de eventos tiver sido adicionado a um menu ou estiver localizado com o FindCommand método, considere se você deseja restaurar esse comando de menu mais tarde e se deseja invocar o manipulador de eventos atual do seu novo manipulador de eventos. Se o código puder restaurar o comando de menu ou encadear a invocação de manipuladores de eventos, armazene uma referência ao comando de menu em algum lugar.

  2. Verifique se qualquer comando de menu existente anteriormente com o mesmo CommandID foi removido do menu usando o RemoveCommand método.

  3. Crie um novo MenuCommand e especifique o manipulador de eventos no construtor, juntamente com um CommandID que represente o comando a ser adicionado. Cada comando de menu padrão está associado a um local de menu predefinido ao qual ele é adicionado. As IDs de comando com suporte são definidas nas StandardCommands enumerações MenuCommands .

  4. Se você quiser invocar qualquer manipulador de eventos pré-existente para o comando de menu, chame o Invoke método do comando de menu substituído no menu do manipulador de eventos que manipula o evento de invocação do comando de menu.

  5. Se você estiver interessado em restaurar o manipulador de eventos de um comando de menu pré-existente que você substituiu, adicione o comando de menu armazenado e pré-existente depois de remover o comando de menu de substituição que você criou. Talvez você queira adicionar esse comportamento ao método para o Dispose seu tipo.

Aplica-se a

Confira também