Struktur REBARBANDINFOA (commctrl.h)
Berisi informasi yang mendefinisikan pita dalam kontrol bilah-ulang.
Sintaks
typedef struct tagREBARBANDINFOA {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPSTR lpText;
UINT cch;
int iImage;
HWND hwndChild;
UINT cxMinChild;
UINT cyMinChild;
UINT cx;
HBITMAP hbmBack;
UINT wID;
UINT cyChild;
UINT cyMaxChild;
UINT cyIntegral;
UINT cxIdeal;
LPARAM lParam;
UINT cxHeader;
RECT rcChevronLocation;
UINT uChevronState;
} REBARBANDINFOA, *LPREBARBANDINFOA;
Anggota
cbSize
Jenis: UINT
Ukuran struktur ini, dalam byte. Aplikasi Anda harus mengisi anggota ini sebelum mengirim pesan apa pun yang menggunakan alamat struktur ini sebagai parameter.
fMask
Jenis: UINT
Bendera yang menunjukkan anggota struktur ini mana yang valid atau harus diisi. Nilai ini bisa menjadi kombinasi dari yang berikut ini:
Nilai | Makna |
---|---|
|
Anggota hbmBack valid atau harus diatur. |
|
Anggota hwndChild valid atau harus diatur. |
|
Anggota cxMinChild, cyMinChild, cyChild, cyMaxChild, dan cyIntegral valid atau harus ditetapkan. |
|
Anggota clrFore dan clrBack valid atau harus ditetapkan. |
|
Versi 4.71. Anggota cxHeader valid atau harus diatur. |
|
Versi 4.71. Anggota cxIdeal valid atau harus ditetapkan. |
|
Anggota wID valid atau harus diatur. |
|
Anggota iImage valid atau harus ditetapkan. |
|
Versi 4.71. Anggota lParam valid atau harus diatur. |
|
Anggota cx valid atau harus ditetapkan. |
|
Anggota fStyle valid atau harus ditetapkan. |
|
Anggota lpText valid atau harus diatur. |
|
Anggota rcChevronLocation valid atau harus ditetapkan. |
|
Anggota uChevronState valid atau harus diatur. |
fStyle
Jenis: UINT
Bendera yang menentukan gaya pita. Nilai ini bisa menjadi kombinasi dari yang berikut ini:
Nilai | Makna |
---|---|
|
Band ini berada di baris baru. |
|
Pita memiliki tepi di bagian atas dan bawah jendela anak. |
|
Bitmap latar belakang tidak bergerak ketika pita diubah ukurannya. |
|
Band tidak bisa berukuran. Dengan gaya ini, pegangan ukuran tidak ditampilkan pada band. |
|
Versi 4.71. Band akan selalu memiliki pegangan ukuran, bahkan jika itu adalah satu-satunya band di rebar. |
|
Pita tidak akan terlihat. |
|
Versi 4.71. Band tidak akan pernah memiliki pegangan ukuran, bahkan jika ada lebih dari satu band di rebar. |
|
Versi 5.80. Tampilkan tombol chevron jika pita lebih kecil dari cxIdeal. |
|
Versi 4.71. Pita dapat diubah ukurannya dengan kontrol bilah ulang; cyIntegral dan cyMaxChild memengaruhi bagaimana rebar akan mengubah ukuran band. |
|
Jangan tampilkan ketika vertikal. |
|
Jaga agar judul band tetap tersembunyi. |
|
Pertahankan pita di baris atas. |
clrFore
Jenis: COLORREF
Warna latar depan pita.
clrBack
Jenis: COLORREF
Warna latar belakang pita. Jika hbmBack menentukan bitmap latar belakang, anggota ini diabaikan. Secara default, pita akan menggunakan warna latar belakang kontrol bilah ulang yang diatur dengan pesan RB_SETBKCOLOR . Jika warna latar belakang ditentukan di sini, maka warna latar belakang ini akan digunakan sebagai gantinya.
lpText
Jenis: LPTSTR
Penunjuk ke buffer yang berisi teks tampilan untuk pita. Jika informasi band diminta dari kontrol dan RBBIM_TEXT ditentukan dalam fMask, anggota ini harus diinisialisasi ke alamat buffer yang akan menerima teks.
cch
Jenis: UINT
Ukuran buffer di lpText, dalam byte. Jika informasi tidak diminta dari kontrol, anggota ini diabaikan.
iImage
Jenis: int
Indeks berbasis nol dari gambar apa pun yang harus ditampilkan dalam pita. Daftar gambar diatur menggunakan pesan RB_SETBARINFO .
hwndChild
Jenis: HWND
Tangani ke jendela anak yang terkandung dalam pita, jika ada.
cxMinChild
Jenis: UINT
Lebar minimum jendela anak, dalam piksel. Pita tidak dapat berukuran lebih kecil dari nilai ini.
cyMinChild
Jenis: UINT
Tinggi minimum jendela anak, dalam piksel. Pita tidak dapat berukuran lebih kecil dari nilai ini.
cx
Jenis: UINT
Panjang pita, dalam piksel.
hbmBack
Jenis: HBITMAP
Tangani ke bitmap yang digunakan sebagai latar belakang untuk pita ini.
wID
Jenis: UINT
Nilai UINT yang digunakan kontrol untuk mengidentifikasi pita ini untuk pesan pemberitahuan gambar kustom.
cyChild
Jenis: UINT
Versi 4.71. Tinggi awal pita, dalam piksel. Anggota ini diabaikan kecuali gaya RBBS_VARIABLEHEIGHT ditentukan.
cyMaxChild
Jenis: UINT
Versi 4.71. Tinggi maksimum pita, dalam piksel. Anggota ini diabaikan kecuali gaya RBBS_VARIABLEHEIGHT ditentukan.
cyIntegral
Jenis: UINT
Versi 4.71. Nilai langkah di mana pita dapat tumbuh atau menyusut, dalam piksel. Jika diubah ukurannya, pita akan diubah ukurannya dalam langkah-langkah yang ditentukan oleh nilai ini. Anggota ini diabaikan kecuali gaya RBBS_VARIABLEHEIGHT ditentukan.
cxIdeal
Jenis: UINT
Versi 4.71. Lebar pita yang ideal, dalam piksel. Jika pita dimaksimalkan ke lebar ideal (lihat RB_MAXIMIZEBAND), kontrol bilah ulang akan mencoba membuat pita lebar ini.
lParam
Jenis: LPARAM
Versi 4.71. Nilai yang ditentukan aplikasi.
cxHeader
Jenis: UINT
Versi 4.71. Ukuran header band, dalam piksel. Header band adalah area antara tepi pita dan tepi jendela anak. Ini adalah area tempat teks dan gambar pita ditampilkan, jika ditentukan. Jika nilai ini ditentukan, nilai ini akan menggantikan dimensi header normal yang dihitung kontrol untuk pita.
rcChevronLocation
Jenis: RECT
Versi 6. Lokasi chevron.
uChevronState
Jenis: UINT
Versi 6. Kombinasi Konstanta Status Objek.
Keterangan
Anggota cxMinChild, cyMinChild, dan cx memberikan informasi tentang dimensi yang relatif terhadap orientasi kontrol. Artinya, untuk kontrol rebar horizontal, cxMinChild dan cx adalah pengukuran horizontal dan cyMinChild adalah pengukuran vertikal. Namun, jika kontrol menggunakan gaya CCS_VERT , cxMinChild dan cx adalah pengukuran vertikal dan cyMinChild adalah pengukuran horizontal.
Catatan
Header commctrl.h mendefinisikan REBARBANDINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Header | commctrl.h |