Compartilhar via


IMenuCommandService.AddCommand(MenuCommand) Método

Definição

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 a ser adicionado.

Exceções

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

Comentários

As MenuCommands enumerações e 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.

Observação

Uma tentativa de adicionar um comando de menu com um já existente CommandID gerará um InvalidOperationException. Ao adicionar um comando de menu, certifique-se de marcar que 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 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 seu manipulador de eventos no construtor, juntamente com um CommandID que representa 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 e MenuCommands .

  4. Se você quiser invocar qualquer manipulador de eventos preexistência para o comando de menu, chame o Invoke método do comando de menu que você substituiu no menu do manipulador de eventos que manipula o evento invoke do comando de menu.

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

Aplica-se a

Confira também