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)
參數
- command
- MenuCommand
還有 MenuCommand 一點要補充。
例外狀況
CommandID這些指定MenuCommand內容已經在菜單上。
備註
MenuCommands與StandardCommands列舉包含CommandID預先定義的標準指令及選單指令的識別碼,這些指令已與特定選單中的位置相關聯。
Note
嘗試用已存在 CommandID 的選單指令加入選單指令會拋出一個 InvalidOperationException。 新增選單指令時,務必確認該指令尚未在使用該 FindCommand 方法的選單中,或明智地使用例外處理。
你可以透過以下程序將事件處理器附加到預設的選單指令中:
如果連結事件處理器的選單指令已被加入選單,或是方法中 FindCommand 包含,請考慮你是否想稍後還原這個選單指令,以及是否想從新的事件處理程序調用目前的事件處理程序。 如果你的程式碼可能會還原選單指令或串接事件處理程序的呼叫,務必在某處儲存選單指令的參考。
請確保之前任何包含相同 CommandID 內容的選單指令都已透過此 RemoveCommand 方法從選單中移除。
建立一個新的 MenuCommand ,並在建構子中指定你的事件處理程序,並附上 CommandID 一個代表要加的指令。 每個標準選單指令都會對應一個預設的選單位置,並加入該指令。 支援的指令 ID 定義在 StandardCommands 和 MenuCommands 枚舉中。
如果你想調用選單指令中任何既有的事件處理程序,請 Invoke 從處理選單指令中 invoke 事件的事件處理程序呼叫你在選單中替換的選單指令的方法。
如果你想恢復已替換的已存在選單指令的事件處理程序,移除你建立的替換選單指令後,再新增已儲存的預設選單指令。 你也可以把這種行為加入
Dispose你類型的方法裡。