鉄筋コントロールの主な目的は、子ウィンドウ、共通ダイアログ コントロール、メニュー、ツールバーなどのコンテナーとして機能することです。 このコンテインメントは、"バンド" の概念によってサポートされています。各鉄筋バンドには、グリッパー バー、ビットマップ、テキスト ラベル、および子ウィンドウの任意の組み合わせを含めることができます。
クラス CReBarCtrl には、特定の鉄筋バンドの情報を取得および操作するために使用できる多くのメンバー関数があります。
GetBandCount 鉄筋コントロール内の現在のバンドの数を取得します。
GetBandInfo 指定したバンドからの情報を使用して 、REBARBANDINFO 構造体を初期化します。 対応する SetBandInfo メンバー関数があります。
GetRect 指定したバンドの外接する四角形を取得します。
GetRowCount 鉄筋コントロール内のバンド行の数を取得します。
IDToIndex 指定したバンドのインデックスを取得します。
GetBandBorders バンドの境界線を取得します。
操作に加えて、特定の鉄筋バンドを操作できるいくつかのメンバー関数が用意されています。
InsertBand と DeleteBand は、鉄筋バンドを追加および削除します。 MinimizeBand と MaximizeBand は、特定の鉄筋バンドの現在のサイズに影響します。 MoveBand は、特定の鉄筋バンドのインデックスを変更します。 ShowBand は、鉄筋帯をユーザーに表示または非表示にします。
次の例では、ツールバー バンド (m_wndToolBar) を既存の鉄筋コントロール (m_wndReBar) に追加する方法を示します。 バンドを記述するには、 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);