IMenuCommandService.AddCommand(MenuCommand) Метод

Определение

Пространство имен:
System.ComponentModel.Design
Сборки:
netstandard.dll, System.ComponentModel.TypeConverter.dll
Сборка:
System.ComponentModel.TypeConverter.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
IMenuCommandService.cs
Исходный код:
IMenuCommandService.cs

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

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 объект.

Исключения

InvalidOperationException

Указанный CommandID элемент MenuCommand уже присутствует в меню.

Комментарии

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

Note

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

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

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

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

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

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

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

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

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