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 = "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 = "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 };
 128
 129 class WXDLLEXPORT wxTabEvent: public wxCommandEvent
 130 {
 131   DECLARE_DYNAMIC_CLASS(wxTabEvent)
 132
 133  public:
 134   wxTabEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
 135 };
 136
 137 typedef void (wxEvtHandler::*wxTabEventFunction)(wxTabEvent&);
 138
 139 #define EVT_TAB_SEL_CHANGED(id, fn) DECLARE_EVENT_TABLE_ENTRY(wxEVT_COMMAND_TAB_SEL_CHANGED, \
 140   id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL),
 141 #define EVT_TAB_SEL_CHANGING(id, fn) DECLARE_EVENT_TABLE_ENTRY(wxEVT_COMMAND_TAB_SEL_CHANGING, \
 142   id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL),
 143
 144 #endif
 145     // _WX_TABCTRL_H_