Bagikan melalui

Tentang Kontrol Bilah Ulang

  • Artikel

Kontrol Rebar bertindak sebagai kontainer untuk jendela anak. Ini dapat berisi satu atau beberapa pita, dan setiap pita dapat memiliki kombinasi bilah gripper, bitmap, label teks, dan satu jendela anak. Aplikasi menetapkan jendela anak—biasanya kontrol lain— ke band kontrol bilah ulang. Saat Anda secara dinamis memposisikan ulang band kontrol rebar, kontrol rebar mengelola ukuran dan posisi jendela anak yang ditetapkan ke pita tersebut. Selain itu, aplikasi dapat menentukan bitmap latar belakang untuk band, dan kontrol rebar akan menampilkan jendela anak band di atas bitmap.

Cuplikan layar berikut menunjukkan kontrol rebar yang memiliki dua pita. Satu berisi bilah alat, dan yang lainnya berisi kotak kombo. Kedua pita memiliki gripper yang memungkinkan mereka untuk dipindahkan dan diubah ukurannya.

screen shot of dialog box showing a rebar control with a band containing a toolbar and a band containing a combo box

Catatan

Kontrol rebar diimplementasikan dalam versi 4.70 dan yang lebih baru dari Comctl32.dll.

 

Rebar Bands dan Child Windows

Aplikasi mendefinisikan sifat band rebar dengan menggunakan pesan RB_INSERTBAND dan RB_SETBANDINFO. Pesan-pesan ini menerima alamat struktur REBARBANDINFO sebagai parameter lParam . Anggota struktur REBARBANDINFO mendefinisikan sifat-sifat pita tertentu. Untuk mengatur sifat pita, atur anggota cbsize untuk menunjukkan ukuran struktur, dalam byte. Kemudian atur anggota fMask untuk menunjukkan anggota struktur mana yang diisi aplikasi Anda.

Untuk menetapkan jendela anak ke pita, sertakan bendera RBBIM_CHILD di anggota fMask struktur REBARBANDINFO, lalu atur anggota hwndChild ke handel jendela anak. Aplikasi dapat mengatur lebar minimum yang diizinkan dan tinggi jendela anak di anggota cxMinChild dan cyMinChild .

Ketika kontrol rebar dihancurkan, itu menghancurkan jendela anak yang ditetapkan ke pita di dalamnya. Untuk mencegah kontrol menghancurkan jendela anak yang ditetapkan ke pitanya, hapus pita dengan mengirim pesan RB_DELETEBAND, lalu gunakan pesan RB_SETPARENT untuk mengatur ulang induk ke jendela lain sebelum menghancurkan kontrol bilah ulang.

Antarmuka Pengguna Kontrol Bilah Ulang

Semua pita kontrol rebar dapat diubah ukurannya, kecuali yang menggunakan gaya RBBS_FIXEDSIZE. Untuk mengubah ukuran atau mengubah urutan pita dalam kontrol, klik dan seret bilah gripper pita. Kontrol rebar secara otomatis mengubah ukuran dan memposisikan ulang jendela anak yang ditetapkan ke pitanya. Selain itu, Anda dapat mengalihkan ukuran pita dengan mengklik teks pita, jika ada.

Daftar Gambar Kontrol Rebar

Jika aplikasi menggunakan daftar gambar dengan kontrol rebar, aplikasi harus mengirim pesan RB_SETBARINFO sebelum menambahkan pita ke kontrol. Pesan ini menerima alamat struktur REBARINFO sebagai parameter lParam. Sebelum mengirim pesan, siapkan struktur REBARINFO dengan mengatur anggota cbSize ke ukuran struktur, dalam byte. Kemudian, jika kontrol rebar akan menampilkan gambar pada band, atur anggota fMask ke bendera RBIM_IMAGELIST dan tetapkan handel daftar gambar ke anggota himl . Jika rebar tidak akan menggunakan gambar band, atur fMask ke nol.

Penerusan Pesan Kontrol Bilah Ulang

Kontrol bilah ulang meneruskan semua pesan jendela WM_NOTIFY ke jendela induknya. Selain itu, kontrol rebar meneruskan pesan apa pun yang dikirim dari jendela yang ditetapkan ke pitanya, seperti WM_CHARTOITEM, WM_COMMAND, dan lainnya.