Kelas CReBarctrl

Artikel
10/12/2023

Merangkum fungsionalitas kontrol rebar, yang merupakan kontainer untuk jendela anak.

Sintaks

class CReBarCtrl : public CWnd

Anggota

Konstruktor Publik

Nama	Deskripsi
CReBarctrl::CReBarctrl	Membuat `CReBarCtrl` objek.

Metode Publik

Nama	Deskripsi
CReBarCtrl::BeginDrag	Tempatkan kontrol bilah ulang ke mode seret dan letakkan.
CReBarctrl::Create	Membuat kontrol rebar dan melampirkannya ke `CReBarCtrl` objek.
CReBarctrl::CreateEx	Membuat kontrol bilah-ulang dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke `CReBarCtrl` objek.
CReBarCtrl::D eleteBand	Menghapus pita dari kontrol bilah ulang.
CReBarCtrl::D ragMove	Memperbarui posisi seret di kontrol rebar setelah panggilan ke `BeginDrag`.
CReBarCtrl::EndDrag	Mengakhiri operasi seret dan letakkan kontrol rebar.
CReBarCtrl::GetBandBorders	Mengambil batas pita.
CReBarCtrl::GetBandCount	Mengambil jumlah pita yang saat ini berada di kontrol rebar.
CReBarCtrl::GetBandInfo	Mengambil informasi tentang pita tertentu dalam kontrol rebar.
CReBarCtrl::GetBandMargins	Mengambil margin pita.
CReBarctrl::GetBarHeight	Mengambil tinggi kontrol rebar.
CReBarctrl::GetBarInfo	Mengambil informasi tentang kontrol rebar dan daftar gambar yang digunakannya.
CReBarCtrl::GetBkColor	Mengambil warna latar belakang default kontrol rebar.
CReBarCtrl::GetColorScheme	Mengambil struktur COLORSCHEME yang terkait dengan kontrol bilah ulang.
CReBarCtrl::GetDropTarget	Mengambil penunjuk `IDropTarget` antarmuka kontrol rebar.
CReBarCtrl::GetExtendedStyle	Mendapatkan gaya yang diperluas dari kontrol rebar saat ini.
CReBarctrl::GetImageList	Mengambil daftar gambar yang terkait dengan kontrol bilah ulang.
CReBarctrl::GetPalette	Mengambil palet kontrol rebar saat ini.
CReBarctrl::GetRect	Mengambil persegi panjang pembatas untuk pita tertentu dalam kontrol bilah ulang.
CReBarctrl::GetRowCount	Mengambil jumlah baris pita dalam kontrol bilah ulang.
CReBarctrl::GetRowHeight	Mengambil tinggi baris yang ditentukan dalam kontrol bilah ulang.
CReBarCtrl::GetTextColor	Mengambil warna teks default kontrol rebar.
CReBarCtrl::GetToolTips	Mengambil handel ke kontrol tip alat apa pun yang terkait dengan kontrol rebar.
CReBarctrl::Hittest	Menentukan bagian mana dari band rebar pada titik tertentu di layar, jika ada band rebar pada saat itu.
CReBarCtrl::IDToIndex	Mengonversi pengidentifikasi pita (ID) ke indeks pita dalam kontrol bilah ulang.
CReBarCtrl::InsertBand	Menyisipkan pita baru dalam kontrol bilah-ulang.
CReBarCtrl::MaximizeBand	Mengubah ukuran pita dalam kontrol rebar ke ukuran terbesarnya.
CReBarCtrl::MinimizeBand	Mengubah ukuran pita dalam kontrol rebar ke ukuran terkecilnya.
CReBarCtrl::MoveBand	Memindahkan pita dari satu indeks ke indeks lainnya.
CReBarCtrl::P ushChevron	Secara terprogram mendorong chevron.
CReBarCtrl::RestoreBand	Mengubah ukuran pita dalam kontrol rebar ke ukuran idealnya.
CReBarCtrl::SetBandInfo	Mengatur karakteristik pita yang ada dalam kontrol bilah ulang.
CReBarCtrl::SetBandWidth	Mengatur lebar pita yang ditambatkan yang ditentukan dalam kontrol bilah-ulang saat ini.
CReBarctrl::SetBarInfo	Mengatur karakteristik kontrol rebar.
CReBarCtrl::SetBkColor	Mengatur warna latar belakang default kontrol rebar.
CReBarCtrl::SetColorScheme	Mengatur skema warna untuk tombol pada kontrol bilah ulang.
CReBarCtrl::SetExtendedStyle	Mengatur gaya yang diperluas untuk kontrol bilah-ulang saat ini.
CReBarctrl::SetImageList	Mengatur daftar gambar kontrol rebar.
CReBarctrl::SetOwner	Mengatur jendela pemilik kontrol rebar.
CReBarctrl::SetPalette	Mengatur palet kontrol rebar saat ini.
CReBarCtrl::SetTextColor	Mengatur warna teks default kontrol rebar.
CReBarCtrl::SetToolTips	Mengaitkan kontrol tips alat dengan kontrol rebar.
CReBarCtrl::SetWindowTheme	Mengatur gaya visual kontrol bilah ulang.
CReBarCtrl::ShowBand	Menampilkan atau menyembunyikan pita tertentu dalam kontrol bilah-ulang.
CReBarctrl::SizeToRect	Cocok dengan kontrol rebar ke persegi panjang tertentu.

Keterangan

Aplikasi tempat kontrol rebar berada menetapkan jendela anak yang terkandung oleh kontrol rebar ke band rebar. Jendela anak biasanya merupakan kontrol umum lainnya.

Kontrol bilah ulang berisi satu atau beberapa pita. Setiap pita dapat berisi kombinasi bilah gripper, bitmap, label teks, dan jendela anak. Pita hanya dapat berisi satu dari masing-masing item ini.

Kontrol bilah-ulang dapat menampilkan jendela anak di atas bitmap latar belakang tertentu. Semua pita kontrol rebar dapat diubah ukurannya, kecuali yang menggunakan gaya RBBS_FIXEDSIZE. Saat Anda memposisikan ulang atau mengubah ukuran band kontrol rebar, kontrol rebar mengelola ukuran dan posisi jendela anak yang ditetapkan ke pita tersebut. Untuk mengubah ukuran atau mengubah urutan pita dalam kontrol, klik dan seret bilah gripper pita.

Ilustrasi berikut menunjukkan kontrol rebar yang memiliki tiga pita:

Pita 0 berisi kontrol toolbar datar dan transparan.
Pita 1 berisi tombol dropdown standar transparan dan transparan.
Pita 2 berisi kotak kombo dan empat tombol standar.

Kontrol bilah ulang

Dukungan kontrol bilah ulang:

Daftar gambar.
Penanganan pesan.
Fungsionalitas gambar kustom.
Berbagai gaya kontrol selain gaya jendela standar. Untuk daftar gaya ini, lihat Gaya Kontrol Bilah Ulang di Windows SDK.

Untuk informasi selengkapnya, lihat Menggunakan CReBarCtrl.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CReBarCtrl

Persyaratan

Header: afxcmn.h

CReBarCtrl::BeginDrag

Menerapkan perilaku pesan Win32 RB_BEGINDRAG, seperti yang dijelaskan di Windows SDK.

void BeginDrag(
    UINT uBand,
    DWORD dwPos = (DWORD)-1);

Parameter

uBand
Indeks berbasis nol dari pita yang akan dipengaruhi oleh operasi seret dan letakkan.

dwPos
Nilai DWORD yang berisi koordinat mouse awal. Koordinat horizontal terkandung dalam LOWORD dan koordinat vertikal terkandung dalam HIWORD. Jika Anda lulus (DWORD)-1, kontrol rebar akan menggunakan posisi mouse terakhir kali utas kontrol dipanggil GetMessage atau PeekMessage.

CReBarctrl::Create

Membuat kontrol rebar dan melampirkannya ke CReBarCtrl objek.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Menentukan kombinasi gaya kontrol bilah-ulang yang diterapkan ke kontrol. Lihat Gaya Kontrol Bilah Ulang di Windows SDK untuk daftar gaya yang didukung.

rect
Referensi ke objek CRect atau struktur RECT , yang merupakan posisi dan ukuran kontrol rebar.

pParentWnd
Penunjuk ke objek CWnd yang merupakan jendela induk kontrol bilah ulang. Ini tidak boleh NULL.

Nid
Menentukan ID kontrol kontrol rebar.

Tampilkan Nilai

Bukan nol jika objek berhasil dibuat; jika tidak, 0.

Keterangan

Buat kontrol rebar dalam dua langkah:

Panggil CReBarCtrl untuk membuat CReBarCtrl objek.
Panggil fungsi anggota ini, yang membuat kontrol rebar Windows dan melampirkannya ke CReBarCtrl objek.

Saat Anda memanggil Create, kontrol umum diinisialisasi.

Contoh

CReBarCtrl *pReBarCtrl = new CReBarCtrl();
CRect rect;
GetWindowRect(rect);
pReBarCtrl->Create(RBS_BANDBORDERS, rect, this, AFX_IDW_REBAR);

// Use ReBar Control.

delete pReBarCtrl;

CReBarctrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CReBarCtrl objek.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat parameter dwExStyle untuk CreateWindowEx di Windows SDK.

dwStyle
Menentukan kombinasi gaya kontrol bilah-ulang yang diterapkan ke kontrol. Untuk daftar gaya yang didukung, lihat Gaya Kontrol Bilah Ulang di Windows SDK.

rect
Referensi ke struktur RECT yang menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien pParentWnd.

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

Nid
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Gunakan CreateEx alih-alih Buat untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface gaya windows yang diperluas WS_EX_.

CReBarctrl::CReBarctrl

CReBarCtrl Membuat objek.

CReBarCtrl();

Contoh

Lihat contoh untuk CReBarCtrl::Create.

CReBarCtrl::D eleteBand

Menerapkan perilaku pesan Win32 RB_DELETEBAND, seperti yang dijelaskan di Windows SDK.

BOOL DeleteBand(UINT uBand);

Parameter

uBand
Indeks berbasis nol dari pita yang akan dihapus.

Tampilkan Nilai

Bukan nol jika pita berhasil dihapus; jika tidak, nol.

Contoh

UINT nCount = m_wndReBar.GetReBarCtrl().GetBandCount();

if (nCount > 0)
   m_wndReBar.GetReBarCtrl().DeleteBand(nCount - 1);

CReBarCtrl::D ragMove

Menerapkan perilaku pesan Win32 RB_DRAGMOVE, seperti yang dijelaskan di Windows SDK.

void DragMove(DWORD dwPos = (DWORD)-1);

Parameter

dwPos
Nilai DWORD yang berisi koordinat mouse baru. Koordinat horizontal terkandung dalam LOWORD dan koordinat vertikal terkandung dalam HIWORD. Jika Anda lulus (DWORD)-1, kontrol rebar akan menggunakan posisi mouse terakhir kali utas kontrol dipanggil GetMessage atau PeekMessage.

CReBarCtrl::EndDrag

Menerapkan perilaku pesan Win32 RB_ENDDRAG, seperti yang dijelaskan di Windows SDK.

void EndDrag();

CReBarCtrl::GetBandBorders

Menerapkan perilaku pesan Win32 RB_GETBANDBORDERS, seperti yang dijelaskan di Windows SDK.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parameter

uBand
Indeks berbasis nol dari pita tempat batas akan diambil.

Rrc
Penunjuk ke struktur RECT yang akan menerima batas pita. Jika kontrol rebar memiliki gaya RBS_BANDBORDERS, setiap anggota struktur ini akan menerima jumlah piksel, di sisi pita yang sesuai, yang merupakan batas. Jika kontrol rebar tidak memiliki gaya RBS_BANDBORDERS, hanya anggota kiri struktur ini yang menerima informasi yang valid. Untuk deskripsi gaya kontrol bilah ulang, lihat Gaya Kontrol Bilah Ulang di Windows SDK.

CReBarCtrl::GetBandCount

Menerapkan perilaku pesan Win32 RB_GETBANDCOUNT, seperti yang dijelaskan di Windows SDK.

UINT GetBandCount() const;

Tampilkan Nilai

Jumlah pita yang ditetapkan ke kontrol.

CReBarCtrl::GetBandInfo

Menerapkan perilaku pesan Win32 RB_GETBANDINFO seperti yang dijelaskan di Windows SDK.

BOOL GetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi) const;

Parameter

uBand
Indeks berbasis nol dari pita tempat informasi akan diambil.

prbbi
Pointer ke struktur REBARBANDINFO untuk menerima informasi band. Anda harus mengatur cbSize anggota struktur ini ke sizeof(REBARBANDINFO) dan mengatur fMask anggota ke item yang ingin Anda ambil sebelum mengirim pesan ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CReBarCtrl::GetBandMargins

Mengambil margin pita.

void GetBandMargins(PMARGINS pMargins);

Parameter

pMargins
Penunjuk ke struktur MARGINSyang akan menerima informasi.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas pesan RB_GETBANDMARGINS , seperti yang dijelaskan di Windows SDK.

CReBarctrl::GetBarHeight

Mengambil tinggi bilah batang rebar.

UINT GetBarHeight() const;

Tampilkan Nilai

Nilai yang mewakili tinggi, dalam piksel, kontrol.

CReBarctrl::GetBarInfo

Menerapkan perilaku pesan Win32 RB_GETBARINFO, seperti yang dijelaskan di Windows SDK.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parameter

prbi
Pointer ke struktur REBARINFO yang akan menerima informasi kontrol rebar. Anda harus mengatur anggota cbSize dari struktur ini sebelum sizeof(REBARINFO) mengirim pesan ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CReBarCtrl::GetBkColor

Menerapkan perilaku pesan Win32 RB_GETBKCOLOR, seperti yang dijelaskan di Windows SDK.

COLORREF GetBkColor() const;

Tampilkan Nilai

Nilai COLORREF yang mewakili warna latar belakang default saat ini.

CReBarCtrl::GetColorScheme

Mengambil struktur COLORSCHEME untuk kontrol bilah ulang.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parameter

lpcs
Penunjuk ke struktur COLORSCHEME , seperti yang dijelaskan dalam Windows SDK.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Struktur COLORSCHEME mencakup warna sorotan tombol dan warna bayangan tombol.

CReBarCtrl::GetDropTarget

Menerapkan perilaku pesan Win32 RB_GETDROPTARGET, seperti yang dijelaskan di Windows SDK.

IDropTarget* GetDropTarget() const;

Tampilkan Nilai

Penunjuk ke antarmuka IDropTarget .

CReBarCtrl::GetExtendedStyle

Mendapatkan gaya yang diperluas dari kontrol rebar saat ini.

DWORD GetExtendedStyle() const;

Tampilkan Nilai

Kombinasi bitwise (OR) bendera yang menunjukkan gaya yang diperluas. Bendera yang mungkin RBS_EX_SPLITTER dan RBS_EX_TRANSPARENT. Untuk informasi selengkapnya, lihat parameter dwMask dari metode CReBarCtrl::SetExtendedStyle .

Keterangan

Metode ini mengirim pesan RB_GETEXTENDEDSTYLE , yang dijelaskan dalam Windows SDK.

CReBarctrl::GetImageList

Mendapatkan objek yang CImageList terkait dengan kontrol rebar.

CImageList* GetImageList() const;

Tampilkan Nilai

Penunjuk ke objek CImageList . Mengembalikan NULL jika tidak ada daftar gambar yang diatur untuk kontrol.

Keterangan

Fungsi anggota ini menggunakan informasi ukuran dan masker yang disimpan dalam struktur REBARINFO , seperti yang dijelaskan dalam Windows SDK.

CReBarctrl::GetPalette

Mengambil palet kontrol rebar saat ini.

CPalette* GetPalette() const;

Tampilkan Nilai

Penunjuk ke objek CPalette yang menentukan palet kontrol rebar saat ini.

Keterangan

Perhatikan bahwa fungsi anggota ini menggunakan CPalette objek sebagai nilai pengembaliannya, bukan HPALETTE.

Contoh

CPalette *pPalette = m_wndReBar.GetReBarCtrl().GetPalette();
if (pPalette)
{
   int nEntries = pPalette->GetEntryCount();
   CString msg;
   msg.Format(_T("Number of palette entries: %d"), nEntries);
   AfxMessageBox(msg);
}
else
{
   AfxMessageBox(_T("No palette!"));
}

CReBarctrl::GetRect

Menerapkan perilaku pesan Win32 RB_GETRECT, seperti yang dijelaskan di Windows SDK.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parameter

uBand
Indeks berbasis nol dari pita dalam kontrol rebar.

Rrc
Penunjuk ke struktur RECT yang akan menerima batas pita rebar.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Contoh

CRect rc;
m_wndReBar.GetReBarCtrl().GetRect(0, &rc);
CString msg;
msg.Format(_T("rect.left = %d, rect.top = %d, ")
           _T("rect.right = %d, rect.bottom = %d"),
           rc.left,
           rc.top, rc.right, rc.bottom);
AfxMessageBox(msg);

CReBarctrl::GetRowCount

Menerapkan perilaku pesan Win32 RB_GETROWCOUNT, seperti yang dijelaskan di Windows SDK.

UINT GetRowCount() const;

Tampilkan Nilai

Nilai UINT yang menunjukkan jumlah baris pita dalam kontrol.

Contoh

UINT nRowCount = m_wndReBar.GetReBarCtrl().GetRowCount();
CString msg;
msg.Format(_T("Row Count is %d"), nRowCount);
AfxMessageBox(msg);

CReBarctrl::GetRowHeight

Menerapkan perilaku pesan Win32 RB_GETROWHEIGHT, seperti yang dijelaskan di Windows SDK.

UINT GetRowHeight(UINT uRow) const;

Parameter

URow
Indeks berbasis nol dari pita yang akan mengambil tingginya.

Tampilkan Nilai

Nilai UINT yang mewakili tinggi baris, dalam piksel.

Contoh

int nCount = m_wndReBar.GetReBarCtrl().GetRowCount();
for (int i = 0; i < nCount; i++)
{
   UINT nHeight = m_wndReBar.GetReBarCtrl().GetRowHeight(i);
   CString msg;
   msg.Format(_T("Height of row %d is %u"), i, nHeight);
   AfxMessageBox(msg);
}

CReBarCtrl::GetTextColor

Menerapkan perilaku pesan Win32 RB_GETTEXTCOLOR, seperti yang dijelaskan di Windows SDK.

COLORREF GetTextColor() const;

Tampilkan Nilai

Nilai COLORREF yang mewakili warna teks default saat ini.

CReBarCtrl::GetToolTips

Menerapkan perilaku pesan Win32 RB_GETTOOLTIPS, seperti yang dijelaskan di Windows SDK.

CToolTipCtrl* GetToolTips() const;

Tampilkan Nilai

Penunjuk ke objek CToolTipCtrl .

Keterangan

Perhatikan bahwa implementasi GetToolTips MFC mengembalikan pointer ke CToolTipCtrl, bukan HWND.

CReBarctrl::Hittest

Menerapkan perilaku pesan Win32 RB_HITTEST, seperti yang dijelaskan di Windows SDK.

int HitTest(RBHITTESTINFO* prbht);

Parameter

prbht
Penunjuk ke struktur RBHITTESTINFO . Sebelum mengirim pesan, pt anggota struktur ini harus diinisialisasi ke titik yang akan diuji, dalam koordinat klien.

Tampilkan Nilai

Indeks berbasis nol dari pita pada titik tertentu, atau -1 jika tidak ada band rebar pada titik tersebut.

CReBarCtrl::IDToIndex

Menerapkan perilaku pesan Win32 RB_IDTOINDEX, seperti yang dijelaskan di Windows SDK.

int IDToIndex(UINT uBandID) const;

Parameter

uBandID
Pengidentifikasi yang ditentukan aplikasi dari pita yang ditentukan, diteruskan dalam wID anggota struktur REBARBANDINFO saat pita dimasukkan.

Tampilkan Nilai

Indeks band berbasis nol jika berhasil, atau -1 sebaliknya. Jika indeks pita duplikat ada, indeks pertama dikembalikan.

CReBarCtrl::InsertBand

Menerapkan perilaku pesan Win32 RB_INSERTBAND, seperti yang dijelaskan di Windows SDK.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parameter

uIndex
Indeks berbasis nol dari lokasi tempat pita akan disisipkan. Jika Anda mengatur parameter ini ke -1, kontrol akan menambahkan band baru di lokasi terakhir.

prbbi
Penunjuk ke struktur REBARBANDINFO yang menentukan pita yang akan disisipkan. Anda harus mengatur anggota cbSize dari struktur ini sebelum sizeof(REBARBANDINFO) memanggil fungsi ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Contoh

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
             RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
             RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
             RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);

CReBarCtrl::MaximizeBand

Mengubah ukuran pita dalam kontrol rebar ke ukuran terbesarnya.

void MaximizeBand(UINT uBand);

Parameter

uBand
Indeks berbasis nol dari pita yang akan dimaksimalkan.

Keterangan

Menerapkan perilaku pesan Win32 RB_MAXIMIZEBAND dengan fIdeal diatur ke 0, seperti yang dijelaskan dalam Windows SDK.

Contoh

CReBarCtrl& refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MaximizeBand(i);

CReBarCtrl::MinimizeBand

Mengubah ukuran pita dalam kontrol rebar ke ukuran terkecilnya.

void MinimizeBand(UINT uBand);

Parameter

uBand
Indeks berbasis nol dari pita yang akan diminimalkan.

Keterangan

Menerapkan perilaku pesan Win32 RB_MINIMIZEBAND, seperti yang dijelaskan di Windows SDK.

Contoh

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MinimizeBand(i);

CReBarCtrl::MoveBand

Menerapkan perilaku pesan Win32 RB_MOVEBAND, seperti yang dijelaskan di Windows SDK.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parameter

uFrom
Indeks berbasis nol dari pita yang akan dipindahkan.

uTo
Indeks berbasis nol dari posisi pita baru. Nilai parameter ini tidak boleh lebih besar dari jumlah pita dikurangi satu. Untuk mendapatkan jumlah band, hubungi GetBandCount.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CReBarCtrl::P ushChevron

Menerapkan perilaku pesan Win32 RB_PUSHCHEVRON, seperti yang dijelaskan di Windows SDK.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parameter

uBand
Indeks berbasis nol dari band yang chevron-nya akan didorong.

lAppValue
Aplikasi mendefinisikan nilai 32-bit. Lihat lAppValue di RB_PUSHCHEVRON di Windows SDK.

CReBarCtrl::RestoreBand

Mengubah ukuran pita dalam kontrol rebar ke ukuran idealnya.

void RestoreBand(UINT uBand);

Parameter

uBand
Indeks berbasis nol dari pita yang akan dimaksimalkan.

Keterangan

Menerapkan perilaku pesan Win32 RB_MAXIMIZEBAND dengan fIdeal diatur ke 1, seperti yang dijelaskan dalam Windows SDK.

Contoh

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.RestoreBand(i);

CReBarCtrl::SetBandInfo

Menerapkan perilaku pesan Win32 RB_SETBANDINFO, seperti yang dijelaskan di Windows SDK.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parameter

uBand
Indeks berbasis nol dari pita untuk menerima pengaturan baru.

prbbi
Penunjuk ke struktur REBARBANDINFO yang menentukan pita yang akan disisipkan. Anda harus menyetel cbSize anggota struktur ini sebelum sizeof(REBARBANDINFO) mengirim pesan ini.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Contoh

int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}

CReBarCtrl::SetBandWidth

Mengatur lebar pita yang ditambatkan yang ditentukan dalam kontrol bilah-ulang saat ini.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parameter

uBand
[di] Indeks berbasis nol dari band rebar.

cxWidth
[di] Lebar baru pita rebar, dalam piksel.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak, FALSE.

Keterangan

Metode ini mengirim pesan RB_SETBANDWIDTH , yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode pertama mendefinisikan variabel, m_rebar, yang digunakan untuk mengakses kontrol rebar saat ini. Variabel ini digunakan dalam contoh berikutnya.

public:
CReBarCtrl m_rebar;
BOOL bRet;
static const int TOTAL_BANDS = 5;
static const int BUFFER_SIZE = 10;

Contoh kode berikutnya mengatur setiap pita rebar menjadi lebar yang sama.

// Set the width of each band.
m_rebar.GetClientRect(&rect);
int iWidth = rect.Width() / TOTAL_BANDS;
for (int iIndex = 0; iIndex < TOTAL_BANDS; iIndex++)
   bRet = m_rebar.SetBandWidth(iIndex, iWidth);

CReBarctrl::SetBarInfo

Menerapkan perilaku pesan Win32 RB_SETBARINFO, seperti yang dijelaskan di Windows SDK.

BOOL SetBarInfo(REBARINFO* prbi);

Parameter

prbi
Penunjuk ke struktur REBARINFO yang berisi informasi yang akan diatur. Anda harus mengatur cbSize anggota struktur ini sebelum sizeof(REBARINFO) mengirim pesan ini

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Contoh

REBARINFO rbi = {0};
rbi.cbSize = sizeof(REBARINFO);
rbi.fMask = 0;
rbi.himl = 0;
m_wndReBar.GetReBarCtrl().SetBarInfo(&rbi);

CReBarCtrl::SetBkColor

Menerapkan perilaku pesan Win32 RB_SETBKCOLOR, seperti yang dijelaskan di Windows SDK.

COLORREF SetBkColor(COLORREF clr);

Parameter

Clr
Nilai COLORREF yang mewakili warna latar belakang default baru.

Tampilkan Nilai

Nilai COLORREF yang mewakili warna latar belakang default sebelumnya.

Keterangan

Lihat topik ini untuk informasi selengkapnya tentang kapan harus mengatur warna latar belakang, dan cara mengatur default.

CReBarCtrl::SetColorScheme

Mengatur skema warna untuk tombol pada kontrol bilah ulang.

void SetColorScheme(const COLORSCHEME* lpcs);

Parameter

lpcs
Penunjuk ke struktur COLORSCHEME , seperti yang dijelaskan dalam Windows SDK.

Keterangan

Struktur COLORSCHEME mencakup warna sorotan tombol dan warna bayangan tombol.

CReBarCtrl::SetExtendedStyle

Mengatur gaya yang diperluas untuk kontrol bilah-ulang saat ini.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parameter

dwMask
[di] Kombinasi bitwise (OR) bendera yang menentukan bendera mana dalam parameter dwStyleEx yang berlaku. Gunakan satu atau beberapa nilai berikut:

RBS_EX_SPLITTER: Secara default, tampilkan pemisah di bagian bawah dalam mode horizontal, dan di sebelah kanan dalam mode vertikal.
RBS_EX_TRANSPARENT: Teruskan pesan WM_ERASEBKGND ke jendela induk.

dwStyleEx
[di] Kombinasi bitwise (OR) bendera yang menentukan gaya yang akan diterapkan. Untuk mengatur gaya, tentukan bendera yang sama yang digunakan dalam parameter dwMask . Untuk mengatur ulang gaya, tentukan nol biner.

Tampilkan Nilai

Gaya yang diperluas sebelumnya.

Keterangan

Metode ini mengirim pesan RB_SETEXTENDEDSTYLE , yang dijelaskan dalam Windows SDK.

CReBarctrl::SetImageList

Menetapkan daftar gambar ke kontrol bilah-ulang.

BOOL SetImageList(CImageList* pImageList);

Parameter

pImageList
Penunjuk ke objek CImageList yang berisi daftar gambar yang akan ditetapkan ke kontrol rebar.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CReBarctrl::SetOwner

Menerapkan perilaku pesan Win32 RB_SETPARENT, seperti yang dijelaskan di Windows SDK.

CWnd* SetOwner(CWnd* pWnd);

Parameter

pWnd
Penunjuk ke CWnd objek untuk diatur sebagai pemilik kontrol bilah ulang.

Tampilkan Nilai

Penunjuk ke objek CWnd yang merupakan pemilik kontrol rebar saat ini.

Keterangan

Perhatikan bahwa fungsi anggota ini menggunakan penunjuk ke CWnd objek untuk pemilik kontrol rebar saat ini dan yang dipilih, bukan handel ke jendela.

Catatan

Fungsi anggota ini tidak mengubah induk aktual yang diatur ketika kontrol dibuat; melainkan mengirim pesan pemberitahuan ke jendela yang Anda tentukan.

CReBarctrl::SetPalette

Menerapkan perilaku pesan Win32 RB_SETPALETTE, seperti yang dijelaskan di Windows SDK.

CPalette* SetPalette(HPALETTE hPal);

Parameter

hPal
HPALETTE yang menentukan palet baru yang akan digunakan kontrol rebar.

Tampilkan Nilai

Penunjuk ke objek CPalette yang menentukan palet sebelumnya kontrol rebar.

Keterangan

Perhatikan bahwa fungsi anggota ini menggunakan CPalette objek sebagai nilai pengembaliannya, bukan HPALETTE.

CReBarCtrl::SetTextColor

Menerapkan perilaku pesan Win32 RB_SETTEXTCOLOR, seperti yang dijelaskan di Windows SDK.

COLORREF SetTextColor(COLORREF clr);

Parameter

Clr
Nilai COLORREF yang mewakili warna teks baru dalam CReBarCtrl objek.

Tampilkan Nilai

Nilai COLORREF yang mewakili warna teks sebelumnya yang terkait dengan CReBarCtrl objek.

Keterangan

Ini disediakan untuk mendukung fleksibilitas warna teks dalam kontrol rebar.

CReBarCtrl::SetToolTips

Mengaitkan kontrol tip alat dengan kontrol rebar.

void SetToolTips(CToolTipCtrl* pToolTip);

Parameter

pToolTip
Penunjuk ke objek CToolTipCtrl

Keterangan

Anda harus menghancurkan CToolTipCtrl objek ketika Anda selesai dengannya.

CReBarCtrl::SetWindowTheme

Mengatur gaya visual kontrol bilah ulang.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Penunjuk ke string Unicode yang berisi gaya visual bilah ulang untuk diatur.

Tampilkan Nilai

Nilai yang dikembalikan tidak digunakan.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas pesan RB_SETWINDOWTHEME , seperti yang dijelaskan di Windows SDK.

CReBarCtrl::ShowBand

Menerapkan perilaku pesan Win32 RB_SHOWBAND, seperti yang dijelaskan di Windows SDK.

BOOL ShowBand(
    UINT uBand,
    BOOL fShow = TRUE);

Parameter

uBand
Indeks berbasis nol dari pita dalam kontrol rebar.

fShow
Menunjukkan apakah band harus ditampilkan atau disembunyikan. Jika nilai ini TRUE, pita akan ditampilkan. Jika tidak, band akan disembunyikan.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CReBarctrl::SizeToRect

Menerapkan perilaku pesan Win32 RB_SIZETORECT, seperti yang dijelaskan di Windows SDK.

BOOL SizeToRect(CRect& rect);

Parameter

rect
Referensi ke objek CRect yang menentukan persegi panjang tempat kontrol rebar harus berukuran.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Perhatikan bahwa fungsi anggota ini menggunakan CRect objek sebagai parameter, bukan RECT struktur.

Lihat juga

Kelas CWnd
Bagan Hierarki

Bagikan melalui

Kelas CReBarctrl

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Kontrol bilah ulang

Hierarki Warisan

Persyaratan

CReBarCtrl::BeginDrag

Parameter

CReBarctrl::Create

Parameter

Tampilkan Nilai

Keterangan

Contoh

CReBarctrl::CreateEx

Parameter

Tampilkan Nilai

Keterangan

CReBarctrl::CReBarctrl

Contoh

CReBarCtrl::D eleteBand

Parameter

Tampilkan Nilai

Contoh

CReBarCtrl::D ragMove

Parameter

CReBarCtrl::EndDrag

CReBarCtrl::GetBandBorders

Parameter

CReBarCtrl::GetBandCount

Tampilkan Nilai

CReBarCtrl::GetBandInfo

Parameter

Tampilkan Nilai

CReBarCtrl::GetBandMargins

Parameter

Keterangan

CReBarctrl::GetBarHeight

Tampilkan Nilai

CReBarctrl::GetBarInfo

Parameter

Tampilkan Nilai

CReBarCtrl::GetBkColor

Tampilkan Nilai

CReBarCtrl::GetColorScheme

Parameter

Tampilkan Nilai

Keterangan

CReBarCtrl::GetDropTarget

Tampilkan Nilai

CReBarCtrl::GetExtendedStyle

Tampilkan Nilai

Keterangan

CReBarctrl::GetImageList

Tampilkan Nilai

Keterangan

CReBarctrl::GetPalette

Tampilkan Nilai

Keterangan

Contoh

CReBarctrl::GetRect

Parameter

Tampilkan Nilai

Contoh

CReBarctrl::GetRowCount

Tampilkan Nilai

Contoh

CReBarctrl::GetRowHeight

Parameter

Tampilkan Nilai

Contoh

CReBarCtrl::GetTextColor

Tampilkan Nilai

CReBarCtrl::GetToolTips

Tampilkan Nilai

Keterangan

CReBarctrl::Hittest