IMenuCommandService.AddCommand(MenuCommand) Metoda

  • Reference

Definice

Obor názvů:
System.ComponentModel.Design
Sestavení:
System.ComponentModel.TypeConverter.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Přidá zadaný standardní příkaz nabídky do nabídky.

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

Přidá MenuCommand se.

Výjimky

InvalidOperationException

V CommandID nabídce se již nachází zadaný MenuCommand parametr .

Poznámky

Výčty MenuCommands a StandardCommands obsahují CommandID identifikátory pro předdefinované standardní příkazy a příkazy nabídky, které jsou již přidruženy k umístění v konkrétní nabídce.

Poznámka

Pokus o přidání příkazu nabídky s již existujícím CommandID příkazem vyvolá .InvalidOperationException Při přidávání příkazu nabídky nezapomeňte pomocí FindCommand metody zkontrolovat, že již není v nabídce, nebo používejte zpracování výjimek uvádě.

Obslužnou rutinu události můžete připojit k předdefinovanému příkazu nabídky pomocí následujícího postupu:

  1. Pokud příkaz nabídky pro propojení s obslužnou rutinou události byl přidán do nabídky nebo je umístěn s FindCommand metodou , zvažte, zda chcete obnovit tento příkaz nabídky později a zda chcete vyvolat aktuální obslužnou rutinu události z vaší nové obslužné rutiny události. Pokud váš kód může obnovit příkaz nabídky nebo zřetězit vyvolání obslužných rutin událostí, nezapomeňte někam uložit odkaz na příkaz nabídky.

  2. Ujistěte se, že všechny dříve existující příkazy nabídky se stejným CommandID příkazem byly odebrány z nabídky pomocí RemoveCommand metody .

  3. Vytvořte novou MenuCommand a v konstruktoru zadejte obslužnou rutinu události spolu s příkazem CommandID představujícím přidání. Každý standardní příkaz nabídky je přidružen k předdefinovanému umístění nabídky, do kterého je přidán. Podporovaná ID příkazů jsou definována ve výčtech StandardCommands a MenuCommands .

  4. Pokud chcete vyvolat jakoukoli dříve existující obslužnou rutinu události pro příkaz nabídky, zavolejte metodu Invoke příkazu nabídky, který jste nahradili v nabídce z obslužné rutiny události, která zpracovává událost vyvolání příkazu nabídky.

  5. Pokud chcete obnovit obslužnou rutinu události dříve existujícího příkazu nabídky, který jste nahradili, přidejte uložený, existující příkaz nabídky po odebrání příkazu náhradní nabídky, který jste vytvořili. Toto chování můžete chtít přidat do Dispose metody pro váš typ.

Platí pro

Viz také