Tombol Pemisah

Tombol Pisahkan adalah kontrol komposit tempat pengguna dapat memilih nilai default yang terikat ke tombol utama, atau memilih dari daftar nilai yang saling eksklusif yang ditampilkan dalam daftar drop-down yang terikat ke tombol sekunder.

• Pendahuluan
• Properti Tombol Pisahkan
• Topik terkait

Pengantar

Kontrol ini berguna untuk mengekspos item yang terkait erat dalam kasus di mana default yang jelas tersedia dan di mana masing-masing item dapat diwakili oleh gambar, teks, atau keduanya.

Cuplikan layar berikut mengilustrasikan Tombol Pisahkan Pita.

Properti Tombol Pisahkan

Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Tombol Pisahkan .

Biasanya, properti Tombol Terpisah 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 mencantumkan kunci properti yang terkait dengan kontrol Tombol Pisahkan.

Kunci Properti	Catatan
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 Pisahkan 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 Pisahkan di UI pita.
UI_PKEY_Keytip	Hanya dapat diperbarui melalui pembatalan.
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 SplitButton