JumpListItem Kelas

Definisi

Ruang nama:

Windows.UI.StartScreen

Menyediakan fungsionalitas untuk membuat dan menentukan item jump list untuk jump list aplikasi.

public ref class JumpListItem sealed

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

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

Public NotInheritable Class JumpListItem

Warisan

Object Platform::Object IInspectable JumpListItem

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 membuat tugas untuk JumpList yang meluncurkan aplikasi dengan parameter baris perintah dan mengambil tindakan yang diinginkan. Pelokalan tidak ditampilkan, tetapi dimungkinkan untuk DisplayName, deskripsi, dan logo melalui penggunaan ms-resource: dan ms-appx: skema URI.

private Windows.UI.StartScreen.JumpListItem CreateJumpListItemTask()
{
    var taskItem = JumpListItem.CreateWithArguments(
                            "/Argument", "DisplayName");

    // Set the description. (Optional.)
    taskItem.Description = "Compose a new message to " + friendName;

    // Set the logo for this jump list item. Must be ms-appx: or ms-appdata:.
    taskItem.Logo = new Uri("ms-appdata:///local/downloads/taskImage.png");

    // If the GroupName is left blank, then the item goes into the Tasks group by default.

    return taskItem;
}

partial class App
{
    protected override void OnLaunched(LaunchActivatedEventArgs e)
    {
        if (e.Kind == ActivationKind.Launch && e.Arguments == "/Argument")
        {
            // Run code relevant to the task that was selected.
        }
    }
}

Keterangan

JumpListItem dibuat menggunakan metode CreateWithArguments dan CreateSeparator . Setelah dibuat, mereka dapat ditambahkan ke daftar lompat aplikasi menggunakan properti Item daftar lompat dan metode SaveAsync . Ketahuilah bahwa di antarmuka pengguna, pengguna dapat mengklik kanan item jump list yang ada di grup kustom dan memilih "Hapus dari daftar ini". Ketika tindakan ini terjadi, sistem menandai item sebagai dihapus oleh pengguna dan menekannya dari UI. Saat berikutnya aplikasi memuat daftar lompat, aplikasi harus memeriksa item untuk melihat apakah properti RemovedByUser item diatur ke True. Jika RemovedByUser true, maka aplikasi harus memperbarui status internalnya agar sinkron dengan perubahan yang dimulai pengguna. Aplikasi bertanggung jawab untuk memastikan bahwa item yang dihapus tidak ditambahkan kembali ke daftar lompat hingga kondisi untuk penambahannya kembali terpenuhi, misalnya, oleh pengguna yang membuka dokumen terkait lagi.

Saat aplikasi menyimpan JumpList menggunakan SaveAsync, sistem operasi mengatur item sebagai berikut.

• Item apa pun dengan RemovedByUser sama dengan True akan dihapus.
• Item dengan properti GroupName yang sama ditempatkan bersama-sama, mempertahankan urutan relatifnya.
• Grup diurutkan berdasarkan posisi asli item pertama dalam grup, dengan pengecualian bahwa grup yang dikelola sistem selalu berada di bagian atas dan grup Tugas selalu berada di bagian bawah jika ada. Itu berarti bahwa ketika aplikasi memuat JumpList-nya menggunakan metode LoadCurrentAsync , item diambil dalam urutan terorganisir mereka, yang mungkin tidak setuju dengan urutan item dalam daftar lompat ketika awalnya disimpan.

Properti

Arguments	Mendapatkan argumen baris perintah untuk item jump list.
Description	Mendapatkan atau mengatur deskripsi tugas item daftar lompat.
DisplayName	Mendapatkan atau mengatur nama tampilan item daftar lompat. Nama tampilan juga dapat ditentukan sebagai parameter menggunakan metode CreateWithArguments saat item jump list dibuat.
GroupName	Mendapatkan atau mengatur nama grup kustom item jump list. Jika tidak ada nama yang ditentukan, item akan ditambahkan ke grup Tugas secara default.
Kind	Mendapatkan JumpListItemKind dari item jump list.
Logo	Mendapatkan atau mengatur logo item daftar lompat.
RemovedByUser	Mendapatkan boolean yang menunjukkan apakah item jump list dihapus dari daftar lompat aplikasi oleh pengguna.

Metode

CreateSeparator()	Membuat item jump list yang merupakan pemisah inert untuk grup kustom dalam daftar lompat aplikasi.
CreateWithArguments(String, String)	Membuat item jump list baru untuk jump list aplikasi.

Lihat juga

• Sampel kustomisasi jump list