CReBar 類別

發行項
08/04/2024

提供 Rebar 控制項配置、持續性和狀態資訊的控制列。

語法

class CReBar : public CControlBar

成員

公用方法

名稱	描述
CReBar：：AddBar	將帶狀新增至 Rebar。
CReBar：：Create	建立 Rebar 控件，並將它附加至 `CReBar` 物件。
CReBar：：GetReBarCtrl	允許直接存取基礎通用控制件。

備註

Rebar 物件可以包含各種子視窗 (通常是其他控制項)，包括編輯方塊、工具列和清單方塊。 Rebar 物件可以在指定的點陣圖上顯示其子視窗。您的應用程式可以自動調整 Rebar 的大小，或者使用者可以按下或拖曳其控制列來手動調整 Rebar 的大小。

RebarMenu 的範例。

Rebar 控件

Rebar 對象的行為與工具欄物件類似。 Rebar 會使用點選和拖曳機制來調整其頻帶的大小。 Rebar 控制項可以包含一個或多個群組列，而且每個群組列都具有移駐夾列、點陣圖、文字標籤和子視窗中的任何組合。不過，群組列不能包含一個以上的子視窗。

CReBar會使用 CReBarCtrl 類別來提供其實作。您可以透過 GetReBarCtrl 存取 Rebar 控件，以利用控件的自定義選項。如需 Rebar 控件的詳細資訊，請參閱 CReBarCtrl。如需使用 Rebar 控件的詳細資訊，請參閱使用 CReBarCtrl。

警告

Rebar 和 Rebar 控制件物件不支援 MFC 控制件列停駐。如果 CRebar::EnableDocking 呼叫，您的應用程式將會判斷提示。

繼承階層架構

CReBar

需求

標頭： afxext.h

CReBar：：AddBar

呼叫此成員函式，將帶狀新增至 Rebar。

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
要插入 Rebar 之子視窗之物件的指標 CWnd 。參考的對象必須有WS_CHILD。

lpszText
字串的指標，其中包含要出現在 Rebar 上的文字。根據預設，NULL。包含在 lpszText 中的文字不是子視窗的一部分;它位於 rebar 本身。

pbmp
要顯示在 Rebar 背景的物件指標 CBitmap 。根據預設，NULL。

dwStyle
包含要套用至 Rebar 之樣式的 DWORD。 fStyle如需樂隊樣式的完整清單，請參閱 Win32 結構 REBARBANDINFO 中的函式描述。

clrFore
COLORREF 值，表示 Rebar 的前景色彩。

clrBack
代表 Rebar 背景色彩的 COLORREF 值。

傳回值

如果成功則為非零；否則為 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

呼叫此成員函式以建立 Rebar。

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
物件的指標， CWnd 其 Windows 視窗是狀態列的父系。通常您的框架視窗。

dwCtrlStyle
Rebar 控件樣式。根據預設，RBS_BANDBORDERS，其會顯示窄線以分隔 Rebar 控件內的相鄰帶。如需樣式清單，請參閱 Windows SDK 中的 Rebar 控件樣式。

dwStyle
Rebar 視窗樣式。

nID
Rebar 的子視窗標識碼。

傳回值

如果成功則為非零；否則為 0。

範例

請參閱 CReBar：：AddBar 的範例。

CReBar：：GetReBarCtrl

此成員函式允許直接存取基礎通用控制件。

CReBarCtrl& GetReBarCtrl() const;

傳回值

CReBarCtrl 對象的參考。

備註

呼叫此成員函式，以利用自定義 Rebar 中的 Windows Rebar 通用控制項功能。當您呼叫 GetReBarCtrl時，它會將參考物件傳回至物件， CReBarCtrl 讓您可以使用任一組成員函式。

如需使用 CReBarCtrl 來自定義 Rebar 的詳細資訊，請參閱使用 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
階層架構圖表

共用方式為