Bagikan melalui

Item Terbaru

  • Artikel

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).

cuplikan layar daftar item terbaru di pita cat microsoft.

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 .

cuplikan layar daftar item terbaru dalam menu aplikasi.

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.

 

cuplikan layar item terbaru yang disematkan di menu aplikasi.

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.

Pustaka Kontrol Windows Ribbon Framework

Elemen markup item terbaru