CScrollBar::Create

Creates the Windows scroll bar and attaches it to the CScrollBar object.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parameters

• dwStyle
  Specifies the scroll bar's style. Apply any combination of scroll-bar styles to the scroll bar.

• rect
  Specifies the scroll bar's size and position. Can be either a RECT structure or a CRect object.

• pParentWnd
  Specifies the scroll bar's parent window, usually a CDialog object. It must not be NULL.

• nID
  The scroll bar's control ID.

Return Value

Nonzero if successful; otherwise 0.

Remarks

You construct a CScrollBar object in two steps. First, call the constructor, which constructs the CScrollBar object; then call Create, which creates and initializes the associated Windows scroll bar and attaches it to the CScrollBar object.

Apply the following window styles to a scroll bar:

• WS_CHILD   Always

• WS_VISIBLE   Usually

• WS_DISABLED   Rarely

• WS_GROUP   To group controls

Example

// Example 1:
// Create a horizontal CScrollBar control as a child window of CMyDialog 
// class (a CDialog-derived class). The scroll bar is NOT visible until the
// call ShowScrollBar() is made. m_ScrollBarHorz is of type CScrollBar class,
// and it is a member variable in CMyDialog class.
VERIFY(m_ScrollBarHorz.Create(SBS_HORZ | SBS_TOPALIGN | WS_CHILD,
   CRect(5, 5, 100, 30), this, IDC_SCROLLBARCTRL));

m_ScrollBarHorz.ShowScrollBar();

// Example 2:
// Create a vertical CScrollBar control as a child window of CMyDialog 
// class (a CDialog-derived class). m_ScrollBarVert is of type CScrollBar 
// class, and it is a member variable in CMyDialog class.
VERIFY(m_ScrollBarVert.Create(SBS_VERT | SBS_LEFTALIGN | WS_CHILD | 
   WS_VISIBLE, CRect(5, 30, 30, 130), this, IDC_SCROLLBARCTRL));

Requirements

Header: afxwin.h

See Also

Reference

CScrollBar Class

Hierarchy Chart

CScrollBar::CScrollBar

Other Resources

CScrollBar Members