Rebar コントロールの主な目的は、子ウィンドウ、ダイアログ コントロール、メニュー、ツールバーのコンテナーとして機能します。このコンテインメントは 「バンドの概念によってサポートされます」。各の Rebar バンドは、グリップ バー、ビットマップ、テキスト ラベル、子ウィンドウの組み合わせを含めることができます。
クラス CReBarCtrl に検索し、処理に使用されたの Rebar のバンドの情報できる多くのメンバー関数があります:
GetBandCount は、 Rebar コントロールの現在のバンドの数を取得します。
指定GetBandInfo はバンドからの情報で REBARBANDINFO の構造体を初期化します。SetBandInfo の対応するメンバー関数があります。
指定GetRect はバンドの外接する四角形を取得します。
GetRowCount は、 Rebar コントロールのバンドの行の数を取得します。
指定IDToIndex はバンドのインデックスを取得します。
GetBandBorders はバンドの境界線を取得します。
操作に加えて、複数のメンバー関数は、割り当てが特定の Rebar バンドを操作する付けばがあります。
InsertBand と DeleteBand は rebar のバンドを追加および削除します。MinimizeBand と MaximizeBand は、特定の Rebar のバンドの現在のサイズに影響します。MoveBand は、特定の Rebar のバンドのインデックスを変更します。ShowBand はユーザーからの Rebar バンドを表示または非表示にします。
次の例は、既存の Rebar コントロール （m_wndReBar）をツールバーの棒 （m_wndToolBar）を追加する方法を示します。バンドは rbi の構造体を初期化し、 InsertBand のメンバー関数を呼び出すことによって記述されています:
//load bitmap for toolbar background
m_RebarBitmap.LoadBitmap(IDB_BITMAP1);
//create a toolbar band
m_Toolbar1.Create(this, TBSTYLE_TRANSPARENT | TBSTYLE_FLAT);
m_Toolbar1.LoadToolBar(IDR_MAINFRAME);
REBARBANDINFO rbi = {0};
rbi.cbSize = sizeof(REBARBANDINFO);
rbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD | RBBIM_CHILDSIZE |
RBBIM_STYLE | RBBIM_TEXT;
rbi.fStyle = RBBS_GRIPPERALWAYS;
rbi.cxMinChild = 300;
rbi.cyMinChild = 50;
rbi.lpText = _T("Band #1");
rbi.cch = 7;
rbi.cx = 300;
rbi.hbmBack = (HBITMAP)m_RebarBitmap;
rbi.hwndChild = (HWND)m_Toolbar1;
m_Rebar.GetReBarCtrl().InsertBand(0, &rbi);