include/wx/mac/carbon/listbox.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/mac/carbon/listbox.h
   3 // Purpose:     wxListBox 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_LISTBOX_H_
  13 #define _WX_LISTBOX_H_
  14
  15 // ----------------------------------------------------------------------------
  16 // simple types
  17 // ----------------------------------------------------------------------------
  18 #include  "wx/dynarray.h"
  19 #include  "wx/arrstr.h"
  20
  21 // forward decl for GetSelections()
  22 class wxArrayInt;
  23
  24 // List box item
  25
  26 WX_DEFINE_ARRAY( char * , wxListDataArray ) ;
  27
  28 // ----------------------------------------------------------------------------
  29 // List box control
  30 // ----------------------------------------------------------------------------
  31
  32 class WXDLLEXPORT wxListBox : public wxListBoxBase
  33 {
  34 public:
  35     // ctors and such
  36     wxListBox();
  37     wxListBox(wxWindow *parent, wxWindowID id,
  38             const wxPoint& pos = wxDefaultPosition,
  39             const wxSize& size = wxDefaultSize,
  40             int n = 0, const wxString choices[] = NULL,
  41             long style = 0,
  42             const wxValidator& validator = wxDefaultValidator,
  43             const wxString& name = wxListBoxNameStr)
  44     {
  45         Create(parent, id, pos, size, n, choices, style, validator, name);
  46     }
  47     wxListBox(wxWindow *parent, wxWindowID id,
  48             const wxPoint& pos,
  49             const wxSize& size,
  50             const wxArrayString& choices,
  51             long style = 0,
  52             const wxValidator& validator = wxDefaultValidator,
  53             const wxString& name = wxListBoxNameStr)
  54     {
  55         Create(parent, id, pos, size, choices, style, validator, name);
  56     }
  57
  58     bool Create(wxWindow *parent, wxWindowID id,
  59                 const wxPoint& pos = wxDefaultPosition,
  60                 const wxSize& size = wxDefaultSize,
  61                 int n = 0, const wxString choices[] = NULL,
  62                 long style = 0,
  63                 const wxValidator& validator = wxDefaultValidator,
  64                 const wxString& name = wxListBoxNameStr);
  65     bool Create(wxWindow *parent, wxWindowID id,
  66                 const wxPoint& pos,
  67                 const wxSize& size,
  68                 const wxArrayString& choices,
  69                 long style = 0,
  70                 const wxValidator& validator = wxDefaultValidator,
  71                 const wxString& name = wxListBoxNameStr);
  72
  73     virtual ~wxListBox();
  74     virtual void Refresh(bool eraseBack = TRUE, const wxRect *rect = NULL);
  75
  76     // implement base class pure virtuals
  77     virtual void Clear();
  78     virtual void Delete(int n);
  79
  80     virtual int GetCount() const;
  81     virtual wxString GetString(int n) const;
  82     virtual void SetString(int n, const wxString& s);
  83     virtual int FindString(const wxString& s, bool bCase = false) const;
  84
  85     virtual bool IsSelected(int n) const;
  86     virtual void DoSetSelection(int n, bool select);
  87     virtual int GetSelection() const;
  88     virtual int GetSelections(wxArrayInt& aSelections) const;
  89
  90     virtual int DoAppend(const wxString& item);
  91     virtual void DoInsertItems(const wxArrayString& items, int pos);
  92     virtual void DoSetItems(const wxArrayString& items, void **clientData);
  93
  94     virtual void DoSetFirstItem(int n);
  95
  96     virtual void DoSetItemClientData(int n, void* clientData);
  97     virtual void* DoGetItemClientData(int n) const;
  98     virtual void DoSetItemClientObject(int n, wxClientData* clientData);
  99     virtual wxClientData* DoGetItemClientObject(int n) const;
 100     virtual void       DoSetSize(int x, int y,int width, int height,int sizeFlags = wxSIZE_AUTO ) ;
 101
 102     // wxCheckListBox support
 103     static wxVisualAttributes
 104     GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
 105
 106     // Windows callbacks
 107 #ifndef __WXMAC_OSX__
 108     void OnChar(wxKeyEvent& event);
 109 #endif
 110
 111     void*           m_macList ;
 112     wxArrayString   m_stringArray ;
 113     wxListDataArray m_dataArray ;
 114
 115     // as we are getting the same events for human and API selection we have to suppress
 116     // events in the latter case
 117     bool            MacIsSelectionSuppressed() const { return m_suppressSelection ; }
 118 protected:
 119     void            MacDelete( int n ) ;
 120     void            MacInsert( int n , const wxString& item) ;
 121     void            MacAppend( const wxString& item) ;
 122     void            MacSet( int n , const wxString& item ) ;
 123     void            MacClear() ;
 124     void            MacDeselectAll() ;
 125     void            MacSetSelection( int n , bool select ) ;
 126     int             MacGetSelection() const ;
 127     int             MacGetSelections(wxArrayInt& aSelections) const ;
 128     bool            MacIsSelected( int n ) const ;
 129     void            MacScrollTo( int n ) ;
 130     bool            MacSuppressSelection( bool suppress ) ;
 131
 132     // free memory (common part of Clear() and dtor)
 133     // prevent collision with some BSD definitions of macro Free()
 134     void FreeData();
 135
 136     int m_noItems;
 137     int m_selected;
 138     bool m_suppressSelection ;
 139     wxString  m_typeIn ;
 140     long      m_lastTypeIn ;
 141
 142     virtual wxSize DoGetBestSize() const;
 143
 144 private:
 145     DECLARE_DYNAMIC_CLASS(wxListBox)
 146     DECLARE_EVENT_TABLE()
 147 };
 148
 149 #endif // _WX_LISTBOX_H_