Klasa CMFCReBar

CMFCReBar Obiekt to pasek sterowania, który zapewnia informacje o układzie, trwałości i stanie dla kontrolek paska pomocniczego. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCReBar : public CPane

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
CMFCReBar::AddBar	Dodaje pasm do paska pomocniczego.
CMFCReBar::CalcFixedLayout	(Przesłonięcia) CBasePane::CalcFixedLayout).
CMFCReBar::CanFloat	(Przesłonięcia) CBasePane::CanFloat).
CMFCReBar::Create	Tworzy kontrolkę paska pomocniczego CMFCReBar i dołącza ją do obiektu.
CMFCReBar::EnableDocking	(Przesłonięcia) CBasePane::EnableDocking).
CMFCReBar::GetReBarBandInfoSize
CMFCReBar::GetReBarCtrl	Zapewnia bezpośredni dostęp do podstawowej kontrolki CReBarCtrl .
CMFCReBar::OnShowControlBarMenu	(Przesłonięcia) CPane::OnShowControlBarMenu.)
CMFCReBar::OnToolHitTest	(Przesłonięcia) CWnd::OnToolHitTest).
CMFCReBar::OnUpdateCmdUI	(Przesłonięcia) CBasePane::OnUpdateCmdUI.
CMFCReBar::SetPaneAlignment	(Przesłonięcia) CBasePane::SetPaneAlignment.

Uwagi

Obiekt CMFCReBar może zawierać różne okna podrzędne. Obejmuje to pola edycji, paski narzędzi i pola listy. Możesz programowo zmienić rozmiar paska, a użytkownik może ręcznie zmienić rozmiar paska pomocniczego, przeciągając pasek uchwytu. Możesz również ustawić tło obiektu paska pomocniczego na wybraną mapę bitową.

Obiekt paska pomocniczego zachowuje się podobnie do obiektu paska narzędzi. Kontrolka paska pomocniczego może zawierać co najmniej jeden przedział, a każdy zespół może zawierać pasek uchwytu, mapę bitową, etykietę tekstową i okno podrzędne.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCReBar klasie . W przykładzie pokazano, jak utworzyć kontrolkę paska pomocniczego i dodać do niej przedział. Pasek działa jako wewnętrzny pasek narzędzi. Ten fragment kodu jest częścią przykładu Test paska ponownego.

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

Hierarchia dziedziczenia

Obiekt CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Wymagania

Nagłówek: afxRebar.h

CMFCReBar::AddBar

Dodaje pasm do paska pomocniczego.

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

Pasek p
[in, out] Wskaźnik do okna podrzędnego, który ma zostać wstawiony do paska pomocniczego. Obiekt, do których się odwołuje, musi mieć styl okna WS_CHILD .

pszText
[in] Określa tekst, który ma być wyświetlany na pasku nawigacyjnym. Tekst nie jest częścią okna podrzędnego. Zamiast tego jest on wyświetlany na samym pasku nawigacyjnym.

pbmp
[in, out] Określa mapę bitową, która ma być wyświetlana na tle paska pomocniczego.

dwStyle
[in] Zawiera styl, który ma być stosowany do zespołu. Aby uzyskać pełną listę stylów pasm, zobacz opis fStyle struktury REBARBANDINFO w dokumentacji zestawu Windows SDK.

clrFore
[in] Reprezentuje kolor pierwszego planu paska pomocniczego.

clrBack
[in] Reprezentuje kolor tła paska pomocniczego.

Wartość zwracana

WARTOŚĆ TRUE, jeśli pasmo zostało pomyślnie dodane do paska pomocniczego; w przeciwnym razie, FAŁSZ.

CMFCReBar::Create

Tworzy kontrolkę paska pomocniczego i dołącza ją do obiektu CMFCReBar .

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
[in, out] Wskaźnik do okna nadrzędnego tej kontrolki paska pomocniczego.

dwCtrlStyle
[in] Określa styl kontrolki paska pomocniczego. Domyślna wartość stylu to RBS_BANDBORDERS, która wyświetla wąskie linie w celu oddzielenia sąsiednich pasków na kontrolce paska pomocniczego. Aby uzyskać listę prawidłowych stylów, zobacz Style kontrolek paska ponownego w dokumentacji zestawu Windows SDK.

dwStyle
[in] Styl okna kontrolki paska pomocniczego. Aby uzyskać listę prawidłowych stylów, zobacz Style okien.

Nid
[in] Identyfikator okna podrzędnego paska.

Wartość zwracana

Wartość TRUE, jeśli pasek rebar został pomyślnie utworzony; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCReBar::GetReBarCtrl

Zapewnia bezpośredni dostęp do CReBarCtrl podstawowej wspólnej kontroli dla CMFCReBar obiektów.

CReBarCtrl& GetReBarCtrl() const;

Wartość zwracana

Odwołanie do obiektu bazowego CReBarCtrl .

Uwagi

Wywołaj tę metodę, aby skorzystać z typowych funkcji kontroli paska systemu Windows podczas dostosowywania paska rebar.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

[in] bStretch
[in] bHorz

Wartość zwracana

Uwagi

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

Wartość zwracana

Uwagi

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Parametry

[in] dwDockStyle

Uwagi

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Wartość zwracana

Uwagi

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parametry

[in] CPoint

Wartość zwracana

Uwagi

CMFCReBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Parametry

[in] punkt
[in] Pti

Wartość zwracana

Uwagi

CMFCReBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parametry

[in] pTarget
[in] bDisableIfNoHndler

Uwagi

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Parametry

[in] dwAlignment

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CReBarCtrl
Klasa CPane