IMenuCommandService.AddCommand(MenuCommand) Methode

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.dll
Assembly:
netstandard.dll

Fügt dem Menü den angegebenen Standardmenübefehl hinzu.

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)

Parameter

command
MenuCommand

Der MenuCommand hinzuzufügende

Ausnahmen

InvalidOperationException

Der CommandID angegebene MenuCommand Ist-Wert ist bereits in einem Menü vorhanden.

Hinweise

Die MenuCommands Und StandardCommands Enumerationen enthalten CommandID Bezeichner für vordefinierte Standardbefehle und Menübefehle, die bereits einem Speicherort in einem bestimmten Menü zugeordnet sind.

Note

Beim Versuch, einen Menübefehl mit einem bereits vorhandenen CommandID Menü hinzuzufügen, wird ein InvalidOperationException. Achten Sie beim Hinzufügen eines Menübefehls darauf, dass es sich nicht bereits in einem Menü mit der FindCommand Methode befindet, oder weisen Sie die Ausnahmebehandlung zu.

Sie können einen Ereignishandler an einen vordefinierten Menübefehl mit der folgenden Prozedur anfügen:

  1. Wenn der Menübefehl zum Verknüpfen mit einem Ereignishandler zu einem Menü hinzugefügt wurde oder sich mit der FindCommand Methode befindet, überlegen Sie, ob Sie diesen Menübefehl später wiederherstellen möchten und ob Sie den aktuellen Ereignishandler aus dem neuen Ereignishandler aufrufen möchten. Wenn ihr Code den Menübefehl möglicherweise wiederherstellen oder den Aufruf von Ereignishandlern verkettet, müssen Sie einen Verweis auf den Menübefehl an einer beliebigen Stelle speichern.

  2. Stellen Sie sicher, dass alle zuvor vorhandenen Menübefehle mit demselben CommandID mithilfe der RemoveCommand Methode aus dem Menü entfernt wurden.

  3. Erstellen Sie einen neuen MenuCommand , und geben Sie den Ereignishandler im Konstruktor zusammen mit einer CommandID Darstellung des hinzuzufügenden Befehls an. Jeder Standardmenübefehl ist einem vordefinierten Menüspeicherort zugeordnet, an dem er hinzugefügt wird. Die unterstützten Befehls-IDs werden in den StandardCommands Und MenuCommands Enumerationen definiert.

  4. Wenn Sie einen bereits vorhandenen Ereignishandler für den Menübefehl aufrufen möchten, rufen Sie die Invoke Methode des Menübefehls auf, den Sie im Menü ersetzt haben, aus dem Ereignishandler, der das Aufrufereignis des Menübefehls behandelt.

  5. Wenn Sie den Ereignishandler eines bereits vorhandenen Menübefehls wiederherstellen möchten, den Sie ersetzt haben, fügen Sie den gespeicherten, bereits vorhandenen Menübefehl hinzu, nachdem Sie den von Ihnen erstellten Ersatzmenübefehl entfernt haben. Sie können dieses Verhalten der Dispose Methode für Ihren Typ hinzufügen.

Gilt für:

Weitere Informationen