CReBar-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Een besturingsbalk die indelings-, persistentie- en statusinformatie biedt voor besturingselementen voor opnieuw balken.

Syntaxis

class CReBar : public CControlBar

Leden

Openbare methoden

Naam	Description
CReBar::AddBar	Voegt een band toe aan een rebar.
CReBar::Maken	Hiermee maakt u het besturingselement voor de balk en koppelt u het aan het CReBar object.
CReBar::GetReBarCtrl	Hiermee wordt directe toegang tot het onderliggende algemene besturingselement toegestaan.

Opmerkingen

Een rebar-object kan verschillende onderliggende vensters bevatten, meestal andere besturingselementen, waaronder bewerkingsvakken, werkbalken en keuzelijsten. Een rebar-object kan de onderliggende vensters over een opgegeven bitmap weergeven. De toepassing kan het formaat van de balk automatisch wijzigen of de gebruiker kan het formaat van de balk handmatig wijzigen door op de greepbalk te klikken of te slepen.

Besturingselement voor opnieuw balken

Een rebar-object gedraagt zich op dezelfde manier als een werkbalkobject. Een rebar maakt gebruik van het klik- en sleepmechanisme om het formaat van de stroken te wijzigen. Een rebarbesturingselement kan een of meer stroken bevatten, waarbij elke band een combinatie heeft van een greepbalk, een bitmap, een tekstlabel en een onderliggend venster. Banden mogen echter niet meer dan één onderliggend venster bevatten.

CReBar maakt gebruik van de CReBarCtrl-klasse om de implementatie te bieden. U kunt het besturingselement voor de rebar openen via GetReBarCtrl om te profiteren van de aanpassingsopties van het besturingselement. Zie voor meer informatie over besturingselementen voor opnieuw balken CReBarCtrl. Zie CReBarCtrl gebruiken voor meer informatie over het gebruik van besturingselementen voor opnieuw balken.

Waarschuwing

Besturingsobjecten voor opnieuw balken en balken bieden geen ondersteuning voor het dokken van MFC-besturingsbalken. Als CRebar::EnableDocking deze wordt aangeroepen, wordt uw toepassing assertie.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CControlBar

CReBar

Requirements

Koptekst: afxext.h

CReBar::AddBar

Roep deze lidfunctie aan om een band toe te voegen aan de 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);

Parameterwaarden

pBar
Een aanwijzer naar een CWnd object dat het onderliggende venster is dat in de rebalk moet worden ingevoegd. Het object waarnaar wordt verwezen, moet een WS_CHILD hebben.

lpszText
Een aanwijzer naar een tekenreeks die de tekst bevat die op de balk moet worden weergegeven. NULL standaard. De tekst in lpszText maakt geen deel uit van het onderliggende venster; het bevindt zich op de rebar zelf.

pbmp
Een aanwijzer naar een CBitmap object dat moet worden weergegeven op de achtergrond van de balk. NULL standaard.

dwStyle
Een DWORD met de stijl die moet worden toegepast op de rebar. Zie de fStyle functiebeschrijving in de Win32-structuur REBARBANDINFO voor een volledige lijst met bandstijlen.

clrFore
Een COLORREF-waarde die de voorgrondkleur van de rebar vertegenwoordigt.

clrBack
Een COLORREF-waarde die de achtergrondkleur van de balk vertegenwoordigt.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

// 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::Maken

Roep deze lidfunctie aan om een nieuwe balk te maken.

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

Parameterwaarden

pParentWnd
Wijs het object aan waarvan het CWnd Windows-venster het bovenliggende element van de statusbalk is. Normaal gesproken uw framevenster.

dwCtrlStyle
De stijl van het besturingselement voor de balk. Standaard RBS_BANDBORDERS, waarmee smalle lijnen worden weergegeven om aangrenzende banden binnen het rebar-besturingselement te scheiden. Zie Besturingsstijlen voor opnieuw balken in de Windows SDK voor een lijst met stijlen.

dwStyle
De vensterstijlen voor de balk.

nID
De id van het onderliggende venster van de balk.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Example

Zie het voorbeeld voor CReBar::AddBar.

CReBar::GetReBarCtrl

Deze lidfunctie biedt directe toegang tot het onderliggende algemene besturingselement.

CReBarCtrl& GetReBarCtrl() const;

Retourwaarde

Een verwijzing naar een CReBarCtrl-object .

Opmerkingen

Roep deze lidfunctie aan om te profiteren van de functionaliteit van het algemene besturingselement voor windows-rebars bij het aanpassen van uw rebar. Wanneer u aanroept GetReBarCtrl, retourneert het een verwijzingsobject naar het CReBarCtrl object, zodat u een van beide set lidfuncties kunt gebruiken.

Zie CReBarCtrl gebruiken voor meer informatie over het aanpassen CReBarCtrl van uw rebar.

Example

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);

Zie ook

MFC-voorbeeld MFCIE
CControlBar-klasse
Hiërarchiegrafiek