CMFCReBar::AddBar

Adds a band to a 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 
);

Parameters

  • [in] [out] pBar
    A pointer to the child window that is to be inserted into the rebar. The referenced object must have the WS_CHILD window style.

  • [in] pszText
    Specifies the text to appear on the rebar. The text is not part of the child window. Rather, it is displayed on the rebar itself.

  • [in] [out] pbmp
    Specifies the bitmap to be displayed on the rebar background.

  • [in] dwStyle
    Contains the style to apply to the band. For a complete list of band styles, see the description for fStyle in the REBARBANDINFO structure in the Windows SDK documentation.

  • [in] clrFore
    Represents the foreground color of the rebar.

  • [in] clrBack
    Represents the background color of the rebar.

Return Value

TRUE if the band was successfully added to the rebar; otherwise, FALSE.

Requirements

Header: afxRebar.h

See Also

Reference

CMFCReBar Class

Hierarchy Chart