Tombol Drop-Down
Tombol Drop-Down terdiri dari tombol yang ketika diklik menampilkan daftar drop-down item yang saling eksklusif.
Detail
Kontrol ini berguna untuk mengekspos item yang terkait erat dalam kasus di mana tidak ada default yang jelas yang tersedia dan di mana masing-masing item dapat diwakili oleh gambar, teks, atau keduanya.
Cuplikan layar berikut mengilustrasikan Tombol Drop-Down Pita dalam contoh Pita.
Properti Tombol Drop-Down
Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Tombol Drop-Down.
Biasanya, properti Tombol Drop-Down 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 dikueri untuk 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 mencantumkan kunci properti yang terkait dengan kontrol tombol Drop-Down.
Kunci Properti | Catatan |
---|---|
UI_PKEY_Categories | Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty. |
UI_PKEY_Enabled | Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty. Jika semua item anak dinonaktifkan, kerangka kerja mengatur UI_PKEY_Enabled ke false (0). Jika tidak, jika satu atau beberapa item anak diaktifkan, UI_PKEY_Enabled diatur ke true (-1). Penting: Properti UI_PKEY_Enabled untuk kontrol Tombol Drop-Down harus tidak valid setelah satu atau beberapa item anak diaktifkan atau dinonaktifkan. Ini memastikan bahwa kerangka kerja meminta nilai properti yang diperbarui dan menyegarkan status kontrol tombol Drop-Down di UI pita. |
UI_PKEY_ItemsSource | Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty. |
UI_PKEY_Keytip | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_Label | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_LargeHighContrastImage | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_LargeImage | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_SelectedItem | Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty. Catatan: Jika Perintah yang terkait dengan kontrol tidak valid melalui panggilan ke IUIFramework::InvalidateUICommand, kerangka kerja meminta properti ini ketika UI_INVALIDATIONS_VALUE diteruskan sebagai nilai bendera. |
UI_PKEY_SmallHighContrastImage | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_SmallImage | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_TooltipDescription | Hanya dapat diperbarui melalui pembatalan. |
UI_PKEY_TooltipTitle | Hanya dapat diperbarui melalui pembatalan. |
Topik terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk