Struktur REBARBANDINFOA (commctrl.h)

  • Artikel

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
RBBIM_BACKGROUND
 Anggota hbmBack valid atau harus diatur.
RBBIM_CHILD
 Anggota hwndChild valid atau harus diatur.
RBBIM_CHILDSIZE
 Anggota cxMinChild, cyMinChild, cyChild, cyMaxChild, dan cyIntegral valid atau harus ditetapkan.
RBBIM_COLORS
 Anggota clrFore dan clrBack valid atau harus ditetapkan.
RBBIM_HEADERSIZE

Versi 4.71. Anggota cxHeader valid atau harus diatur.
RBBIM_IDEALSIZE

Versi 4.71. Anggota cxIdeal valid atau harus ditetapkan.
RBBIM_ID
 Anggota wID valid atau harus diatur.
RBBIM_IMAGE
 Anggota iImage valid atau harus ditetapkan.
RBBIM_LPARAM

Versi 4.71. Anggota lParam valid atau harus diatur.
RBBIM_SIZE
 Anggota cx valid atau harus ditetapkan.
RBBIM_STYLE
 Anggota fStyle valid atau harus ditetapkan.
RBBIM_TEXT
 Anggota lpText valid atau harus diatur.
RBBIM_CHEVRONLOCATION
 Anggota rcChevronLocation valid atau harus ditetapkan.
RBBIM_CHEVRONSTATE
 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
RBBS_BREAK
 Band ini berada di baris baru.
RBBS_CHILDEDGE
 Pita memiliki tepi di bagian atas dan bawah jendela anak.
RBBS_FIXEDBMP
 Bitmap latar belakang tidak bergerak ketika pita diubah ukurannya.
RBBS_FIXEDSIZE
 Band tidak bisa berukuran. Dengan gaya ini, pegangan ukuran tidak ditampilkan pada band.
RBBS_GRIPPERALWAYS

Versi 4.71. Band akan selalu memiliki pegangan ukuran, bahkan jika itu adalah satu-satunya band di rebar.
RBBS_HIDDEN
 Pita tidak akan terlihat.
RBBS_NOGRIPPER

Versi 4.71. Band tidak akan pernah memiliki pegangan ukuran, bahkan jika ada lebih dari satu band di rebar.
RBBS_USECHEVRON

Versi 5.80. Tampilkan tombol chevron jika pita lebih kecil dari cxIdeal.
RBBS_VARIABLEHEIGHT

Versi 4.71. Pita dapat diubah ukurannya dengan kontrol bilah ulang; cyIntegral dan cyMaxChild memengaruhi bagaimana rebar akan mengubah ukuran band.
RBBS_NOVERT
 Jangan tampilkan ketika vertikal.
RBBS_HIDETITLE
 Jaga agar judul band tetap tersembunyi.
RBBS_TOPALIGN
 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