utils/wxPython/src/controls2.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        controls2.i
   3 // Purpose:     More control (widget) classes for wxPython
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     6/10/98
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 1998 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 %module controls2
  14
  15 %{
  16 #include "helpers.h"
  17 #include <wx/listctrl.h>
  18 #include <wx/treectrl.h>
  19 #if 0
  20 #include <wx/tabctrl.h>
  21 #endif
  22 %}
  23
  24 //----------------------------------------------------------------------
  25
  26 %include typemaps.i
  27 %include my_typemaps.i
  28
  29 // Import some definitions of other classes, etc.
  30 %import _defs.i
  31 %import misc.i
  32 %import windows.i
  33 %import gdi.i
  34 %import events.i
  35 %import controls.i
  36
  37 %pragma(python) code = "import wxp"
  38
  39 //----------------------------------------------------------------------
  40
  41 %{
  42 extern wxValidator wxPyDefaultValidator;
  43 %}
  44
  45 //----------------------------------------------------------------------
  46
  47 class wxListItem {
  48 public:
  49     long            m_mask;     // Indicates what fields are valid
  50     long            m_itemId;   // The zero-based item position
  51     int             m_col;      // Zero-based column, if in report mode
  52     long            m_state;    // The state of the item
  53     long            m_stateMask; // Which flags of m_state are valid (uses same flags)
  54     wxString        m_text;     // The label/header text
  55     int             m_image;    // The zero-based index into an image list
  56     long            m_data;     // App-defined data
  57 //    wxColour       *m_colour;   // only wxGLC, not supported by Windows ;->
  58
  59     // For columns only
  60     int             m_format;   // left, right, centre
  61     int             m_width;    // width of column
  62
  63     wxListItem();
  64     ~wxListItem();
  65 };
  66
  67 class wxListEvent: public wxCommandEvent {
  68 public:
  69     int           m_code;
  70     long          m_itemIndex;
  71     long          m_oldItemIndex;
  72     int           m_col;
  73     bool          m_cancelled;
  74     wxPoint       m_pointDrag;
  75     wxListItem    m_item;
  76 };
  77
  78
  79
  80
  81 class wxListCtrl : public wxControl {
  82 public:
  83     wxListCtrl(wxWindow* parent, wxWindowID id,
  84                const wxPoint& pos = wxPyDefaultPosition,
  85                const wxSize& size = wxPyDefaultSize,
  86                long style = wxLC_ICON,
  87                const wxValidator& validator = wxPyDefaultValidator,
  88                char* name = "listCtrl");
  89
  90     %pragma(python) addtomethod = "__init__:wxp._StdWindowCallbacks(self)"
  91
  92     bool Arrange(int flag = wxLIST_ALIGN_DEFAULT);
  93     bool DeleteItem(long item);
  94     bool DeleteAllItems();
  95     bool DeleteColumn(int col);
  96 #ifdef __WXMSW__
  97     bool DeleteAllColumns(void);
  98     void ClearAll(void);
  99     wxTextCtrl* EditLabel(long item);
 100     bool EndEditLabel(bool cancel);
 101 #endif
 102     bool EnsureVisible(long item);
 103     long FindItem(long start, const wxString& str, bool partial = FALSE);
 104     %name(FindItemData)long FindItem(long start, long data);
 105     %name(FindItemAtPos)long FindItem(long start, const wxPoint& pt,
 106                                       int direction);
 107     bool GetColumn(int col, wxListItem& item);
 108     int GetColumnWidth(int col);
 109     int GetCountPerPage();
 110 #ifdef __WXMSW__
 111     wxTextCtrl* GetEditControl();
 112 #endif
 113     wxImageList* GetImageList(int which);
 114     long GetItemData(long item);
 115
 116     %addmethods {
 117         %new wxListItem* GetItem() {
 118             wxListItem* info = new wxListItem;
 119             self->GetItem(*info);
 120             return info;
 121         }
 122         %new wxPoint* GetItemPosition(long item) {
 123             wxPoint* pos = new wxPoint;
 124             self->GetItemPosition(item, *pos);
 125             return pos;
 126         }
 127         %new wxRect* GetItemRect(long item, int code = wxLIST_RECT_BOUNDS) {
 128             wxRect* rect= new wxRect;
 129             self->GetItemRect(item, *rect, code);
 130             return rect;
 131         }
 132     }
 133
 134     int GetItemState(long item, long stateMask);
 135     int GetItemCount();
 136     int GetItemSpacing(bool isSmall);
 137     wxString GetItemText(long item);
 138     long GetNextItem(long item,
 139                      int geometry = wxLIST_NEXT_ALL,
 140                      int state = wxLIST_STATE_DONTCARE);
 141     int GetSelectedItemCount();
 142 #ifdef __WXMSW__
 143     wxColour GetTextColour();
 144 #endif
 145     long GetTopItem();
 146     long HitTest(const wxPoint& point, int& OUTPUT);
 147     %name(InsertColumnWithInfo)long InsertColumn(long col, wxListItem& info);
 148     long InsertColumn(long col, const wxString& heading,
 149                       int format = wxLIST_FORMAT_LEFT,
 150                       int width = -1);
 151
 152     long InsertItem(wxListItem& info);
 153     %name(InsertStringItem)     long InsertItem(long index, const wxString& label);
 154     %name(InsertImageItem)      long InsertItem(long index, int imageIndex);
 155     %name(InsertImageStringItem)long InsertItem(long index, const wxString& label,
 156                                                 int imageIndex);
 157
 158     bool ScrollList(int dx, int dy);
 159     void SetBackgroundColour(const wxColour& col);
 160     bool SetColumn(int col, wxListItem& item);
 161     bool SetColumnWidth(int col, int width);
 162     void SetImageList(wxImageList* imageList, int which);
 163     bool SetItem(wxListItem& info);
 164     %name(SetItemString)long SetItem(long index, int col, const wxString& label,
 165                                      int imageId = -1);
 166     bool SetItemData(long item, long data);
 167     bool SetItemImage(long item, int image, int selImage);
 168     bool SetItemPosition(long item, const wxPoint& pos);
 169     bool SetItemState(long item, long state, long stateMask);
 170     void SetItemText(long item, const wxString& text);
 171     void SetSingleStyle(long style, bool add = TRUE);
 172 #ifdef __WXMSW__
 173     void SetTextColour(const wxColour& col);
 174 #endif
 175     void SetWindowStyleFlag(long style);
 176     // TODO:  bool SortItems(wxListCtrlCompare fn, long data);
 177 };
 178
 179
 180
 181 //----------------------------------------------------------------------
 182
 183
 184 //#ifdef __WXMSW__
 185 class wxTreeItemId {
 186 public:
 187     wxTreeItemId();
 188     ~wxTreeItemId();
 189     bool IsOk() const { return m_itemId != 0; }
 190
 191 //    %addmethods {
 192 //        long GetId() { return (long)(*self); }
 193 //    }
 194 };
 195
 196
 197
 198 // ****  This isn't very useful yet.  This needs to be specialized to enable
 199 // derived Python classes...
 200 class wxTreeItemData {
 201 public:
 202     wxTreeItemData();
 203     ~wxTreeItemData();
 204
 205     const wxTreeItemId& GetId();
 206     void SetId(const wxTreeItemId& id);
 207 };
 208
 209
 210
 211
 212 class wxTreeEvent : public wxCommandEvent {
 213 public:
 214     wxTreeItemId GetItem();
 215     wxTreeItemId GetOldItem();
 216     wxPoint GetPoint();
 217     int GetCode();
 218     void Veto();
 219 };
 220
 221
 222 // These are for the GetFirstChild/GetNextChild methods below
 223 %typemap(python, in)     long& INOUT = long* INOUT;
 224 %typemap(python, argout) long& INOUT = long* INOUT;
 225
 226
 227 class wxTreeCtrl : public wxControl {
 228 public:
 229 #ifdef __WXMSW__
 230     wxTreeCtrl(wxWindow *parent, wxWindowID id = -1,
 231                const wxPoint& pos = wxPyDefaultPosition,
 232                const wxSize& size = wxPyDefaultSize,
 233                long style = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT,
 234                const wxValidator& validator = wxPyDefaultValidator,
 235                char* name = "wxTreeCtrl");
 236
 237 #else
 238     wxTreeCtrl(wxWindow *parent, wxWindowID id = -1,
 239                const wxPoint& pos = wxPyDefaultPosition,
 240                const wxSize& size = wxPyDefaultSize,
 241                long style = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT,
 242                //const wxValidator& validator = wxPyDefaultValidator,
 243                char* name = "wxTreeCtrl");
 244 #endif
 245     %pragma(python) addtomethod = "__init__:wxp._StdWindowCallbacks(self)"
 246
 247     size_t GetCount();
 248     unsigned int GetIndent();
 249     void SetIndent(unsigned int indent);
 250     wxImageList *GetImageList();
 251     wxImageList *GetStateImageList();
 252     void SetImageList(wxImageList *imageList);
 253     void SetStateImageList(wxImageList *imageList);
 254
 255     wxString GetItemText(const wxTreeItemId& item);
 256     int GetItemImage(const wxTreeItemId& item);
 257     int GetItemSelectedImage(const wxTreeItemId& item);
 258     wxTreeItemData *GetItemData(const wxTreeItemId& item);
 259
 260     void SetItemText(const wxTreeItemId& item, const wxString& text);
 261     void SetItemImage(const wxTreeItemId& item, int image);
 262     void SetItemSelectedImage(const wxTreeItemId& item, int image);
 263     void SetItemData(const wxTreeItemId& item, wxTreeItemData *data);
 264
 265     bool IsVisible(const wxTreeItemId& item);
 266     bool ItemHasChildren(const wxTreeItemId& item);
 267     bool IsExpanded(const wxTreeItemId& item);
 268     bool IsSelected(const wxTreeItemId& item);
 269
 270     wxTreeItemId GetRootItem();
 271     wxTreeItemId GetSelection();
 272     wxTreeItemId GetParent(const wxTreeItemId& item);
 273
 274     wxTreeItemId GetFirstChild(const wxTreeItemId& item, long& INOUT);
 275     wxTreeItemId GetNextChild(const wxTreeItemId& item, long& INOUT);
 276     wxTreeItemId GetNextSibling(const wxTreeItemId& item);
 277     wxTreeItemId GetPrevSibling(const wxTreeItemId& item);
 278     wxTreeItemId GetFirstVisibleItem();
 279     wxTreeItemId GetNextVisible(const wxTreeItemId& item);
 280     wxTreeItemId GetPrevVisible(const wxTreeItemId& item);
 281
 282
 283     wxTreeItemId AddRoot(const wxString& text,
 284                          int image = -1, int selectedImage = -1,
 285                          wxTreeItemData *data = NULL);
 286     wxTreeItemId PrependItem(const wxTreeItemId& parent,
 287                              const wxString& text,
 288                              int image = -1, int selectedImage = -1,
 289                              wxTreeItemData *data = NULL);
 290     wxTreeItemId InsertItem(const wxTreeItemId& parent,
 291                             const wxTreeItemId& idPrevious,
 292                             const wxString& text,
 293                             int image = -1, int selectedImage = -1,
 294                             wxTreeItemData *data = NULL);
 295     wxTreeItemId AppendItem(const wxTreeItemId& parent,
 296                             const wxString& text,
 297                             int image = -1, int selectedImage = -1,
 298                             wxTreeItemData *data = NULL);
 299
 300     void Delete(const wxTreeItemId& item);
 301     void DeleteAllItems();
 302
 303     void Expand(const wxTreeItemId& item);
 304     void Collapse(const wxTreeItemId& item);
 305     void CollapseAndReset(const wxTreeItemId& item);
 306     void Toggle(const wxTreeItemId& item);
 307
 308     void Unselect();
 309     void SelectItem(const wxTreeItemId& item);
 310     void EnsureVisible(const wxTreeItemId& item);
 311     void ScrollTo(const wxTreeItemId& item);
 312
 313     wxTextCtrl* EditLabel(const wxTreeItemId& item);
 314                           // **** figure out how to do this
 315                           // wxClassInfo* textCtrlClass = CLASSINFO(wxTextCtrl));
 316     wxTextCtrl* GetEditControl();
 317     void EndEditLabel(const wxTreeItemId& item, bool discardChanges = FALSE);
 318
 319 //    void SortChildren(const wxTreeItemId& item);
 320                       // **** And this too
 321                       // wxTreeItemCmpFunc *cmpFunction = NULL);
 322
 323 };
 324
 325 //#endif
 326
 327 //----------------------------------------------------------------------
 328
 329 #ifdef SKIPTHIS
 330 #ifdef __WXMSW__
 331 class wxTabEvent : public wxCommandEvent {
 332 public:
 333 };
 334
 335
 336
 337 class wxTabCtrl : public wxControl {
 338 public:
 339     wxTabCtrl(wxWindow* parent, wxWindowID id,
 340               const wxPoint& pos = wxPyDefaultPosition,
 341               const wxSize& size = wxPyDefaultSize,
 342               long style = 0,
 343               char* name = "tabCtrl");
 344
 345     %pragma(python) addtomethod = "__init__:wxp._StdWindowCallbacks(self)"
 346
 347     bool DeleteAllItems();
 348     bool DeleteItem(int item);
 349     wxImageList* GetImageList();
 350     int GetItemCount();
 351     // TODO: void* GetItemData();
 352     int GetItemImage(int item);
 353
 354     %addmethods {
 355         %new wxRect* GetItemRect(int item) {
 356             wxRect* rect = new wxRect;
 357             self->GetItemRect(item, *rect);
 358             return rect;
 359         }
 360     }
 361
 362     wxString GetItemText(int item);
 363     bool GetRowCount();
 364     int GetSelection();
 365     int HitTest(const wxPoint& pt, long& OUTPUT);
 366     void InsertItem(int item, const wxString& text,
 367                     int imageId = -1, void* clientData = NULL);
 368     // TODO: bool SetItemData(int item, void* data);
 369     bool SetItemImage(int item, int image);
 370     void SetImageList(wxImageList* imageList);
 371     void SetItemSize(const wxSize& size);
 372     bool SetItemText(int item, const wxString& text);
 373     void SetPadding(const wxSize& padding);
 374     int SetSelection(int item);
 375
 376 };
 377
 378 #endif
 379 #endif
 380
 381 //----------------------------------------------------------------------
 382
 383
 384 /////////////////////////////////////////////////////////////////////////////
 385 //
 386 // $Log$
 387 // Revision 1.9  1998/11/16 00:00:54  RD
 388 // Generic treectrl for wxPython/GTK compiles...
 389 //
 390 // Revision 1.8  1998/11/11 04:40:20  RD
 391 // wxTreeCtrl now works (sort of) for wxPython-GTK.  This is the new
 392 // TreeCtrl in src/gtk/treectrl.cpp not the old generic one.
 393 //
 394 // Revision 1.7  1998/11/11 03:12:25  RD
 395 //
 396 // Additions for wxTreeCtrl
 397 //
 398 // Revision 1.6  1998/10/20 06:43:55  RD
 399 // New wxTreeCtrl wrappers (untested)
 400 // some changes in helpers
 401 // etc.
 402 //
 403 // Revision 1.5  1998/10/07 07:34:33  RD
 404 // Version 0.4.1 for wxGTK
 405 //
 406 // Revision 1.4  1998/10/02 06:40:36  RD
 407 //
 408 // Version 0.4 of wxPython for MSW.
 409 //
 410 // Revision 1.3  1998/08/18 19:48:15  RD
 411 // more wxGTK compatibility things.
 412 //
 413 // It builds now but there are serious runtime problems...
 414 //
 415 // Revision 1.2  1998/08/15 07:36:30  RD
 416 // - Moved the header in the .i files out of the code that gets put into
 417 // the .cpp files.  It caused CVS conflicts because of the RCS ID being
 418 // different each time.
 419 //
 420 // - A few minor fixes.
 421 //
 422 // Revision 1.1  1998/08/09 08:25:49  RD
 423 // Initial version
 424 //
 425 //