Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CListBox►                                    ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd,
               UINT nID );
 
  Parameter    Description
 
  <dwStyle>    Specifies the ◄style► of the list 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
               or CModalDialog object). It must not be NULL.
 
  <nID>        Specifies the list box's resource ID.
 
  Remarks
 
  You construct a CListBox object in two steps. First call the
  constructor, 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.
 
  To handle Windows notification messages sent from a CListBox object to
  its parent, add any of the following message-map entries that you want
  to process to the parent class message map:
 
  ON_COMMAND
  ON_LBN_DBLCLK
  ON_LBN_ERRSPACE
  ON_LBN_KILLFOCUS
  ON_LBN_SELCHANGE
  ON_LBN_SETFOCUS
 
  Apply the following ◄window styles► to a list-box control:
 
  Style         Application
 
  WS_CHILD      Always.
 
  WS_VISIBLE    Usually.
 
  WS_DISABLED   Rarely.
 
  WS_VSCROLL    Adds a vertical scroll bar.
 
  WS_HSCROLL    Adds a horizontal scroll bar.
 
  WS_GROUP      To group controls.
 
  WS_TABSTOP    To allow tabbing to this control.
 
  Apply any combination of ◄list-box styles► to a list box.
 
  Return Value
 
  TRUE if successful; otherwise FALSE.
 
  See Also
 
  ◄CListBox::CListBox►
 
 
                                     -♦-