CReBar osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Egy vezérlősáv, amely elrendezési, adatmegőrzési és állapotinformációkat biztosít a sávvezérlőkhöz.

Szemantika

class CReBar : public CControlBar

Tagok

Nyilvános metódusok

Név	Description
CReBar::AddBar	Sávot ad hozzá egy sávhoz.
CReBar::Létrehozás	Létrehozza a rebar vezérlőt, és csatolja az CReBar objektumhoz.
CReBar::GetReBarCtrl	Lehetővé teszi a közvetlen hozzáférést a mögöttes közös vezérlőhöz.

Megjegyzések

A sávobjektumok számos gyermekablakot tartalmazhatnak, általában más vezérlőket, például szerkesztési mezőket, eszköztárakat és listamezőket. Egy rebar objektum megjelenítheti a gyermekablakait egy megadott bitképen keresztül. Az alkalmazás automatikusan átméretezheti a sávot, vagy a felhasználó manuálisan átméretezheti a fogósávot a fogósávra kattintva vagy húzásával.

Rebar Control

A sávobjektumok ugyanúgy viselkednek, mint egy eszköztárobjektum. A sávok a kattintással és húzással átméretezik a sávokat. A sávvezérlők tartalmazhatnak egy vagy több sávot, és mindegyik sáv rendelkezik fogósáv, bitkép, szövegfelirat és gyermekablak kombinációjával. A sávok azonban nem tartalmazhatnak egynél több gyermekablakot.

CReBar A CReBarCtrl osztályt használja annak implementálásához. A rebar vezérlőt a GetReBarCtrl segítségével érheti el, hogy kihasználhassa a vezérlő testreszabási lehetőségeit. További információ a sávvezérlőkről: CReBarCtrl. További információ a sávvezérlők használatáról: A CReBarCtrl használata.

Caution

A rebar és a rebar vezérlőobjektumok nem támogatják az MFC vezérlősávok rögzítését. Ha CRebar::EnableDocking meghívják, az alkalmazás érvényesíteni fogja.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CControlBar

CReBar

Requirements

Fejléc: afxext.h

CReBar::AddBar

Hívja meg ezt a tagfüggvényt, ha sávot szeretne hozzáadni a sávhoz.

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

Paraméterek

pBar
Egy olyan objektumra CWnd mutató mutató, amely a sávba beszúrandó gyermekablak. A hivatkozott objektumnak WS_CHILD kell rendelkeznie.

lpszText
A sávon megjelenítendő szöveget tartalmazó sztringre mutató mutató. ALAPÉRTELMEZÉS SZERINT NULL. Az lpszText szöveg nem része a gyermekablaknak; a sávon van.

pbmp
A sáv hátterében megjelenítendő objektumra mutató mutató CBitmap . ALAPÉRTELMEZÉS SZERINT NULL.

dwStyle
A rebarra alkalmazni kívánt stílust tartalmazó DWORD. A sávstílusok teljes listáját a fStyle Win32 struktúra REBARBANDINFO-ban találja.

clrFore
A SZÍNREF érték, amely a sáv előtérszínét jelöli.

clrBack
A SZÍNREF érték, amely a sáv háttérszínét jelöli.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 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::Létrehozás

Hívja meg ezt a tagfüggvényt egy sáv létrehozásához.

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

Paraméterek

pParentWnd
Mutasson arra az CWnd objektumra, amelynek Windows ablaka az állapotsor szülője. Általában a keretablak.

dwCtrlStyle
A sávvezérlő stílusa. Alapértelmezés szerint RBS_BANDBORDERS, amely keskeny vonalakat jelenít meg a szomszédos sávok elválasztásához a rebar vezérlőn belül. A stílusok listájáért tekintse meg a Windows SDK sávvezérlési stílusait .

dwStyle
A rebar ablakstílusok.

nID
A sáv gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Example

Lásd a CReBar::AddBar példát.

CReBar::GetReBarCtrl

Ez a tagfüggvény közvetlen hozzáférést biztosít a mögöttes közös vezérlőhöz.

CReBarCtrl& GetReBarCtrl() const;

Visszaadott érték

Hivatkozás egy CReBarCtrl-objektumra .

Megjegyzések

Hívja meg ezt a tagfüggvényt, hogy kihasználhassa a Windows-rebar közös vezérlő funkcióit a sáv testreszabása során. Híváskor GetReBarCtrlaz objektum egy referenciaobjektumot ad vissza, CReBarCtrl így bármelyik tagfüggvény-készletet használhatja.

A sáv testreszabásáról CReBarCtrl további információt a CReBarCtrl használata című témakörben talál.

Example

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

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

Lásd még

MFC-minta MFCIE
CControlBar osztály
hierarchiadiagram