include/wx/msw/tabctrl.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        tabctrl.h
   3 // Purpose:     wxTabCtrl 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_TABCTRL_H_
  13 #define _WX_TABCTRL_H_
  14
  15 #ifdef __GNUG__
  16 #pragma interface "tabctrl.h"
  17 #endif
  18
  19 class wxImageList;
  20
  21 // WXDLLEXPORT_DATA(extern const wxChar*) wxToolBarNameStr;
  22
  23 /*
  24  * Flags returned by HitTest
  25  */
  26
  27 #define wxTAB_HITTEST_NOWHERE           1
  28 #define wxTAB_HITTEST_ONICON            2
  29 #define wxTAB_HITTEST_ONLABEL           4
  30 #define wxTAB_HITTEST_ONITEM            6
  31
  32 class WXDLLEXPORT wxTabCtrl: public wxControl
  33 {
  34   DECLARE_DYNAMIC_CLASS(wxTabCtrl)
  35  public:
  36    /*
  37     * Public interface
  38     */
  39
  40     wxTabCtrl();
  41
  42     inline wxTabCtrl(wxWindow *parent, wxWindowID id, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
  43             long style = 0, const wxString& name = wxT("tabCtrl"))
  44     {
  45         Create(parent, id, pos, size, style, name);
  46     }
  47     ~wxTabCtrl();
  48
  49 // Accessors
  50
  51     // Get the selection
  52     int GetSelection() const;
  53
  54     // Get the tab with the current keyboard focus
  55     int GetCurFocus() const;
  56
  57     // Get the associated image list
  58     wxImageList* GetImageList() const;
  59
  60     // Get the number of items
  61     int GetItemCount() const;
  62
  63     // Get the rect corresponding to the tab
  64     bool GetItemRect(int item, wxRect& rect) const;
  65
  66     // Get the number of rows
  67     int GetRowCount() const;
  68
  69     // Get the item text
  70     wxString GetItemText(int item) const ;
  71
  72     // Get the item image
  73     int GetItemImage(int item) const;
  74
  75     // Get the item data
  76     void* GetItemData(int item) const;
  77
  78     // Set the selection
  79     int SetSelection(int item);
  80
  81     // Set the image list
  82     void SetImageList(wxImageList* imageList);
  83
  84     // Set the text for an item
  85     bool SetItemText(int item, const wxString& text);
  86
  87     // Set the image for an item
  88     bool SetItemImage(int item, int image);
  89
  90     // Set the data for an item
  91     bool SetItemData(int item, void* data);
  92
  93     // Set the size for a fixed-width tab control
  94     void SetItemSize(const wxSize& size);
  95
  96     // Set the padding between tabs
  97     void SetPadding(const wxSize& padding);
  98
  99 // Operations
 100
 101     bool Create(wxWindow *parent, wxWindowID id, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
 102                 long style = 0, const wxString& name = wxT("tabCtrl"));
 103
 104     // Delete all items
 105     bool DeleteAllItems();
 106
 107     // Delete an item
 108     bool DeleteItem(int item);
 109
 110     // Hit test
 111     int HitTest(const wxPoint& pt, long& flags);
 112
 113     // Insert an item
 114     bool InsertItem(int item, const wxString& text, int imageId = -1, void* data = NULL);
 115
 116     // Implementation
 117
 118     virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
 119
 120     // Responds to colour changes
 121     void OnSysColourChanged(wxSysColourChangedEvent& event);
 122
 123 protected:
 124     wxImageList*    m_imageList;
 125
 126 DECLARE_EVENT_TABLE()
 127     DECLARE_NO_COPY_CLASS(wxTabCtrl)
 128 };
 129
 130 class WXDLLEXPORT wxTabEvent : public wxNotifyEvent
 131 {
 132 public:
 133     wxTabEvent(wxEventType commandType = wxEVT_NULL, int id = 0,
 134                     int nSel = -1, int nOldSel = -1)
 135         : wxNotifyEvent(commandType, id)
 136         {
 137             m_nSel = nSel;
 138             m_nOldSel = nOldSel;
 139         }
 140
 141     // accessors
 142         // the currently selected page (-1 if none)
 143     int GetSelection() const { return m_nSel; }
 144     void SetSelection(int nSel) { m_nSel = nSel; }
 145         // the page that was selected before the change (-1 if none)
 146     int GetOldSelection() const { return m_nOldSel; }
 147     void SetOldSelection(int nOldSel) { m_nOldSel = nOldSel; }
 148
 149 private:
 150     int m_nSel,     // currently selected page
 151         m_nOldSel;  // previously selected page
 152
 153     DECLARE_DYNAMIC_CLASS(wxTabEvent)
 154 };
 155
 156 typedef void (wxEvtHandler::*wxTabEventFunction)(wxTabEvent&);
 157
 158 #define EVT_TAB_SEL_CHANGED(id, fn) DECLARE_EVENT_TABLE_ENTRY(wxEVT_COMMAND_TAB_SEL_CHANGED, \
 159   id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL),
 160 #define EVT_TAB_SEL_CHANGING(id, fn) DECLARE_EVENT_TABLE_ENTRY(wxEVT_COMMAND_TAB_SEL_CHANGING, \
 161   id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL),
 162
 163 #endif
 164     // _WX_TABCTRL_H_