CReBar – třída

Ovládací panel, který poskytuje informace o rozložení, trvalosti a stavu pro ovládací prvky rebaru.

Syntaxe

class CReBar : public CControlBar

Členové

Veřejné metody

Jméno	popis
CReBar::AddBar	Přidá pruh na panel.
CReBar::Create	Vytvoří ovládací prvek rebar a připojí ho k objektu CReBar .
CReBar::GetReBarCtrl	Umožňuje přímý přístup k základnímu společnému řízení.

Poznámky

Objekt rebaru může obsahovat celou řadu podřízených oken, obvykle jiných ovládacích prvků, včetně polí pro úpravy, panelů nástrojů a seznamů. Objekt rebaru může zobrazit podřízená okna nad zadaným rastrovým obrázkem. Vaše aplikace může automaticky změnit velikost rebaru nebo uživatel může ručně změnit velikost panelu kliknutím nebo přetažením úchytu.

Ovládací prvek Rebar

Objekt rebar se chová podobně jako objekt panelu nástrojů. Rebar používá mechanismus kliknutí a přetažení ke změně velikosti pásem. Ovládací prvek rebar může obsahovat jednu nebo více pásem, přičemž každá skupina má libovolnou kombinaci úchytu, rastrového obrázku, textového popisku a podřízeného okna. Pásma však nesmí obsahovat více než jedno podřízené okno.

CReBarpoužívá CReBarCtrl třídy k poskytnutí jeho implementace. K ovládacímu prvku rebaru se dostanete přes GetReBarCtrl , abyste mohli využít možnosti přizpůsobení ovládacího prvku. Další informace o ovládacích prvcích rebaru naleznete v tématu CReBarCtrl. Další informace o použití ovládacích prvků rebaru naleznete v tématu Použití CReBarCtrl.

Upozornění

Ovládací objekty rebar a rebar nepodporují ukotvení ovládacích panelů MFC. Pokud CRebar::EnableDocking je volána, aplikace se bude uplatňovat.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

CControlBar

CReBar

Požadavky

Hlavička: afxext.h

CReBar::AddBar

Voláním této členské funkce přidáte do rebaru pruh.

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

Parametry

pBar
Ukazatel na CWnd objekt, který se má vložit do rebaru, je podřízené okno. Odkazovaný objekt musí mít WS_CHILD.

lpszText
Ukazatel na řetězec obsahující text, který se má zobrazit na panelu. Ve výchozím nastavení má hodnotu NULL. Text obsažený v lpszText není součástí podřízeného okna; je na samotném panelu.

pbmp
Ukazatel na CBitmap objekt, který se má zobrazit na pozadí panelu. Ve výchozím nastavení má hodnotu NULL.

dwStyle
A DWORD obsahující styl, který se má použít na rebar. fStyle Úplný seznam stylů kapel najdete v popisu funkce ve struktuře Win32 REBARBANDINFO.

clrFore
Hodnota COLORREF, která představuje barvu popředí rebaru.

clrBack
Hodnota COLORREF, která představuje barvu pozadí panelu.

Vrácená hodnota

Nenulové, pokud je úspěšné; jinak 0.

Příklad

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

Voláním této členské funkce vytvořte rebar.

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

Parametry

pParentWnd
Ukazatel na CWnd objekt, jehož okno Windows je nadřazený stavovým řádkem. Za normálních okolností okno rámečku.

dwCtrlStyle
Styl ovládacího prvku panelu. Ve výchozím nastavení RBS_BANDBORDERS, který zobrazuje úzké čáry k oddělení sousedních pásem v ovládacím prvku panelu. Seznam stylů stylů ovládacího prvku najdete v sadě Windows SDK v části Styly ovládacích prvků na panelu.

dwStyle
Styly oken na panelu.

Nid
ID podřízeného okna panelu.

Vrácená hodnota

Nenulové, pokud je úspěšné; jinak 0.

Příklad

Podívejte se na příklad pro CReBar::AddBar.

CReBar::GetReBarCtrl

Tato členová funkce umožňuje přímý přístup k základnímu společnému řízení.

CReBarCtrl& GetReBarCtrl() const;

Vrácená hodnota

Odkaz na objekt CReBarCtrl .

Poznámky

Voláním této členské funkce můžete využít funkce společného ovládacího prvku panelu Windows při přizpůsobení panelu. Při volání GetReBarCtrlvrátí objekt odkazu na CReBarCtrl objekt, takže můžete použít některou sadu členských funkcí.

Další informace o použití CReBarCtrl k přizpůsobení rebaru naleznete v tématu Použití CReBarCtrl.

Příklad

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

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

Viz také

MFC – ukázka MFCIE
CControlBar – třída
Graf hierarchie