Kotak Kombo (Windows Ribbon Framework)

Kotak Kombo terdiri dari kotak daftar kolom tunggal yang berisi kumpulan item atau Perintah yang saling eksklusif yang dikombinasikan dengan kontrol statis atau edit dan panah drop-down. Bagian kotak daftar kontrol ditampilkan saat pengguna mengklik panah turun bawah.

• Detail
• Properti Kotak Kombo
• Topik terkait

Detail

Item atau Perintah yang saat ini dipilih (jika ada) dalam kotak daftar ditampilkan dalam kontrol statis atau edit. Dengan kontrol edit, jika pengguna mengetikan karakter awal item atau Perintah yang ada, kotak daftar akan menyoroti item pertama dengan karakter awal tersebut dan melengkapi entri dalam kontrol edit.

Hanya mendukung bilah gripper vertikal, atau mengubah ukuran handel.

Kontrol ini berguna untuk mengekspos item teks sederhana dan terkait erat.

Cuplikan layar berikut mengilustrasikan Kotak Kombo Pita di Live Movie Maker.

Properti Kotak Kombo

Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Kotak Kombo.

Biasanya, properti Kotak Kombo 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 ini mencantumkan kunci properti yang terkait dengan kontrol Kotak Kombo.

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	Mendukung IUIFramework::GetUICommandProperty dan IUIFramework::SetUICommandProperty.
UI_PKEY_SmallHighContrastImage	Hanya dapat diperbarui melalui pembatalan.
UI_PKEY_SmallImage	Hanya dapat diperbarui melalui pembatalan.
UI_PKEY_StringValue	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_TooltipDescription	Hanya dapat diperbarui melalui pembatalan.
UI_PKEY_TooltipTitle	Hanya dapat diperbarui melalui pembatalan.

Topik terkait

Pustaka Kontrol Windows Ribbon Framework

Elemen markup ComboBox

Bekerja dengan Galeri

Sampel Galeri