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.

◄CButton►                                     ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL Create( const char FAR* lpCaption, DWORD dwStyle,
               const RECT& rect, CWnd* pParentWnd, UINT nID );
 
  Parameter    Description
 
  <lpCaption>  Specifies the button control's text.
 
  <dwStyle>    Specifies the button control's ◄style►.
 
  <rect>       Specifies the button control's size and position. It can be
               either a CRect object or a RECT structure.
 
  <pParentWnd> Specifies the button control's parent window, usually a
               CDialog or CModalDialog. It must not be NULL.
 
  <nID>        Specifies the button control's resource ID.
 
  Remarks
 
  You construct a CButton object in two steps. First call the constructor,
  then call Create, which creates the Windows button control and attaches
  it to the CButton object.
 
  When Create executes, Windows sends the ◄WM_NCCREATE►, ◄WM_CREATE►,
  ◄WM_NCCALCSIZE►, and ◄WM_GETMINMAXINFO► messages to the button 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
  CButton, 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 that the CButton object sends 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_BN_CLICKED
  ON_BN_DOUBLECLICKED
 
  Apply the following ◄window styles► to a button control:
 
  Style        Application
 
  WS_CHILD     Always.
 
  WS_VISIBLE   Usually.
 
  WS_DIABLED   Rarely.
 
  WS_GROUP     To group controls.
 
  WS_TABSTOP   To include the button in the tabbing order.
 
  Apply any combination of ◄button styles► to the button.
 
  Return Value
 
  TRUE if successful; otherwise FALSE.
 
  See Also
 
  ◄CButton::CButton►
 
 
                                     -♦-