Bagikan melalui

Galeri Drop-Down

  • Artikel

Galeri Drop-Down terdiri dari tombol yang saat diklik menampilkan daftar drop-down yang berisi kumpulan item atau Perintah yang saling eksklusif.

Detail

Kontrol ini berguna untuk mengekspos item atau Perintah terkait di mana tidak ada default yang jelas, dan item individual dapat diwakili oleh gambar, teks, atau keduanya.

Dukungan untuk bilah gripper vertikal dan sudut, atau handel pengubah ukuran, disediakan melalui elemen DropDownGallery.MenuLayout .

Cuplikan layar berikut mengilustrasikan Galeri Drop-Down Pita di Microsoft Paint.

cuplikan layar kontrol dropdowngallery di pita cat microsoft.

Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol galeri Drop-Down.

Biasanya, properti Drop-Down Gallery 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 galeri Drop-Down.

Kunci Properti Catatan
UI_PKEY_Categories Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty.
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(hanya valid untuk galeri item)
 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.

Pustaka Kontrol Windows Ribbon Framework

Elemen markup DropDownGallery

Bekerja dengan Galeri

Sampel Galeri