Item Terbaru
Daftar Item Terbaru adalah panel di Menu Aplikasi yang menampilkan item yang terakhir digunakan (MRU) untuk aplikasi.
Detail
Cuplikan layar berikut mengilustrasikan daftar Item Terbaru dari WordPad untuk Windows 7).
Menu Aplikasi dapat memiliki paling banyak satu daftar ApplicationMenu.RecentItems, yang diwakili oleh elemen ApplicationMenu.RecentItems, untuk menampilkan dokumen terbaru, gambar, film, dan proyek lain yang telah dikerjakan pengguna. Jumlah item yang tercantum berkisar dari nol hingga angka maksimum yang ditentukan dalam markup, dengan nilai default sepuluh. Item terbaru ditampilkan sebagai daftar string bernomor yang menunjukkan nama file. Disarankan agar properti Command.LabelDescription digunakan untuk memberikan jalur lengkap untuk lokasi file, seperti yang ditunjukkan pada cuplikan layar berikut .
Elemen RecentItems memiliki atribut EnablePinning yang, jika diatur ke true
, menampilkan ikon sematkan di sebelah kanan setiap item dalam daftar, seperti yang ditunjukkan pada cuplikan layar berikut.
Catatan
Penyematan diaktifkan secara default jika atribut EnablePinning tidak ditentukan.
Algoritma penyematan dimaksudkan untuk menjaga item tidak jatuh dari daftar Item terbaru . Algoritma menghasilkan perilaku berikut:
- Item baru selalu ditambahkan di bagian atas daftar Item terbaru .
- Item akan berpindah ke bawah dalam daftar dari waktu ke waktu. Setelah daftar penuh (mencapai jumlah maksimum item yang ditentukan dalam markup), item yang lebih lama berada di bagian bawah daftar saat item baru ditambahkan ke bagian atas daftar.
- Jika item sudah muncul di suatu tempat dalam daftar tetapi diakses lagi, item akan kembali ke bagian atas daftar.
- Jika item disematkan, item masih akan melakukan perjalanan ke bawah daftar, tetapi tidak akan jatuh dari bawah. Sebaliknya, setelah daftar penuh, item pertama yang tidak disematkan di atas item yang disematkan akan jatuh saat item baru ditambahkan ke daftar.
- Jika jumlah item yang disematkan mencapai jumlah item maksimum, maka tidak ada item baru yang akan ditambahkan ke daftar hingga item tidak disematkan.
Properti Item Terbaru
Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Item Terbaru.
Biasanya, properti Item Terbaru diperbarui di UI pita dengan membatalkan Perintah yang terkait dengan kontrol melalui panggilan ke metode IUIFramework::InvalidateUICommand . Peristiwa pembatalan ditangani, dan pembaruan properti ditentukan, oleh metode panggilan balik IUICommandHandler::UpdateProperty .
Metode panggilan balik IUICommandHandler::UpdateProperty tidak dijalankan, dan aplikasi meminta nilai properti yang diperbarui, hingga properti diperlukan oleh kerangka kerja. Misalnya, saat tab diaktifkan dan kontrol terungkap di UI pita, atau saat tipsalat ditampilkan.
Catatan
Dalam beberapa kasus, properti dapat diambil melalui metode IUIFramework::GetUICommandProperty dan diatur dengan metode IUIFramework::SetUICommandProperty .
Tabel berikut ini mencantumkan kunci properti yang terkait dengan kontrol Item Terbaru.
Kunci Properti | Catatan |
---|---|
UI_PKEY_Keytip | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_RecentItems | Hanya dapat diperbarui melalui pembatalan. |
Keterangan
Metode IApplicationDocumentLists::GetList dapat digunakan untuk mengambil daftar MRU Windows Shell untuk aplikasi Pita. Objek yang diambil oleh metode ini kemudian dapat digunakan oleh aplikasi untuk membuat data yang diperlukan oleh kerangka kerja Pita untuk mengisi daftar item Terbaru dari Menu Aplikasi.
Catatan
Saat menggunakan metode ini, listtype harus memiliki nilai ADLT_RECENT
.
Untuk contoh cara mengimplementasikan daftar item MRU dalam aplikasi kerangka kerja Pita, lihat Sampel HTMLEditRibbon.
Topik terkait