次の方法で共有

CReBar クラス

  • [アーティクル]

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

構文

class CReBar : public CControlBar

メンバー

パブリック メソッド

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

解説

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

鉄筋メニューの例。

鉄筋コントロール

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

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

注意事項

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

継承階層

CObject

CCmdTarget

CWnd

CControlBar

CReBar

要件

Header: 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。 バンド スタイルの完全な一覧については、Win32 構造体 REBARBANDINFO のfStyle関数の説明を参照してください。

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 の「 Rebar コントロール のスタイル 」を参照してください。

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
階層図