定義
命名空間: Microsoft.CommandPalette.Extensions
用戶選擇命令時調用的方法。
參數
sender物件
表示從中調用命令的上下文。 這可以是不同的類型,具體取決於命令的使用位置:
- TopLevelCommands (和回退): sender 是調用的頂級命令的 ICommandItem 。
- IListPage.GetItems(): sender 是為該命令選擇的清單項的 IListItem 。
- ICommandItem.MoreCommands (上下文功能表): sender 是命令附加到清單頁的 IListItem ,或者是頂級命令的 ICommandItem (如果這是頂級命令上的上下文項)。
- IContentPage.Commands: sender 是 IContentPage 本身。
使用 sender 參數對於每個專案的可作資訊大致相同的大型項目清單非常有用。 一個例子是一長串連結。 您可以將其實現為單個 IInvokableCommand,該 II nvokableCommand 根據傳入的 sender 對象打開 URL。 然後,每個清單項將存儲要打開的URL和連結的標題。 這減少了擴展和主機通信的開銷。
退貨
一個 ICommandResult 物件,表示命令調用的結果。 此物件可以包含有關命令成功或失敗的資訊,以及可能與命令執行相關的任何其他數據。
範例
有關如何實現此方法的範例,請參閱 添加命令 。