將項目加入 Windows 捷徑清單

跳轉清單是 Windows 在使用者在工作列或開始選單右鍵點擊應用程式圖示時會顯示的捷徑選單。 你可以在跳轉清單中加入 任務 ——像是快速的全應用程式操作，例如撰寫新訊息或開啟設定——以及 自訂項目群組 ，例如最近的專案或置頂文件。

打開 WinUI 圖庫應用程式，看看 JumpList 的運作方式

Important

JumpList API 需要套件身份。 它能在封裝的（MSIX）應用程式和帶有外部位置的應用程式中運作，但在未封裝的應用程式中無法使用。

先決條件

  • 你的應用程式必須有套件識別碼：要 麼是用 MSIX 打包 ，要麼 是用外部位置打包。 未封裝的應用程式不被支援。
  • 目標是 Windows 10，版本 1607（周年更新，版本 14393）或更新版本。

載入目前的跳躍清單

在新增或移除項目前，請透過呼叫 JumpList.LoadCurrentAsync： 載入應用程式目前的跳轉清單。

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

新增工作

任務是具有空 GroupName 屬性的項目。 Windows 會把它們放在跳轉清單底部的內建任務區塊。 使用任務來執行無論情境如何都相關且始終相關的常見行動。

用 JumpListItem.CreateWithArguments 建立任務，加入 Items 集合，然後透過呼叫 JumpList.SaveAsync 來儲存。 當使用者選取該工作時，Windows 會以你提供的引數字串啟動你的應用程式，而你可以在啟動時從啟動引數中讀取該字串。

var jumpList = await JumpList.LoadCurrentAsync();

var task = JumpListItem.CreateWithArguments("/compose", "New Message");
task.Description = "Compose a new message";
task.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(task);
await jumpList.SaveAsync();

將項目加入自訂群組

自訂群組可以讓你把相關項目整理在有名稱的標題下。 將 GroupName 屬性設為非空字串;所有相同的 GroupName 項目會在同一個項目下一起出現。

var jumpList = await JumpList.LoadCurrentAsync();

var item = JumpListItem.CreateWithArguments("/project-alpha", "Project Alpha");
item.GroupName = "Projects";
item.Description = "Open Project Alpha";
item.Logo = new Uri("ms-appx:///Assets/Tiles/AppList.targetsize-48.png");

jumpList.Items.Add(item);
await jumpList.SaveAsync();

清除所有物品

要移除你已新增的所有物品，儲存前先清除 物品 集合：

var jumpList = await JumpList.LoadCurrentAsync();
jumpList.Items.Clear();
await jumpList.SaveAsync();

Windows 會保留系統管理的區塊（例如最近和頻繁），不論此呼叫如何;只有您的自訂任務和群組會被清除。

  • Last updated on