IMenuCommandService.AddCommand(MenuCommand) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将指定的标准菜单命令添加到菜单中。

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)

要添加的 MenuCommand。

菜单上已存在指定 CommandID 的 MenuCommand。

MenuCommands和 StandardCommands 枚举包含CommandID预定义的标准命令和菜单命令的标识符，这些命令已与特定菜单上的位置相关联。

注意

尝试添加具有已存在的 CommandID 菜单命令将引发 InvalidOperationException。添加菜单命令时，请确保使用方法检查该命令尚未位于菜单上FindCommand，或明智地使用异常处理。

可以使用以下过程将事件处理程序附加到预定义的菜单命令：

如果与事件处理程序链接的菜单命令已添加到菜单中，或者与方法一起 FindCommand 找到，请考虑以后是否要还原此菜单命令，以及是否要从新的事件处理程序调用当前事件处理程序。如果代码可能还原菜单命令或链接事件处理程序的调用，请确保将对菜单命令的引用存储在某个位置。
确保已使用 RemoveCommand 方法从菜单中删除任何以前存在的具有相同的CommandID菜单命令。
创建一个新的 MenuCommand 并在构造函数中指定事件处理程序，以及 CommandID 表示要添加的命令的。每个标准菜单命令都与添加到的预定义菜单位置相关联。支持的命令 ID 在和 MenuCommands 枚举中StandardCommands定义。
如果要为菜单命令调用任何预先存在的事件处理程序，请 Invoke 从处理菜单命令的 invoke 事件的事件处理程序调用在菜单上替换的菜单命令的方法。
如果有兴趣还原已替换的预先存在的菜单命令的事件处理程序，请在删除创建的替换菜单命令后添加已存储的预先存在的菜单命令。你可能希望将此行为添加到 Dispose 类型的方法。