include/wx/msw/control.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        control.h
   3 // Purpose:     wxControl class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_CONTROL_H_
  13 #define _WX_CONTROL_H_
  14
  15 #ifdef __GNUG__
  16     #pragma interface "control.h"
  17 #endif
  18
  19 #include "wx/dynarray.h"
  20
  21 WXDLLEXPORT_DATA(extern const wxChar*) wxControlNameStr;
  22
  23 // General item class
  24 class WXDLLEXPORT wxControl : public wxControlBase
  25 {
  26     DECLARE_ABSTRACT_CLASS(wxControl)
  27
  28 public:
  29    wxControl();
  30    wxControl(wxWindow *parent, wxWindowID id,
  31              const wxPoint& pos = wxDefaultPosition,
  32              const wxSize& size = wxDefaultSize, long style = 0,
  33 #if wxUSE_VALIDATORS
  34              const wxValidator& validator = wxDefaultValidator,
  35 #endif
  36              const wxString& name = wxControlNameStr)
  37     {
  38         Create(parent, id, pos, size, style, validator, name);
  39     }
  40
  41     bool Create(wxWindow *parent, wxWindowID id,
  42             const wxPoint& pos = wxDefaultPosition,
  43             const wxSize& size = wxDefaultSize, long style = 0,
  44 #if wxUSE_VALIDATORS
  45             const wxValidator& validator = wxDefaultValidator,
  46 #endif
  47             const wxString& name = wxControlNameStr);
  48
  49     virtual ~wxControl();
  50
  51    // Simulates an event
  52    virtual void Command(wxCommandEvent& event) { ProcessCommand(event); }
  53
  54    // implementation from now on
  55    // --------------------------
  56
  57    // Calls the callback and appropriate event handlers
  58    bool ProcessCommand(wxCommandEvent& event);
  59
  60    // MSW-specific
  61 #ifdef __WIN95__
  62    virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
  63 #endif // Win95
  64
  65    // For ownerdraw items
  66    virtual bool MSWOnDraw(WXDRAWITEMSTRUCT *WXUNUSED(item)) { return FALSE; };
  67    virtual bool MSWOnMeasure(WXMEASUREITEMSTRUCT *WXUNUSED(item)) { return FALSE; };
  68
  69    wxArrayLong GetSubcontrols() { return m_subControls; }
  70
  71    void OnEraseBackground(wxEraseEvent& event);
  72
  73    virtual WXHBRUSH OnCtlColor(WXHDC pDC, WXHWND pWnd, WXUINT nCtlColor,
  74                                WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
  75
  76 #if WXWIN_COMPATIBILITY
  77    virtual void SetButtonColour(const wxColour& WXUNUSED(col)) { }
  78    wxColour* GetButtonColour() const { return NULL; }
  79
  80    inline virtual void SetLabelFont(const wxFont& font);
  81    inline virtual void SetButtonFont(const wxFont& font);
  82    inline wxFont& GetLabelFont() const;
  83    inline wxFont& GetButtonFont() const;
  84
  85    // Adds callback
  86    inline void Callback(const wxFunction function);
  87
  88    wxFunction GetCallback() { return m_callback; }
  89
  90 protected:
  91    wxFunction       m_callback;     // Callback associated with the window
  92 #endif // WXWIN_COMPATIBILITY
  93
  94 protected:
  95    // for controls like radiobuttons which are really composite this array
  96    // holds the ids (not HWNDs!) of the sub controls
  97    wxArrayLong m_subControls;
  98
  99    virtual wxSize DoGetBestSize() const;
 100
 101    // create the control of the given class with the given style, returns FALSE
 102    // if creation failed
 103    //
 104    // All parameters except classname and style are optional, if the
 105    // size/position are not given, they should be set later with SetSize() and,
 106    // label (the title of the window), of course, is left empty. The extended
 107    // style is determined from the style and the app 3D settings automatically
 108    // if it's not specified explicitly.
 109    bool MSWCreateControl(const wxChar *classname,
 110                          WXDWORD style,
 111                          const wxPoint& pos = wxDefaultPosition,
 112                          const wxSize& size = wxDefaultSize,
 113                          const wxString& label = wxEmptyString,
 114                          WXDWORD exstyle = (WXDWORD)-1);
 115
 116    // determine the extended styles combination for this window (may slightly
 117    // modify style parameter, this is why it's non const)
 118    WXDWORD GetExStyle(WXDWORD& style, bool *want3D) const;
 119
 120 private:
 121    DECLARE_EVENT_TABLE()
 122 };
 123
 124
 125 #if WXWIN_COMPATIBILITY
 126     inline void wxControl::Callback(const wxFunction f) { m_callback = f; };
 127     inline wxFont& wxControl::GetLabelFont() const { return GetFont(); }
 128     inline wxFont& wxControl::GetButtonFont() const { return GetFont(); }
 129     inline void wxControl::SetLabelFont(const wxFont& font) { SetFont(font); }
 130     inline void wxControl::SetButtonFont(const wxFont& font) { SetFont(font); }
 131 #endif // WXWIN_COMPATIBILITY
 132
 133 #endif
 134     // _WX_CONTROL_H_