include/wx/gtk/listbox.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/gtk/listbox.h
   3 // Purpose:     wxListBox class declaration
   4 // Author:      Robert Roebling
   5 // Id:          $Id$
   6 // Copyright:   (c) 1998 Robert Roebling
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifndef _WX_GTK_LISTBOX_H_
  11 #define _WX_GTK_LISTBOX_H_
  12
  13 struct _GtkTreeEntry;
  14 struct _GtkTreeIter;
  15
  16 //-----------------------------------------------------------------------------
  17 // wxListBox
  18 //-----------------------------------------------------------------------------
  19
  20 class WXDLLIMPEXP_CORE wxListBox : public wxListBoxBase
  21 {
  22 public:
  23     // ctors and such
  24     wxListBox()
  25     {
  26         Init();
  27     }
  28     wxListBox( wxWindow *parent, wxWindowID id,
  29             const wxPoint& pos = wxDefaultPosition,
  30             const wxSize& size = wxDefaultSize,
  31             int n = 0, const wxString choices[] = (const wxString *) NULL,
  32             long style = 0,
  33             const wxValidator& validator = wxDefaultValidator,
  34             const wxString& name = wxListBoxNameStr )
  35     {
  36         Init();
  37         Create(parent, id, pos, size, n, choices, style, validator, name);
  38     }
  39     wxListBox( wxWindow *parent, wxWindowID id,
  40             const wxPoint& pos,
  41             const wxSize& size,
  42             const wxArrayString& choices,
  43             long style = 0,
  44             const wxValidator& validator = wxDefaultValidator,
  45             const wxString& name = wxListBoxNameStr )
  46     {
  47         Init();
  48         Create(parent, id, pos, size, choices, style, validator, name);
  49     }
  50     virtual ~wxListBox();
  51
  52     bool Create(wxWindow *parent, wxWindowID id,
  53                 const wxPoint& pos = wxDefaultPosition,
  54                 const wxSize& size = wxDefaultSize,
  55                 int n = 0, const wxString choices[] = (const wxString *) NULL,
  56                 long style = 0,
  57                 const wxValidator& validator = wxDefaultValidator,
  58                 const wxString& name = wxListBoxNameStr);
  59     bool Create(wxWindow *parent, wxWindowID id,
  60                 const wxPoint& pos,
  61                 const wxSize& size,
  62                 const wxArrayString& choices,
  63                 long style = 0,
  64                 const wxValidator& validator = wxDefaultValidator,
  65                 const wxString& name = wxListBoxNameStr);
  66
  67     // implement base class pure virtuals
  68     virtual void Clear();
  69     virtual void Delete(unsigned int n);
  70
  71     virtual unsigned int GetCount() const;
  72     virtual wxString GetString(unsigned int n) const;
  73     virtual void SetString(unsigned int n, const wxString& s);
  74     virtual int FindString(const wxString& s, bool bCase = false) const;
  75
  76     virtual bool IsSelected(int n) const;
  77     virtual int GetSelection() const;
  78     virtual int GetSelections(wxArrayInt& aSelections) const;
  79
  80     static wxVisualAttributes
  81     GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
  82
  83     // implementation from now on
  84
  85     GtkWidget *GetConnectWidget();
  86
  87 #if wxUSE_TOOLTIPS
  88     void ApplyToolTip( GtkTooltips *tips, const gchar *tip );
  89 #endif // wxUSE_TOOLTIPS
  90
  91     struct _GtkTreeView   *m_treeview;
  92     struct _GtkListStore  *m_liststore;
  93
  94 #if wxUSE_CHECKLISTBOX
  95     bool       m_hasCheckBoxes;
  96 #endif // wxUSE_CHECKLISTBOX
  97
  98     bool       m_blockEvent;
  99
 100     struct _GtkTreeEntry* GtkGetEntry(unsigned pos) const;
 101     void GtkInsertItems(const wxArrayString& items,
 102                         void** clientData, unsigned int pos);
 103     void GtkDeselectAll();
 104     void GtkSetSelection(int n, const bool select, const bool blockEvent);
 105
 106 protected:
 107     virtual wxSize DoGetBestSize() const;
 108     virtual void DoApplyWidgetStyle(GtkRcStyle *style);
 109     virtual GdkWindow *GTKGetWindow(wxArrayGdkWindows& windows) const;
 110
 111     virtual void DoSetSelection(int n, bool select);
 112     virtual int DoAppend(const wxString& item);
 113     virtual void DoInsertItems(const wxArrayString& items, unsigned int pos);
 114     virtual void DoSetItems(const wxArrayString& items, void **clientData);
 115     virtual void DoSetFirstItem(int n);
 116     virtual void DoSetItemClientData(unsigned int n, void* clientData);
 117     virtual void* DoGetItemClientData(unsigned int n) const;
 118     virtual void DoSetItemClientObject(unsigned int n, wxClientData* clientData);
 119     virtual wxClientData* DoGetItemClientObject(unsigned int n) const;
 120     virtual int DoListHitTest(const wxPoint& point) const;
 121
 122     // get the iterator for the given index, returns false if invalid
 123     bool GtkGetIteratorFor(unsigned pos, _GtkTreeIter *iter) const;
 124
 125     // get the index for the given iterator, return wxNOT_FOUND on failure
 126     int GtkGetIndexFor(_GtkTreeIter& iter) const;
 127
 128     // set the specified item
 129     void GtkSetItem(_GtkTreeIter& iter, const _GtkTreeEntry *entry);
 130
 131 private:
 132     void Init(); //common construction
 133
 134     DECLARE_DYNAMIC_CLASS(wxListBox)
 135 };
 136
 137 #endif // _WX_GTK_LISTBOX_H_