Bagikan melalui

Grup (Windows Ribbon Framework)

  • Artikel

Grup mengatur Perintah dan kontrol terkait dalam Tab.

Detail

Cuplikan layar berikut mengilustrasikan kontrol Grup Pita.

cuplikan layar dengan callout memperlihatkan grup.

Properti Grup

Kerangka kerja Pita menentukan kumpulan kunci properti untuk kontrol Grup.

Biasanya, properti Grup 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 Grup.

Kunci Properti Catatan
UI_PKEY_Keytip Hanya dapat diperbarui melalui pembatalan. Catatan: Kerangka kerja mengharuskan nilai UI_PKEY_Keytip untuk kontrol Grup dimulai dengan huruf besar Z. Jika nilai yang disediakan oleh aplikasi dalam metode panggilan balik IUICommandHandler::UpdateProperty tidak dimulai dengan huruf Z, nilai ini diabaikan dan nilai dihasilkan oleh kerangka kerja sebagai gantinya. Nilai kerangka kerja adalah huruf Z diikuti oleh nilai numerik mulai dari 1 dan meningkat secara berurutan, sesuai kebutuhan, untuk kontrol Grup berikutnya (Z1, Z2, ..., Zx).
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_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 Grup