JumpList Kelas

Definisi

Ruang nama:

Windows.UI.StartScreen

Menyediakan fungsionalitas untuk daftar lompat aplikasi. Jump list adalah menu yang disediakan sistem yang muncul saat pengguna mengklik kanan program di taskbar atau pada menu Mulai. Ini digunakan untuk menyediakan akses cepat ke dokumen yang baru-baru ini atau sering digunakan dan menawarkan tautan langsung ke fungsionalitas aplikasi. Tidak semua keluarga perangkat mendukung jump list.

public ref class JumpList sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class JumpList final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class JumpList

Public NotInheritable Class JumpList

Warisan

Object Platform::Object IInspectable JumpList

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)

Contoh

Contoh berikut menunjukkan cara menghapus daftar lompat untuk aplikasi, termasuk item kustom apa pun yang mungkin telah ditambahkan sebelumnya.

private async void DisableSystemJumpListAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Disable the system-managed jump list group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.None;

    // Remove any previously added custom jump list items.
    jumpList.Items.Clear();

    // Save the changes to the app's jump list.
    await jumpList.SaveAsync();
}

Contoh berikut menunjukkan cara mengatur jenis grup yang dikelola sistem yang digunakan oleh daftar lompat aplikasi, tanpa memengaruhi item daftar lompat kustom yang ada.

private async void SetSystemGroupAsync()
{
    // Get the app's jump list.
    var jumpList = await Windows.UI.StartScreen.JumpList.LoadCurrentAsync();

    // Set the system to autogenerate a Frequent group for the app jump list.
    // Alternatively, this property could be set to JumpListSystemGroupKind.Recent to autogenerate a Recent group.
    jumpList.SystemGroupKind = Windows.UI.StartScreen.JumpListSystemGroupKind.Frequent;

    // No changes were made to the jump list Items property, so any custom tasks and groups remain intact.
    await jumpList.SaveAsync();
}

Keterangan

JumpList aplikasi diambil menggunakan metode LoadCurrentAsync . Jika aplikasi tidak menyesuaikan daftar lompatnya, sistem menyediakan jump list default. Saat ini, daftar lompat default menunjukkan item terbaru. Pastikan aplikasi Anda telah terdaftar untuk menjadi penangan file default untuk jenis file tertentu yang ingin Anda tampilkan di daftar item terbaru. Untuk informasi selengkapnya, lihat Menangani aktivasi file.

Properti

Items	Mendapatkan daftar JumpListItem untuk daftar lompat. Item berjenis IVector(JumpListItem).
SystemGroupKind	Mendapatkan atau mengatur jenis grup daftar lompat yang dikelola sistem saat ini.

Metode

IsSupported()	Mendapatkan nilai yang menunjukkan apakah sistem mendukung jump list. Catatan Hanya keluarga perangkat desktop yang mendukung jump list, perubahan yang dilakukan pada jump list dengan keluarga perangkat yang berbeda tidak akan bertahan.
LoadCurrentAsync()	Secara asinkron mengambil daftar lompat saat ini dan itemnya.
SaveAsync()	Menyimpan perubahan secara asinkron ke daftar lompat dan itemnya.

Lihat juga

• Sampel kustomisasi jump list