wxPython/src/_treectrl.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _treectrl.i
   3 // Purpose:     SWIG interface file for wxTreeCtrl and related classes
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     10-June-1998
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2002 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 // Not a %module
  14
  15
  16 //---------------------------------------------------------------------------
  17
  18 %{
  19 #include <wx/treectrl.h>
  20 #include "wx/wxPython/pytree.h"
  21 %}
  22
  23 MAKE_CONST_WXSTRING2(TreeCtrlNameStr, _T("wxTreeCtrl"));
  24
  25 //---------------------------------------------------------------------------
  26 %newgroup
  27
  28
  29 // wxTreeCtrl flags
  30 enum {
  31     wxTR_NO_BUTTONS,
  32     wxTR_HAS_BUTTONS,
  33     wxTR_NO_LINES,
  34     wxTR_LINES_AT_ROOT,
  35
  36     wxTR_SINGLE,
  37     wxTR_MULTIPLE,
  38     wxTR_EXTENDED,
  39     wxTR_HAS_VARIABLE_ROW_HEIGHT,
  40
  41     wxTR_EDIT_LABELS,
  42     wxTR_HIDE_ROOT,
  43     wxTR_ROW_LINES,
  44
  45     wxTR_FULL_ROW_HIGHLIGHT,
  46     wxTR_DEFAULT_STYLE,
  47
  48     wxTR_TWIST_BUTTONS,
  49     wxTR_MAC_BUTTONS,
  50     wxTR_AQUA_BUTTONS,
  51 };
  52
  53
  54 enum wxTreeItemIcon
  55 {
  56     wxTreeItemIcon_Normal,              // not selected, not expanded
  57     wxTreeItemIcon_Selected,            //     selected, not expanded
  58     wxTreeItemIcon_Expanded,            // not selected,     expanded
  59     wxTreeItemIcon_SelectedExpanded,    //     selected,     expanded
  60     wxTreeItemIcon_Max
  61 };
  62
  63
  64 // constants for HitTest
  65 enum {
  66     wxTREE_HITTEST_ABOVE,
  67     wxTREE_HITTEST_BELOW,
  68     wxTREE_HITTEST_NOWHERE,
  69     wxTREE_HITTEST_ONITEMBUTTON,
  70     wxTREE_HITTEST_ONITEMICON,
  71     wxTREE_HITTEST_ONITEMINDENT,
  72     wxTREE_HITTEST_ONITEMLABEL,
  73     wxTREE_HITTEST_ONITEMRIGHT,
  74     wxTREE_HITTEST_ONITEMSTATEICON,
  75     wxTREE_HITTEST_TOLEFT,
  76     wxTREE_HITTEST_TORIGHT,
  77     wxTREE_HITTEST_ONITEMUPPERPART,
  78     wxTREE_HITTEST_ONITEMLOWERPART,
  79     wxTREE_HITTEST_ONITEM
  80 };
  81
  82 //---------------------------------------------------------------------------
  83 %newgroup
  84
  85
  86 // wxTreeItemId identifies an element of the tree. In this implementation, it's
  87 // just a trivial wrapper around Win32 HTREEITEM or a pointer to some private
  88 // data structure in the generic version. It's opaque for the application and
  89 // the only method which can be used by user code is IsOk().
  90 class wxTreeItemId {
  91 public:
  92     wxTreeItemId();
  93     ~wxTreeItemId();
  94
  95     // is this a valid tree item?
  96     bool IsOk() const;
  97
  98     %extend {
  99         bool __eq__(const wxTreeItemId* other) { return other ? (*self == *other) : false; }
 100         bool __ne__(const wxTreeItemId* other) { return other ? (*self != *other) : true;  }
 101     }
 102
 103     void*  m_pItem;
 104
 105
 106     %pythoncode {
 107         Ok = IsOk
 108         def __nonzero__(self): return self.IsOk() }
 109 };
 110
 111
 112
 113
 114 // wxTreeItemData is some (arbitrary) user data associated with some tree
 115 // item.  The Python version is just a simple wrapper around a Python object
 116 // that knows how to handle references properly.  Using this class directly in
 117 // Python code should rarely be neccessary.  Just use the GetItemPyData and
 118 // SetItemPyData tree methods instead of the GetItemData and SetItemData
 119 // methods.
 120 %rename(TreeItemData) wxPyTreeItemData;
 121 class wxPyTreeItemData {
 122 public:
 123     wxPyTreeItemData(PyObject* obj = NULL);
 124
 125     PyObject* GetData();
 126     void      SetData(PyObject* obj);
 127
 128     const wxTreeItemId& GetId();
 129     void                SetId(const wxTreeItemId& id);
 130
 131     %extend { void Destroy() { delete self; } }
 132 };
 133
 134
 135
 136 #if 0  // it's not currently used anywhere...
 137
 138 // wxTreeItemAttr: a structure containing the visual attributes of an item
 139 class wxTreeItemAttr
 140 {
 141 public:
 142     // ctors
 143     //wxTreeItemAttr() { }
 144     wxTreeItemAttr(const wxColour& colText = wxNullColour,
 145                    const wxColour& colBack = wxNullColour,
 146                    const wxFont& font = wxNullFont);
 147
 148     // setters
 149     void SetTextColour(const wxColour& colText);
 150     void SetBackgroundColour(const wxColour& colBack);
 151     void SetFont(const wxFont& font);
 152
 153     // accessors
 154     bool HasTextColour();
 155     bool HasBackgroundColour();
 156     bool HasFont();
 157
 158     wxColour GetTextColour();
 159     wxColour GetBackgroundColour();
 160     wxFont GetFont();
 161
 162     %extend { void Destroy() { delete self; } }
 163 };
 164
 165 #endif
 166
 167
 168 //---------------------------------------------------------------------------
 169 %newgroup
 170
 171 /* Tree control event types */
 172 %constant wxEventType wxEVT_COMMAND_TREE_BEGIN_DRAG;
 173 %constant wxEventType wxEVT_COMMAND_TREE_BEGIN_RDRAG;
 174 %constant wxEventType wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT;
 175 %constant wxEventType wxEVT_COMMAND_TREE_END_LABEL_EDIT;
 176 %constant wxEventType wxEVT_COMMAND_TREE_DELETE_ITEM;
 177 %constant wxEventType wxEVT_COMMAND_TREE_GET_INFO;
 178 %constant wxEventType wxEVT_COMMAND_TREE_SET_INFO;
 179 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDED;
 180 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDING;
 181 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSED;
 182 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSING;
 183 %constant wxEventType wxEVT_COMMAND_TREE_SEL_CHANGED;
 184 %constant wxEventType wxEVT_COMMAND_TREE_SEL_CHANGING;
 185 %constant wxEventType wxEVT_COMMAND_TREE_KEY_DOWN;
 186 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_ACTIVATED;
 187 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK;
 188 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK;
 189 %constant wxEventType wxEVT_COMMAND_TREE_END_DRAG;
 190 %constant wxEventType wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK;
 191 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP;
 192 %constant wxEventType wxEVT_COMMAND_TREE_ITEM_MENU;
 193
 194 %pythoncode {
 195
 196 EVT_TREE_BEGIN_DRAG        = wx.PyEventBinder(wxEVT_COMMAND_TREE_BEGIN_DRAG       , 1)
 197 EVT_TREE_BEGIN_RDRAG       = wx.PyEventBinder(wxEVT_COMMAND_TREE_BEGIN_RDRAG      , 1)
 198 EVT_TREE_BEGIN_LABEL_EDIT  = wx.PyEventBinder(wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT , 1)
 199 EVT_TREE_END_LABEL_EDIT    = wx.PyEventBinder(wxEVT_COMMAND_TREE_END_LABEL_EDIT   , 1)
 200 EVT_TREE_DELETE_ITEM       = wx.PyEventBinder(wxEVT_COMMAND_TREE_DELETE_ITEM      , 1)
 201 EVT_TREE_GET_INFO          = wx.PyEventBinder(wxEVT_COMMAND_TREE_GET_INFO         , 1)
 202 EVT_TREE_SET_INFO          = wx.PyEventBinder(wxEVT_COMMAND_TREE_SET_INFO         , 1)
 203 EVT_TREE_ITEM_EXPANDED     = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_EXPANDED    , 1)
 204 EVT_TREE_ITEM_EXPANDING    = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_EXPANDING   , 1)
 205 EVT_TREE_ITEM_COLLAPSED    = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_COLLAPSED   , 1)
 206 EVT_TREE_ITEM_COLLAPSING   = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_COLLAPSING  , 1)
 207 EVT_TREE_SEL_CHANGED       = wx.PyEventBinder(wxEVT_COMMAND_TREE_SEL_CHANGED      , 1)
 208 EVT_TREE_SEL_CHANGING      = wx.PyEventBinder(wxEVT_COMMAND_TREE_SEL_CHANGING     , 1)
 209 EVT_TREE_KEY_DOWN          = wx.PyEventBinder(wxEVT_COMMAND_TREE_KEY_DOWN         , 1)
 210 EVT_TREE_ITEM_ACTIVATED    = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_ACTIVATED   , 1)
 211 EVT_TREE_ITEM_RIGHT_CLICK  = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK , 1)
 212 EVT_TREE_ITEM_MIDDLE_CLICK = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK, 1)
 213 EVT_TREE_END_DRAG          = wx.PyEventBinder(wxEVT_COMMAND_TREE_END_DRAG         , 1)
 214 EVT_TREE_STATE_IMAGE_CLICK = wx.PyEventBinder(wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK, 1)
 215 EVT_TREE_ITEM_GETTOOLTIP   = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP,   1)
 216 EVT_COMMAND_TREE_ITEM_MENU = wx.PyEventBinder(wxEVT_COMMAND_TREE_ITEM_MENU,         1)
 217 }
 218
 219
 220
 221 // wxTreeEvent is a special class for all events associated with tree controls
 222 //
 223 // NB: note that not all accessors make sense for all events, see the event
 224 //     descriptions below
 225 class wxTreeEvent : public wxNotifyEvent {
 226 public:
 227     wxTreeEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
 228
 229         // get the item on which the operation was performed or the newly
 230         // selected item for wxEVT_COMMAND_TREE_SEL_CHANGED/ING events
 231     wxTreeItemId GetItem() const;
 232     void SetItem(const wxTreeItemId& item);
 233
 234         // for wxEVT_COMMAND_TREE_SEL_CHANGED/ING events, get the previously
 235         // selected item
 236     wxTreeItemId GetOldItem() const;
 237     void SetOldItem(const wxTreeItemId& item);
 238
 239         // the point where the mouse was when the drag operation started (for
 240         // wxEVT_COMMAND_TREE_BEGIN_(R)DRAG events only) or click position
 241     wxPoint GetPoint() const;
 242     void SetPoint(const wxPoint& pt);
 243
 244         // keyboard data (for wxEVT_COMMAND_TREE_KEY_DOWN only)
 245     const wxKeyEvent& GetKeyEvent() const;
 246     int GetKeyCode() const;
 247     void SetKeyEvent(const wxKeyEvent& evt);
 248
 249         // label (for EVT_TREE_{BEGIN|END}_LABEL_EDIT only)
 250     const wxString& GetLabel() const;
 251     void SetLabel(const wxString& label);
 252
 253         // edit cancel flag (for EVT_TREE_{BEGIN|END}_LABEL_EDIT only)
 254     bool IsEditCancelled() const;
 255     void SetEditCanceled(bool editCancelled);
 256
 257         // Set the tooltip for the item (for EVT_TREE_ITEM_GETTOOLTIP events)
 258     void SetToolTip(const wxString& toolTip);
 259 };
 260
 261 //---------------------------------------------------------------------------
 262 %newgroup
 263
 264 %{ // C++ version of Python aware wxTreeCtrl
 265 class wxPyTreeCtrl : public wxTreeCtrl {
 266     DECLARE_ABSTRACT_CLASS(wxPyTreeCtrl);
 267 public:
 268     wxPyTreeCtrl() : wxTreeCtrl() {}
 269     wxPyTreeCtrl(wxWindow *parent, wxWindowID id,
 270                  const wxPoint& pos,
 271                  const wxSize& size,
 272                  long style,
 273                  const wxValidator& validator,
 274                  const wxString& name) :
 275         wxTreeCtrl(parent, id, pos, size, style, validator, name) {}
 276
 277     bool Create(wxWindow *parent, wxWindowID id,
 278                 const wxPoint& pos,
 279                 const wxSize& size,
 280                 long style,
 281                 const wxValidator& validator,
 282                 const wxString& name) {
 283         return wxTreeCtrl::Create(parent, id, pos, size, style, validator, name);
 284     }
 285
 286
 287     int OnCompareItems(const wxTreeItemId& item1,
 288                        const wxTreeItemId& item2) {
 289         int rval = 0;
 290         bool found;
 291         bool blocked = wxPyBeginBlockThreads();
 292         if ((found = wxPyCBH_findCallback(m_myInst, "OnCompareItems"))) {
 293             PyObject *o1 = wxPyConstructObject((void*)&item1, wxT("wxTreeItemId"), false);
 294             PyObject *o2 = wxPyConstructObject((void*)&item2, wxT("wxTreeItemId"), false);
 295             rval = wxPyCBH_callCallback(m_myInst, Py_BuildValue("(OO)",o1,o2));
 296             Py_DECREF(o1);
 297             Py_DECREF(o2);
 298         }
 299         wxPyEndBlockThreads(blocked);
 300         if (! found)
 301             rval = wxTreeCtrl::OnCompareItems(item1, item2);
 302         return rval;
 303     }
 304     PYPRIVATE;
 305 };
 306
 307 IMPLEMENT_ABSTRACT_CLASS(wxPyTreeCtrl, wxTreeCtrl);
 308
 309 %}
 310
 311
 312
 313
 314 MustHaveApp(wxPyTreeCtrl);
 315
 316 %rename(TreeCtrl) wxPyTreeCtrl;
 317 class wxPyTreeCtrl : public wxControl {
 318 public:
 319     %pythonAppend wxPyTreeCtrl         "self._setOORInfo(self);self._setCallbackInfo(self, TreeCtrl)"
 320     %pythonAppend wxPyTreeCtrl()       ""
 321     %typemap(out) wxPyTreeCtrl*;    // turn off this typemap
 322
 323     wxPyTreeCtrl(wxWindow *parent, wxWindowID id = -1,
 324                  const wxPoint& pos = wxDefaultPosition,
 325                  const wxSize& size = wxDefaultSize,
 326                  long style = wxTR_DEFAULT_STYLE,
 327                  const wxValidator& validator = wxDefaultValidator,
 328                  const wxString& name = wxPyTreeCtrlNameStr);
 329     %RenameCtor(PreTreeCtrl, wxPyTreeCtrl());
 330
 331     // Turn it back on again
 332     %typemap(out) wxPyTreeCtrl* { $result = wxPyMake_wxObject($1, $owner); }
 333
 334     bool Create(wxWindow *parent, wxWindowID id = -1,
 335                 const wxPoint& pos = wxDefaultPosition,
 336                 const wxSize& size = wxDefaultSize,
 337                 long style = wxTR_DEFAULT_STYLE,
 338                 const wxValidator& validator = wxDefaultValidator,
 339                 const wxString& name = wxPyTreeCtrlNameStr);
 340
 341     void _setCallbackInfo(PyObject* self, PyObject* _class);
 342
 343
 344     // get the total number of items in the control
 345     size_t GetCount() const;
 346
 347     // indent is the number of pixels the children are indented relative to
 348     // the parents position. SetIndent() also redraws the control
 349     // immediately.
 350     unsigned int GetIndent() const;
 351     void SetIndent(unsigned int indent);
 352
 353     // spacing is the number of pixels between the start and the Text
 354     // not implemented under wxMSW
 355     unsigned int GetSpacing() const;
 356     void SetSpacing(unsigned int spacing);
 357
 358
 359     // image list: these functions allow to associate an image list with
 360     // the control and retrieve it. Note that the control does _not_ delete
 361     // the associated image list when it's deleted in order to allow image
 362     // lists to be shared between different controls.
 363     //
 364     // The normal image list is for the icons which correspond to the
 365     // normal tree item state (whether it is selected or not).
 366     // Additionally, the application might choose to show a state icon
 367     // which corresponds to an app-defined item state (for example,
 368     // checked/unchecked) which are taken from the state image list.
 369     wxImageList *GetImageList() const;
 370     wxImageList *GetStateImageList() const;
 371
 372     void SetImageList(wxImageList *imageList);
 373     void SetStateImageList(wxImageList *imageList);
 374
 375     %apply SWIGTYPE *DISOWN { wxImageList *imageList };
 376     void AssignImageList(wxImageList *imageList);
 377     void AssignStateImageList(wxImageList *imageList);
 378     %clear wxImageList *imageList;
 379
 380
 381     // retrieve items label
 382     wxString GetItemText(const wxTreeItemId& item) const;
 383
 384     // get one of the images associated with the item (normal by default)
 385     int GetItemImage(const wxTreeItemId& item,
 386                      wxTreeItemIcon which = wxTreeItemIcon_Normal) const;
 387
 388     %extend {
 389         // get the wxPyTreeItemData associated with the tree item
 390         wxPyTreeItemData* GetItemData(const wxTreeItemId& item) {
 391             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
 392             if (data == NULL) {
 393                 data = new wxPyTreeItemData();
 394                 data->SetId(item); // set the id
 395                 self->SetItemData(item, data);
 396             }
 397             return data;
 398         }
 399         // Get the Python object associated with the tree item
 400         PyObject* GetItemPyData(const wxTreeItemId& item) {
 401             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
 402             if (data == NULL) {
 403                 data = new wxPyTreeItemData();
 404                 data->SetId(item); // set the id
 405                 self->SetItemData(item, data);
 406             }
 407             return data->GetData();
 408         }
 409     }
 410     %pythoncode { GetPyData = GetItemPyData }
 411
 412
 413     // get the item's text colour
 414     wxColour GetItemTextColour(const wxTreeItemId& item) const;
 415
 416     // get the item's background colour
 417     wxColour GetItemBackgroundColour(const wxTreeItemId& item) const;
 418
 419     // get the item's font
 420     wxFont GetItemFont(const wxTreeItemId& item) const;
 421
 422
 423
 424     // set items label
 425     void SetItemText(const wxTreeItemId& item, const wxString& text);
 426
 427     // get one of the images associated with the item (normal by default)
 428     void SetItemImage(const wxTreeItemId& item, int image,
 429                       wxTreeItemIcon which = wxTreeItemIcon_Normal);
 430
 431     %extend {
 432         // associate a wxPyTreeItemData with the tree item
 433         void SetItemData(const wxTreeItemId& item, wxPyTreeItemData* data) {
 434             data->SetId(item); // set the id
 435             self->SetItemData(item, data);
 436         }
 437
 438         // associate a Python object with the tree item
 439         void SetItemPyData(const wxTreeItemId& item, PyObject* obj) {
 440             wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
 441             if (data == NULL) {
 442                 data = new wxPyTreeItemData(obj);
 443                 data->SetId(item); // set the id
 444                 self->SetItemData(item, data);
 445             } else
 446                 data->SetData(obj);
 447         }
 448     }
 449     %pythoncode { SetPyData = SetItemPyData }
 450
 451
 452     // force appearance of [+] button near the item. This is useful to
 453     // allow the user to expand the items which don't have any children now
 454     // - but instead add them only when needed, thus minimizing memory
 455     // usage and loading time.
 456     void SetItemHasChildren(const wxTreeItemId& item, bool has = true);
 457
 458     // the item will be shown in bold
 459     void SetItemBold(const wxTreeItemId& item, bool bold = true);
 460
 461 #ifdef __WXMSW__
 462     // the item will be shown with a drop highlight
 463     void SetItemDropHighlight(const wxTreeItemId& item, bool highlight = true);
 464 #endif
 465
 466     // set the items text colour
 467     void SetItemTextColour(const wxTreeItemId& item, const wxColour& col);
 468
 469     // set the items background colour
 470     void SetItemBackgroundColour(const wxTreeItemId& item, const wxColour& col);
 471
 472     // set the items font (should be of the same height for all items)
 473     void SetItemFont(const wxTreeItemId& item, const wxFont& font);
 474
 475
 476     // is the item visible (it might be outside the view or not expanded)?
 477     bool IsVisible(const wxTreeItemId& item) const;
 478
 479     // does the item has any children?
 480     bool ItemHasChildren(const wxTreeItemId& item) const;
 481
 482     // is the item expanded (only makes sense if HasChildren())?
 483     bool IsExpanded(const wxTreeItemId& item) const;
 484
 485     // is this item currently selected (the same as has focus)?
 486     bool IsSelected(const wxTreeItemId& item) const;
 487
 488     // is item text in bold font?
 489     bool IsBold(const wxTreeItemId& item) const;
 490
 491
 492     // if 'recursively' is False, only immediate children count, otherwise
 493     // the returned number is the number of all items in this branch
 494     size_t GetChildrenCount(const wxTreeItemId& item,
 495                             bool recursively = true) /*const*/;
 496
 497
 498
 499     // get the root tree item
 500     // wxTreeItemId.IsOk() will return False if there is no such item
 501     wxTreeItemId GetRootItem() const;
 502
 503     // get the item currently selected
 504     // wxTreeItemId.IsOk() will return False if there is no such item
 505     wxTreeItemId GetSelection() const;
 506
 507     %extend {
 508         // get the items currently selected, return the number of such item
 509         //
 510         // NB: this operation is expensive and can take a long time for a
 511         //     control with a lot of items (~ O(number of items)).
 512         PyObject* GetSelections() {
 513             bool blocked = wxPyBeginBlockThreads();
 514             PyObject*           rval = PyList_New(0);
 515             wxArrayTreeItemIds  array;
 516             size_t              num, x;
 517             num = self->GetSelections(array);
 518             for (x=0; x < num; x++) {
 519                 wxTreeItemId *tii = new wxTreeItemId(array.Item(x));
 520                 PyObject* item = wxPyConstructObject((void*)tii, wxT("wxTreeItemId"), true);
 521                 PyList_Append(rval, item);
 522                 Py_DECREF(item);
 523             }
 524             wxPyEndBlockThreads(blocked);
 525             return rval;
 526         }
 527     }
 528
 529     // get the parent of this item
 530     // wxTreeItemId.IsOk() will return False if there is no such item
 531     wxTreeItemId GetItemParent(const wxTreeItemId& item) const;
 532
 533
 534     // NOTE: These are a copy of the same methods in gizmos.i, be sure to
 535     // update both at the same time.  (Or find a good way to refactor!)
 536     %extend {
 537         // Get the first child of this item.  Returns a wxTreeItemId and an
 538         // opaque "cookie" value that should be passed to GetNextChild in
 539         // order to continue the search.
 540         PyObject* GetFirstChild(const wxTreeItemId& item) {
 541             void* cookie = 0;
 542             wxTreeItemId* ritem = new wxTreeItemId(self->GetFirstChild(item, cookie));
 543             bool blocked = wxPyBeginBlockThreads();
 544             PyObject* tup = PyTuple_New(2);
 545             PyTuple_SET_ITEM(tup, 0, wxPyConstructObject(ritem, wxT("wxTreeItemId"), true));
 546             PyTuple_SET_ITEM(tup, 1, wxPyMakeSwigPtr(cookie, wxT("void")));
 547             wxPyEndBlockThreads(blocked);
 548             return tup;
 549         }
 550
 551
 552         // Get the next child of this item.  The cookie parameter is the 2nd
 553         // value returned from GetFirstChild or the previous GetNextChild.
 554         // Returns a wxTreeItemId and an opaque "cookie" value that should be
 555         // passed to GetNextChild in order to continue the search.
 556         PyObject* GetNextChild(const wxTreeItemId& item, void* cookie) {
 557             wxTreeItemId* ritem = new wxTreeItemId(self->GetNextChild(item, cookie));
 558             bool blocked = wxPyBeginBlockThreads();
 559             PyObject* tup = PyTuple_New(2);
 560             PyTuple_SET_ITEM(tup, 0, wxPyConstructObject(ritem, wxT("wxTreeItemId"), true));
 561             PyTuple_SET_ITEM(tup, 1, wxPyMakeSwigPtr(cookie, wxT("void")));
 562             wxPyEndBlockThreads(blocked);
 563             return tup;
 564         }
 565     }
 566
 567     // get the last child of this item
 568     wxTreeItemId GetLastChild(const wxTreeItemId& item) const;
 569
 570     // get the next sibling of this item
 571     wxTreeItemId GetNextSibling(const wxTreeItemId& item) const;
 572
 573     // get the previous sibling
 574     wxTreeItemId GetPrevSibling(const wxTreeItemId& item) const;
 575
 576     // get first visible item
 577     wxTreeItemId GetFirstVisibleItem() const;
 578
 579     // get the next visible item: item must be visible itself!
 580     // see IsVisible() and wxTreeCtrl::GetFirstVisibleItem()
 581     wxTreeItemId GetNextVisible(const wxTreeItemId& item) const;
 582
 583     // get the previous visible item: item must be visible itself!
 584     wxTreeItemId GetPrevVisible(const wxTreeItemId& item) const;
 585
 586
 587
 588     // add the root node to the tree
 589     wxTreeItemId AddRoot(const wxString& text,
 590                          int image = -1, int selectedImage = -1,
 591                          wxPyTreeItemData *data = NULL);
 592
 593     // insert a new item in as the first child of the parent
 594     wxTreeItemId PrependItem(const wxTreeItemId& parent,
 595                              const wxString& text,
 596                              int image = -1, int selectedImage = -1,
 597                              wxPyTreeItemData *data = NULL);
 598
 599     // insert a new item after a given one
 600     wxTreeItemId InsertItem(const wxTreeItemId& parent,
 601                             const wxTreeItemId& idPrevious,
 602                             const wxString& text,
 603                             int image = -1, int selectedImage = -1,
 604                             wxPyTreeItemData *data = NULL);
 605
 606     // insert a new item before the one with the given index
 607     %Rename(InsertItemBefore,
 608     wxTreeItemId, InsertItem(const wxTreeItemId& parent,
 609                             size_t index,
 610                             const wxString& text,
 611                             int image = -1, int selectedImage = -1,
 612                             wxPyTreeItemData *data = NULL));
 613
 614         // insert a new item in as the last child of the parent
 615     wxTreeItemId AppendItem(const wxTreeItemId& parent,
 616                             const wxString& text,
 617                             int image = -1, int selectedImage = -1,
 618                             wxPyTreeItemData *data = NULL);
 619
 620
 621
 622     // delete this item and associated data if any
 623     void Delete(const wxTreeItemId& item);
 624
 625     // delete all children (but don't delete the item itself)
 626     // NB: this won't send wxEVT_COMMAND_TREE_ITEM_DELETED events
 627     void DeleteChildren(const wxTreeItemId& item);
 628
 629     // delete all items from the tree
 630     // NB: this won't send wxEVT_COMMAND_TREE_ITEM_DELETED events
 631     void DeleteAllItems();
 632
 633
 634     // expand this item
 635     void Expand(const wxTreeItemId& item);
 636
 637     // collapse the item without removing its children
 638     void Collapse(const wxTreeItemId& item);
 639
 640     // collapse the item and remove all children
 641     void CollapseAndReset(const wxTreeItemId& item);
 642
 643     // toggles the current state
 644     void Toggle(const wxTreeItemId& item);
 645
 646
 647     // remove the selection from currently selected item (if any)
 648     void Unselect();
 649
 650     // remove the selection from the given one (multiselect mode only)
 651     void UnselectItem(const wxTreeItemId& item);
 652
 653     // unselect all items (only makes sense for multiple selection control)
 654     void UnselectAll();
 655
 656     // select this item
 657     void SelectItem(const wxTreeItemId& item, bool select = true);
 658
 659     // toggle the item selection
 660     void ToggleItemSelection(const wxTreeItemId& item);
 661
 662
 663     // make sure this item is visible (expanding the parent item and/or
 664     // scrolling to this item if necessary)
 665     void EnsureVisible(const wxTreeItemId& item);
 666
 667     // scroll to this item (but don't expand its parent)
 668     void ScrollTo(const wxTreeItemId& item);
 669
 670
 671
 672     // start editing the item label: this (temporarily) replaces the item
 673     // with a one line edit control. The item will be selected if it hadn't
 674     // been before.
 675     /**wxTextCtrl* */ void  EditLabel(const wxTreeItemId& item);
 676
 677     // returns the same pointer as StartEdit() if the item is being edited,
 678     // NULL otherwise (it's assumed that no more than one item may be
 679     // edited simultaneously)
 680     wxTextCtrl* GetEditControl() const;
 681
 682 #ifdef __WXMSW__
 683     // end editing and accept or discard the changes to item label
 684     void EndEditLabel(const wxTreeItemId& item, bool discardChanges = false);
 685 #endif
 686
 687
 688     // Sort the children of this item using OnCompareItems, a member function
 689     // that is called to compare 2 items and should return -1, 0 or +1 if the
 690     // first item is less than, equal to or greater than the second one. The
 691     // base class version performs alphabetic comparaison of item labels
 692     // (GetText)
 693     void SortChildren(const wxTreeItemId& item);
 694
 695
 696
 697     DocDeclAStr(
 698         wxTreeItemId, HitTest(const wxPoint& point, int& OUTPUT),
 699         "HitTest(Point point) -> (item, where)",
 700         "Determine which item (if any) belongs the given point.  The coordinates
 701 specified are relative to the client area of tree ctrl and the where return
 702 value is set to a bitmask of wxTREE_HITTEST_xxx constants.
 703 ", "");
 704
 705
 706     %extend {
 707         // get the bounding rectangle of the item (or of its label only)
 708         PyObject* GetBoundingRect(const wxTreeItemId& item,  bool textOnly = false) {
 709              wxRect rect;
 710             if (self->GetBoundingRect(item, rect, textOnly)) {
 711                 bool blocked = wxPyBeginBlockThreads();
 712                 wxRect* r = new wxRect(rect);
 713                 PyObject* val = wxPyConstructObject((void*)r, wxT("wxRect"), true);
 714                 wxPyEndBlockThreads(blocked);
 715                 return val;
 716             }
 717             else
 718                 RETURN_NONE();
 719         }
 720     }
 721
 722 #ifdef __WXMSW__
 723     // set/get the item state.image (state == -1 means cycle to the next one)
 724     void SetState(const wxTreeItemId& node, int state);
 725     int GetState(const wxTreeItemId& node);
 726 #endif
 727
 728     static wxVisualAttributes
 729     GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
 730 };
 731
 732
 733 //---------------------------------------------------------------------------
 734 %init %{
 735     // Map renamed classes back to their common name for OOR
 736     wxPyPtrTypeMap_Add("wxTreeItemData", "wxPyTreeItemData");
 737     wxPyPtrTypeMap_Add("wxTreeCtrl", "wxPyTreeCtrl");
 738 %}
 739 //---------------------------------------------------------------------------