CReBar-Klasse
Eine Steuerleiste, die Layout-, Persistenz- und Zustandsinformationen für Grundleisten-Steuerelemente bereitstellt.
Syntax
class CReBar : public CControlBar
Member
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CReBar::AddBar | Fügt einem Balken einen Balken hinzu. |
| CReBar::Create | Erstellt das Rebar-Steuerelement und fügt es an das CReBar Objekt an. |
| CReBar::GetReBarCtrl | Ermöglicht direkten Zugriff auf das zugrunde liegende allgemeine Steuerelement. |
Hinweise
Ein Rebar-Objekt kann eine Vielzahl von untergeordneten Fenstern enthalten, in der Regel andere Steuerelemente, einschließlich Bearbeitungsfelder, Symbolleisten und Listenfelder. Ein Rebar-Objekt kann seine untergeordneten Fenster über einer angegebenen Bitmap anzeigen. Ihre Anwendung kann die Größe der Leiste automatisch ändern, oder der Benutzer kann die Größe der Leiste manuell ändern, indem sie auf die Ziehleiste klicken oder ziehen.
Rebar-Steuerelement
Ein Rebar-Objekt verhält sich ähnlich wie ein Symbolleistenobjekt. Eine Leiste verwendet den Klick-und-Ziehen-Mechanismus, um die Größe der Bänder zu ändern. Ein Rebar-Steuerelement kann einen oder mehrere Bänder enthalten, wobei jedes Band eine beliebige Kombination aus einem Ziehelementbalken, einer Bitmap, einer Textbeschriftung und einem untergeordneten Fenster aufweist. Bänder dürfen jedoch nicht mehr als ein untergeordnetes Fenster enthalten.
CReBar verwendet die CReBarCtrl-Klasse , um die Implementierung bereitzustellen. Sie können über GetReBarCtrl auf das Rebar-Steuerelement zugreifen, um die Anpassungsoptionen des Steuerelements zu nutzen. Weitere Informationen zu Rebar-Steuerelementen finden Sie unter CReBarCtrl. Weitere Informationen zur Verwendung von Rebar-Steuerelementen finden Sie unter Verwenden von CReBarCtrl.
Achtung
Rebar- und Rebar-Steuerelementobjekte unterstützen das Andocken der MFC-Steuerleiste nicht. Wenn CRebar::EnableDocking sie aufgerufen wird, wird Ihre Anwendung bestätigt.
Vererbungshierarchie
CReBar
Anforderungen
Header: afxext.h
CReBar::AddBar
Rufen Sie diese Memberfunktion auf, um der Rebar ein Band hinzuzufügen.
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
Ein Zeiger auf ein CWnd Objekt, das das untergeordnete Fenster ist, das in die Leiste eingefügt werden soll. Das referenzierte Objekt muss über eine WS_CHILD verfügen.
lpszText
Ein Zeiger auf eine Zeichenfolge, die den Text enthält, der auf der Leiste angezeigt werden soll. NULL standardmäßig. Der in lpszText enthaltene Text ist nicht Teil des untergeordneten Fensters. Er befindet sich auf der Rebar selbst.
Pbmp
Ein Zeiger auf ein CBitmap Objekt, das im Hintergrund der Leiste angezeigt werden soll. NULL standardmäßig.
dwStyle
Ein DWORD mit der Formatvorlage, die auf die Leiste angewendet werden soll. Eine vollständige Liste der Bandstile finden Sie in der fStyle Funktionsbeschreibung in der Win32-Struktur REBARBANDINFO .
clrFore
Ein COLORREF-Wert, der die Vordergrundfarbe der Leiste darstellt.
clrBack
Ein COLORREF-Wert, der die Hintergrundfarbe der Rebar darstellt.
Rückgabewert
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Beispiel
// 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
Rufen Sie diese Memberfunktion auf, um eine Erneute Leiste zu erstellen.
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);
Parameter
pParentWnd
Zeigen Sie auf das CWnd Objekt, dessen Windows-Fenster das übergeordnete Element der Statusleiste ist. Normalerweise wird ihr Rahmenfenster angezeigt.
dwCtrlStyle
Die Formatvorlage für das Rebar-Steuerelement. Standardmäßig RBS_BANDBORDERS, der schmale Linien anzeigt, um benachbarte Bänder innerhalb des Rebar-Steuerelements zu trennen. Eine Liste der Formatvorlagen finden Sie unter "Rebar Control Styles" im Windows SDK.See Rebar Control Styles in the Windows SDK for a list of styles.
dwStyle
Die Fensterformatvorlagen für die Leiste.
Nid
Die ID des untergeordneten Fensters der Leiste.
Rückgabewert
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Beispiel
Sehen Sie sich das Beispiel für CReBar::AddBar an.
CReBar::GetReBarCtrl
Diese Memberfunktion ermöglicht direkten Zugriff auf das zugrunde liegende allgemeine Steuerelement.
CReBarCtrl& GetReBarCtrl() const;
Rückgabewert
Ein Verweis auf ein CReBarCtrl -Objekt.
Hinweise
Rufen Sie diese Memberfunktion auf, um die Funktionalität des allgemeinen Windows-Leiste-Steuerelements beim Anpassen der Rebar zu nutzen. Wenn Sie aufrufen GetReBarCtrl, wird ein Verweisobjekt auf das CReBarCtrl Objekt zurückgegeben, sodass Sie einen satz von Memberfunktionen verwenden können.
Weitere Informationen zum CReBarCtrl Anpassen der Leiste finden Sie unter Verwenden von CReBarCtrl.
Beispiel
CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);