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 #ifdef __WXMSW__
  18 #include <windows.h>
  19 #endif
  20 #include <wx/listctrl.h>
  21 #include <wx/treectrl.h>
  22 #include <wx/imaglist.h>
  23 #include <wx/dirctrl.h>
  24
  25 #include "pytree.h"
  26 %}
  27
  28 //----------------------------------------------------------------------
  29
  30 %include typemaps.i
  31 %include my_typemaps.i
  32
  33 // Import some definitions of other classes, etc.
  34 %import _defs.i
  35 %import misc.i
  36 %import windows.i
  37 %import gdi.i
  38 %import events.i
  39 %import controls.i
  40
  41 %pragma(python) code = "import wx"
  42
  43
  44 //----------------------------------------------------------------------
  45 %{
  46     // Put some wx default wxChar* values into wxStrings.
  47     const wxChar* wxListCtrlNameStr = _T("wxListCtrl");
  48     DECLARE_DEF_STRING(ListCtrlNameStr);
  49
  50     const wxChar* wx_TreeCtrlNameStr = _T("wxTreeCtrl");
  51     DECLARE_DEF_STRING(_TreeCtrlNameStr);
  52     DECLARE_DEF_STRING(DirDialogDefaultFolderStr);
  53
  54     static const wxString wxPyEmptyString(wxT(""));
  55 %}
  56
  57
  58 %{
  59     static const long longzero = 0;
  60 %}
  61
  62 //----------------------------------------------------------------------
  63
  64 enum {
  65     /* List control event types */
  66     wxEVT_COMMAND_LIST_BEGIN_DRAG,
  67     wxEVT_COMMAND_LIST_BEGIN_RDRAG,
  68     wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT,
  69     wxEVT_COMMAND_LIST_END_LABEL_EDIT,
  70     wxEVT_COMMAND_LIST_DELETE_ITEM,
  71     wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS,
  72     wxEVT_COMMAND_LIST_GET_INFO,
  73     wxEVT_COMMAND_LIST_SET_INFO,
  74     wxEVT_COMMAND_LIST_ITEM_SELECTED,
  75     wxEVT_COMMAND_LIST_ITEM_DESELECTED,
  76     wxEVT_COMMAND_LIST_KEY_DOWN,
  77     wxEVT_COMMAND_LIST_INSERT_ITEM,
  78     wxEVT_COMMAND_LIST_COL_CLICK,
  79     wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK,
  80     wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK,
  81     wxEVT_COMMAND_LIST_ITEM_ACTIVATED,
  82     wxEVT_COMMAND_LIST_CACHE_HINT,
  83     wxEVT_COMMAND_LIST_COL_RIGHT_CLICK,
  84     wxEVT_COMMAND_LIST_COL_BEGIN_DRAG,
  85     wxEVT_COMMAND_LIST_COL_DRAGGING,
  86     wxEVT_COMMAND_LIST_COL_END_DRAG,
  87     wxEVT_COMMAND_LIST_ITEM_FOCUSED,
  88 };
  89
  90
  91 %pragma(python) code = "
  92 def EVT_LIST_BEGIN_DRAG(win, id, func):
  93     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_DRAG, func)
  94
  95 def EVT_LIST_BEGIN_RDRAG(win, id, func):
  96     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_RDRAG, func)
  97
  98 def EVT_LIST_BEGIN_LABEL_EDIT(win, id, func):
  99     win.Connect(id, -1, wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT, func)
 100
 101 def EVT_LIST_END_LABEL_EDIT(win, id, func):
 102     win.Connect(id, -1, wxEVT_COMMAND_LIST_END_LABEL_EDIT, func)
 103
 104 def EVT_LIST_DELETE_ITEM(win, id, func):
 105     win.Connect(id, -1, wxEVT_COMMAND_LIST_DELETE_ITEM, func)
 106
 107 def EVT_LIST_DELETE_ALL_ITEMS(win, id, func):
 108     win.Connect(id, -1, wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS, func)
 109
 110 def EVT_LIST_GET_INFO(win, id, func):
 111     win.Connect(id, -1, wxEVT_COMMAND_LIST_GET_INFO, func)
 112
 113 def EVT_LIST_SET_INFO(win, id, func):
 114     win.Connect(id, -1, wxEVT_COMMAND_LIST_SET_INFO, func)
 115
 116 def EVT_LIST_ITEM_SELECTED(win, id, func):
 117     win.Connect(id, -1,  wxEVT_COMMAND_LIST_ITEM_SELECTED, func)
 118
 119 def EVT_LIST_ITEM_DESELECTED(win, id, func):
 120     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_DESELECTED, func)
 121
 122 def EVT_LIST_KEY_DOWN(win, id, func):
 123     win.Connect(id, -1, wxEVT_COMMAND_LIST_KEY_DOWN, func)
 124
 125 def EVT_LIST_INSERT_ITEM(win, id, func):
 126     win.Connect(id, -1, wxEVT_COMMAND_LIST_INSERT_ITEM, func)
 127
 128 def EVT_LIST_COL_CLICK(win, id, func):
 129     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_CLICK, func)
 130
 131 def EVT_LIST_COL_RIGHT_CLICK(win, id, func):
 132     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_RIGHT_CLICK, func)
 133
 134 def EVT_LIST_COL_BEGIN_DRAG(win, id, func):
 135     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_BEGIN_DRAG, func)
 136
 137 def EVT_LIST_COL_DRAGGING(win, id, func):
 138     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_DRAGGING, func)
 139
 140 def EVT_LIST_COL_END_DRAG(win, id, func):
 141     win.Connect(id, -1, wxEVT_COMMAND_LIST_COL_END_DRAG, func)
 142
 143 def EVT_LIST_ITEM_RIGHT_CLICK(win, id, func):
 144     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK, func)
 145
 146 def EVT_LIST_ITEM_MIDDLE_CLICK(win, id, func):
 147     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK, func)
 148
 149 def EVT_LIST_ITEM_ACTIVATED(win, id, func):
 150     win.Connect(id, -1,  wxEVT_COMMAND_LIST_ITEM_ACTIVATED, func)
 151
 152 def EVT_LIST_CACHE_HINT(win, id, func):
 153     win.Connect(id, -1, wxEVT_COMMAND_LIST_CACHE_HINT, func)
 154
 155 def EVT_LIST_ITEM_FOCUSED(win, id, func):
 156     win.Connect(id, -1, wxEVT_COMMAND_LIST_ITEM_FOCUSED, func)
 157 "
 158
 159
 160 enum {
 161     /* Style flags */
 162     wxLC_VRULES,
 163     wxLC_HRULES,
 164
 165     wxLC_ICON,
 166     wxLC_SMALL_ICON,
 167     wxLC_LIST,
 168     wxLC_REPORT,
 169
 170     wxLC_ALIGN_TOP,
 171     wxLC_ALIGN_LEFT,
 172     wxLC_AUTOARRANGE,
 173     wxLC_VIRTUAL,
 174     wxLC_EDIT_LABELS,
 175     wxLC_NO_HEADER,
 176     wxLC_NO_SORT_HEADER,
 177     wxLC_SINGLE_SEL,
 178     wxLC_SORT_ASCENDING,
 179     wxLC_SORT_DESCENDING,
 180
 181     wxLC_MASK_TYPE,
 182     wxLC_MASK_ALIGN,
 183     wxLC_MASK_SORT,
 184
 185     wxLC_USER_TEXT,
 186 };
 187
 188
 189 enum {
 190     // Mask flags
 191     wxLIST_MASK_STATE,
 192     wxLIST_MASK_TEXT,
 193     wxLIST_MASK_IMAGE,
 194     wxLIST_MASK_DATA,
 195     wxLIST_SET_ITEM,
 196     wxLIST_MASK_WIDTH,
 197     wxLIST_MASK_FORMAT,
 198
 199     // State flags
 200     wxLIST_STATE_DONTCARE,
 201     wxLIST_STATE_DROPHILITED,
 202     wxLIST_STATE_FOCUSED,
 203     wxLIST_STATE_SELECTED,
 204     wxLIST_STATE_CUT,
 205
 206     // Hit test flags
 207     wxLIST_HITTEST_ABOVE,
 208     wxLIST_HITTEST_BELOW,
 209     wxLIST_HITTEST_NOWHERE,
 210     wxLIST_HITTEST_ONITEMICON,
 211     wxLIST_HITTEST_ONITEMLABEL,
 212     wxLIST_HITTEST_ONITEMRIGHT,
 213     wxLIST_HITTEST_ONITEMSTATEICON,
 214     wxLIST_HITTEST_TOLEFT,
 215     wxLIST_HITTEST_TORIGHT,
 216     wxLIST_HITTEST_ONITEM,
 217
 218     // Flags for GetNextItem
 219     wxLIST_NEXT_ABOVE,
 220     wxLIST_NEXT_ALL,
 221     wxLIST_NEXT_BELOW,
 222     wxLIST_NEXT_LEFT,
 223     wxLIST_NEXT_RIGHT,
 224
 225     // Alignment flags
 226     wxLIST_ALIGN_DEFAULT,
 227     wxLIST_ALIGN_LEFT,
 228     wxLIST_ALIGN_TOP,
 229     wxLIST_ALIGN_SNAP_TO_GRID,
 230
 231     // Autosize values for SetColumnWidth
 232     wxLIST_AUTOSIZE = -1,
 233     wxLIST_AUTOSIZE_USEHEADER = -2,
 234
 235     // Flag values for GetItemRect
 236     wxLIST_RECT_BOUNDS,
 237     wxLIST_RECT_ICON,
 238     wxLIST_RECT_LABEL,
 239
 240     // Flag values for FindItem (MSW only)
 241     wxLIST_FIND_UP,
 242     wxLIST_FIND_DOWN,
 243     wxLIST_FIND_LEFT,
 244     wxLIST_FIND_RIGHT,
 245
 246
 247 };
 248
 249
 250
 251 enum wxListColumnFormat
 252 {
 253     wxLIST_FORMAT_LEFT,
 254     wxLIST_FORMAT_RIGHT,
 255     wxLIST_FORMAT_CENTRE,
 256     wxLIST_FORMAT_CENTER = wxLIST_FORMAT_CENTRE
 257 };
 258
 259
 260
 261
 262 class wxListItemAttr
 263 {
 264 public:
 265     // ctors
 266     //wxListItemAttr();
 267     wxListItemAttr(const wxColour& colText = wxNullColour,
 268                    const wxColour& colBack = wxNullColour,
 269                    const wxFont& font = wxNullFont);
 270
 271
 272     // setters
 273     void SetTextColour(const wxColour& colText);
 274     void SetBackgroundColour(const wxColour& colBack);
 275     void SetFont(const wxFont& font);
 276
 277     // accessors
 278     bool HasTextColour();
 279     bool HasBackgroundColour();
 280     bool HasFont();
 281
 282     wxColour GetTextColour();
 283     wxColour GetBackgroundColour();
 284     wxFont GetFont();
 285 };
 286
 287
 288 class wxListItem : public wxObject {
 289 public:
 290     wxListItem();
 291     ~wxListItem();
 292
 293     // resetting
 294     void Clear();
 295     void ClearAttributes();
 296
 297     // setters
 298     void SetMask(long mask);
 299     void SetId(long id);
 300     void SetColumn(int col);
 301     void SetState(long state);
 302     void SetStateMask(long stateMask);
 303     void SetText(const wxString& text);
 304     void SetImage(int image);
 305     void SetData(long data);
 306
 307     void SetWidth(int width);
 308     void SetAlign(wxListColumnFormat align);
 309
 310     void SetTextColour(const wxColour& colText);
 311     void SetBackgroundColour(const wxColour& colBack);
 312     void SetFont(const wxFont& font);
 313
 314     // accessors
 315     long GetMask();
 316     long GetId();
 317     int GetColumn();
 318     long GetState();
 319     const wxString& GetText();
 320     int GetImage();
 321     long GetData();
 322
 323     int GetWidth();
 324     wxListColumnFormat GetAlign();
 325
 326     wxListItemAttr *GetAttributes();
 327     bool HasAttributes();
 328
 329     wxColour GetTextColour() const;
 330     wxColour GetBackgroundColour() const;
 331     wxFont GetFont() const;
 332
 333     // these members are public for compatibility
 334     long            m_mask;     // Indicates what fields are valid
 335     long            m_itemId;   // The zero-based item position
 336     int             m_col;      // Zero-based column, if in report mode
 337     long            m_state;    // The state of the item
 338     long            m_stateMask;// Which flags of m_state are valid (uses same flags)
 339     wxString        m_text;     // The label/header text
 340     int             m_image;    // The zero-based index into an image list
 341     long            m_data;     // App-defined data
 342
 343     // For columns only
 344     int             m_format;   // left, right, centre
 345     int             m_width;    // width of column
 346
 347 };
 348
 349
 350 class wxListEvent: public wxNotifyEvent {
 351 public:
 352     wxListEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
 353
 354 %readonly
 355     int           m_code;
 356     long          m_oldItemIndex;
 357     long          m_itemIndex;
 358     int           m_col;
 359     wxPoint       m_pointDrag;
 360     wxListItem    m_item;
 361 %readwrite
 362
 363     int GetKeyCode();
 364     %pragma(python) addtoclass = "GetCode = GetKeyCode"
 365     long GetIndex();
 366     int GetColumn();
 367     wxPoint GetPoint();
 368     const wxString& GetLabel();
 369     const wxString& GetText();
 370     int GetImage();
 371     long GetData();
 372     long GetMask();
 373     const wxListItem& GetItem();
 374
 375     long GetCacheFrom();
 376     long GetCacheTo();
 377 };
 378
 379
 380 %{  // C++ Version of a Python aware class
 381 class wxPyListCtrl : public wxListCtrl {
 382     DECLARE_ABSTRACT_CLASS(wxPyListCtrl);
 383 public:
 384     wxPyListCtrl() : wxListCtrl() {}
 385     wxPyListCtrl(wxWindow* parent, wxWindowID id,
 386                  const wxPoint& pos,
 387                  const wxSize& size,
 388                  long style,
 389                  const wxValidator& validator,
 390                  const wxString& name) :
 391         wxListCtrl(parent, id, pos, size, style, validator, name) {}
 392
 393     bool Create(wxWindow* parent, wxWindowID id,
 394                 const wxPoint& pos,
 395                 const wxSize& size,
 396                 long style,
 397                 const wxValidator& validator,
 398                 const wxString& name) {
 399         return wxListCtrl::Create(parent, id, pos, size, style, validator, name);
 400     }
 401
 402     DEC_PYCALLBACK_STRING_LONGLONG(OnGetItemText);
 403     DEC_PYCALLBACK_INT_LONG(OnGetItemImage);
 404     DEC_PYCALLBACK_LISTATTR_LONG(OnGetItemAttr);
 405
 406     PYPRIVATE;
 407 };
 408
 409 IMPLEMENT_ABSTRACT_CLASS(wxPyListCtrl, wxListCtrl);
 410
 411 IMP_PYCALLBACK_STRING_LONGLONG(wxPyListCtrl, wxListCtrl, OnGetItemText);
 412 IMP_PYCALLBACK_INT_LONG(wxPyListCtrl, wxListCtrl, OnGetItemImage);
 413 IMP_PYCALLBACK_LISTATTR_LONG(wxPyListCtrl, wxListCtrl, OnGetItemAttr);
 414 %}
 415
 416
 417
 418 %name(wxListCtrl)class wxPyListCtrl : public wxControl {
 419 public:
 420     wxPyListCtrl(wxWindow* parent, wxWindowID id = -1,
 421                  const wxPoint& pos = wxDefaultPosition,
 422                  const wxSize& size = wxDefaultSize,
 423                  long style = wxLC_ICON,
 424                  const wxValidator& validator = wxDefaultValidator,
 425                  const wxString& name = wxPyListCtrlNameStr);
 426     %name(wxPreListCtrl)wxPyListCtrl();
 427
 428     bool Create(wxWindow* parent, wxWindowID id = -1,
 429                  const wxPoint& pos = wxDefaultPosition,
 430                  const wxSize& size = wxDefaultSize,
 431                  long style = wxLC_ICON,
 432                  const wxValidator& validator = wxDefaultValidator,
 433                  const wxString& name = wxPyListCtrlNameStr);
 434
 435     void _setCallbackInfo(PyObject* self, PyObject* _class);
 436     %pragma(python) addtomethod = "__init__:self._setCallbackInfo(self, wxListCtrl)"
 437
 438     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 439     %pragma(python) addtomethod = "wxPreListCtrl:val._setOORInfo(val)"
 440
 441     // Set the control colours
 442     bool SetForegroundColour(const wxColour& col);
 443     bool SetBackgroundColour(const wxColour& col);
 444
 445     // Gets information about this column
 446     // bool GetColumn(int col, wxListItem& item) const;
 447     %addmethods {
 448         %new wxListItem* GetColumn(int col) {
 449             wxListItem item;
 450             item.SetMask(0xFFFF);
 451             if (self->GetColumn(col, item))
 452                 return new wxListItem(item);
 453             else
 454                 return NULL;
 455         }
 456     } // The OOR typemaps don't know what to do with the %new, so fix it up.
 457     %pragma(python) addtoclass = "
 458     def GetColumn(self, *_args, **_kwargs):
 459         val = controls2c.wxListCtrl_GetColumn(self, *_args, **_kwargs)
 460         if val is not None: val.thisown = 1
 461         return val
 462     "
 463
 464     // Sets information about this column
 465     bool SetColumn(int col, wxListItem& item) ;
 466
 467     // Gets the column width
 468     int GetColumnWidth(int col) const;
 469
 470     // Sets the column width
 471     bool SetColumnWidth(int col, int width) ;
 472
 473     // Gets the number of items that can fit vertically in the
 474     // visible area of the list control (list or report view)
 475     // or the total number of items in the list control (icon
 476     // or small icon view)
 477     int GetCountPerPage() const;
 478
 479 #ifdef __WXMSW__
 480     // Gets the edit control for editing labels.
 481     wxTextCtrl* GetEditControl() const;
 482 #endif
 483
 484     //bool GetItem(wxListItem& info) const ;
 485     %addmethods {
 486         // Gets information about the item
 487         %new wxListItem* GetItem(long itemId, int col=0) {
 488             wxListItem* info = new wxListItem;
 489             info->m_itemId = itemId;
 490             info->m_col = col;
 491             info->m_mask = 0xFFFF;
 492             self->GetItem(*info);
 493             return info;
 494         }
 495     }  // The OOR typemaps don't know what to do with the %new, so fix it up.
 496     %pragma(python) addtoclass = "
 497     def GetItem(self, *_args, **_kwargs):
 498         val = controls2c.wxListCtrl_GetItem(self, *_args, **_kwargs)
 499         if val is not None: val.thisown = 1
 500         return val
 501     "
 502
 503     // Sets information about the item
 504     bool SetItem(wxListItem& info) ;
 505
 506     // Sets a string field at a particular column
 507     %name(SetStringItem)long SetItem(long index, int col, const wxString& label, int imageId = -1);
 508
 509     // Gets the item state
 510     int  GetItemState(long item, long stateMask) const ;
 511
 512     // Sets the item state
 513     bool SetItemState(long item, long state, long stateMask) ;
 514
 515     // Sets the item image
 516     bool SetItemImage(long item, int image, int selImage) ;
 517
 518     // Gets the item text
 519     wxString GetItemText(long item) const ;
 520
 521     // Sets the item text
 522     void SetItemText(long item, const wxString& str) ;
 523
 524     // Gets the item data
 525     long GetItemData(long item) const ;
 526
 527     // Sets the item data
 528     bool SetItemData(long item, long data) ;
 529
 530
 531     //bool GetItemRect(long item, wxRect& rect, int code = wxLIST_RECT_BOUNDS) const ;
 532     //bool GetItemPosition(long item, wxPoint& pos) const ;
 533
 534     // Gets the item position
 535     %addmethods {
 536         %new wxPoint* GetItemPosition(long item) {
 537             wxPoint* pos = new wxPoint;
 538             self->GetItemPosition(item, *pos);
 539             return pos;
 540         }
 541         // Gets the item rectangle
 542         %new wxRect* GetItemRect(long item, int code = wxLIST_RECT_BOUNDS) {
 543             wxRect* rect= new wxRect;
 544             self->GetItemRect(item, *rect, code);
 545             return rect;
 546         }
 547     }
 548
 549
 550     // Sets the item position
 551     bool SetItemPosition(long item, const wxPoint& pos) ;
 552
 553     // Gets the number of items in the list control
 554     int GetItemCount() const;
 555
 556     // Gets the number of columns in the list control
 557     int GetColumnCount() const;
 558
 559     // Retrieves the spacing between icons in pixels.
 560     // If small is TRUE, gets the spacing for the small icon
 561     // view, otherwise the large icon view.
 562     int GetItemSpacing(bool isSmall) const;
 563
 564 #ifndef __WXMSW__
 565     void SetItemSpacing( int spacing, bool isSmall = FALSE );
 566 #endif
 567
 568     // Gets the number of selected items in the list control
 569     int GetSelectedItemCount() const;
 570
 571     // Gets the text colour of the listview
 572     wxColour GetTextColour() const;
 573
 574     // Sets the text colour of the listview
 575     void SetTextColour(const wxColour& col);
 576
 577     // Gets the index of the topmost visible item when in
 578     // list or report view
 579     long GetTopItem() const ;
 580
 581     // Add or remove a single window style
 582     void SetSingleStyle(long style, bool add = TRUE) ;
 583
 584     // Set the whole window style
 585     void SetWindowStyleFlag(long style) ;
 586
 587     // Searches for an item, starting from 'item'.
 588     // item can be -1 to find the first item that matches the
 589     // specified flags.
 590     // Returns the item or -1 if unsuccessful.
 591     long GetNextItem(long item, int geometry = wxLIST_NEXT_ALL, int state = wxLIST_STATE_DONTCARE) const ;
 592
 593     // Gets one of the three image lists
 594     wxImageList *GetImageList(int which) const ;
 595
 596     // Sets the image list
 597     void SetImageList(wxImageList *imageList, int which) ;
 598     void AssignImageList(wxImageList *imageList, int which) ;
 599     %pragma(python) addtomethod = "AssignImageList:_args[0].thisown = 0"
 600
 601     // returns true if it is a virtual list control
 602     bool IsVirtual() const;
 603
 604     // refresh items selectively (only useful for virtual list controls)
 605     void RefreshItem(long item);
 606     void RefreshItems(long itemFrom, long itemTo);
 607
 608     // Arranges the items
 609     bool Arrange(int flag = wxLIST_ALIGN_DEFAULT);
 610
 611     // Deletes an item
 612     bool DeleteItem(long item);
 613
 614     // Deletes all items
 615     bool DeleteAllItems() ;
 616
 617     // Deletes a column
 618     bool DeleteColumn(int col);
 619
 620     // Deletes all columns
 621     bool DeleteAllColumns();
 622
 623     // Clears items, and columns if there are any.
 624     void ClearAll();
 625
 626 #ifdef __WXMSW__
 627     // Edit the label
 628     wxTextCtrl* EditLabel(long item /*, wxClassInfo* textControlClass = CLASSINFO(wxTextCtrl)*/);
 629
 630     // End label editing, optionally cancelling the edit
 631     bool EndEditLabel(bool cancel);
 632 #else
 633     void EditLabel(long item);
 634 #endif
 635
 636     // Ensures this item is visible
 637     bool EnsureVisible(long item) ;
 638
 639     // Find an item whose label matches this string, starting from the item after 'start'
 640     // or the beginning if 'start' is -1.
 641     long FindItem(long start, const wxString& str, bool partial = FALSE);
 642
 643     // Find an item whose data matches this data, starting from the item after 'start'
 644     // or the beginning if 'start' is -1.
 645     %name(FindItemData)long FindItem(long start, long data);
 646
 647     // Find an item nearest this position in the specified direction, starting from
 648     // the item after 'start' or the beginning if 'start' is -1.
 649     %name(FindItemAtPos)long FindItem(long start, const wxPoint& pt, int direction);
 650
 651     // Determines which item (if any) is at the specified point,
 652     // giving details in the second return value (see wxLIST_HITTEST_... flags above)
 653     long HitTest(const wxPoint& point, int& OUTPUT);
 654
 655     // Inserts an item, returning the index of the new item if successful,
 656     // -1 otherwise.
 657     long InsertItem(wxListItem& info);
 658
 659     // Insert a string item
 660     %name(InsertStringItem)long InsertItem(long index, const wxString& label);
 661
 662     // Insert an image item
 663     %name(InsertImageItem)long InsertItem(long index, int imageIndex);
 664
 665     // Insert an image/string item
 666     %name(InsertImageStringItem)long InsertItem(long index, const wxString& label, int imageIndex);
 667
 668     // For list view mode (only), inserts a column.
 669     %name(InsertColumnInfo)long InsertColumn(long col, wxListItem& info);
 670
 671     long InsertColumn(long col,
 672                       const wxString& heading,
 673                       int format = wxLIST_FORMAT_LEFT,
 674                       int width = -1);
 675
 676     // set the number of items in a virtual list control
 677     void SetItemCount(long count);
 678
 679     // Scrolls the list control. If in icon, small icon or report view mode,
 680     // x specifies the number of pixels to scroll. If in list view mode, x
 681     // specifies the number of columns to scroll.
 682     // If in icon, small icon or list view mode, y specifies the number of pixels
 683     // to scroll. If in report view mode, y specifies the number of lines to scroll.
 684     bool ScrollList(int dx, int dy);
 685
 686     void SetItemTextColour( long item, const wxColour& col);
 687     wxColour GetItemTextColour( long item ) const;
 688     void SetItemBackgroundColour( long item, const wxColour &col);
 689     wxColour GetItemBackgroundColour( long item ) const;
 690
 691
 692     %pragma(python) addtoclass = "
 693     # Some helpers...
 694
 695     def Select(self, idx, on=1):
 696         '''[de]select an item'''
 697         if on: state = wxLIST_STATE_SELECTED
 698         else: state = 0
 699         self.SetItemState(idx, state, wxLIST_STATE_SELECTED)
 700
 701     def Focus(self, idx):
 702         '''Focus and show the given item'''
 703         self.SetItemState(idx, wxLIST_STATE_FOCUSED, wxLIST_STATE_FOCUSED)
 704         self.EnsureVisible(idx)
 705
 706     def GetFocusedItem(self):
 707         '''get the currently focused item or -1 if none'''
 708         return self.GetNextItem(-1, wxLIST_NEXT_ALL, wxLIST_STATE_FOCUSED)
 709
 710     def GetFirstSelected(self, *args):
 711         '''return first selected item, or -1 when none'''
 712         return self.GetNextSelected(-1)
 713
 714     def GetNextSelected(self, item):
 715         '''return subsequent selected items, or -1 when no more'''
 716         return self.GetNextItem(item, wxLIST_NEXT_ALL, wxLIST_STATE_SELECTED)
 717
 718     def IsSelected(self, idx):
 719         '''return TRUE if the item is selected'''
 720         return self.GetItemState(idx, wxLIST_STATE_SELECTED) != 0
 721
 722     def SetColumnImage(self, col, image):
 723         item = wxListItem()
 724         item.SetMask(wxLIST_MASK_IMAGE)
 725         item.SetImage(image)
 726         self.SetColumn(col, item)
 727
 728     def ClearColumnImage(self, col):
 729         self.SetColumnImage(col, -1)
 730
 731     def Append(self, entry):
 732         '''Append an item to the list control.  The entry parameter should be a
 733            sequence with an item for each column'''
 734         if len(entry):
 735             if wx.wxUSE_UNICODE:
 736                 cvtfunc = unicode
 737             else:
 738                 cvtfunc = str
 739             pos = self.GetItemCount()
 740             self.InsertStringItem(pos, cvtfunc(entry[0]))
 741             for i in range(1, len(entry)):
 742                 self.SetStringItem(pos, i, cvtfunc(entry[i]))
 743             return pos
 744     "
 745
 746
 747     // bool SortItems(wxListCtrlCompare fn, long data);
 748     %addmethods {
 749         // Sort items.
 750         // func is a function which takes 2 long arguments: item1, item2.
 751         // item1 is the long data associated with a first item (NOT the index).
 752         // item2 is the long data associated with a second item (NOT the index).
 753         // The return value is a negative number if the first item should precede the second
 754         // item, a positive number of the second item should precede the first,
 755         // or zero if the two items are equivalent.
 756         bool SortItems(PyObject* func) {
 757             if (!PyCallable_Check(func))
 758                 return FALSE;
 759             return self->SortItems(wxPyListCtrl_SortItems, (long)func);
 760         }
 761     }
 762
 763
 764     %addmethods {
 765         wxWindow* GetMainWindow() {
 766         #ifdef __WXMSW__
 767             return self;
 768         #else
 769             return (wxWindow*)self->m_mainWin;
 770         #endif
 771         }
 772     }
 773 };
 774
 775
 776
 777 %{ // Python aware sorting function for wxPyListCtrl
 778     int wxCALLBACK wxPyListCtrl_SortItems(long item1, long item2, long funcPtr) {
 779         int retval = 0;
 780         PyObject* func = (PyObject*)funcPtr;
 781         wxPyBeginBlockThreads();
 782
 783         PyObject* args = Py_BuildValue("(ii)", item1, item2);
 784         PyObject* result = PyEval_CallObject(func, args);
 785         Py_DECREF(args);
 786         if (result) {
 787             retval = PyInt_AsLong(result);
 788             Py_DECREF(result);
 789         }
 790
 791         wxPyEndBlockThreads();
 792         return retval;
 793     }
 794
 795 %}
 796
 797 //----------------------------------------------------------------------
 798
 799 class wxListView : public wxPyListCtrl
 800 {
 801 public:
 802     wxListView( wxWindow *parent,
 803                 wxWindowID id = -1,
 804                 const wxPoint& pos = wxDefaultPosition,
 805                 const wxSize& size = wxDefaultSize,
 806                 long style = wxLC_REPORT,
 807                 const wxValidator& validator = wxDefaultValidator,
 808                 const wxString& name = wxPyListCtrlNameStr);
 809     %name(wxPreListView)wxListView();
 810
 811     bool Create( wxWindow *parent,
 812                 wxWindowID id = -1,
 813                 const wxPoint& pos = wxDefaultPosition,
 814                 const wxSize& size = wxDefaultSize,
 815                 long style = wxLC_REPORT,
 816                 const wxValidator& validator = wxDefaultValidator,
 817                 const wxString& name = wxPyListCtrlNameStr);
 818
 819     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
 820     %pragma(python) addtomethod = "wxPreListView:val._setOORInfo(val)"
 821
 822     // [de]select an item
 823     void Select(long n, bool on = TRUE);
 824
 825     // focus and show the given item
 826     void Focus(long index);
 827
 828     // get the currently focused item or -1 if none
 829     long GetFocusedItem() const;
 830
 831     // get first and subsequent selected items, return -1 when no more
 832     long GetNextSelected(long item) const;
 833     long GetFirstSelected() const;
 834
 835     // return TRUE if the item is selected
 836     bool IsSelected(long index);
 837
 838     void SetColumnImage(int col, int image);
 839     void ClearColumnImage(int col);
 840 };
 841
 842
 843 //----------------------------------------------------------------------
 844
 845 // wxTreeCtrl flags
 846 enum {
 847     wxTR_NO_BUTTONS,
 848     wxTR_HAS_BUTTONS,
 849     wxTR_TWIST_BUTTONS,
 850     wxTR_NO_LINES,
 851     wxTR_MAC_BUTTONS,
 852     wxTR_AQUA_BUTTONS,
 853
 854     wxTR_SINGLE,
 855     wxTR_MULTIPLE,
 856     wxTR_EXTENDED,
 857     wxTR_FULL_ROW_HIGHLIGHT,
 858
 859     wxTR_EDIT_LABELS,
 860     wxTR_LINES_AT_ROOT,
 861     wxTR_HIDE_ROOT,
 862     wxTR_ROW_LINES,
 863     wxTR_HAS_VARIABLE_ROW_HEIGHT,
 864
 865     wxTR_DEFAULT_STYLE,
 866 };
 867
 868 enum wxTreeItemIcon
 869 {
 870     wxTreeItemIcon_Normal,              // not selected, not expanded
 871     wxTreeItemIcon_Selected,            //     selected, not expanded
 872     wxTreeItemIcon_Expanded,            // not selected,     expanded
 873     wxTreeItemIcon_SelectedExpanded,    //     selected,     expanded
 874     wxTreeItemIcon_Max
 875 };
 876
 877
 878 // constants for HitTest
 879 enum {
 880     wxTREE_HITTEST_ABOVE,
 881     wxTREE_HITTEST_BELOW,
 882     wxTREE_HITTEST_NOWHERE,
 883     wxTREE_HITTEST_ONITEMBUTTON,
 884     wxTREE_HITTEST_ONITEMICON,
 885     wxTREE_HITTEST_ONITEMINDENT,
 886     wxTREE_HITTEST_ONITEMLABEL,
 887     wxTREE_HITTEST_ONITEMRIGHT,
 888     wxTREE_HITTEST_ONITEMSTATEICON,
 889     wxTREE_HITTEST_TOLEFT,
 890     wxTREE_HITTEST_TORIGHT,
 891     wxTREE_HITTEST_ONITEMUPPERPART,
 892     wxTREE_HITTEST_ONITEMLOWERPART,
 893     wxTREE_HITTEST_ONITEM
 894 };
 895
 896
 897 enum {
 898     /* Tree control event types */
 899     wxEVT_COMMAND_TREE_BEGIN_DRAG,
 900     wxEVT_COMMAND_TREE_BEGIN_RDRAG,
 901     wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT,
 902     wxEVT_COMMAND_TREE_END_LABEL_EDIT,
 903     wxEVT_COMMAND_TREE_DELETE_ITEM,
 904     wxEVT_COMMAND_TREE_GET_INFO,
 905     wxEVT_COMMAND_TREE_SET_INFO,
 906     wxEVT_COMMAND_TREE_ITEM_EXPANDED,
 907     wxEVT_COMMAND_TREE_ITEM_EXPANDING,
 908     wxEVT_COMMAND_TREE_ITEM_COLLAPSED,
 909     wxEVT_COMMAND_TREE_ITEM_COLLAPSING,
 910     wxEVT_COMMAND_TREE_SEL_CHANGED,
 911     wxEVT_COMMAND_TREE_SEL_CHANGING,
 912     wxEVT_COMMAND_TREE_KEY_DOWN,
 913     wxEVT_COMMAND_TREE_ITEM_ACTIVATED,
 914     wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK,
 915     wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK,
 916     wxEVT_COMMAND_TREE_END_DRAG,
 917 };
 918
 919
 920 %pragma(python) code = "
 921 # wxTreeCtrl events
 922 def EVT_TREE_BEGIN_DRAG(win, id, func):
 923     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_DRAG, func)
 924
 925 def EVT_TREE_BEGIN_RDRAG(win, id, func):
 926     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_RDRAG, func)
 927
 928 def EVT_TREE_END_DRAG(win, id, func):
 929     win.Connect(id, -1, wxEVT_COMMAND_TREE_END_DRAG, func)
 930
 931 def EVT_TREE_BEGIN_LABEL_EDIT(win, id, func):
 932     win.Connect(id, -1, wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT, func)
 933
 934 def EVT_TREE_END_LABEL_EDIT(win, id, func):
 935     win.Connect(id, -1, wxEVT_COMMAND_TREE_END_LABEL_EDIT, func)
 936
 937 def EVT_TREE_GET_INFO(win, id, func):
 938     win.Connect(id, -1, wxEVT_COMMAND_TREE_GET_INFO, func)
 939
 940 def EVT_TREE_SET_INFO(win, id, func):
 941     win.Connect(id, -1, wxEVT_COMMAND_TREE_SET_INFO, func)
 942
 943 def EVT_TREE_ITEM_EXPANDED(win, id, func):
 944     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_EXPANDED, func)
 945
 946 def EVT_TREE_ITEM_EXPANDING(win, id, func):
 947     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_EXPANDING, func)
 948
 949 def EVT_TREE_ITEM_COLLAPSED(win, id, func):
 950     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_COLLAPSED, func)
 951
 952 def EVT_TREE_ITEM_COLLAPSING(win, id, func):
 953     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_COLLAPSING, func)
 954
 955 def EVT_TREE_SEL_CHANGED(win, id, func):
 956     win.Connect(id, -1, wxEVT_COMMAND_TREE_SEL_CHANGED, func)
 957
 958 def EVT_TREE_SEL_CHANGING(win, id, func):
 959     win.Connect(id, -1, wxEVT_COMMAND_TREE_SEL_CHANGING, func)
 960
 961 def EVT_TREE_KEY_DOWN(win, id, func):
 962     win.Connect(id, -1, wxEVT_COMMAND_TREE_KEY_DOWN, func)
 963
 964 def EVT_TREE_DELETE_ITEM(win, id, func):
 965     win.Connect(id, -1, wxEVT_COMMAND_TREE_DELETE_ITEM, func)
 966
 967 def EVT_TREE_ITEM_ACTIVATED(win, id, func):
 968     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_ACTIVATED, func)
 969
 970 def EVT_TREE_ITEM_RIGHT_CLICK(win, id, func):
 971     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK, func)
 972
 973 def EVT_TREE_ITEM_MIDDLE_CLICK(win, id, func):
 974     win.Connect(id, -1, wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK, func)
 975 "
 976
 977
 978 class wxTreeItemAttr
 979 {
 980 public:
 981     // ctors
 982     //wxTreeItemAttr() { }
 983     wxTreeItemAttr(const wxColour& colText = wxNullColour,
 984                    const wxColour& colBack = wxNullColour,
 985                    const wxFont& font = wxNullFont);
 986
 987     // setters
 988     void SetTextColour(const wxColour& colText);
 989     void SetBackgroundColour(const wxColour& colBack);
 990     void SetFont(const wxFont& font);
 991
 992     // accessors
 993     bool HasTextColour();
 994     bool HasBackgroundColour();
 995     bool HasFont();
 996
 997     wxColour GetTextColour();
 998     wxColour GetBackgroundColour();
 999     wxFont GetFont();
1000 };
1001
1002
1003 class wxTreeItemId {
1004 public:
1005     wxTreeItemId();
1006     ~wxTreeItemId();
1007     bool IsOk();
1008     %pragma(python) addtoclass = "
1009     Ok = IsOk
1010     def __nonzero__(self):
1011         return self.IsOk()
1012 "
1013
1014     %addmethods {
1015         int __cmp__(wxTreeItemId* other) {
1016             if (! other) return -1;
1017             return *self != *other;
1018         }
1019     }
1020 };
1021
1022
1023
1024
1025 %name(wxTreeItemData) class wxPyTreeItemData : public wxObject {
1026 public:
1027     wxPyTreeItemData(PyObject* obj = NULL);
1028
1029     PyObject* GetData();
1030     void      SetData(PyObject* obj);
1031
1032     const wxTreeItemId& GetId();
1033     void                SetId(const wxTreeItemId& id);
1034 };
1035
1036
1037
1038 class wxTreeEvent : public wxNotifyEvent {
1039 public:
1040     wxTreeEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
1041
1042     wxTreeItemId GetItem();
1043     wxTreeItemId GetOldItem();
1044     wxPoint GetPoint();
1045     const wxKeyEvent& GetKeyEvent();
1046     int GetKeyCode();
1047     %pragma(python) addtoclass = "GetCode = GetKeyCode"
1048     const wxString& GetLabel();
1049     bool IsEditCancelled() const;
1050     void SetItem(const wxTreeItemId& item);
1051     void SetOldItem(const wxTreeItemId& item);
1052     void SetPoint(const wxPoint& pt);
1053     void SetKeyEvent(const wxKeyEvent& evt);
1054     void SetLabel(const wxString& label);
1055     void SetEditCanceled(bool editCancelled);
1056 };
1057
1058
1059
1060 %{ // C++ version of Python aware wxTreeCtrl
1061 class wxPyTreeCtrl : public wxTreeCtrl {
1062     DECLARE_ABSTRACT_CLASS(wxPyTreeCtrl);
1063 public:
1064     wxPyTreeCtrl() : wxTreeCtrl() {}
1065     wxPyTreeCtrl(wxWindow *parent, wxWindowID id,
1066                  const wxPoint& pos,
1067                  const wxSize& size,
1068                  long style,
1069                  const wxValidator& validator,
1070                  const wxString& name) :
1071         wxTreeCtrl(parent, id, pos, size, style, validator, name) {}
1072
1073     bool Create(wxWindow *parent, wxWindowID id,
1074                 const wxPoint& pos,
1075                 const wxSize& size,
1076                 long style,
1077                 const wxValidator& validator,
1078                 const wxString& name) {
1079         return wxTreeCtrl::Create(parent, id, pos, size, style, validator, name);
1080     }
1081
1082
1083     int OnCompareItems(const wxTreeItemId& item1,
1084                        const wxTreeItemId& item2) {
1085         int rval = 0;
1086         bool found;
1087         wxPyBeginBlockThreads();
1088         if ((found = m_myInst.findCallback("OnCompareItems"))) {
1089             PyObject *o1 = wxPyConstructObject((void*)&item1, wxT("wxTreeItemId"));
1090             PyObject *o2 = wxPyConstructObject((void*)&item2, wxT("wxTreeItemId"));
1091             rval = m_myInst.callCallback(Py_BuildValue("(OO)",o1,o2));
1092             Py_DECREF(o1);
1093             Py_DECREF(o2);
1094         }
1095         wxPyEndBlockThreads();
1096         if (! found)
1097             rval = wxTreeCtrl::OnCompareItems(item1, item2);
1098         return rval;
1099     }
1100     PYPRIVATE;
1101 };
1102
1103 IMPLEMENT_ABSTRACT_CLASS(wxPyTreeCtrl, wxTreeCtrl);
1104
1105 %}
1106
1107 // These are for the GetFirstChild/GetNextChild methods below
1108 %typemap(python, in)     long& INOUT = long* INOUT;
1109 %typemap(python, argout) long& INOUT = long* INOUT;
1110
1111
1112 %name(wxTreeCtrl)class wxPyTreeCtrl : public wxControl {
1113 public:
1114     wxPyTreeCtrl(wxWindow *parent, wxWindowID id = -1,
1115                  const wxPoint& pos = wxDefaultPosition,
1116                  const wxSize& size = wxDefaultSize,
1117                  long style = wxTR_DEFAULT_STYLE,
1118                  const wxValidator& validator = wxDefaultValidator,
1119                  const wxString& name = wxPy_TreeCtrlNameStr);
1120     %name(wxPreTreeCtrl)wxPyTreeCtrl();
1121
1122     bool Create(wxWindow *parent, wxWindowID id = -1,
1123                 const wxPoint& pos = wxDefaultPosition,
1124                 const wxSize& size = wxDefaultSize,
1125                 long style = wxTR_DEFAULT_STYLE,
1126                 const wxValidator& validator = wxDefaultValidator,
1127                 const wxString& name = wxPy_TreeCtrlNameStr);
1128
1129     void _setCallbackInfo(PyObject* self, PyObject* _class);
1130     %pragma(python) addtomethod = "__init__:self._setCallbackInfo(self, wxTreeCtrl)"
1131
1132     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
1133     %pragma(python) addtomethod = "wxPreTreeCtrl:val._setOORInfo(val)"
1134
1135     size_t GetCount();
1136     unsigned int GetIndent();
1137     void SetIndent(unsigned int indent);
1138     wxImageList *GetImageList();
1139     wxImageList *GetStateImageList();
1140     void SetImageList(wxImageList *imageList);
1141     void SetStateImageList(wxImageList *imageList);
1142     void AssignImageList(wxImageList* imageList);
1143     %pragma(python) addtomethod = "AssignImageList:_args[0].thisown = 0"
1144     void AssignStateImageList(wxImageList* imageList);
1145     %pragma(python) addtomethod = "AssignStateImageList:_args[0].thisown = 0"
1146
1147     unsigned int GetSpacing();
1148     void SetSpacing(unsigned int spacing);
1149
1150     wxString GetItemText(const wxTreeItemId& item);
1151     int GetItemImage(const wxTreeItemId& item,
1152                      wxTreeItemIcon which = wxTreeItemIcon_Normal);
1153     int GetItemSelectedImage(const wxTreeItemId& item);
1154
1155     void SetItemText(const wxTreeItemId& item, const wxString& text);
1156     void SetItemImage(const wxTreeItemId& item, int image,
1157                       wxTreeItemIcon which = wxTreeItemIcon_Normal);
1158     void SetItemSelectedImage(const wxTreeItemId& item, int image);
1159     void SetItemHasChildren(const wxTreeItemId& item, bool hasChildren = TRUE);
1160
1161     %addmethods {
1162         // [Get|Set]ItemData substitutes.  Automatically create wxPyTreeItemData
1163         // if needed.
1164         wxPyTreeItemData* GetItemData(const wxTreeItemId& item) {
1165             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
1166             if (data == NULL) {
1167                 data = new wxPyTreeItemData();
1168                 data->SetId(item); // set the id
1169                 self->SetItemData(item, data);
1170             }
1171             return data;
1172         }
1173
1174         void SetItemData(const wxTreeItemId& item, wxPyTreeItemData* data) {
1175             data->SetId(item); // set the id
1176             self->SetItemData(item, data);
1177         }
1178
1179         // [Get|Set]PyData are short-cuts.  Also made somewhat crash-proof by
1180         // automatically creating data classes.
1181         PyObject* GetPyData(const wxTreeItemId& item) {
1182             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
1183             if (data == NULL) {
1184                 data = new wxPyTreeItemData();
1185                 data->SetId(item); // set the id
1186                 self->SetItemData(item, data);
1187             }
1188             return data->GetData();
1189         }
1190
1191         void SetPyData(const wxTreeItemId& item, PyObject* obj) {
1192             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
1193             if (data == NULL) {
1194                 data = new wxPyTreeItemData(obj);
1195                 data->SetId(item); // set the id
1196                 self->SetItemData(item, data);
1197             } else
1198                 data->SetData(obj);
1199         }
1200     }
1201
1202
1203     // get the item's text colour
1204     wxColour GetItemTextColour(const wxTreeItemId& item) const;
1205
1206     // get the item's background colour
1207     wxColour GetItemBackgroundColour(const wxTreeItemId& item) const;
1208
1209     // get the item's font
1210     wxFont GetItemFont(const wxTreeItemId& item) const;
1211
1212
1213     bool IsVisible(const wxTreeItemId& item);
1214     bool ItemHasChildren(const wxTreeItemId& item);
1215     bool IsExpanded(const wxTreeItemId& item);
1216     bool IsSelected(const wxTreeItemId& item);
1217
1218     wxTreeItemId GetRootItem();
1219     wxTreeItemId GetSelection();
1220     wxTreeItemId GetItemParent(const wxTreeItemId& item);
1221     //size_t GetSelections(wxArrayTreeItemIds& selection);
1222     %addmethods {
1223         PyObject* GetSelections() {
1224             wxPyBeginBlockThreads();
1225             PyObject*           rval = PyList_New(0);
1226             wxArrayTreeItemIds  array;
1227             size_t              num, x;
1228             num = self->GetSelections(array);
1229             for (x=0; x < num; x++) {
1230                 wxTreeItemId *tii = new wxTreeItemId(array.Item(x));
1231                 PyObject* item = wxPyConstructObject((void*)tii, wxT("wxTreeItemId"), TRUE);
1232                 PyList_Append(rval, item);
1233             }
1234             wxPyEndBlockThreads();
1235             return rval;
1236         }
1237     }
1238
1239
1240
1241     size_t GetChildrenCount(const wxTreeItemId& item, bool recursively = TRUE);
1242
1243     wxTreeItemId GetFirstChild(const wxTreeItemId& item, long& INOUT = longzero);
1244     wxTreeItemId GetNextChild(const wxTreeItemId& item, long& INOUT);
1245     wxTreeItemId GetNextSibling(const wxTreeItemId& item);
1246     wxTreeItemId GetPrevSibling(const wxTreeItemId& item);
1247     wxTreeItemId GetFirstVisibleItem();
1248     wxTreeItemId GetNextVisible(const wxTreeItemId& item);
1249     wxTreeItemId GetPrevVisible(const wxTreeItemId& item);
1250     wxTreeItemId GetLastChild(const wxTreeItemId& item);
1251
1252
1253
1254     wxTreeItemId AddRoot(const wxString& text,
1255                          int image = -1, int selectedImage = -1,
1256                          wxPyTreeItemData *data = NULL);
1257     wxTreeItemId PrependItem(const wxTreeItemId& parent,
1258                              const wxString& text,
1259                              int image = -1, int selectedImage = -1,
1260                              wxPyTreeItemData *data = NULL);
1261     wxTreeItemId InsertItem(const wxTreeItemId& parent,
1262                             const wxTreeItemId& idPrevious,
1263                             const wxString& text,
1264                             int image = -1, int selectedImage = -1,
1265                             wxPyTreeItemData *data = NULL);
1266     %name(InsertItemBefore)
1267         wxTreeItemId InsertItem(const wxTreeItemId& parent,
1268                                 size_t before,
1269                                 const wxString& text,
1270                                 int image = -1, int selectedImage = -1,
1271                                 wxPyTreeItemData *data = NULL);
1272     wxTreeItemId AppendItem(const wxTreeItemId& parent,
1273                             const wxString& text,
1274                             int image = -1, int selectedImage = -1,
1275                             wxPyTreeItemData *data = NULL);
1276
1277     void Delete(const wxTreeItemId& item);
1278     void DeleteChildren(const wxTreeItemId& item);
1279     void DeleteAllItems();
1280
1281     void Expand(const wxTreeItemId& item);
1282     void Collapse(const wxTreeItemId& item);
1283     void CollapseAndReset(const wxTreeItemId& item);
1284     void Toggle(const wxTreeItemId& item);
1285
1286     void Unselect();
1287     void UnselectAll();
1288     void SelectItem(const wxTreeItemId& item);
1289     void EnsureVisible(const wxTreeItemId& item);
1290     void ScrollTo(const wxTreeItemId& item);
1291
1292     wxTextCtrl* GetEditControl();
1293     void EditLabel(const wxTreeItemId& item);
1294 #ifdef __WXMSW__
1295     void EndEditLabel(const wxTreeItemId& item, int discardChanges = FALSE);
1296 #endif
1297
1298     void SortChildren(const wxTreeItemId& item);
1299
1300     void SetItemBold(const wxTreeItemId& item, int bold = TRUE);
1301     bool IsBold(const wxTreeItemId& item) const;
1302     wxTreeItemId HitTest(const wxPoint& point, int& OUTPUT);
1303
1304
1305
1306     void SetItemTextColour(const wxTreeItemId& item, const wxColour& col);
1307     void SetItemBackgroundColour(const wxTreeItemId& item, const wxColour& col);
1308     void SetItemFont(const wxTreeItemId& item, const wxFont& font);
1309
1310 #ifdef __WXMSW__
1311     void SetItemDropHighlight(const wxTreeItemId& item, int highlight = TRUE);
1312 #endif
1313
1314     //bool GetBoundingRect(const wxTreeItemId& item, wxRect& rect, int textOnly = FALSE)
1315     %addmethods {
1316         PyObject* GetBoundingRect(const wxTreeItemId& item, int textOnly = FALSE) {
1317             wxRect rect;
1318             if (self->GetBoundingRect(item, rect, textOnly)) {
1319                 wxPyBeginBlockThreads();
1320                 wxRect* r = new wxRect(rect);
1321                 PyObject* val = wxPyConstructObject((void*)r, wxT("wxRect"), 1);
1322                 wxPyEndBlockThreads();
1323                 return val;
1324             }
1325             else {
1326                 Py_INCREF(Py_None);
1327                 return Py_None;
1328             }
1329         }
1330     }
1331
1332
1333 %pragma(python) addtoclass = "
1334     # Redefine some methods that SWIG gets a bit confused on...
1335     def GetFirstChild(self, *_args, **_kwargs):
1336         val1,val2 = controls2c.wxTreeCtrl_GetFirstChild(self, *_args, **_kwargs)
1337         val1 = wxTreeItemIdPtr(val1)
1338         val1.thisown = 1
1339         return (val1,val2)
1340     def GetNextChild(self, *_args, **_kwargs):
1341         val1,val2 = controls2c.wxTreeCtrl_GetNextChild(self, *_args, **_kwargs)
1342         val1 = wxTreeItemIdPtr(val1)
1343         val1.thisown = 1
1344         return (val1,val2)
1345     def HitTest(self, *_args, **_kwargs):
1346         val1, val2 = controls2c.wxTreeCtrl_HitTest(self, *_args, **_kwargs)
1347         val1 = wxTreeItemIdPtr(val1)
1348         val1.thisown = 1
1349         return (val1,val2)
1350 "
1351
1352 };
1353
1354
1355 //----------------------------------------------------------------------
1356
1357
1358 enum {
1359     wxDIRCTRL_DIR_ONLY,
1360     wxDIRCTRL_SELECT_FIRST,
1361     wxDIRCTRL_SHOW_FILTERS,
1362     wxDIRCTRL_3D_INTERNAL,
1363     wxDIRCTRL_EDIT_LABELS,
1364
1365     wxID_TREECTRL,
1366     wxID_FILTERLISTCTRL,
1367 };
1368
1369
1370 class wxDirItemData : public wxObject // wxTreeItemData
1371 {
1372 public:
1373   wxDirItemData(const wxString& path, const wxString& name, bool isDir);
1374 //  ~wxDirItemDataEx();
1375   void SetNewDirName( wxString path );
1376   wxString m_path, m_name;
1377   bool m_isHidden;
1378   bool m_isExpanded;
1379   bool m_isDir;
1380 };
1381
1382
1383 class wxGenericDirCtrl: public wxControl
1384 {
1385 public:
1386     wxGenericDirCtrl(wxWindow *parent, const wxWindowID id = -1,
1387                      const wxString& dir = wxPyDirDialogDefaultFolderStr,
1388                      const wxPoint& pos = wxDefaultPosition,
1389                      const wxSize& size = wxDefaultSize,
1390                      long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
1391                      const wxString& filter = wxPyEmptyString,
1392                      int defaultFilter = 0,
1393                      const wxString& name = wxPy_TreeCtrlNameStr);
1394     %name(wxPreGenericDirCtrl)wxGenericDirCtrl();
1395
1396     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
1397     %pragma(python) addtomethod = "wxPreGenericDirCtrl:val._setOORInfo(val)"
1398
1399     bool Create(wxWindow *parent, const wxWindowID id = -1,
1400                 const wxString& dir = wxPyDirDialogDefaultFolderStr,
1401                 const wxPoint& pos = wxDefaultPosition,
1402                 const wxSize& size = wxDefaultSize,
1403                 long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
1404                 const wxString& filter = wxPyEmptyString,
1405                 int defaultFilter = 0,
1406                 const wxString& name = wxPy_TreeCtrlNameStr);
1407
1408
1409     // Try to expand as much of the given path as possible.
1410     bool ExpandPath(const wxString& path);
1411
1412     // Accessors
1413
1414     inline wxString GetDefaultPath() const;
1415     void SetDefaultPath(const wxString& path);
1416
1417     // Get dir or filename
1418     wxString GetPath() const ;
1419
1420     // Get selected filename path only (else empty string).
1421     // I.e. don't count a directory as a selection
1422     wxString GetFilePath() const ;
1423     void SetPath(const wxString& path) ;
1424
1425     void ShowHidden( bool show );
1426     bool GetShowHidden();
1427
1428     wxString GetFilter() const;
1429     void SetFilter(const wxString& filter);
1430
1431     int GetFilterIndex() const;
1432     void SetFilterIndex(int n) ;
1433
1434     wxTreeItemId GetRootId();
1435
1436     wxTreeCtrl* GetTreeCtrl() const;
1437     wxDirFilterListCtrl* GetFilterListCtrl() const;
1438
1439     // Collapse & expand the tree, thus re-creating it from scratch:
1440     void ReCreateTree();
1441
1442 //  //// Helpers
1443 //      void SetupSections();
1444 //      // Parse the filter into an array of filters and an array of descriptions
1445 //      int ParseFilter(const wxString& filterStr, wxArrayString& filters, wxArrayString& descriptions);
1446 //      // Find the child that matches the first part of 'path'.
1447 //      // E.g. if a child path is "/usr" and 'path' is "/usr/include"
1448 //      // then the child for /usr is returned.
1449 //      // If the path string has been used (we're at the leaf), done is set to TRUE
1450 //      wxTreeItemId FindChild(wxTreeItemId parentId, const wxString& path, bool& done);
1451 };
1452
1453
1454 class wxDirFilterListCtrl: public wxChoice
1455 {
1456 public:
1457     wxDirFilterListCtrl(wxGenericDirCtrl* parent, const wxWindowID id = -1,
1458                         const wxPoint& pos = wxDefaultPosition,
1459                         const wxSize& size = wxDefaultSize,
1460                         long style = 0);
1461     %name(wxPreDirFilterListCtrl)wxDirFilterListCtrl();
1462
1463     %pragma(python) addtomethod = "__init__:self._setOORInfo(self)"
1464     %pragma(python) addtomethod = "wxPreDirFilterListCtrl:val._setOORInfo(val)"
1465
1466     bool Create(wxGenericDirCtrl* parent, const wxWindowID id = -1,
1467               const wxPoint& pos = wxDefaultPosition,
1468               const wxSize& size = wxDefaultSize,
1469               long style = 0);
1470
1471 //// Operations
1472     void FillFilterList(const wxString& filter, int defaultFilter);
1473 };
1474
1475
1476 //----------------------------------------------------------------------
1477 //----------------------------------------------------------------------
1478
1479 %init %{
1480     // Map renamed classes back to their common name for OOR
1481     wxPyPtrTypeMap_Add("wxTreeItemData", "wxPyTreeItemData");
1482     wxPyPtrTypeMap_Add("wxTreeCtrl", "wxPyTreeCtrl");
1483     wxPyPtrTypeMap_Add("wxListCtrl", "wxPyListCtrl");
1484 %}
1485
1486 //----------------------------------------------------------------------
1487
1488