include/wx/osx/combobox.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/mac/carbon/combobox.h
   3 // Purpose:     wxComboBox class
   4 // Author:      Stefan Csomor
   5 // Modified by:
   6 // Created:     1998-01-01
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Stefan Csomor
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_COMBOBOX_H_
  13 #define _WX_COMBOBOX_H_
  14
  15 #include "wx/containr.h"
  16 #include "wx/choice.h"
  17
  18 WXDLLIMPEXP_DATA_CORE(extern const char) wxComboBoxNameStr[];
  19
  20 // forward declaration of private implementation classes
  21
  22 class wxComboBoxText;
  23 class wxComboBoxChoice;
  24
  25 // Combobox item
  26 class WXDLLIMPEXP_CORE wxComboBox : public wxControl, public wxComboBoxBase
  27 {
  28     DECLARE_DYNAMIC_CLASS(wxComboBox)
  29
  30  public:
  31     virtual ~wxComboBox();
  32
  33     // forward these functions to all subcontrols
  34     virtual bool Enable(bool enable = true);
  35     virtual bool Show(bool show = true);
  36
  37     // callback functions
  38     virtual void DelegateTextChanged( const wxString& value );
  39     virtual void DelegateChoice( const wxString& value );
  40
  41     wxComboBox() { Init(); }
  42
  43     wxComboBox(wxWindow *parent, wxWindowID id,
  44            const wxString& value = wxEmptyString,
  45            const wxPoint& pos = wxDefaultPosition,
  46            const wxSize& size = wxDefaultSize,
  47            int n = 0, const wxString choices[] = NULL,
  48            long style = 0,
  49            const wxValidator& validator = wxDefaultValidator,
  50            const wxString& name = wxComboBoxNameStr)
  51     {
  52         Init();
  53         Create(parent, id, value, pos, size, n, choices, style, validator, name);
  54     }
  55
  56     wxComboBox(wxWindow *parent, wxWindowID id,
  57            const wxString& value,
  58            const wxPoint& pos,
  59            const wxSize& size,
  60            const wxArrayString& choices,
  61            long style = 0,
  62            const wxValidator& validator = wxDefaultValidator,
  63            const wxString& name = wxComboBoxNameStr)
  64     {
  65         Init();
  66         Create(parent, id, value, pos, size, choices, style, validator, name);
  67     }
  68
  69     bool Create(wxWindow *parent, wxWindowID id,
  70            const wxString& value = wxEmptyString,
  71            const wxPoint& pos = wxDefaultPosition,
  72            const wxSize& size = wxDefaultSize,
  73            int n = 0, const wxString choices[] = NULL,
  74            long style = 0,
  75            const wxValidator& validator = wxDefaultValidator,
  76            const wxString& name = wxComboBoxNameStr);
  77
  78     bool Create(wxWindow *parent, wxWindowID id,
  79            const wxString& value,
  80            const wxPoint& pos,
  81            const wxSize& size,
  82            const wxArrayString& choices,
  83            long style = 0,
  84            const wxValidator& validator = wxDefaultValidator,
  85            const wxString& name = wxComboBoxNameStr);
  86
  87     virtual int GetSelection() const;
  88     virtual void SetSelection(int n);
  89     virtual int FindString(const wxString& s, bool bCase = false) const;
  90     virtual wxString GetString(unsigned int n) const;
  91     virtual wxString GetStringSelection() const;
  92     virtual void SetString(unsigned int n, const wxString& s);
  93
  94     // Text field functions
  95     virtual void SetValue(const wxString& value);
  96     virtual wxString GetValue() const;
  97     virtual void WriteText(const wxString& text);
  98     virtual void GetSelection(long *from, long *to) const;
  99
 100     // Clipboard operations
 101     virtual void Copy();
 102     virtual void Cut();
 103     virtual void Paste();
 104     virtual void SetInsertionPoint(long pos);
 105     virtual void SetInsertionPointEnd();
 106     virtual long GetInsertionPoint() const;
 107     virtual wxTextPos GetLastPosition() const;
 108     virtual void Replace(long from, long to, const wxString& value);
 109     virtual void Remove(long from, long to);
 110     virtual void SetSelection(long from, long to);
 111     virtual void SetEditable(bool editable);
 112     virtual bool IsEditable() const;
 113
 114     virtual unsigned int GetCount() const;
 115
 116     virtual void Undo();
 117     virtual void Redo();
 118     virtual void SelectAll();
 119
 120     virtual bool CanCopy() const;
 121     virtual bool CanCut() const;
 122     virtual bool CanPaste() const;
 123     virtual bool CanUndo() const;
 124     virtual bool CanRedo() const;
 125
 126     virtual wxClientDataType GetClientDataType() const;
 127
 128     // osx specific event handling common for all osx-ports
 129
 130     virtual bool        OSXHandleClicked( double timestampsec );
 131
 132     wxCONTROL_ITEMCONTAINER_CLIENTDATAOBJECT_RECAST
 133
 134     WX_DECLARE_CONTROL_CONTAINER();
 135
 136 protected:
 137     // common part of all ctors
 138     void Init();
 139
 140     // List functions
 141     virtual void DoDeleteOneItem(unsigned int n);
 142     virtual void DoClear();
 143
 144     // wxTextEntry functions
 145     virtual wxString DoGetValue() const;
 146     virtual wxWindow *GetEditableWindow() { return this; }
 147
 148     // override the base class virtuals involved in geometry calculations
 149     virtual wxSize DoGetBestSize() const;
 150     virtual void DoMoveWindow(int x, int y, int width, int height);
 151
 152     virtual int DoInsertItems(const wxArrayStringsAdapter& items,
 153                               unsigned int pos,
 154                               void **clientData, wxClientDataType type);
 155
 156     virtual void DoSetItemClientData(unsigned int n, void* clientData);
 157     virtual void * DoGetItemClientData(unsigned int n) const;
 158
 159     virtual void SetClientDataType(wxClientDataType clientDataItemsType);
 160
 161     virtual void EnableTextChangedEvents(bool enable);
 162
 163     // the subcontrols
 164     wxComboBoxText*     m_text;
 165     wxComboBoxChoice*   m_choice;
 166
 167     DECLARE_EVENT_TABLE()
 168 };
 169
 170 #endif // _WX_COMBOBOX_H_