Kelas CReBar
Bilah kontrol yang menyediakan informasi tata letak, persistensi, dan status untuk kontrol bilah ulang.
Sintaks
class CReBar : public CControlBar
Anggota
Metode Publik
| Nama | Deskripsi |
|---|---|
| CReBar::AddBar | Menambahkan pita ke bilah ulang. |
| CReBar::Create | Membuat kontrol rebar dan melampirkannya ke CReBar objek. |
| CReBar::GetReBarctrl | Memungkinkan akses langsung ke kontrol umum yang mendasar. |
Keterangan
Objek rebar dapat berisi berbagai jendela anak, biasanya kontrol lain, termasuk kotak edit, toolbar, dan kotak daftar. Objek batang ulang dapat menampilkan jendela turunannya melalui bitmap tertentu. Aplikasi Anda dapat mengubah ukuran rebar secara otomatis, atau pengguna dapat mengubah ukuran bilah ulang secara manual dengan mengklik atau menyeret bilah gripper-nya.
Kontrol Bilah Ulang
Objek rebar berperilaku mirip dengan objek toolbar. Bilah ulang menggunakan mekanisme klik dan seret untuk mengubah ukuran pitanya. Kontrol rebar dapat berisi satu atau beberapa pita, dengan setiap pita memiliki kombinasi bilah gripper, bitmap, label teks, dan jendela anak. Namun, pita tidak boleh berisi lebih dari satu jendela anak.
CReBarmenggunakan kelas CReBarCtrl untuk menyediakan implementasinya. Anda dapat mengakses kontrol rebar melalui GetReBarCtrl untuk memanfaatkan opsi kustomisasi kontrol. Untuk informasi selengkapnya tentang kontrol rebar, lihat CReBarCtrl. Untuk informasi selengkapnya tentang menggunakan kontrol bilah ulang, lihat Menggunakan CReBarCtrl.
Perhatian
Objek kontrol bilah ulang dan bilah ulang tidak mendukung dok bilah kontrol MFC. Jika CRebar::EnableDocking dipanggil, aplikasi Anda akan menegaskan.
Hierarki Warisan
CReBar
Persyaratan
Header: afxext.h
CReBar::AddBar
Panggil fungsi anggota ini untuk menambahkan pita ke bilah ulang.
BOOL AddBar(
CWnd* pBar,
LPCTSTR pszText = NULL,
CBitmap* pbmp = NULL,
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP);
BOOL AddBar(
CWnd* pBar,
COLORREF clrFore,
COLORREF clrBack,
LPCTSTR pszText = NULL,
DWORD dwStyle = RBBS_GRIPPERALWAYS);
Parameter
pBar
Penunjuk ke CWnd objek yang merupakan jendela anak yang akan dimasukkan ke dalam bilah ulang. Objek yang dirujuk harus memiliki WS_CHILD.
lpszText
Penunjuk ke string yang berisi teks untuk muncul di rebar. NULL secara default. Teks yang terkandung dalam lpszText bukan bagian dari jendela anak; teks berada di rebar itu sendiri.
pbmp
Penunjuk ke objek yang CBitmap akan ditampilkan di latar belakang batang ulang. NULL secara default.
dwStyle
DWORD yang berisi gaya untuk diterapkan ke rebar. fStyle Lihat deskripsi fungsi dalam struktur Win32 REBARBANDINFO untuk daftar lengkap gaya pita.
clrFore
Nilai COLORREF yang mewakili warna latar depan bilah ulang.
clrBack
Nilai COLORREF yang mewakili warna latar belakang bilah ulang.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
Contoh
// Define a CRebar in your class definition,
// such as: CReBar m_wndReBar;
m_wndReBar.Create(this);
m_wndDlgBar.Create(this, IDD_DIALOGBAR, CBRS_ALIGN_TOP,
IDD_DIALOGBAR);
m_wndReBar.AddBar(&m_wndDlgBar);
CReBar::Create
Panggil fungsi anggota ini untuk membuat bilah ulang.
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwCtrlStyle = RBS_BANDBORDERS,
DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_TOP,
UINT nID = AFX_IDW_REBAR);
Parameter
pParentWnd
Penunjuk ke CWnd objek yang jendela Windows-nya adalah induk bilah status. Biasanya jendela bingkai Anda.
dwCtrlStyle
Gaya kontrol rebar. Secara default, RBS_BANDBORDERS, yang menampilkan garis sempit untuk memisahkan pita yang berdekatan dalam kontrol bilah ulang. Lihat Gaya Kontrol Bilah Ulang di Windows SDK untuk daftar gaya.
dwStyle
Gaya jendela bilah ulang.
Nid
ID jendela anak rebar.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
Contoh
Lihat contoh untuk CReBar::AddBar.
CReBar::GetReBarctrl
Fungsi anggota ini memungkinkan akses langsung ke kontrol umum yang mendasar.
CReBarCtrl& GetReBarCtrl() const;
Tampilkan Nilai
Referensi ke objek CReBarCtrl .
Keterangan
Panggil fungsi anggota ini untuk memanfaatkan fungsionalitas kontrol umum rebar Windows dalam menyesuaikan bilah ulang Anda. Saat Anda memanggil GetReBarCtrl, ini mengembalikan objek referensi ke CReBarCtrl objek sehingga Anda dapat menggunakan salah satu set fungsi anggota.
Untuk informasi selengkapnya tentang menggunakan CReBarCtrl untuk mengkustomisasi rebar Anda, lihat Menggunakan CReBarCtrl.
Contoh
CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);