IMenuCommandService.AddCommand(MenuCommand) Metoda

Definice

Obor názvů:
System.ComponentModel.Design
Sestavení:
netstandard.dll, System.ComponentModel.TypeConverter.dll
Sestavení:
System.ComponentModel.TypeConverter.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
IMenuCommandService.cs
Zdroj:
IMenuCommandService.cs

Přidá do nabídky zadaný standardní příkaz 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ání MenuCommand

Výjimky

InvalidOperationException

Zadaný CommandID parametr MenuCommand již existuje v nabídce.

Poznámky

MenuCommands Výčty 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.

Note

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

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 byl příkaz nabídky pro propojení s obslužnou rutinou události přidán do nabídky nebo je umístěn s FindCommand metodou, zvažte, zda chcete tento příkaz nabídky obnovit později a zda chcete vyvolat aktuální obslužnou rutinu události z 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 uložit odkaz na příkaz nabídky někam.

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

  3. Vytvořte novou MenuCommand a zadejte obslužnou rutinu události v konstruktoru spolu s reprezentací CommandID příkazu, který chcete přidat. Každý standardní příkaz nabídky je přidružený k předdefinovanému umístění nabídky, do kterého se přidá. Id podporovaných příkazů jsou definována v StandardCommands výčtech.MenuCommands

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

  5. Pokud vás zajímá obnovení obslužné rutiny události předexistujícího příkazu nabídky, který jste nahradili, přidejte uložený příkaz předexistující nabídky po odebrání příkazu náhradní nabídky, který jste vytvořili. Toto chování můžete přidat do Dispose metody pro váš typ.

Platí pro

Viz také