CMFCReBar 類別

發行項
08/04/2024

CMFCReBar對像是一個控件列，提供 Rebar 控制項的配置、持續性和狀態資訊。如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。

語法

class CMFCReBar : public CPane

成員

公用方法

名稱	描述
CMFCReBar：：AddBar	將帶狀新增至 Rebar。
CMFCReBar：：CalcFixedLayout	（覆寫 CBasePane：：CalcFixedLayout.）
CMFCReBar：：CanFloat	（覆寫 CBasePane：：CanFloat.）
CMFCReBar：：Create	建立 Rebar 控件，並將它附加至 `CMFCReBar` 物件。
CMFCReBar：：EnableDocking	（覆寫 CBasePane：：EnableDocking.）
CMFCReBar：：GetReBarBandInfoSize
CMFCReBar：：GetReBarCtrl	提供基礎 CReBarCtrl 通用控制件的直接存取權。
CMFCReBar：：OnShowControlBarMenu	（覆寫 CPane：：OnShowControlBarMenu.）
CMFCReBar：：OnToolHitTest	（覆寫 CWnd：：OnToolHitTest.）
CMFCReBar：：OnUpdateCmdUI	（覆寫 CBasePane：：OnUpdateCmdUI.）
CMFCReBar：：SetPaneAlignment	（覆寫 CBasePane：：SetPaneAlignment.）

備註

CMFCReBar物件可以包含各種子視窗。這包括編輯框、工具列和清單框。您可以以程式設計方式調整 Rebar 的大小，或者使用者可以拖曳其移入列列來手動調整 Rebar 的大小。您也可以將 Rebar 物件的背景設定為您選擇的點陣圖。

Rebar 對象的行為與工具欄物件類似。 Rebar 控制項可以包含一或多個頻帶，而且每個帶可以包含夾板列、點陣圖、文字捲標和子視窗。

範例

下例示範如何在 CMFCReBar 類別中使用各種方法。此範例示範如何建立 Rebar 控件，並將帶狀新增至該控件。頻帶會以內部工具列的形式運作。此代碼段是 Rebar 測試範例的一部分。

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

繼承階層架構

CObject
。 CCmdTarget
。 CWnd
。 CBasePane
。 CPane
\ CMFCReBar

需求

標頭： afxRebar.h

CMFCReBar：：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
[in， out]要插入 Rebar 之子視窗的指標。參考的對象必須具有 WS_CHILD 視窗樣式。

pszText
[in]指定要出現在 Rebar 上的文字。文字不是子視窗的一部分。相反地，它會顯示在 Rebar 本身。

pbmp
[in， out]指定要顯示在 Rebar 背景上的點陣圖。

dwStyle
[in]包含要套用至帶狀的樣式。如需樂隊樣式的完整清單，請參閱 fStyle Windows SDK 檔中 REBARBANDINFO 結構的描述。

clrFore
[in]代表 Rebar 的前景色彩。

clrBack
[in]表示 Rebar 的背景色彩。

傳回值

如果成功將帶狀線新增至 Rebar，則為 TRUE;否則為 FALSE。

CMFCReBar：：Create

建立 Rebar 控件，並將它附加至 CMFCReBar 物件。

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
[in， out]這個 Rebar 控件之父視窗的指標。

dwCtrlStyle
[in]指定 Rebar 控件的樣式。默認樣式值為 RBS_BANDBORDERS，其會顯示窄線以分隔 Rebar 控件上的相鄰帶。如需有效樣式的清單，請參閱 Windows SDK 檔中的 Rebar 控件樣式。

dwStyle
[in]Rebar 控件的窗口樣式。如需有效樣式的清單，請參閱視窗樣式。

nID
[in]Rebar 的子視窗標識碼。

傳回值

如果成功建立 Rebar，則為 TRUE;否則為 FALSE。

備註

CMFCReBar：：GetReBarCtrl

提供物件之基礎通用控制件的CMFCReBar直接存取CReBarCtrl權。

CReBarCtrl& GetReBarCtrl() const;

傳回值

基礎 CReBarCtrl 對象的參考。

備註

呼叫此方法，以在自定義 Rebar 時利用 Windows Rebar 通用控制項功能。

CMFCReBar：：CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

參數

[in] bStretch
[in] bHorz

傳回值

備註

CMFCReBar：：CanFloat

virtual BOOL CanFloat() const;

傳回值

備註

CMFCReBar：：EnableDocking

void EnableDocking(DWORD dwDockStyle);

參數

[in] dwDockStyle

備註

CMFCReBar：：GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

傳回值

備註

CMFCReBar：：OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

參數

[in] CPoint

傳回值

備註

CMFCReBar：：OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

參數

[in] 點
[in] pTI

傳回值

備註

CMFCReBar：：OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

參數

[in] pTarget
[in] bDisableIfNoHndler

備註

CMFCReBar：：SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

共用方式為