CReBarCtrl クラス

[アーティクル]
10/12/2023

Rebar コントロールの機能がカプセル化されています。Rebar コントロールは、子ウィンドウを含むコンテナーです。

構文

class CReBarCtrl : public CWnd

メンバー

パブリックコンストラクター

名前	説明
CReBarCtrl::CReBarCtrl	`CReBarCtrl` オブジェクトを構築します。

パブリックメソッド

名前	説明
CReBarCtrl::BeginDrag	鉄筋コントロールをドラッグアンドドロップモードにします。
CReBarCtrl::Create	鉄筋コントロールを作成し、オブジェクトに `CReBarCtrl` アタッチします。
CReBarCtrl::CreateEx	指定した Windows 拡張スタイルを使用して鉄筋コントロールを作成し、オブジェクトに `CReBarCtrl` アタッチします。
CReBarCtrl::D eleteBand	鉄筋コントロールからバンドを削除します。
CReBarCtrl::D ragMove	呼び出し後の鉄筋コントロールのドラッグ位置を更新します`BeginDrag`。
CReBarCtrl::EndDrag	鉄筋コントロールのドラッグアンドドロップ操作を終了します。
CReBarCtrl::GetBandBorders	バンドの境界線を取得します。
CReBarCtrl::GetBandCount	鉄筋コントロール内の現在のバンドの数を取得します。
CReBarCtrl::GetBandInfo	鉄筋コントロール内の指定されたバンドに関する情報を取得します。
CReBarCtrl::GetBandMargins	バンドの余白を取得します。
CReBarCtrl::GetBarHeight	鉄筋コントロールの高さを取得します。
CReBarCtrl::GetBarInfo	鉄筋コントロールおよび使用するイメージリストに関する情報を取得します。
CReBarCtrl::GetBkColor	鉄筋コントロールの既定の背景色を取得します。
CReBarCtrl::GetColorScheme	鉄筋コントロールに関連付けられている COLORSCHEME 構造体を取得します。
CReBarCtrl::GetDropTarget	鉄筋コントロールのインターフェイスポインターを `IDropTarget` 取得します。
CReBarCtrl::GetExtendedStyle	現在の鉄筋コントロールの拡張スタイルを取得します。
CReBarCtrl::GetImageList	鉄筋コントロールに関連付けられているイメージリストを取得します。
CReBarCtrl::GetPalette	鉄筋コントロールの現在のパレットを取得します。
CReBarCtrl::GetRect	鉄筋コントロール内の特定のバンドの外接する四角形を取得します。
CReBarCtrl::GetRowCount	鉄筋コントロール内のバンド行の数を取得します。
CReBarCtrl::GetRowHeight	鉄筋コントロール内の指定した行の高さを取得します。
CReBarCtrl::GetTextColor	鉄筋コントロールの既定のテキストの色を取得します。
CReBarCtrl::GetToolヒント	鉄筋コントロールに関連付けられているツールヒントコントロールのハンドルを取得します。
CReBarCtrl::HitTest	鉄筋バンドがそのポイントに存在する場合に、画面上の特定のポイントにある鉄筋バンドの部分を決定します。
CReBarCtrl::IDToIndex	帯識別子 (ID) を鉄筋コントロールのバンドインデックスに変換します。
CReBarCtrl::InsertBand	鉄筋コントロールに新しいバンドを挿入します。
CReBarCtrl::MaximizeBand	鉄筋コントロールのバンドのサイズを最大サイズに変更します。
CReBarCtrl::MinimizeBand	鉄筋コントロールのバンドのサイズを最小サイズに変更します。
CReBarCtrl::MoveBand	あるインデックスから別のインデックスにバンドを移動します。
CReBarCtrl::P ushChevron	プログラムによってシェブロンをプッシュします。
CReBarCtrl::RestoreBand	鉄筋コントロールのバンドのサイズを理想的なサイズに変更します。
CReBarCtrl::SetBandInfo	鉄筋コントロールの既存のバンドの特性を設定します。
CReBarCtrl::SetBandWidth	現在の鉄筋コントロールの指定したドッキングバンドの幅を設定します。
CReBarCtrl::SetBarInfo	鉄筋コントロールの特性を設定します。
CReBarCtrl::SetBkColor	鉄筋コントロールの既定の背景色を設定します。
CReBarCtrl::SetColorScheme	鉄筋コントロールのボタンの配色を設定します。
CReBarCtrl::SetExtendedStyle	現在の鉄筋コントロールの拡張スタイルを設定します。
CReBarCtrl::SetImageList	鉄筋コントロールのイメージリストを設定します。
CReBarCtrl::SetOwner	鉄筋コントロールの所有者ウィンドウを設定します。
CReBarCtrl::SetPalette	鉄筋コントロールの現在のパレットを設定します。
CReBarCtrl::SetTextColor	鉄筋コントロールの既定のテキストの色を設定します。
CReBarCtrl::SetToolヒント	ツールヒントコントロールを鉄筋コントロールに関連付けます。
CReBarCtrl::SetWindowTheme	鉄筋コントロールの表示スタイルを設定します。
CReBarCtrl::ShowBand	鉄筋コントロール内の特定のバンドを表示または非表示にします。
CReBarCtrl::SizeToRect	鉄筋コントロールを指定した四角形に適合させます。

解説

鉄筋コントロールが存在するアプリケーションは、鉄筋コントロールに含まれる子ウィンドウを鉄筋バンドに割り当てます。通常、子ウィンドウは別の共通コントロールです。

鉄筋コントロールには、1 つ以上のバンドが含まれています。各バンドには、グリッパーバー、ビットマップ、テキストラベル、および子ウィンドウの組み合わせを含めることができます。バンドには、これらの各項目のうち 1 つだけを含めることができます。

鉄筋コントロールは、指定された背景ビットマップ上に子ウィンドウを表示できます。 RBBS_FIXEDSIZE スタイルを使用するものを除き、すべての鉄筋コントロールバンドのサイズを変更できます。鉄筋コントロールバンドの位置を変更したり、サイズを変更したりすると、そのバンドに割り当てられた子ウィンドウのサイズと位置が、鉄筋コントロールによって管理されます。コントロール内のバンドのサイズを変更または変更するには、バンドのグリッパーバーをクリックしてドラッグします。

次の図は、3 つのバンドを持つ鉄筋コントロールを示しています。

バンド 0 には、フラットで透明なツールバーコントロールが含まれています。
バンド 1 には、透明な標準と透明の両方のドロップダウンボタンが含まれています。
バンド 2 には、コンボボックスと 4 つの標準ボタンが含まれています。

鉄筋コントロール

鉄筋コントロールのサポート:

画像リスト。
メッセージ処理。
カスタム描画機能。
標準のウィンドウスタイルに加えて、さまざまなコントロールスタイル。これらのスタイルの一覧については、「Windows SDK の鉄筋コントロールスタイル」を参照してください。

詳細については、「CReBarCtrl の使用」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CReBarCtrl

必要条件

ヘッダー: afxcmn.h

CReBarCtrl::BeginDrag

Windows SDK で説明されているように、Win32 メッセージ RB_BEGINDRAGの動作を実装します。

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

パラメーター

uBand
ドラッグアンドドロップ操作が影響を受けるバンドの 0 から始まるインデックス。

dwPos
開始マウス座標を含む DWORD 値。水平座標は LOWORD に含まれており、垂直座標は HIWORD に含まれています。 (DWORD)-1 を渡すと、鉄筋コントロールは、コントロールのスレッドが最後に呼び出 GetMessage されたとき、または PeekMessageマウスの位置を使用します。

CReBarCtrl::Create

鉄筋コントロールを作成し、オブジェクトに CReBarCtrl アタッチします。

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

パラメーター

dwStyle
コントロールに適用される鉄筋コントロールスタイルの組み合わせを指定します。サポートされているスタイルの一覧については、Windows SDK の「鉄筋コントロールスタイル」を参照してください。

rect
鉄筋コントロールの位置とサイズである CRect オブジェクトまたは RECT 構造体への参照。

pParentWnd
鉄筋コントロールの親ウィンドウである CWnd オブジェクトへのポインター。 NULL は指定できません。

nID
鉄筋コントロールのコントロール ID を指定します。

戻り値

オブジェクトが正常に作成された場合は 0 以外。それ以外の場合は 0。

解説

2 つの手順で鉄筋コントロールを作成します。

CReBarCtrl を呼び出してオブジェクトをCReBarCtrl構築します。
このメンバー関数を呼び出します。これにより、Windows 鉄筋コントロールが作成され、オブジェクトに CReBarCtrl アタッチされます。

呼び出 Createすと、共通コントロールが初期化されます。

例

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

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

コントロール (子ウィンドウ) を作成し、オブジェクトに CReBarCtrl 関連付けます。

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

パラメーター

dwExStyle
作成するコントロールの拡張スタイルを指定します。拡張 Windows スタイルの一覧については、Windows SDK の CreateWindowEx の dwExStyle パラメーターを参照してください。

rect
pParentWnd のクライアント座標における、作成するウィンドウのサイズと位置を記述する RECT 構造体への参照。

pParentWnd
コントロールの親であるウィンドウへのポインター。

nID
コントロールの子ウィンドウ ID。

戻り値

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

解説

Windows 拡張スタイルの前置WS_EX_で指定された拡張 Windows スタイルを適用するには、[作成] の代わりに使用CreateExします。

CReBarCtrl::CReBarCtrl

CReBarCtrl オブジェクトを作成します。

CReBarCtrl();

例

CReBarCtrl::Create の例を参照してください。

CReBarCtrl::D eleteBand

Windows SDK で説明されているように、Win32 メッセージ RB_DELETEBANDの動作を実装します。

BOOL DeleteBand(UINT uBand);

パラメーター

uBand
削除するバンドの 0 から始まるインデックス。

戻り値

バンドが正常に削除された場合は 0 以外。それ以外の場合は 0。

例

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

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

CReBarCtrl::D ragMove

Windows SDK で説明されているように、Win32 メッセージ RB_DRAGMOVEの動作を実装します。

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

パラメーター

dwPos
新しいマウス座標を含む DWORD 値。水平座標は LOWORD に含まれており、垂直座標は HIWORD に含まれています。 (DWORD)-1 を渡すと、鉄筋コントロールは、コントロールのスレッドが最後に呼び出 GetMessage されたとき、または PeekMessageマウスの位置を使用します。

CReBarCtrl::EndDrag

Windows SDK で説明されているように、Win32 メッセージ RB_ENDDRAGの動作を実装します。

void EndDrag();

CReBarCtrl::GetBandBorders

Windows SDK で説明されているように、Win32 メッセージ RB_GETB (テラバイト)ANDBORDERS の動作を実装します。

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

パラメーター

uBand
罫線を取得するバンドの 0 から始まるインデックス。

prc
バンド境界を受け取る RECT 構造体へのポインター。鉄筋コントロールにRBS_BANDBORDERS スタイルがある場合、この構造の各メンバーは、境界線を構成する、バンドの対応する側のピクセル数を受け取ります。鉄筋コントロールにRBS_BANDBORDERS スタイルがない場合は、この構造の左側のメンバーのみが有効な情報を受け取ります。鉄筋コントロールスタイルの説明については、Windows SDK の「鉄筋コントロールスタイル」を参照してください。

CReBarCtrl::GetBandCount

Windows SDK で説明されているように、Win32 メッセージ RB_GETB (テラバイト)ANDCOUNT の動作を実装します。

UINT GetBandCount() const;

戻り値

コントロールに割り当てられたバンドの数。

CReBarCtrl::GetBandInfo

Windows SDK で説明されているように、Win32 メッセージ RB_GETB (テラバイト)ANDINFO の動作を実装します。

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

パラメーター

uBand
情報を取得するバンドの 0 から始まるインデックス。

prbbi
バンド情報を受信する、REBARBANDINFO 構造体へのポインター。このメッセージを送信する前に、 cbSize この構造体のメンバーを sizeof(REBARBANDINFO) 設定し、取得する項目にメンバーを設定 fMask する必要があります。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBarCtrl::GetBandMargins

バンドの余白を取得します。

void GetBandMargins(PMARGINS pMargins);

パラメーター

pMargins
情報を受け取る MARGINS構造体へのポインター。

解説

このメンバー関数は、Windows SDK で説明されているように、RB_GETB (テラバイト)ANDMARGINS メッセージの機能をエミュレートします。

CReBarCtrl::GetBarHeight

鉄筋バーの高さを取得します。

UINT GetBarHeight() const;

戻り値

コントロールの高さをピクセル単位で表す値。

CReBarCtrl::GetBarInfo

Windows SDK で説明されているように、Win32 メッセージ RB_GETB (テラバイト)ARINFO の動作を実装します。

BOOL GetBarInfo(REBARINFO* prbi) const;

パラメーター

prbi
鉄筋コントロール情報を受け取る、REBARINFO 構造体へのポインター。このメッセージを送信する前に、 この構造体の cbSize メンバーを設定する sizeof(REBARINFO) 必要があります。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBarCtrl::GetBkColor

Windows SDK で説明されているように、Win32 メッセージ RB_GETB (テラバイト)KCOLOR の動作を実装します。

COLORREF GetBkColor() const;

戻り値

現在の既定の背景色を表す COLORREF 値。

CReBarCtrl::GetColorScheme

鉄筋コントロールの COLORSCHEME 構造を取得します。

BOOL GetColorScheme(COLORSCHEME* lpcs);

パラメーター

lpcs
Windows SDK で説明されている COLORSCHEME 構造体へのポインター。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

構造には COLORSCHEME 、ボタンの強調表示の色とボタンの影の色が含まれます。

CReBarCtrl::GetDropTarget

Windows SDK で説明されているように、Win32 メッセージ RB_GETDROPTARGETの動作を実装します。

IDropTarget* GetDropTarget() const;

戻り値

IDropTarget インターフェイスへのポインター。

CReBarCtrl::GetExtendedStyle

現在の鉄筋コントロールの拡張スタイルを取得します。

DWORD GetExtendedStyle() const;

戻り値

拡張スタイルを示すフラグのビットごとの組み合わせ (OR)。使用可能なフラグは、RBS_EX_SPLITTERとRBS_EX_TRANSPARENTです。詳細については、CReBarCtrl::SetExtendedStyle メソッドの dwMask パラメーターを参照してください。

解説

このメソッドは、Windows SDK で説明されているRB_GETEXTENDEDSTYLE メッセージを送信します。

CReBarCtrl::GetImageList

鉄筋コントロールに CImageList 関連付けられているオブジェクトを取得します。

CImageList* GetImageList() const;

戻り値

CImageList オブジェクトへのポインター。コントロールにイメージリストが設定されていない場合は NULL を返します。

解説

このメンバー関数は、WINDOWS SDK で説明されているように、REBARINFO 構造体に格納されているサイズとマスク情報を使用します。

CReBarCtrl::GetPalette

鉄筋コントロールの現在のパレットを取得します。

CPalette* GetPalette() const;

戻り値

鉄筋コントロールの現在のパレットを指定する CPalette オブジェクトへのポインター。

解説

このメンバー関数は、HPALETTE ではなく、戻り値としてオブジェクトを使用 CPalette することに注意してください。

例

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

Windows SDK で説明されているように、Win32 メッセージ RB_GETRECTの動作を実装します。

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

パラメーター

uBand
鉄筋コントロールのバンドの 0 から始まるインデックス。

prc
鉄筋バンドの境界を受け取る RECT 構造体へのポインター。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

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

Windows SDK で説明されているように、Win32 メッセージ RB_GETROWCOUNTの動作を実装します。

UINT GetRowCount() const;

戻り値

コントロール内のバンド行の数を表す UINT 値。

例

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

CReBarCtrl::GetRowHeight

Windows SDK で説明されているように、Win32 メッセージ RB_GETROWHEIGHTの動作を実装します。

UINT GetRowHeight(UINT uRow) const;

パラメーター

uRow
高さを取得するバンドの 0 から始まるインデックス。

戻り値

行の高さをピクセル単位で表す UINT 値。

例

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

Windows SDK で説明されているように、Win32 メッセージ RB_GETTEXTCOLORの動作を実装します。

COLORREF GetTextColor() const;

戻り値

現在の既定のテキストの色を表す COLORREF 値。

CReBarCtrl::GetToolヒント

Windows SDK で説明されているように、Win32 メッセージ RB_GETTOOLTIPSの動作を実装します。

CToolTipCtrl* GetToolTips() const;

戻り値

CToolTipCtrl オブジェクトへのポインター。

解説

MFC の実装 GetToolTips では、HWND ではなく、a CToolTipCtrlへのポインターが返されることに注意してください。

CReBarCtrl::HitTest

Windows SDK で説明されているように、Win32 メッセージ RB_HITTESTの動作を実装します。

int HitTest(RBHITTESTINFO* prbht);

パラメーター

prbht
RBHITTESTINFO 構造体へのポインター。メッセージを送信する前に pt 、この構造体のメンバーをクライアント座標でテストするポイントに初期化する必要があります。

戻り値

指定したポイントのバンドの 0 から始まるインデックス。鉄筋バンドがポイントに存在しない場合は -1。

CReBarCtrl::IDToIndex

Windows SDK で説明されているように、Win32 メッセージ RB_IDTOINDEXの動作を実装します。

int IDToIndex(UINT uBandID) const;

パラメーター

uBandID
バンドの挿入時に、指定されたバンドのアプリケーション定義識別子が、REBARBANDINFO 構造体のメンバーでwID渡されます。

戻り値

成功した場合は 0 から始まるバンドインデックス。それ以外の場合は -1。重複するバンドインデックスが存在する場合は、最初のインデックスが返されます。

CReBarCtrl::InsertBand

Windows SDK で説明されているように、Win32 メッセージ RB_INStandard Edition R TB (テラバイト)AND の動作を実装します。

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

パラメーター

uIndex
バンドが挿入される位置の 0 から始まるインデックス。このパラメーターを -1 に設定すると、コントロールは最後の場所に新しいバンドを追加します。

prbbi
挿入するバンドを定義する、REBARBANDINFO 構造体へのポインター。この関数を呼び出す前に、 この構造体の cbSize メンバーを設定する sizeof(REBARBANDINFO) 必要があります。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

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

鉄筋コントロールのバンドのサイズを最大サイズに変更します。

void MaximizeBand(UINT uBand);

パラメーター

uBand
最大化するバンドの 0 から始まるインデックス。

解説

Windows SDK で説明されているように、Win32 メッセージ RB_MAXIMIZEBAND の動作を fIdeal 0 に設定して実装します。

例

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

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

CReBarCtrl::MinimizeBand

鉄筋コントロールのバンドのサイズを最小サイズに変更します。

void MinimizeBand(UINT uBand);

パラメーター

uBand
最小化するバンドの 0 から始まるインデックス。

解説

Windows SDK で説明されているように、Win32 メッセージ RB_MINIMIZEBANDの動作を実装します。

例

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

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

CReBarCtrl::MoveBand

Windows SDK で説明されているように、Win32 メッセージ RB_MOVEBANDの動作を実装します。

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

パラメーター

uFrom
移動するバンドの 0 から始まるインデックス。

宇土
新しいバンド位置の 0 から始まるインデックス。このパラメーター値は、バンドの数から 1 を引いた値を超えてはなりません。バンドの数を取得するには、GetBandCount を呼び出します。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBarCtrl::P ushChevron

Windows SDK で説明されているように、Win32 メッセージ RB_PUSHCHEVRONの動作を実装します。

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

パラメーター

uBand
シェブロンがプッシュされるバンドの 0 から始まるインデックス。

lAppValue
アプリケーション定義の 32 ビット値。 Windows SDK の RB_PUSHCHEVRON の lAppValue を参照してください。

CReBarCtrl::RestoreBand

鉄筋コントロールのバンドのサイズを理想的なサイズに変更します。

void RestoreBand(UINT uBand);

パラメーター

uBand
最大化するバンドの 0 から始まるインデックス。

解説

Windows SDK で説明されているように、Win32 メッセージ RB_MAXIMIZEBAND の動作を fIdeal 1 に設定して実装します。

例

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

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

CReBarCtrl::SetBandInfo

Windows SDK で説明されているように、Win32 メッセージ RB_Standard EditionTB (テラバイト)ANDINFO の動作を実装します。

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

パラメーター

uBand
新しい設定を受け取るバンドの 0 から始まるインデックス。

prbbi
挿入するバンドを定義する、REBARBANDINFO 構造体へのポインター。このメッセージを送信する前に、 cbSize この構造体のメンバーを設定する sizeof(REBARBANDINFO) 必要があります。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

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

現在の鉄筋コントロールの指定したドッキングバンドの幅を設定します。

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

パラメーター

uBand
[in]鉄筋バンドの 0 から始まるインデックス。

cxWidth
[in]鉄筋バンドの新しい幅 (ピクセル単位)。

戻り値

メソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

このメソッドは、Windows SDK で説明されている RB_Standard EditionTB (テラバイト)ANDWIDTH メッセージを送信します。

例

最初のコード例では、 m_rebar現在の鉄筋コントロールにアクセスするために使用される変数を定義します。この変数は次の例で使用されています。

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

次のコード例では、各鉄筋バンドを同じ幅に設定します。

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

Windows SDK で説明されているように、Win32 メッセージ RB_Standard EditionTB (テラバイト)ARINFO の動作を実装します。

BOOL SetBarInfo(REBARINFO* prbi);

パラメーター

prbi
設定する情報を含む、REBARINFO 構造体へのポインター。このメッセージを送信する前に、 cbSize この構造体のメンバーを設定する sizeof(REBARINFO) 必要があります

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

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

CReBarCtrl::SetBkColor

Windows SDK で説明されているように、Win32 メッセージ RB_Standard EditionTB (テラバイト)KCOLOR の動作を実装します。

COLORREF SetBkColor(COLORREF clr);

パラメーター

Clr
新しい既定の背景色を表す COLORREF 値。

戻り値

前の既定の背景色を表す COLORREF 値。

解説

背景色を設定するタイミングと既定値を設定する方法の詳細については、このトピックを参照してください。

CReBarCtrl::SetColorScheme

鉄筋コントロールのボタンの配色を設定します。

void SetColorScheme(const COLORSCHEME* lpcs);

パラメーター

lpcs
Windows SDK で説明されている COLORSCHEME 構造体へのポインター。

解説

構造には COLORSCHEME 、ボタンの強調表示の色とボタンの影の色の両方が含まれています。

CReBarCtrl::SetExtendedStyle

現在の鉄筋コントロールの拡張スタイルを設定します。

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

パラメーター

Dwmask
[in]dwStyleEx パラメーターで適用されるフラグを指定するフラグのビットごとの組み合わせ (OR)。次の値のうち 1 つ以上を使用します。

RBS_EX_SPLITTER: 既定では、水平モードでは下部にスプリッターを表示し、垂直モードでは右に表示します。
RBS_EX_TRANSPARENT: WM_ERAStandard Edition BKGND メッセージを親ウィンドウに転送します。

dwStyleEx
[in]適用するスタイルを指定するフラグのビットごとの組み合わせ (OR)。スタイルを設定するには、dwMask パラメーターで使用されるのと同じフラグを指定します。スタイルをリセットするには、2 進ゼロを指定します。

戻り値

前の拡張スタイル。

解説

このメソッドは、Windows SDK で説明されている RB_Standard Edition TEXTENDEDSTYLE メッセージを送信します。

CReBarCtrl::SetImageList

イメージリストを鉄筋コントロールに割り当てます。

BOOL SetImageList(CImageList* pImageList);

パラメーター

pImageList
鉄筋コントロールに割り当てるイメージリストを含む CImageList オブジェクトへのポインター。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBarCtrl::SetOwner

Windows SDK で説明されているように、Win32 メッセージ RB_Standard Edition TPARENT の動作を実装します。

CWnd* SetOwner(CWnd* pWnd);

パラメーター

pWnd
鉄筋コントロールの CWnd 所有者として設定するオブジェクトへのポインター。

戻り値

鉄筋コントロールの現在の所有者である CWnd オブジェクトへのポインター。

解説

このメンバー関数は、ウィンドウへの CWnd ハンドルではなく、鉄筋コントロールの現在の所有者と選択した所有者の両方のオブジェクトへのポインターを使用します。

Note

このメンバー関数は、コントロールの作成時に設定された実際の親を変更しません。ではなく、指定したウィンドウに通知メッセージを送信します。

CReBarCtrl::SetPalette

Windows SDK で説明されているように、Win32 メッセージ RB_Standard Edition TPALETTE の動作を実装します。

CPalette* SetPalette(HPALETTE hPal);

パラメーター

hPal
鉄筋コントロールが使用する新しいパレットを指定する HPALETTE。

戻り値

鉄筋コントロールの前のパレットを指定する CPalette オブジェクトへのポインター。

解説

このメンバー関数は、HPALETTE ではなく、戻り値としてオブジェクトを使用 CPalette することに注意してください。

CReBarCtrl::SetTextColor

Windows SDK で説明されているように、Win32 メッセージ RB_Standard Edition TTEXTCOLOR の動作を実装します。

COLORREF SetTextColor(COLORREF clr);

パラメーター

Clr
オブジェクト内の新しいテキストの色 CReBarCtrl を表す COLORREF 値。

戻り値

解説

これは、鉄筋コントロールのテキストの色の柔軟性をサポートするために提供されます。

CReBarCtrl::SetToolヒント

ツールヒントコントロールを鉄筋コントロールに関連付けます。

void SetToolTips(CToolTipCtrl* pToolTip);

パラメーター

pToolTip
CToolTipCtrl オブジェクトへのポインター

解説

オブジェクトの処理が CToolTipCtrl 完了したら、オブジェクトを破棄する必要があります。

CReBarCtrl::SetWindowTheme

鉄筋コントロールの表示スタイルを設定します。

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

パラメーター

pszSubAppName
設定する鉄筋の表示スタイルを含む Unicode 文字列へのポインター。

戻り値

戻り値は使用されません。

解説

このメンバー関数は、Windows SDK で説明されているように、RB_Standard Edition TWINDOWTHEME メッセージの機能をエミュレートします。

CReBarCtrl::ShowBand

Windows SDK で説明されているように、Win32 メッセージ RB_SHOWBANDの動作を実装します。

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

パラメーター

uBand
鉄筋コントロールのバンドの 0 から始まるインデックス。

fShow
バンドを表示するか非表示にするかを示します。この値が TRUE の場合、バンドが表示されます。それ以外の場合、バンドは非表示になります。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CReBarCtrl::SizeToRect

Windows SDK で説明されているように、Win32 メッセージ RB_SIZETORECTの動作を実装します。

BOOL SizeToRect(CRect& rect);

パラメーター

rect
鉄筋コントロールのサイズを設定する四角形を指定する CRect オブジェクトへの参照。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

このメンバー関数は、構造体ではなく、パラメーターとしてオブジェクトをRECT使用CRectします。

CReBarCtrl クラス

構文

メンバー

パブリック コンストラクター

パブリック メソッド

解説

鉄筋コントロール

継承階層

必要条件

CReBarCtrl::BeginDrag

パラメーター

CReBarCtrl::Create

パラメーター

戻り値

解説

例

CReBarCtrl::CreateEx

パラメーター

戻り値

解説

CReBarCtrl::CReBarCtrl

例

CReBarCtrl::D eleteBand

パラメーター

戻り値

例

CReBarCtrl::D ragMove

パラメーター

CReBarCtrl::EndDrag

CReBarCtrl::GetBandBorders

パラメーター

CReBarCtrl::GetBandCount

戻り値

CReBarCtrl::GetBandInfo

パラメーター

戻り値

CReBarCtrl::GetBandMargins

パラメーター

解説

CReBarCtrl::GetBarHeight

戻り値

CReBarCtrl::GetBarInfo

パラメーター

戻り値

CReBarCtrl::GetBkColor

戻り値

CReBarCtrl::GetColorScheme

パラメーター

戻り値

解説

CReBarCtrl::GetDropTarget

戻り値

CReBarCtrl::GetExtendedStyle

戻り値

解説

CReBarCtrl::GetImageList

戻り値

解説

CReBarCtrl::GetPalette

戻り値

解説

例

CReBarCtrl::GetRect

パラメーター

戻り値

例

CReBarCtrl::GetRowCount

戻り値

例

CReBarCtrl::GetRowHeight

パラメーター

戻り値

例

CReBarCtrl::GetTextColor

戻り値

CReBarCtrl::GetToolヒント

戻り値

解説

CReBarCtrl::HitTest

パラメーター

パブリックコンストラクター

パブリックメソッド