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

CObject

CCmdTarget

CWnd

CControlBar

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

Siehe auch

MFC-Beispiel-MFCIE
CControlBar Class
Hierarchiediagramm