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
| Name | Beschreibung |
|---|---|
| CMFCReBar::AddBar | Fügt einem Balken einen Balken hinzu. |
| CMFCReBar::CalcFixedLayout | (Außerkraftsetzungen CBasePane::CalcFixedLayout.) |
| CMFCReBar::CanFloat | (Außerkraftsetzungen CBasePane::CanFloat.) |
| CMFCReBar::Create | Erstellt das Rebar-Steuerelement und fügt es an das CMFCReBar Objekt an. |
| CMFCReBar::EnableDocking | (Außerkraftsetzungen CBasePane::EnableDocking.) |
| CMFCReBar::GetReBarBandInfoSize | |
| CMFCReBar::GetReBarCtrl | Bietet direkten Zugriff auf das zugrunde liegende allgemeine CReBarCtrl-Steuerelement . |
| CMFCReBar::OnShowControlBarMenu | (Außerkraftsetzungen CPane::OnShowControlBarMenu.) |
| CMFCReBar::OnToolHitTest | (Außerkraftsetzungen CWnd::OnToolHitTest.) |
| CMFCReBar::OnUpdateCmdUI | (Außerkraftsetzungen CBasePane::OnUpdateCmdUI.) |
| CMFCReBar::SetPaneAlignment | (Außerkraftsetzungen CBasePane::SetPaneAlignment.) |
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