Tambahkan item ke Jump List Windows

Jump list adalah menu pintasan yang Windows ditampilkan saat pengguna mengklik kanan ikon aplikasi Anda di taskbar atau di menu Mulai. Anda dapat mengisi jump list dengan tugas — tindakan cepat di seluruh aplikasi seperti menyusun pesan baru atau membuka pengaturan — serta dengan grup kustom berisi item seperti proyek terbaru atau dokumen yang disematkan.

Buka aplikasi Galeri WinUI dan lihat JumpList beraksi

Important

API JumpList memerlukan identitas paket. Ini berfungsi pada aplikasi yang dikemas (MSIX) dan aplikasi yang dikemas dengan lokasi eksternal, tetapi tidak tersedia pada aplikasi yang tidak dikemas.

Prerequisites

Muat daftar pintas saat ini

Sebelum Anda menambahkan atau menghapus item, muat jump list aplikasi saat ini dengan memanggil JumpList.LoadCurrentAsync:

using Windows.UI.StartScreen;

var jumpList = await JumpList.LoadCurrentAsync();

Menambahkan tugas

Tugas adalah item dengan properti GroupName yang kosong. Windows menempatkannya di bagian Tugas bawaan di bagian bawah daftar lompat. Gunakan tugas untuk tindakan umum yang selalu relevan terlepas dari konteksnya.

Buat tugas dengan JumpListItem.CreateWithArguments, tambahkan ke koleksi Item , lalu simpan dengan memanggil JumpList.SaveAsync. Saat pengguna memilih tugas, Windows meluncurkan aplikasi Anda dengan string argumen yang Anda berikan, yang dapat Anda baca dari argumen aktivasi saat startup.

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();

Tambahkan item ke grup khusus

Grup kustom memungkinkan Anda mengatur item terkait di bawah judul bernama. Atur properti GroupName ke string yang tidak kosong; semua item yang berbagi sama GroupName muncul bersama-sama di bawah judul tersebut.

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();

Hapus semua item

Untuk menghapus semua item yang telah Anda tambahkan, kosongkan kumpulan Item sebelum menyimpan:

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

Windows mempertahankan bagian yang dikelola sistem (seperti Terbaru dan Sering) terlepas dari panggilan ini; hanya tugas dan grup kustom Anda yang dihapus.

  • Last updated on