include/wx/msw/choice.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        choice.h
   3 // Purpose:     wxChoice class
   4 // Author:      Julian Smart
   5 // Modified by: Vadim Zeitlin to derive from wxChoiceBase
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_CHOICE_H_
  13 #define _WX_CHOICE_H_
  14
  15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  16     #pragma interface "choice.h"
  17 #endif
  18
  19 // ----------------------------------------------------------------------------
  20 // Choice item
  21 // ----------------------------------------------------------------------------
  22
  23 class WXDLLEXPORT wxChoice : public wxChoiceBase
  24 {
  25 public:
  26     // ctors
  27     wxChoice() { Init(); }
  28     virtual ~wxChoice();
  29
  30     wxChoice(wxWindow *parent,
  31              wxWindowID id,
  32              const wxPoint& pos = wxDefaultPosition,
  33              const wxSize& size = wxDefaultSize,
  34              int n = 0, const wxString choices[] = NULL,
  35              long style = 0,
  36              const wxValidator& validator = wxDefaultValidator,
  37              const wxString& name = wxChoiceNameStr)
  38     {
  39         Create(parent, id, pos, size, n, choices, style, validator, name);
  40     }
  41
  42     wxChoice(wxWindow *parent,
  43              wxWindowID id,
  44              const wxPoint& pos,
  45              const wxSize& size,
  46              const wxArrayString& choices,
  47              long style = 0,
  48              const wxValidator& validator = wxDefaultValidator,
  49              const wxString& name = wxChoiceNameStr)
  50     {
  51         Create(parent, id, pos, size, choices, style, validator, name);
  52     }
  53
  54     bool Create(wxWindow *parent,
  55                 wxWindowID id,
  56                 const wxPoint& pos = wxDefaultPosition,
  57                 const wxSize& size = wxDefaultSize,
  58                 int n = 0, const wxString choices[] = NULL,
  59                 long style = 0,
  60                 const wxValidator& validator = wxDefaultValidator,
  61                 const wxString& name = wxChoiceNameStr);
  62     bool Create(wxWindow *parent,
  63                 wxWindowID id,
  64                 const wxPoint& pos,
  65                 const wxSize& size,
  66                 const wxArrayString& choices,
  67                 long style = 0,
  68                 const wxValidator& validator = wxDefaultValidator,
  69                 const wxString& name = wxChoiceNameStr);
  70
  71     // implement base class pure virtuals
  72     virtual int DoAppend(const wxString& item);
  73     virtual int DoInsert(const wxString& item, int pos);
  74     virtual void Delete(int n);
  75     virtual void Clear();
  76
  77     virtual int GetCount() const;
  78     virtual int GetSelection() const;
  79 #if wxABI_VERSION >= 20602
  80     virtual int GetCurrentSelection() const;
  81 #endif
  82     virtual void SetSelection(int n);
  83
  84     virtual int FindString(const wxString& s) const;
  85     virtual wxString GetString(int n) const;
  86     virtual void SetString(int n, const wxString& s);
  87
  88     // MSW only
  89     virtual bool MSWCommand(WXUINT param, WXWORD id);
  90     WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
  91     virtual WXHBRUSH MSWControlColor(WXHDC hDC, WXHWND hWnd);
  92
  93 protected:
  94     // common part of all ctors
  95     void Init() { m_lastAcceptedSelection = wxID_NONE; }
  96
  97     virtual void DoMoveWindow(int x, int y, int width, int height);
  98     virtual void DoSetItemClientData( int n, void* clientData );
  99     virtual void* DoGetItemClientData( int n ) const;
 100     virtual void DoSetItemClientObject( int n, wxClientData* clientData );
 101     virtual wxClientData* DoGetItemClientObject( int n ) const;
 102
 103     // MSW implementation
 104     virtual wxSize DoGetBestSize() const;
 105     virtual void DoGetSize(int *w, int *h) const;
 106     virtual void DoSetSize(int x, int y,
 107                            int width, int height,
 108                            int sizeFlags = wxSIZE_AUTO);
 109
 110     virtual bool MSWShouldPreProcessMessage(WXMSG *pMsg);
 111
 112     virtual WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const;
 113
 114     // update the height of the drop down list to fit the number of items we
 115     // have (without changing the visible height)
 116     void UpdateVisibleHeight();
 117
 118     // create and initialize the control
 119     bool CreateAndInit(wxWindow *parent, wxWindowID id,
 120                        const wxPoint& pos,
 121                        const wxSize& size,
 122                        int n, const wxString choices[],
 123                        long style,
 124                        const wxValidator& validator,
 125                        const wxString& name);
 126
 127     // free all memory we have (used by Clear() and dtor)
 128     void Free();
 129
 130
 131     // last "completed" selection, i.e. not the transient one while the user is
 132     // browsing the popup list: this is only used when != wxID_NONE which is
 133     // the case while the drop down is opened
 134     int m_lastAcceptedSelection;
 135
 136
 137     DECLARE_DYNAMIC_CLASS_NO_COPY(wxChoice)
 138 };
 139
 140 #endif // _WX_CHOICE_H_