wxPython/src/calendar.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        calendar.i
   3 // Purpose:     SWIG definitions for the wxCalendarCtrl
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     23-May-2000
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2000 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 %module calendar
  14
  15
  16 %{
  17 #include "helpers.h"
  18 #include <wx/calctrl.h>
  19 %}
  20
  21 //----------------------------------------------------------------------
  22
  23 %include typemaps.i
  24 %include my_typemaps.i
  25
  26 // Import some definitions of other classes, etc.
  27 %import _defs.i
  28 %import misc.i
  29 %import windows.i
  30 %import controls.i
  31 %import events.i
  32 %import utils.i
  33
  34 %pragma(python) code = "import wx"
  35
  36 //---------------------------------------------------------------------------
  37
  38 enum {
  39     wxCAL_SUNDAY_FIRST,
  40     wxCAL_MONDAY_FIRST,
  41     wxCAL_SHOW_HOLIDAYS,
  42     wxCAL_NO_YEAR_CHANGE,
  43     wxCAL_NO_MONTH_CHANGE,
  44 };
  45
  46
  47 enum wxCalendarHitTestResult
  48 {
  49     wxCAL_HITTEST_NOWHERE,      // outside of anything
  50     wxCAL_HITTEST_HEADER,       // on the header (weekdays)
  51     wxCAL_HITTEST_DAY           // on a day in the calendar
  52 };
  53
  54 // border types for a date
  55 enum wxCalendarDateBorder
  56 {
  57     wxCAL_BORDER_NONE,          // no border (default)
  58     wxCAL_BORDER_SQUARE,        // a rectangular border
  59     wxCAL_BORDER_ROUND          // a round border
  60 };
  61
  62 //---------------------------------------------------------------------------
  63
  64
  65 class wxCalendarDateAttr
  66 {
  67 public:
  68     // ctors
  69     wxCalendarDateAttr(const wxColour& colText,
  70                        const wxColour& colBack = wxNullColour,
  71                        const wxColour& colBorder = wxNullColour,
  72                        const wxFont& font = wxNullFont,
  73                        wxCalendarDateBorder border = wxCAL_BORDER_NONE);
  74
  75     %name(wxCalendarDateAttrBorder)
  76         wxCalendarDateAttr(wxCalendarDateBorder border,
  77                            const wxColour& colBorder = wxNullColour);
  78
  79     // setters
  80     void SetTextColour(const wxColour& colText);
  81     void SetBackgroundColour(const wxColour& colBack);
  82     void SetBorderColour(const wxColour& col);
  83     void SetFont(const wxFont& font);
  84     void SetBorder(wxCalendarDateBorder border);
  85     void SetHoliday(bool holiday);
  86
  87     // accessors
  88     bool HasTextColour() const;
  89     bool HasBackgroundColour() const;
  90     bool HasBorderColour() const;
  91     bool HasFont() const;
  92     bool HasBorder() const;
  93
  94     bool IsHoliday() const;
  95
  96     const wxColour& GetTextColour() const;
  97     const wxColour& GetBackgroundColour() const;
  98     const wxColour& GetBorderColour() const;
  99     const wxFont& GetFont() const;
 100     wxCalendarDateBorder GetBorder() const;
 101 };
 102
 103 //---------------------------------------------------------------------------
 104
 105 class wxCalendarCtrl;
 106
 107 class wxCalendarEvent : public wxCommandEvent
 108 {
 109 public:
 110     wxCalendarEvent(wxCalendarCtrl *cal, wxEventType type);
 111
 112     const wxDateTime& GetDate() const;
 113     wxDateTime::WeekDay GetWeekDay() const;
 114
 115 };
 116
 117 enum {
 118     wxEVT_CALENDAR_DOUBLECLICKED,
 119     wxEVT_CALENDAR_SEL_CHANGED,
 120     wxEVT_CALENDAR_DAY_CHANGED,
 121     wxEVT_CALENDAR_MONTH_CHANGED,
 122     wxEVT_CALENDAR_YEAR_CHANGED,
 123     wxEVT_CALENDAR_WEEKDAY_CLICKED,
 124 };
 125
 126 %pragma(python) code = "
 127 def EVT_CALENDAR(win, id, fn):
 128     win.Connect(id, -1, wxEVT_CALENDAR_DOUBLECLICKED, fn)
 129
 130 def EVT_CALENDAR_SEL_CHANGED(win, id, fn):
 131     win.Connect(id, -1, wxEVT_CALENDAR_SEL_CHANGED, fn)
 132
 133 def EVT_CALENDAR_DAY(win, id, fn):
 134     win.Connect(id, -1, wxEVT_CALENDAR_DAY_CHANGED, fn)
 135
 136 def EVT_CALENDAR_MONTH(win, id, fn):
 137     win.Connect(id, -1, wxEVT_CALENDAR_MONTH_CHANGED, fn)
 138
 139 def EVT_CALENDAR_YEAR(win, id, fn):
 140     win.Connect(id, -1, wxEVT_CALENDAR_YEAR_CHANGED, fn)
 141
 142 def EVT_CALENDAR_WEEKDAY_CLICKED(win, id, fn):
 143     win.Connect(id, -1, wxEVT_CALENDAR_WEEKDAY_CLICKED, fn)
 144
 145 "
 146
 147 //---------------------------------------------------------------------------
 148
 149 class wxCalendarCtrl : public wxControl
 150 {
 151 public:
 152     // construction
 153     wxCalendarCtrl(wxWindow *parent,
 154                    wxWindowID id,
 155                    const wxDateTime& date = wxDefaultDateTime,
 156                    const wxPoint& pos = wxDefaultPosition,
 157                    const wxSize& size = wxDefaultSize,
 158                    long style = wxCAL_SHOW_HOLIDAYS,
 159                    const char* name = "calendar");
 160
 161     // set/get the current date
 162     // ------------------------
 163
 164     void SetDate(const wxDateTime& date);
 165     const wxDateTime& GetDate() const;
 166
 167     // calendar mode
 168     // -------------
 169
 170     // some calendar styles can't be changed after the control creation by
 171     // just using SetWindowStyle() and Refresh() and the functions below
 172     // should be used instead for them
 173
 174     // corresponds to wxCAL_NO_YEAR_CHANGE bit
 175     void EnableYearChange(bool enable = TRUE);
 176
 177     // corresponds to wxCAL_NO_MONTH_CHANGE bit
 178     void EnableMonthChange(bool enable = TRUE);
 179
 180     // corresponds to wxCAL_SHOW_HOLIDAYS bit
 181     void EnableHolidayDisplay(bool display = TRUE);
 182
 183     // customization
 184     // -------------
 185
 186     // header colours are used for painting the weekdays at the top
 187     void SetHeaderColours(const wxColour& colFg, const wxColour& colBg);
 188     const wxColour& GetHeaderColourFg() const;
 189     const wxColour& GetHeaderColourBg() const;
 190
 191     // highlight colour is used for the currently selected date
 192     void SetHighlightColours(const wxColour& colFg, const wxColour& colBg);
 193     const wxColour& GetHighlightColourFg() const;
 194     const wxColour& GetHighlightColourBg() const;
 195
 196     // holiday colour is used for the holidays (if style & wxCAL_SHOW_HOLIDAYS)
 197     void SetHolidayColours(const wxColour& colFg, const wxColour& colBg);
 198     const wxColour& GetHolidayColourFg() const;
 199     const wxColour& GetHolidayColourBg() const;
 200
 201     // an item without custom attributes is drawn with the default colours and
 202     // font and without border, setting custom attributes allows to modify this
 203     //
 204     // the day parameter should be in 1..31 range, for days 29, 30, 31 the
 205     // corresponding attribute is just unused if there is no such day in the
 206     // current month
 207
 208     wxCalendarDateAttr *GetAttr(size_t day) const;
 209     void SetAttr(size_t day, wxCalendarDateAttr *attr);
 210
 211     void SetHoliday(size_t day);
 212
 213     void ResetAttr(size_t day);
 214
 215     // returns one of wxCAL_HITTEST_XXX constants and fills either date or wd
 216     // with the corresponding value (none for NOWHERE, the date for DAY and wd
 217     // for HEADER)
 218     wxCalendarHitTestResult HitTest(const wxPoint& pos,
 219                                     wxDateTime *date = NULL,
 220                                     wxDateTime::WeekDay *wd = NULL);
 221
 222 };
 223
 224
 225 //---------------------------------------------------------------------------
 226 //---------------------------------------------------------------------------
 227
 228 %pragma(python) include="_calextras.py";
 229
 230 //---------------------------------------------------------------------------
 231