CReBar クラス

Rebar コントロールのレイアウト、永続性、および状態に関する情報を提供するコントロール バーです。

構文

class CReBar : public CControlBar

メンバー

パブリック メソッド

名前 説明
CReBar::AddBar 鉄筋にバンドを追加します。
CReBar::Create 鉄筋コントロールを作成し、オブジェクトに CReBar アタッチします。
CReBar::GetReBarCtrl 基になる共通コントロールへの直接アクセスを許可します。

解説

Rebar オブジェクトには、さまざまな子ウィンドウを含めることができます。通常は、エディット ボックス、ツールバー、リスト ボックスなどの他のコントロールが含まれます。 Rebar オブジェクトは、指定されたビットマップ上に子ウィンドウを表示できます。 アプリケーションで鉄筋のサイズを自動的に変更するか、グリッパー バーをクリックまたはドラッグして鉄筋のサイズを手動で変更できます。

Example of RebarMenu.

鉄筋コントロール

鉄筋オブジェクトは、ツールバー オブジェクトと同様に動作します。 鉄筋は、クリックアンドドラッグ機構を使用してバンドのサイズを変更します。 Rebar コントロールには 1 つ以上のバンドを含め、各バンドには、グリッパー バー、ビットマップ、テキスト ラベル、子ウィンドウの任意の組み合わせがあります。 ただし、バンドに複数の子ウィンドウを含めすることはできません。

CReBarは CReBarCtrl クラスを使用してその実装を提供します。 GetReBarCtrl を使用して鉄筋コントロールにアクセスして、コントロールのカスタマイズ オプションを利用できます。 鉄筋コントロールの詳細については、「 CReBarCtrl. 鉄筋コントロールの使用方法の詳細については、「CReBarCtrl の使用」を参照してください

注意事項

鉄筋および鉄筋コントロール オブジェクトは、MFC コントロール バーのドッキングをサポートしていません。 呼び出された場合 CRebar::EnableDocking 、アプリケーションはアサートします。

継承階層

CObject

CCmdTarget

CWnd

CControlBar

CReBar

必要条件

ヘッダー: afxext.h

CReBar::AddBar

このメンバー関数を呼び出して、鉄筋にバンドを追加します。

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);

パラメーター

pBar
鉄筋に CWnd 挿入する子ウィンドウであるオブジェクトへのポインター。 参照先オブジェクトにはWS_CHILDが必要です。

lpszText
鉄筋に表示するテキストを含む文字列へのポインター。 既定では NULL になります。 lpszText含まれるテキストは子ウィンドウの一部ではありません。これは鉄筋自体にあります。

pbmp
鉄筋の CBitmap 背景に表示するオブジェクトへのポインター。 既定では NULL になります。

dwStyle
鉄筋に適用するスタイルを含む DWORD。 バンド スタイルの fStyle 完全な一覧については、Win32 構造体 の REBARBANDINFO の関数の説明を参照してください。

clrFore
鉄筋の前景色を表す COLORREF 値。

clrBack
鉄筋の背景色を表す COLORREF 値。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

// 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

このメンバー関数を呼び出して鉄筋を作成します。

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);

パラメーター

pParentWnd
Windows ウィンドウが CWnd ステータス バーの親であるオブジェクトへのポインター。 通常、フレーム ウィンドウ。

dwCtrlStyle
鉄筋コントロール スタイル。 既定では、RBS_BANDBORDERSは、鉄筋コントロール内の隣接するバンドを分離するために狭い線を表示します。 スタイルの一覧については、Windows SDK の「鉄筋コントロール スタイル」を参照してください

dwStyle
鉄筋の窓スタイル。

nID
鉄筋の子ウィンドウ ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBar::AddBar例を参照してください。

CReBar::GetReBarCtrl

このメンバー関数を使用すると、基になる共通コントロールに直接アクセスできます。

CReBarCtrl& GetReBarCtrl() const;

戻り値

CReBarCtrl オブジェクトへの参照。

解説

このメンバー関数を呼び出して、鉄筋をカスタマイズする Windows 鉄筋共通コントロールの機能を利用します。 呼び出 GetReBarCtrlすと、いずれかのメンバー関数のセットを CReBarCtrl 使用できるように、オブジェクトへの参照オブジェクトが返されます。

鉄筋をカスタマイズする方法CReBarCtrlの詳細については、「CReBarCtrl の使用」を参照してください

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);

関連項目

MFC サンプル MFCIE
CControlBar Class
階層図