Udostępnij za pośrednictwem


IMenuCommandService.AddCommand(MenuCommand) Metoda

Definicja

Dodaje określone standardowe polecenie menu do 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)

Parametry

command
MenuCommand

Element do dodania MenuCommand .

Wyjątki

Określona CommandID wartość MenuCommand jest już obecna w menu.

Uwagi

Wyliczenia MenuCommands i StandardCommands zawierają CommandID identyfikatory wstępnie zdefiniowanych standardowych poleceń i poleceń menu, które są już skojarzone z lokalizacją w określonym menu.

Uwaga

Próba dodania polecenia menu z już istniejącym CommandID poleceniem spowoduje zgłoszenie polecenia InvalidOperationException. Podczas dodawania polecenia menu upewnij się, że nie znajduje się on jeszcze w menu przy użyciu FindCommand metody lub mądrze używaj obsługi wyjątków.

Program obsługi zdarzeń można dołączyć do wstępnie zdefiniowanego polecenia menu przy użyciu następującej procedury:

  1. Jeśli polecenie menu, aby połączyć się z programem obsługi zdarzeń, zostało dodane do menu lub znajduje się z FindCommand metodą, rozważ, czy chcesz przywrócić to polecenie menu później, i czy chcesz wywołać bieżącą procedurę obsługi zdarzeń z nowej procedury obsługi zdarzeń. Jeśli kod może przywrócić polecenie menu lub utworzyć łańcuch wywołań procedur obsługi zdarzeń, pamiętaj, aby zapisać odwołanie do polecenia menu gdzieś.

  2. Upewnij się, że wszystkie wcześniej istniejące polecenie menu z tym samym CommandID poleceniem zostało usunięte z menu przy użyciu RemoveCommand metody .

  3. Utwórz nową MenuCommand i określ procedurę obsługi zdarzeń w konstruktorze wraz z reprezentującym CommandID polecenie do dodania. Każde standardowe polecenie menu jest skojarzone ze wstępnie zdefiniowaną lokalizacją menu, do której jest dodawany. Obsługiwane identyfikatory poleceń są definiowane w wyliczeniach StandardCommands i MenuCommands .

  4. Jeśli chcesz wywołać dowolną wcześniej współistniejącą procedurę obsługi zdarzeń dla polecenia menu, wywołaj Invoke metodę polecenia menu zastąpionego w menu z procedury obsługi zdarzeń obsługującej zdarzenie wywołania polecenia menu.

  5. Jeśli chcesz przywrócić procedurę obsługi zdarzeń istniejącego polecenia menu, które zostało zastąpione, dodaj przechowywane, istniejące polecenie menu po usunięciu utworzonego polecenia menu zastępczego. Możesz dodać to zachowanie do Dispose metody dla danego typu.

Dotyczy

Zobacz też