CReBar::AddBar

BOOL AddBar( CWnd* pBar, LPCTSTR lpszText = 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 );

Return Value

Nonzero if successful; otherwise 0.

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 pszText 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.

Remarks

Call this member function to add a band to the rebar.

Example

// Define a pointer to a CRebar in your class definition,
// such as: CReBar* m_pReBar; More often, however, you
// would probably specify an instance in your class
// definition, such as: CReBar m_ReBar;
m_pReBar = new CReBar();
m_pReBar->Create(this);
m_wndDlgBar.Create(this, IDR_MAINFRAME, CBRS_ALIGN_TOP,
    AFX_IDW_DIALOGBAR);
m_pReBar->AddBar(&m_wndDlgBar);

CReBar OverviewClass MembersHierarchy Chart

See Also   CReBarCtrl