Share via

CReBar::AddBar

  • Article

Call this member function to add a band to the 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

  • pBar
    A pointer to a CWnd object that is the child window to be inserted into the rebar. The referenced object must have a WS_CHILD.

  • lpszText
    A pointer to a string containing the text to appear on the rebar. NULL by default. The text contained in lpszText is not part of the child window; it is on the rebar itself.

  • pbmp
    A pointer to a CBitmap object to be displayed on the rebar background. NULL by default.

  • dwStyle
    A DWORD containing the style to apply to the rebar. See the fStyle function description in the Win32 structure REBARBANDINFO for a complete list of band styles.

  • clrFore
    A COLORREF value that represents the foreground color of the rebar.

  • clrBack
    A COLORREF value that represents the background color of the rebar.

Return Value

Nonzero if successful; otherwise 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);

Requirements

Header: afxext.h

See Also

Reference

CReBar Class

Hierarchy Chart

CReBarCtrl Class