Compartir vía


IMenuCommandService.AddCommand(MenuCommand) Método

Definición

Agrega el comando de menú estándar especificado al menú.

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

MenuCommand que se va a agregar.

Excepciones

El objeto CommandID del objeto MenuCommand especificado ya existe en un menú.

Comentarios

Las MenuCommands enumeraciones y StandardCommands contienen CommandID identificadores para comandos estándar predefinidos y comandos de menú que ya están asociados a una ubicación en un menú determinado.

Nota

Un intento de agregar un comando de menú con un elemento ya existente CommandID producirá una InvalidOperationExceptionexcepción . Al agregar un comando de menú, asegúrese de comprobar que aún no está en un menú mediante el método o use el FindCommand control de excepciones de forma inteligente.

Puede adjuntar un controlador de eventos a un comando de menú predefinido con el procedimiento siguiente:

  1. Si el comando de menú para vincular con un controlador de eventos se ha agregado a un menú o se encuentra con el FindCommand método , considere si desea restaurar este comando de menú más adelante y si desea invocar el controlador de eventos actual desde el nuevo controlador de eventos. Si el código puede restaurar el comando de menú o encadenar la invocación de controladores de eventos, asegúrese de almacenar una referencia al comando de menú en algún lugar.

  2. Asegúrese de que cualquier comando de menú existente anteriormente con el mismo CommandID se ha quitado del menú mediante el RemoveCommand método .

  3. Cree un nuevo MenuCommand y especifique el controlador de eventos en el constructor, junto con un CommandID objeto que representa el comando que se va a agregar. Cada comando de menú estándar está asociado a una ubicación de menú predefinida a la que se agrega. Los identificadores de comando admitidos se definen en las StandardCommands enumeraciones y MenuCommands .

  4. Si desea invocar cualquier controlador de eventos preexistente para el comando de menú, llame al Invoke método del comando de menú que ha reemplazado en el menú del controlador de eventos que controla el evento invoke del comando de menú.

  5. Si está interesado en restaurar el controlador de eventos de un comando de menú preexistente que ha reemplazado, agregue el comando de menú almacenado y preexistente después de quitar el comando de menú de reemplazo que ha creado. Es posible que desee agregar este comportamiento al método para el Dispose tipo.

Se aplica a

Consulte también