Bagikan melalui

Menu Aplikasi

  • Artikel

Menu Aplikasi adalah menu utama untuk aplikasi yang mengimplementasikan kerangka kerja Windows Ribbon.

Pengantar

Menu Aplikasi terdiri dari kontrol tombol drop-down yang menampilkan menu yang berisi Perintah yang mengekspos fungsionalitas yang terkait dengan proyek lengkap, seperti seluruh dokumen, gambar, atau film. Contohnya termasuk Perintah Baru, Buka, Simpan, dan Keluar .

Cuplikan layar berikut mengilustrasikan Menu Aplikasi.

cuplikan layar menu aplikasi dan daftar item terbaru dari cat untuk pita windows 7.

Komponen Menu Aplikasi

Menu Aplikasi adalah elemen wajib dalam aplikasi Pita apa pun. Titik entri ke dalam Menu Aplikasi adalah tombol khas yang muncul sebagai item pertama di baris Tab , seperti yang ditunjukkan pada cuplikan layar berikut.

Catatan

Windows 8 dan yang lebih baru: Gambar tombol Menu Aplikasi diubah menjadi label: File. Kami menyarankan agar Anda tidak menggunakan File sebagai label untuk tab Anda sendiri.

 

cuplikan layar tombol menu aplikasi wordpad untuk windows 7.

Saat diklik, tombol ini menampilkan menu kaya yang ditampilkan dalam cuplikan layar berikut (Menu Aplikasi dari WordPad untuk Windows 7).

cuplikan layar menu menu aplikasi wordpad untuk windows 7.

Catatan

Tidak ada dampak pada tab yang diatur ketika tombol Menu Aplikasi diklik; sebagai gantinya, fokus memasuki menu.

 

Menu Aplikasi berisi dua panel: daftar Perintah yang diwakili oleh satu atau beberapa elemen MenuGroup , dan daftar Item Terbaru yang diwakili oleh elemen ApplicationMenu.RecentItems .

Menu AplikasiGrup Menu

Elemen ApplicationMenu harus berisi setidaknya satu elemen turunan MenuGroup yang mengekspos daftar perintah tingkat aplikasi. Jika beberapa elemen MenuGroup dideklarasikan, garis pembagi digambar di antara grup, seperti yang ditunjukkan pada cuplikan layar berikut.

cuplikan layar grup menu aplikasi.

Berikut ini adalah daftar batasan untuk elemen MenuGroup dari Menu Aplikasi:

Saat Tombol digunakan dalam MenuGroup, nilai Command.LabelTitle ditampilkan di menu dan nilai Command.TooltipTitle dan Command.TooltipDescription ditampilkan sebagai tipsalat, seperti yang ditunjukkan pada cuplikan layar berikut.

cuplikan layar kontrol tombol di menu aplikasi.

Saat Tombol Drop-Down, Tombol Pisahkan, Galeri Drop-Down, atau Galeri Tombol Terpisah digunakan di Menu Aplikasi, bagian menu ditampilkan sebagai flyout yang mencakup dan menyembunyikan panel Item terbaru .

Untuk kontrol Tombol Pisahkan dan Tombol Drop-Down , nilai Command.LabelDescription ditampilkan sebaris di menu flyout untuk membantu pengguna secara visual menemukan fungsionalitas Perintah. Nilai Command.LabelDescription yang ditampilkan secara terprogram dipecah selama rentang dua baris, dan upaya dilakukan agar pas dengan nilai tepat di atas panel Item terbaru di bawahnya. Jika nilai Command.LabelDescription tidak sesuai, flyout akan diperluas untuk mengakomodasi nilai Command.Comment terpanjang di MenuGroup.

Cuplikan layar berikut menggambarkan perilaku ini dalam flyout Tombol Terpisah .

cuplikan layar flyout kontrol daftar di menu aplikasi.

Dengan Galeri Drop-Down dan Galeri Tombol Terpisah, hanya label dan gambar yang ditampilkan.

Mengukur Menu Aplikasi

Ukuran Menu Aplikasi ditangani oleh kerangka kerja Pita. Jika string yang sangat panjang disediakan untuk nilai Command.LabelTitle atau Command.LabelDescription, atau daftar panjang Perintah digunakan, menu akan menyesuaikan ukurannya untuk mengakomodasi konten. Beberapa bentuk penyesuaian termasuk memperluas ukuran flyout atau panel menu, dan menambahkan pandang saat menggulir diperlukan.

Properti Menu Aplikasi

Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Menu Aplikasi.

Biasanya, properti Menu Aplikasi 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 tidak dikueri untuk nilai properti yang diperbarui sampai properti diperlukan oleh kerangka kerja. Misalnya, kerangka kerja memerlukan properti saat tab diaktifkan dan kontrol diungkapkan di UI pita, atau saat tipsalat ditampilkan.

Kunci properti Catatan
UI_PKEY_TooltipDescription Hanya dapat diperbarui melalui pembatalan.
UI_PKEY_TooltipTitle Hanya dapat diperbarui melalui pembatalan.

 

Pustaka Kontrol Windows Ribbon Framework

Elemen markup ApplicationMenu