Klasa CReBar

Pasek sterowania, który zapewnia informacje o układzie, trwałości i stanie dla kontrolek paska pomocniczego.

Składnia

class CReBar : public CControlBar

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
CReBar::AddBar	Dodaje pasm do paska pomocniczego.
CReBar::Create	Tworzy kontrolkę paska pomocniczego CReBar i dołącza ją do obiektu.
CReBar::GetReBarCtrl	Umożliwia bezpośredni dostęp do podstawowej wspólnej kontroli.

Uwagi

Obiekt paska pomocniczego może zawierać różne okna podrzędne, zazwyczaj inne kontrolki, w tym pola edycji, paski narzędzi i pola listy. Obiekt paska pomocniczego może wyświetlać okna podrzędne na określonej mapie bitowej. Aplikacja może automatycznie zmienić rozmiar paska pomocniczego lub ręcznie zmienić rozmiar paska, klikając lub przeciągając pasek uchwytu.

Kontrolka paska pomocniczego

Obiekt paska pomocniczego zachowuje się podobnie do obiektu paska narzędzi. Pasek rebar używa mechanizmu klikania i przeciągania, aby zmienić rozmiar pasków. Kontrolka paska pomocniczego może zawierać co najmniej jeden przedział, a każdy zespół ma dowolną kombinację paska uchwytu, mapy bitowej, etykiety tekstowej i okna podrzędnego. Jednak przedziały nie mogą zawierać więcej niż jednego okna podrzędnego.

CReBarużywa klasy CReBarCtrl, aby zapewnić jej implementację. Dostęp do kontrolki paska ponownego można uzyskać za pomocą polecenia GetReBarCtrl , aby skorzystać z opcji dostosowywania kontrolki. Aby uzyskać więcej informacji na temat kontrolek paska pomocniczego, zobacz CReBarCtrl. Aby uzyskać więcej informacji na temat używania kontrolek paska pomocniczego, zobacz Using CReBarCtrl (Korzystanie z CReBarCtrl).

Uwaga

Obiekty kontrolek paska pomocniczego i paska pomocniczego nie obsługują zadokowania paska sterowania MFC. Jeśli CRebar::EnableDocking zostanie wywołana, aplikacja będzie asercją.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CControlBar

CReBar

Wymagania

Nagłówek: afxext.h

CReBar::AddBar

Wywołaj tę funkcję składową, aby dodać przedział 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
Wskaźnik do obiektu, który jest oknem podrzędnym CWnd , który ma zostać wstawiony do paska pomocniczego. Obiekt, do których odwołuje się odwołanie, musi mieć WS_CHILD.

lpszText
Wskaźnik do ciągu zawierającego tekst wyświetlany na pasku nawigacyjnym. Wartość NULL domyślnie. Tekst zawarty w lpszText nie jest częścią okna podrzędnego; znajduje się na samym pasku nawigacyjnym.

pbmp
Wskaźnik do CBitmap obiektu, który ma być wyświetlany na tle paska pomocniczego. Wartość NULL domyślnie.

dwStyle
DworD zawierający styl, który ma być stosowany do paska pomocniczego. fStyle Zobacz opis funkcji w strukturze Win32 REBARBANDINFO, aby uzyskać pełną listę stylów pasmowych.

clrFore
Wartość COLORREF reprezentująca kolor pierwszego planu paska pomocniczego.

clrBack
Wartość COLORREF reprezentująca kolor tła paska pomocniczego.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Przykład

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

Wywołaj tę funkcję składową, aby utworzyć pasek 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
Wskaźnik do CWnd obiektu, którego okno systemu Windows jest elementem nadrzędnym paska stanu. Zwykle okno ramki.

dwCtrlStyle
Styl kontrolki paska pomocniczego. Domyślnie RBS_BANDBORDERS, która wyświetla wąskie linie do oddzielania sąsiednich pasków w kontrolce paska pomocniczego. Zobacz Style kontrolek paska ponownego w zestawie Windows SDK, aby uzyskać listę stylów.

dwStyle
Style okna paska pomocniczego.

Nid
Identyfikator okna podrzędnego paska.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Przykład

Zobacz przykład CReBar ::AddBar.

CReBar::GetReBarCtrl

Ta funkcja składowa umożliwia bezpośredni dostęp do podstawowej wspólnej kontroli.

CReBarCtrl& GetReBarCtrl() const;

Wartość zwracana

Odwołanie do obiektu CReBarCtrl .

Uwagi

Wywołaj tę funkcję składową, aby skorzystać z funkcji wspólnego sterowania paskiem systemu Windows w dostosowywaniu paska ponownego. Podczas wywoływania GetReBarCtrlmetoda zwraca obiekt odwołania do CReBarCtrl obiektu , aby można było użyć dowolnego zestawu funkcji składowych.

Aby uzyskać więcej informacji na temat dostosowywania CReBarCtrl paska rebar, zobacz Using CReBarCtrl (Używanie narzędzia CReBarCtrl).

Przykład

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

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

Zobacz też

Przykład MFC — MFCIE
Klasa CControlBar
Wykres hierarchii