Поделиться через


IMenuCommandService.AddCommand(MenuCommand) Метод

Определение

Добавляет в меню указанную стандартную команду меню.

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)

Параметры

command
MenuCommand

Добавляемый объект MenuCommand.

Исключения

Идентификатор CommandID указанной команды MenuCommand уже представлен в меню.

Комментарии

Перечисления MenuCommands и StandardCommands содержат CommandID идентификаторы для предопределенных стандартных команд и команд меню, которые уже связаны с расположением в определенном меню.

Примечание

При попытке добавить команду меню с уже существующим CommandID вызывается InvalidOperationExceptionисключение . При добавлении команды меню обязательно проверка, что она еще не находится в меню с помощью FindCommand метода , или используйте обработку исключений с умом.

Обработчик событий можно присоединить к предопределенной команде меню с помощью следующей процедуры:

  1. Если команда меню для связи с обработчиком событий была добавлена в меню или находится с FindCommand помощью метода , подумайте, хотите ли вы восстановить эту команду меню позже и хотите ли вы вызвать текущий обработчик событий из нового обработчика событий. Если код может восстановить команду меню или создать цепочку вызова обработчиков событий, обязательно сохраните ссылку на команду меню.

  2. Убедитесь, что все ранее существующие команды меню с той же CommandID командой были удалены из меню с помощью RemoveCommand метода .

  3. Создайте новый MenuCommand объект и укажите обработчик событий в конструкторе вместе с командой CommandID для добавления. Каждая стандартная команда меню связана с предопределенным расположением меню, куда она добавляется. Поддерживаемые идентификаторы команд определяются в перечислениях StandardCommands и MenuCommands .

  4. Если требуется вызвать любой ранее существующий обработчик событий для команды меню, вызовите Invoke метод команды меню, замененной в меню, из обработчика событий, обрабатывающего событие вызова команды меню.

  5. Если вы заинтересованы в восстановлении обработчика событий ранее заменяемой команды меню, добавьте сохраненную ранее ранее созданную команду меню после удаления созданной команды меню замены. Это поведение может потребоваться добавить в Dispose метод для вашего типа.

Применяется к

См. также раздел