Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método IMenuCommandService.AddCommand (MenuCommand)

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.ComponentModel.Design
Ensamblado:  System (en System.dll)

void AddCommand(
	MenuCommand command
)

Parámetros

command
Type: System.ComponentModel.Design.MenuCommand

MenuCommand que se va a agregar.

Exception Condition
InvalidOperationException

El CommandID del MenuCommand ya está presente en un menú.

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

System_CAPS_noteNota

Intento de agregar un comando de menú con una ya existente CommandID producirá un InvalidOperationException. Al agregar un comando de menú, asegúrese de comprobar que aún no está en un menú con el FindCommand método o utilice excepciones con cuidado.

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

  1. Si el comando de menú para vincular con un controlador de eventos se ha agregado a un menú o se encuentra en la 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 restablece el comando de menú o la cadena de la invocación de controladores de eventos, asegúrese de almacenar una referencia al comando de menú en alguna parte.

  2. Asegúrese de que los comandos de menú existentes con el mismo CommandID se ha quitado del menú usando el RemoveCommand método.

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

  4. Si desea invocar cualquier controlador de eventos preexistentes para el comando de menú, llame a la Invoke método del comando de menú que ha reemplazado en el menú desde el controlador de eventos que controla el evento de invocación del comando de menú.

  5. Si está interesado en restaurar el controlador de eventos de un comando de menú ya existente que ha reemplazado, agregue almacenado, preexistente de comando de menú después de quitar el comando de menú de reemplazo que creó. Puede agregar este comportamiento a la Dispose método para su tipo.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: