This topic has not yet been rated - Rate this topic

CListBox::Create

Visual Studio 2010

Creates the Windows list box and attaches it to the CListBox object.

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

Parameters

dwStyle: Specifies the style of the list box. Apply any combination of list-box styles to the box.
rect: Specifies the list-box size and position. Can be either a CRect object or a RECT structure.
pParentWnd: Specifies the list box's parent window (usually a CDialog object). It must not be NULL.
nID: Specifies the list box's control ID.

Return Value

Nonzero if successful; otherwise 0.

Remarks

You construct a CListBox object in two steps. First, call the constructor and then call Create, which initializes the Windows list box and attaches it to the CListBox object.

When Create executes, Windows sends the WM_NCCREATE, WM_CREATE, WM_NCCALCSIZE, and WM_GETMINMAXINFO messages to the list-box control.

These messages are handled by default by the OnNcCreate, OnCreate, OnNcCalcSize, and OnGetMinMaxInfo member functions in the CWnd base class. To extend the default message handling, derive a class from CListBox, add a message map to the new class, and override the preceding message-handler member functions. Override OnCreate, for example, to perform needed initialization for a new class.

Apply the following window styles to a list-box control.

WS_CHILD Always
WS_VISIBLE Usually
WS_DISABLED Rarely
WS_VSCROLL To add a vertical scroll bar
WS_HSCROLL To add a horizontal scroll bar
WS_GROUP To group controls
WS_TABSTOP To allow tabbing to this control

Example

C++


// pParentWnd is a pointer to the parent window.
m_myListBox.Create(WS_CHILD|WS_VISIBLE|LBS_STANDARD|WS_HSCROLL, 
   CRect(10,10,200,200), pParentWnd, IDC_MYLISTBOX);

Requirements

Header: afxwin.h

Reference

CListBox Class

Hierarchy Chart

CListBox::CListBox

Other Resources

CListBox Members

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD