Freigeben über


CReBar::AddBar

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

Concepts

CReBar Class

CReBar Members

Hierarchy Chart

CReBarCtrl Class