CMFCReBar-Klasse

Ein CMFCReBar Objekt ist eine Steuerelementleiste, die Layout-, Persistenz- und Zustandsinformationen für Rebar-Steuerelemente bereitstellt. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CMFCReBar : public CPane

Member

Öffentliche Methoden

Hinweise

Ein CMFCReBar Objekt kann eine Vielzahl von untergeordneten Fenstern enthalten. Dazu gehören Bearbeitungsfelder, Symbolleisten und Listenfelder. Sie können die Größe der Ziehleiste programmgesteuert ändern, oder der Benutzer kann die Größe der Leiste manuell ändern, indem Sie die Ziehleiste ziehen. Sie können auch den Hintergrund eines Rebar-Objekts auf eine Bitmap Ihrer Wahl festlegen.

Ein Rebar-Objekt verhält sich ähnlich wie ein Symbolleistenobjekt. Ein Rebar-Steuerelement kann einen oder mehrere Bänder enthalten, und jedes Band kann eine Ziehelementleiste, eine Bitmap, eine Textbeschriftung und ein untergeordnetes Fenster enthalten.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCReBar -Klasse. Das Beispiel zeigt, wie Sie ein Rebar-Steuerelement erstellen und ihr einen Band hinzufügen. Das Band fungiert als interne Symbolleiste. Dieser Codeausschnitt ist Teil des Beispiels "Rebar Test".

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
}

Vererbungshierarchie

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Anforderungen

Kopfzeile: afxRebar.h

CMFCReBar::AddBar

Fügt einem Balken einen Balken hinzu.

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

Parameter

pBar
[in, out] Ein Zeiger auf das untergeordnete Fenster, das in die Leiste eingefügt werden soll. Das referenzierte Objekt muss das WS_CHILD Fensterformat aufweisen.

pszText
[in] Gibt den Text an, der auf der Rebar angezeigt werden soll. Der Text ist nicht Teil des untergeordneten Fensters. Stattdessen wird sie auf der Leiste selbst angezeigt.

Pbmp
[in, out] Gibt die Bitmap an, die im Hintergrund der Leiste angezeigt werden soll.

dwStyle
[in] Enthält die Formatvorlage, die auf das Band angewendet werden soll. Eine vollständige Liste der Bandformatvorlagen finden Sie in der Beschreibung fStyle in der ReBARBANDINFO-Struktur in der Windows SDK-Dokumentation.

clrFore
[in] Stellt die Vordergrundfarbe der Leiste dar.

clrBack
[in] Stellt die Hintergrundfarbe der Leiste dar.

Rückgabewert

TRUE, wenn das Band erfolgreich zur Leiste hinzugefügt wurde; andernfalls FALSE.

CMFCReBar::Create

Erstellt das Rebar-Steuerelement und fügt es an das CMFCReBar -Objekt an.

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

Parameter

pParentWnd
[in, out] Ein Zeiger auf das übergeordnete Fenster dieses Rebar-Steuerelements.

dwCtrlStyle
[in] Gibt die Formatvorlage für das Rebar-Steuerelement an. Der Standardstilwert ist RBS_BANDBORDERS, wodurch schmale Linien angezeigt werden, um benachbarte Bänder auf dem Rebar-Steuerelement zu trennen. Eine Liste der gültigen Formatvorlagen finden Sie in der Windows SDK-Dokumentation unter "Rebar Control Styles ".

dwStyle
[in] Das Fensterformat des Rebar-Steuerelements. Eine Liste gültiger Formatvorlagen finden Sie unter "Fensterformatvorlagen".

Nid
[in] Die ID des untergeordneten Fensters der Leiste.

Rückgabewert

TRUE, wenn die Leiste erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

CMFCReBar::GetReBarCtrl

Bietet direkten Zugriff auf CReBarCtrl das zugrunde liegende allgemeine Steuerelement für CMFCReBar Objekte.

CReBarCtrl& GetReBarCtrl() const;

Rückgabewert

Ein Verweis auf das zugrunde liegende CReBarCtrl Objekt.

Hinweise

Rufen Sie diese Methode auf, um die allgemeine Windows-Steuerungsfunktionalität beim Anpassen der Leiste zu nutzen.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

[in] bStretch
[in] bHorz

Rückgabewert

Bemerkungen

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Rückgabewert

Bemerkungen

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parameter

[in] dwDockStyle

Hinweise

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Rückgabewert

Bemerkungen

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parameter

[in] CPoint

Rückgabewert

Bemerkungen

CMFCReBar::OnToolHitTest

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

Parameter

[in] Punkt
[in] Pti

Rückgabewert

Bemerkungen

CMFCReBar::OnUpdateCmdUI

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

Parameter

[in] pTarget
[in] bDisableIfNoHndler

Hinweise

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parameter

[in] dwAlignment

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CReBarCtrl-Klasse
CPane-Klasse