IMenuCommandService.AddCommand(MenuCommand) Método

Referência

Definição

Namespace:: System.ComponentModel.Design

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

InvalidOperationException

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:

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.
Verifique se qualquer comando de menu existente anteriormente com o mesmo CommandID foi removido do menu usando o RemoveCommand método .
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 .
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.
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

Compartilhar via