IMenuCommandService.AddCommand(MenuCommand) Método

Definição

Espaço de Nomes:
System.ComponentModel.Design
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Adiciona o comando padrão especificado no 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 acrescentar.

Exceções

InvalidOperationException

O CommandID do especificado MenuCommand já está presente num menu.

Observações

As MenuCommands enumerações e StandardCommands contêm CommandID identificadores para comandos padrão pré-definidos e comandos de menu que já estão associados a uma localização num menu específico.

Note

Uma tentativa de adicionar um comando de menu com um comando já existente CommandID gerará um InvalidOperationException. Ao adicionar um comando de menu, certifique-se de que não está já no menu usando o FindCommand método, ou use a gestão de exceções com sabedoria.

Pode anexar um gestor de eventos a um comando de menu pré-definido com o seguinte procedimento:

  1. Se o comando de menu para ligar a um gestor de eventos foi adicionado a um menu, ou está localizado com o FindCommand método, considere se deseja restaurar este comando de menu mais tarde e se quer invocar o gestor de eventos atual a partir do seu novo gestor de eventos. Se o seu código puder restaurar o comando menu ou encadear a invocação dos handlers de eventos, certifique-se de armazenar uma referência ao comando menu em algum lado.

  2. Certifique-se de que qualquer comando de menu previamente existente com o CommandID mesmo foi removido do menu usando o RemoveCommand método.

  3. Crie um novo MenuCommand e especifique o seu gestor de eventos no construtor, juntamente com um CommandID que represente o comando a adicionar. Cada comando padrão do menu está associado a uma localização pré-definida onde é adicionado. Os IDs de comandos suportados estão definidos nas StandardCommands enumerações e MenuCommands .

  4. Se quiser invocar qualquer gestor de eventos pré-existente para o comando menu, chame o Invoke método do comando menu que substituiu no menu do handler de eventos que gere o evento invoke do seu comando menu.

  5. Se estiver interessado em restaurar o gestor de eventos de um comando de menu pré-existente que substituiu, adicione o comando de menu pré-existente armazenado depois de remover o comando de substituição do menu que criou. Pode querer adicionar este comportamento ao Dispose método para o seu tipo.

Aplica-se a

Ver também