d14a1e2856
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@24541 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
936 lines
32 KiB
OpenEdge ABL
936 lines
32 KiB
OpenEdge ABL
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: gizmos.i
|
|
// Purpose: Wrappers for the "gizmo" classes in wx/contrib
|
|
//
|
|
// Author: Robin Dunn
|
|
//
|
|
// Created: 23-Nov-2001
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) 2001 by Total Control Software
|
|
// Licence: wxWindows license
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
%module gizmos
|
|
|
|
|
|
%{
|
|
#include "wx/wxPython/wxPython.h"
|
|
#include "wx/wxPython/pyclasses.h"
|
|
|
|
#include <wx/gizmos/dynamicsash.h>
|
|
#include <wx/gizmos/editlbox.h>
|
|
#include <wx/gizmos/splittree.h>
|
|
#include <wx/gizmos/ledctrl.h>
|
|
|
|
#include <wx/listctrl.h>
|
|
#include <wx/treectrl.h>
|
|
#include <wx/imaglist.h>
|
|
|
|
#include "treelistctrl.h"
|
|
#include "wx/wxPython/pytree.h"
|
|
|
|
|
|
static const wxString wxPyDynamicSashNameStr(wxT("dynamicSashWindow"));
|
|
static const wxString wxPyEditableListBoxNameStr(wxT("editableListBox"));
|
|
static const wxString wxPyTreeListCtrlNameStr(wxT("treelistctrl"));
|
|
static const wxString wxPyEmptyString(wxT(""));
|
|
%}
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
%import windows.i
|
|
%import controls.i
|
|
%pythoncode { wx = core }
|
|
|
|
%include _gizmos_rename.i
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
enum {
|
|
wxEVT_DYNAMIC_SASH_SPLIT,
|
|
wxEVT_DYNAMIC_SASH_UNIFY,
|
|
|
|
wxDS_MANAGE_SCROLLBARS,
|
|
wxDS_DRAG_CORNER,
|
|
};
|
|
|
|
|
|
/*
|
|
wxDynamicSashSplitEvents are sent to your view by wxDynamicSashWindow
|
|
whenever your view is being split by the user. It is your
|
|
responsibility to handle this event by creating a new view window as
|
|
a child of the wxDynamicSashWindow. wxDynamicSashWindow will
|
|
automatically reparent it to the proper place in its window hierarchy.
|
|
*/
|
|
class wxDynamicSashSplitEvent : public wxCommandEvent {
|
|
public:
|
|
wxDynamicSashSplitEvent(wxObject *target);
|
|
};
|
|
|
|
|
|
/*
|
|
wxDynamicSashUnifyEvents are sent to your view by wxDynamicSashWindow
|
|
whenever the sash which splits your view and its sibling is being
|
|
reunified such that your view is expanding to replace its sibling.
|
|
You needn't do anything with this event if you are allowing
|
|
wxDynamicSashWindow to manage your view's scrollbars, but it is useful
|
|
if you are managing the scrollbars yourself so that you can keep
|
|
the scrollbars' event handlers connected to your view's event handler
|
|
class.
|
|
*/
|
|
class wxDynamicSashUnifyEvent : public wxCommandEvent {
|
|
public:
|
|
wxDynamicSashUnifyEvent(wxObject *target);
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
wxDynamicSashWindow
|
|
|
|
wxDynamicSashWindow widgets manages the way other widgets are viewed.
|
|
When a wxDynamicSashWindow is first shown, it will contain one child
|
|
view, a viewport for that child, and a pair of scrollbars to allow the
|
|
user to navigate the child view area. Next to each scrollbar is a small
|
|
tab. By clicking on either tab and dragging to the appropriate spot, a
|
|
user can split the view area into two smaller views separated by a
|
|
draggable sash. Later, when the user wishes to reunify the two subviews,
|
|
the user simply drags the sash to the side of the window.
|
|
wxDynamicSashWindow will automatically reparent the appropriate child
|
|
view back up the window hierarchy, and the wxDynamicSashWindow will have
|
|
only one child view once again.
|
|
|
|
As an application developer, you will simply create a wxDynamicSashWindow
|
|
using either the Create() function or the more complex constructor
|
|
provided below, and then create a view window whose parent is the
|
|
wxDynamicSashWindow. The child should respond to
|
|
wxDynamicSashSplitEvents -- perhaps with an OnSplit() event handler -- by
|
|
constructing a new view window whose parent is also the
|
|
wxDynamicSashWindow. That's it! Now your users can dynamically split
|
|
and reunify the view you provided.
|
|
|
|
If you wish to handle the scrollbar events for your view, rather than
|
|
allowing wxDynamicSashWindow to do it for you, things are a bit more
|
|
complex. (You might want to handle scrollbar events yourself, if,
|
|
for instance, you wish to scroll a subwindow of the view you add to
|
|
your wxDynamicSashWindow object, rather than scrolling the whole view.)
|
|
In this case, you will need to construct your wxDynamicSashWindow without
|
|
the wxDS_MANAGE_SCROLLBARS style and you will need to use the
|
|
GetHScrollBar() and GetVScrollBar() methods to retrieve the scrollbar
|
|
controls and call SetEventHanler() on them to redirect the scrolling
|
|
events whenever your window is reparented by wxDyanmicSashWindow.
|
|
You will need to set the scrollbars' event handler at three times:
|
|
|
|
* When your view is created
|
|
* When your view receives a wxDynamicSashSplitEvent
|
|
* When your view receives a wxDynamicSashUnifyEvent
|
|
|
|
See the dynsash_switch sample application for an example which does this.
|
|
|
|
*/
|
|
|
|
class wxDynamicSashWindow : public wxWindow {
|
|
public:
|
|
%addtofunc wxDynamicSashWindow "self._setOORInfo(self)"
|
|
%addtofunc wxDynamicSashWindow() ""
|
|
|
|
wxDynamicSashWindow(wxWindow *parent, wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
|
|
long style = wxCLIP_CHILDREN | wxDS_MANAGE_SCROLLBARS | wxDS_DRAG_CORNER,
|
|
const wxString& name = wxPyDynamicSashNameStr);
|
|
%name(PreDynamicSashWindow)wxDynamicSashWindow();
|
|
|
|
bool Create(wxWindow *parent, wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
|
|
long style = wxCLIP_CHILDREN | wxDS_MANAGE_SCROLLBARS | wxDS_DRAG_CORNER,
|
|
const wxString& name = wxPyDynamicSashNameStr);
|
|
|
|
wxScrollBar *GetHScrollBar(const wxWindow *child) const;
|
|
wxScrollBar *GetVScrollBar(const wxWindow *child) const;
|
|
};
|
|
|
|
|
|
|
|
%pythoncode {
|
|
EVT_DYNAMIC_SASH_SPLIT = wx.PyEventBinder( wxEVT_DYNAMIC_SASH_SPLIT, 1 )
|
|
EVT_DYNAMIC_SASH_UNIFY = wx.PyEventBinder( wxEVT_DYNAMIC_SASH_UNIFY, 1 )
|
|
}
|
|
|
|
//---------------------------------------------------------------------------
|
|
//---------------------------------------------------------------------------
|
|
|
|
enum {
|
|
wxEL_ALLOW_NEW,
|
|
wxEL_ALLOW_EDIT,
|
|
wxEL_ALLOW_DELETE,
|
|
};
|
|
|
|
// This class provides a composite control that lets the
|
|
// user easily enter list of strings
|
|
class wxEditableListBox : public wxPanel
|
|
{
|
|
public:
|
|
%addtofunc wxEditableListBox "self._setOORInfo(self)"
|
|
%addtofunc wxEditableListBox() ""
|
|
|
|
wxEditableListBox(wxWindow *parent, wxWindowID id,
|
|
const wxString& label,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxEL_ALLOW_NEW | wxEL_ALLOW_EDIT | wxEL_ALLOW_DELETE,
|
|
const wxString& name = wxPyEditableListBoxNameStr);
|
|
|
|
|
|
void SetStrings(const wxArrayString& strings);
|
|
|
|
//void GetStrings(wxArrayString& strings);
|
|
%extend {
|
|
PyObject* GetStrings() {
|
|
wxArrayString strings;
|
|
self->GetStrings(strings);
|
|
return wxArrayString2PyList_helper(strings);
|
|
}
|
|
}
|
|
|
|
wxListCtrl* GetListCtrl();
|
|
wxBitmapButton* GetDelButton();
|
|
wxBitmapButton* GetNewButton();
|
|
wxBitmapButton* GetUpButton();
|
|
wxBitmapButton* GetDownButton();
|
|
wxBitmapButton* GetEditButton();
|
|
};
|
|
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
|
/*
|
|
* wxRemotelyScrolledTreeCtrl
|
|
*
|
|
* This tree control disables its vertical scrollbar and catches scroll
|
|
* events passed by a scrolled window higher in the hierarchy.
|
|
* It also updates the scrolled window vertical scrollbar as appropriate.
|
|
*/
|
|
|
|
%{
|
|
typedef wxTreeCtrl wxPyTreeCtrl;
|
|
%}
|
|
|
|
class wxRemotelyScrolledTreeCtrl: public wxPyTreeCtrl
|
|
{
|
|
public:
|
|
%addtofunc wxRemotelyScrolledTreeCtrl "self._setOORInfo(self)"
|
|
%addtofunc wxRemotelyScrolledTreeCtrl() ""
|
|
|
|
wxRemotelyScrolledTreeCtrl(wxWindow* parent, wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_HAS_BUTTONS);
|
|
|
|
|
|
void HideVScrollbar();
|
|
|
|
// Adjust the containing wxScrolledWindow's scrollbars appropriately
|
|
void AdjustRemoteScrollbars();
|
|
|
|
// Find the scrolled window that contains this control
|
|
wxScrolledWindow* GetScrolledWindow() const;
|
|
|
|
// Scroll to the given line (in scroll units where each unit is
|
|
// the height of an item)
|
|
void ScrollToLine(int posHoriz, int posVert);
|
|
|
|
// The companion window is one which will get notified when certain
|
|
// events happen such as node expansion
|
|
void SetCompanionWindow(wxWindow* companion);
|
|
wxWindow* GetCompanionWindow() const;
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
* wxTreeCompanionWindow
|
|
*
|
|
* A window displaying values associated with tree control items.
|
|
*/
|
|
|
|
%{
|
|
class wxPyTreeCompanionWindow: public wxTreeCompanionWindow
|
|
{
|
|
public:
|
|
wxPyTreeCompanionWindow(wxWindow* parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0)
|
|
: wxTreeCompanionWindow(parent, id, pos, size, style) {}
|
|
|
|
|
|
virtual void DrawItem(wxDC& dc, wxTreeItemId id, const wxRect& rect) {
|
|
bool found;
|
|
wxPyBeginBlockThreads();
|
|
if ((found = wxPyCBH_findCallback(m_myInst, "DrawItem"))) {
|
|
PyObject* dcobj = wxPyMake_wxObject(&dc);
|
|
PyObject* idobj = wxPyConstructObject((void*)&id, wxT("wxTreeItemId"), FALSE);
|
|
PyObject* recobj= wxPyConstructObject((void*)&rect, wxT("wxRect"), FALSE);
|
|
wxPyCBH_callCallback(m_myInst, Py_BuildValue("(OOO)", dcobj, idobj, recobj));
|
|
Py_DECREF(dcobj);
|
|
Py_DECREF(idobj);
|
|
Py_DECREF(recobj);
|
|
}
|
|
wxPyEndBlockThreads();
|
|
if (! found)
|
|
wxTreeCompanionWindow::DrawItem(dc, id, rect);
|
|
}
|
|
|
|
PYPRIVATE;
|
|
};
|
|
%}
|
|
|
|
|
|
%name(TreeCompanionWindow) class wxPyTreeCompanionWindow: public wxWindow
|
|
{
|
|
public:
|
|
%addtofunc wxPyTreeCompanionWindow "self._setOORInfo(self);self._setCallbackInfo(self, TreeCompanionWindow)"
|
|
%addtofunc wxPyTreeCompanionWindow() ""
|
|
|
|
wxPyTreeCompanionWindow(wxWindow* parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0);
|
|
void _setCallbackInfo(PyObject* self, PyObject* _class);
|
|
|
|
wxRemotelyScrolledTreeCtrl* GetTreeCtrl() const;
|
|
void SetTreeCtrl(wxRemotelyScrolledTreeCtrl* treeCtrl);
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
* wxThinSplitterWindow
|
|
*
|
|
* Implements a splitter with a less obvious sash
|
|
* than the usual one.
|
|
*/
|
|
|
|
class wxThinSplitterWindow: public wxSplitterWindow
|
|
{
|
|
public:
|
|
%addtofunc wxThinSplitterWindow "self._setOORInfo(self)"
|
|
%addtofunc wxThinSplitterWindow() ""
|
|
|
|
wxThinSplitterWindow(wxWindow* parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxSP_3D | wxCLIP_CHILDREN);
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
* wxSplitterScrolledWindow
|
|
*
|
|
* This scrolled window is aware of the fact that one of its
|
|
* children is a splitter window. It passes on its scroll events
|
|
* (after some processing) to both splitter children for them
|
|
* scroll appropriately.
|
|
*/
|
|
|
|
class wxSplitterScrolledWindow: public wxScrolledWindow
|
|
{
|
|
public:
|
|
%addtofunc wxSplitterScrolledWindow "self._setOORInfo(self)"
|
|
%addtofunc wxSplitterScrolledWindow() ""
|
|
|
|
wxSplitterScrolledWindow(wxWindow* parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0);
|
|
};
|
|
|
|
|
|
//---------------------------------------------------------------------------
|
|
//---------------------------------------------------------------------------
|
|
|
|
|
|
enum wxLEDValueAlign
|
|
{
|
|
wxLED_ALIGN_LEFT,
|
|
wxLED_ALIGN_RIGHT,
|
|
wxLED_ALIGN_CENTER,
|
|
|
|
wxLED_ALIGN_MASK,
|
|
|
|
wxLED_DRAW_FADED,
|
|
};
|
|
|
|
|
|
class wxLEDNumberCtrl : public wxControl
|
|
{
|
|
public:
|
|
%addtofunc wxLEDNumberCtrl "self._setOORInfo(self)"
|
|
%addtofunc wxLEDNumberCtrl() ""
|
|
|
|
wxLEDNumberCtrl(wxWindow *parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxLED_ALIGN_LEFT | wxLED_DRAW_FADED);
|
|
%name(PreLEDNumberCtrl) wxLEDNumberCtrl();
|
|
|
|
bool Create(wxWindow *parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxLED_ALIGN_LEFT | wxLED_DRAW_FADED);
|
|
|
|
wxLEDValueAlign GetAlignment() const;
|
|
bool GetDrawFaded() const;
|
|
const wxString &GetValue() const;
|
|
|
|
void SetAlignment(wxLEDValueAlign Alignment, bool Redraw = true);
|
|
void SetDrawFaded(bool DrawFaded, bool Redraw = true);
|
|
void SetValue(const wxString &Value, bool Redraw = true);
|
|
|
|
};
|
|
|
|
|
|
|
|
//----------------------------------------------------------------------------
|
|
// wxTreeListCtrl - the multicolumn tree control
|
|
//----------------------------------------------------------------------------
|
|
|
|
enum wxTreeListColumnAlign {
|
|
wxTL_ALIGN_LEFT,
|
|
wxTL_ALIGN_RIGHT,
|
|
wxTL_ALIGN_CENTER
|
|
};
|
|
|
|
|
|
|
|
enum {
|
|
wxTREE_HITTEST_ONITEMCOLUMN
|
|
};
|
|
|
|
|
|
|
|
|
|
class wxTreeListColumnInfo: public wxObject {
|
|
public:
|
|
wxTreeListColumnInfo(const wxString& text = wxPyEmptyString,
|
|
int image = -1,
|
|
size_t width = 100,
|
|
wxTreeListColumnAlign alignment = wxTL_ALIGN_LEFT);
|
|
|
|
wxTreeListColumnAlign GetAlignment() const;
|
|
wxString GetText() const;
|
|
int GetImage() const;
|
|
int GetSelectedImage() const;
|
|
size_t GetWidth() const;
|
|
|
|
void SetAlignment(wxTreeListColumnAlign alignment);
|
|
void SetText(const wxString& text);
|
|
void SetImage(int image);
|
|
void SetSelectedImage(int image);
|
|
void SetWidth(size_t with);
|
|
};
|
|
|
|
|
|
|
|
|
|
%{ // C++ version of Python aware control
|
|
class wxPyTreeListCtrl : public wxTreeListCtrl {
|
|
DECLARE_ABSTRACT_CLASS(wxPyTreeListCtrl);
|
|
public:
|
|
wxPyTreeListCtrl() : wxTreeListCtrl() {}
|
|
wxPyTreeListCtrl(wxWindow *parent, wxWindowID id,
|
|
const wxPoint& pos,
|
|
const wxSize& size,
|
|
long style,
|
|
const wxValidator &validator,
|
|
const wxString& name) :
|
|
wxTreeListCtrl(parent, id, pos, size, style, validator, name) {}
|
|
|
|
int OnCompareItems(const wxTreeItemId& item1,
|
|
const wxTreeItemId& item2) {
|
|
int rval = 0;
|
|
bool found;
|
|
wxPyBeginBlockThreads();
|
|
if ((found = wxPyCBH_findCallback(m_myInst, "OnCompareItems"))) {
|
|
PyObject *o1 = wxPyConstructObject((void*)&item1, wxT("wxTreeItemId"), 0);
|
|
PyObject *o2 = wxPyConstructObject((void*)&item2, wxT("wxTreeItemId"), 0);
|
|
rval = wxPyCBH_callCallback(m_myInst, Py_BuildValue("(OO)",o1,o2));
|
|
Py_DECREF(o1);
|
|
Py_DECREF(o2);
|
|
}
|
|
wxPyEndBlockThreads();
|
|
if (! found)
|
|
rval = wxTreeListCtrl::OnCompareItems(item1, item2);
|
|
return rval;
|
|
}
|
|
PYPRIVATE;
|
|
};
|
|
|
|
IMPLEMENT_ABSTRACT_CLASS(wxPyTreeListCtrl, wxTreeListCtrl)
|
|
|
|
%}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
%name(TreeListCtrl) class wxPyTreeListCtrl : public wxControl
|
|
{
|
|
public:
|
|
%addtofunc wxPyTreeListCtrl "self._setOORInfo(self);self._setCallbackInfo(self, TreeListCtrl)"
|
|
%addtofunc wxPyTreeListCtrl() ""
|
|
|
|
wxPyTreeListCtrl(wxWindow *parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_DEFAULT_STYLE,
|
|
const wxValidator &validator = wxDefaultValidator,
|
|
const wxString& name = wxPyTreeListCtrlNameStr );
|
|
%name(PreTreeListCtrl)wxPyTreeListCtrl();
|
|
|
|
bool Create(wxWindow *parent, wxWindowID id = -1,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_DEFAULT_STYLE,
|
|
const wxValidator &validator = wxDefaultValidator,
|
|
const wxString& name = wxPyTreeListCtrlNameStr );
|
|
|
|
void _setCallbackInfo(PyObject* self, PyObject* _class);
|
|
|
|
|
|
// get the total number of items in the control
|
|
size_t GetCount() const;
|
|
|
|
// indent is the number of pixels the children are indented relative to
|
|
// the parents position. SetIndent() also redraws the control
|
|
// immediately.
|
|
unsigned int GetIndent() const;
|
|
void SetIndent(unsigned int indent);
|
|
|
|
// spacing is the number of pixels between the start and the Text
|
|
unsigned int GetSpacing() const;
|
|
void SetSpacing(unsigned int spacing);
|
|
|
|
// line spacing is the space above and below the text on each line
|
|
unsigned int GetLineSpacing() const;
|
|
void SetLineSpacing(unsigned int spacing);
|
|
|
|
// image list: these functions allow to associate an image list with
|
|
// the control and retrieve it. Note that when assigned with
|
|
// SetImageList, the control does _not_ delete
|
|
// the associated image list when it's deleted in order to allow image
|
|
// lists to be shared between different controls. If you use
|
|
// AssignImageList, the control _does_ delete the image list.
|
|
//
|
|
// The normal image list is for the icons which correspond to the
|
|
// normal tree item state (whether it is selected or not).
|
|
// Additionally, the application might choose to show a state icon
|
|
// which corresponds to an app-defined item state (for example,
|
|
// checked/unchecked) which are taken from the state image list.
|
|
wxImageList *GetImageList() const;
|
|
wxImageList *GetStateImageList() const;
|
|
wxImageList *GetButtonsImageList() const;
|
|
|
|
void SetImageList(wxImageList *imageList);
|
|
void SetStateImageList(wxImageList *imageList);
|
|
void SetButtonsImageList(wxImageList *imageList);
|
|
|
|
%addtofunc AssignImageList "args[1].thisown = 0";
|
|
void AssignImageList(wxImageList *imageList);
|
|
|
|
%addtofunc AssignStateImageList "args[1].thisown = 0";
|
|
void AssignStateImageList(wxImageList *imageList);
|
|
|
|
%addtofunc AssignButtonsImageList "args[1].thisown = 0";
|
|
void AssignButtonsImageList(wxImageList *imageList);
|
|
|
|
|
|
|
|
// adds a column
|
|
void AddColumn(const wxString& text);
|
|
%name(AddColumnInfo) void AddColumn(const wxTreeListColumnInfo& col);
|
|
|
|
// inserts a column before the given one
|
|
void InsertColumn(size_t before, const wxString& text);
|
|
%name(InsertColumnInfo) void InsertColumn(size_t before, const wxTreeListColumnInfo& col);
|
|
|
|
// deletes the given column - does not delete the corresponding column
|
|
// of each item
|
|
void RemoveColumn(size_t column);
|
|
|
|
// returns the number of columns in the ctrl
|
|
size_t GetColumnCount() const;
|
|
|
|
void SetColumnWidth(size_t column, size_t width);
|
|
int GetColumnWidth(size_t column) const;
|
|
|
|
// tells which column is the "main" one, i.e. the "threaded" one
|
|
void SetMainColumn(size_t column);
|
|
size_t GetMainColumn() const;
|
|
|
|
void SetColumnText(size_t column, const wxString& text);
|
|
wxString GetColumnText(size_t column) const;
|
|
|
|
void SetColumn(size_t column, const wxTreeListColumnInfo& info);
|
|
wxTreeListColumnInfo& GetColumn(size_t column);
|
|
|
|
// other column-related methods
|
|
void SetColumnAlignment(size_t column, wxTreeListColumnAlign align);
|
|
wxTreeListColumnAlign GetColumnAlignment(size_t column) const;
|
|
|
|
void SetColumnImage(size_t column, int image);
|
|
int GetColumnImage(size_t column) const;
|
|
|
|
|
|
%extend {
|
|
// retrieves item's label of the given column (main column by default)
|
|
wxString GetItemText(const wxTreeItemId& item, int column = -1) {
|
|
if (column < 0) column = self->GetMainColumn();
|
|
return self->GetItemText(item, column);
|
|
}
|
|
|
|
// get one of the images associated with the item (normal by default)
|
|
int GetItemImage(const wxTreeItemId& item, int column = -1,
|
|
wxTreeItemIcon which = wxTreeItemIcon_Normal) {
|
|
if (column < 0) column = self->GetMainColumn();
|
|
return self->GetItemImage(item, column, which);
|
|
}
|
|
|
|
// set item's label (main column by default)
|
|
void SetItemText(const wxTreeItemId& item, const wxString& text, int column = -1) {
|
|
if (column < 0) column = self->GetMainColumn();
|
|
self->SetItemText(item, column, text);
|
|
}
|
|
|
|
// set one of the images associated with the item (normal by default)
|
|
// the which parameter is ignored for all columns but the main one
|
|
void SetItemImage(const wxTreeItemId& item, int image, int column = -1,
|
|
wxTreeItemIcon which = wxTreeItemIcon_Normal) {
|
|
if (column < 0) column = self->GetMainColumn();
|
|
self->SetItemImage(item, column, image, which);
|
|
}
|
|
|
|
|
|
// [Get|Set]ItemData substitutes. Automatically create wxPyTreeItemData
|
|
// if needed.
|
|
wxPyTreeItemData* GetItemData(const wxTreeItemId& item) {
|
|
wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
|
|
if (data == NULL) {
|
|
data = new wxPyTreeItemData();
|
|
data->SetId(item); // set the id
|
|
self->SetItemData(item, data);
|
|
}
|
|
return data;
|
|
}
|
|
|
|
void SetItemData(const wxTreeItemId& item, wxPyTreeItemData* data) {
|
|
data->SetId(item); // set the id
|
|
self->SetItemData(item, data);
|
|
}
|
|
|
|
// [Get|Set]ItemPyData are short-cuts. Also made somewhat crash-proof by
|
|
// automatically creating data classes.
|
|
PyObject* GetItemPyData(const wxTreeItemId& item) {
|
|
wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
|
|
if (data == NULL) {
|
|
data = new wxPyTreeItemData();
|
|
data->SetId(item); // set the id
|
|
self->SetItemData(item, data);
|
|
}
|
|
return data->GetData();
|
|
}
|
|
|
|
void SetItemPyData(const wxTreeItemId& item, PyObject* obj) {
|
|
wxPyTreeItemData* data = (wxPyTreeItemData*)self->GetItemData(item);
|
|
if (data == NULL) {
|
|
data = new wxPyTreeItemData(obj);
|
|
data->SetId(item); // set the id
|
|
self->SetItemData(item, data);
|
|
} else
|
|
data->SetData(obj);
|
|
}
|
|
}
|
|
|
|
|
|
// force appearance of [+] button near the item. This is useful to
|
|
// allow the user to expand the items which don't have any children now
|
|
// - but instead add them only when needed, thus minimizing memory
|
|
// usage and loading time.
|
|
void SetItemHasChildren(const wxTreeItemId& item, bool has = TRUE);
|
|
|
|
// the item will be shown in bold
|
|
void SetItemBold(const wxTreeItemId& item, bool bold = TRUE);
|
|
|
|
// set the item's text colour
|
|
void SetItemTextColour(const wxTreeItemId& item, const wxColour& col);
|
|
|
|
// set the item's background colour
|
|
void SetItemBackgroundColour(const wxTreeItemId& item,
|
|
const wxColour& col);
|
|
|
|
// set the item's font (should be of the same height for all items)
|
|
void SetItemFont(const wxTreeItemId& item, const wxFont& font);
|
|
|
|
|
|
bool GetItemBold(const wxTreeItemId& item) const;
|
|
wxColour GetItemTextColour(const wxTreeItemId& item) const;
|
|
wxColour GetItemBackgroundColour(const wxTreeItemId& item) const;
|
|
wxFont GetItemFont(const wxTreeItemId& item) const;
|
|
|
|
// is the item visible (it might be outside the view or not expanded)?
|
|
bool IsVisible(const wxTreeItemId& item) const;
|
|
|
|
// does the item has any children?
|
|
bool ItemHasChildren(const wxTreeItemId& item) const;
|
|
|
|
// is the item expanded (only makes sense if HasChildren())?
|
|
bool IsExpanded(const wxTreeItemId& item) const;
|
|
|
|
// is this item currently selected (the same as has focus)?
|
|
bool IsSelected(const wxTreeItemId& item) const;
|
|
|
|
// is item text in bold font?
|
|
bool IsBold(const wxTreeItemId& item) const;
|
|
|
|
// if 'recursively' is FALSE, only immediate children count, otherwise
|
|
// the returned number is the number of all items in this branch
|
|
size_t GetChildrenCount(const wxTreeItemId& item, bool recursively = TRUE);
|
|
|
|
|
|
// wxTreeItemId.IsOk() will return FALSE if there is no such item
|
|
|
|
// get the root tree item
|
|
wxTreeItemId GetRootItem() const;
|
|
|
|
// get the item currently selected (may return NULL if no selection)
|
|
wxTreeItemId GetSelection() const;
|
|
|
|
// get the items currently selected, return the number of such item
|
|
//size_t GetSelections(wxArrayTreeItemIds&) const;
|
|
%extend {
|
|
PyObject* GetSelections() {
|
|
wxPyBeginBlockThreads();
|
|
PyObject* rval = PyList_New(0);
|
|
wxArrayTreeItemIds array;
|
|
size_t num, x;
|
|
num = self->GetSelections(array);
|
|
for (x=0; x < num; x++) {
|
|
wxTreeItemId *tii = new wxTreeItemId(array.Item(x));
|
|
PyObject* item = wxPyConstructObject((void*)tii, wxT("wxTreeItemId"), TRUE);
|
|
PyList_Append(rval, item);
|
|
}
|
|
wxPyEndBlockThreads();
|
|
return rval;
|
|
}
|
|
}
|
|
|
|
|
|
// get the parent of this item (may return NULL if root)
|
|
%name(GetItemParent)wxTreeItemId GetParent(const wxTreeItemId& item) const;
|
|
|
|
// for this enumeration function you must pass in a "cookie" parameter
|
|
// which is opaque for the application but is necessary for the library
|
|
// to make these functions reentrant (i.e. allow more than one
|
|
// enumeration on one and the same object simultaneously). Of course,
|
|
// the "cookie" passed to GetFirstChild() and GetNextChild() should be
|
|
// the same!
|
|
|
|
|
|
%extend {
|
|
// Get the first child of this item. Returns a wxTreeItemId and an
|
|
// opaque "cookie" value that should be passed to GetNextChild in
|
|
// order to continue the search.
|
|
PyObject* GetFirstChild(const wxTreeItemId& item) {
|
|
long cookie = 0;
|
|
wxTreeItemId ritem = self->GetFirstChild(item, cookie);
|
|
wxPyBeginBlockThreads();
|
|
PyObject* tup = PyTuple_New(2);
|
|
PyTuple_SET_ITEM(tup, 0, wxPyConstructObject(&ritem, wxT("wxTreeItemId"), true));
|
|
PyTuple_SET_ITEM(tup, 1, PyInt_FromLong(cookie));
|
|
wxPyEndBlockThreads();
|
|
return tup;
|
|
}
|
|
|
|
|
|
// Get the next child of this item. The cookie parameter is the 2nd
|
|
// value returned from GetFirstChild or the previous GetNextChild.
|
|
// Returns a wxTreeItemId and an opaque "cookie" value that should be
|
|
// passed to GetNextChild in order to continue the search.
|
|
PyObject* GetNextChild(const wxTreeItemId& item, long cookie) {
|
|
wxTreeItemId ritem = self->GetNextChild(item, cookie);
|
|
wxPyBeginBlockThreads();
|
|
PyObject* tup = PyTuple_New(2);
|
|
PyTuple_SET_ITEM(tup, 0, wxPyConstructObject(&ritem, wxT("wxTreeItemId"), true));
|
|
PyTuple_SET_ITEM(tup, 1, PyInt_FromLong(cookie));
|
|
wxPyEndBlockThreads();
|
|
return tup;
|
|
}
|
|
}
|
|
|
|
// get the last child of this item - this method doesn't use cookies
|
|
wxTreeItemId GetLastChild(const wxTreeItemId& item) const;
|
|
|
|
// get the next sibling of this item
|
|
wxTreeItemId GetNextSibling(const wxTreeItemId& item) const;
|
|
|
|
// get the previous sibling
|
|
wxTreeItemId GetPrevSibling(const wxTreeItemId& item) const;
|
|
|
|
// get first visible item
|
|
wxTreeItemId GetFirstVisibleItem() const;
|
|
|
|
// get the next visible item: item must be visible itself!
|
|
// see IsVisible() and wxTreeCtrl::GetFirstVisibleItem()
|
|
wxTreeItemId GetNextVisible(const wxTreeItemId& item) const;
|
|
|
|
// get the previous visible item: item must be visible itself!
|
|
wxTreeItemId GetPrevVisible(const wxTreeItemId& item) const;
|
|
|
|
// Only for internal use right now, but should probably be public
|
|
wxTreeItemId GetNext(const wxTreeItemId& item) const;
|
|
|
|
|
|
// add the root node to the tree
|
|
wxTreeItemId AddRoot(const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxPyTreeItemData *data = NULL);
|
|
|
|
// insert a new item in as the first child of the parent
|
|
wxTreeItemId PrependItem(const wxTreeItemId& parent,
|
|
const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxPyTreeItemData *data = NULL);
|
|
|
|
// insert a new item after a given one
|
|
wxTreeItemId InsertItem(const wxTreeItemId& parent,
|
|
const wxTreeItemId& idPrevious,
|
|
const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxPyTreeItemData *data = NULL);
|
|
|
|
// insert a new item before the one with the given index
|
|
%name(InsertItemBefore)
|
|
wxTreeItemId InsertItem(const wxTreeItemId& parent,
|
|
size_t index,
|
|
const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxPyTreeItemData *data = NULL);
|
|
|
|
// insert a new item in as the last child of the parent
|
|
wxTreeItemId AppendItem(const wxTreeItemId& parent,
|
|
const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxPyTreeItemData *data = NULL);
|
|
|
|
// delete this item and associated data if any
|
|
void Delete(const wxTreeItemId& item);
|
|
|
|
// delete all children (but don't delete the item itself)
|
|
// NB: this won't send wxEVT_COMMAND_TREE_ITEM_DELETED events
|
|
void DeleteChildren(const wxTreeItemId& item);
|
|
|
|
// delete all items from the tree
|
|
// NB: this won't send wxEVT_COMMAND_TREE_ITEM_DELETED events
|
|
void DeleteAllItems();
|
|
|
|
// expand this item
|
|
void Expand(const wxTreeItemId& item);
|
|
|
|
// expand this item and all subitems recursively
|
|
void ExpandAll(const wxTreeItemId& item);
|
|
|
|
// collapse the item without removing its children
|
|
void Collapse(const wxTreeItemId& item);
|
|
|
|
// collapse the item and remove all children
|
|
void CollapseAndReset(const wxTreeItemId& item);
|
|
|
|
// toggles the current state
|
|
void Toggle(const wxTreeItemId& item);
|
|
|
|
// remove the selection from currently selected item (if any)
|
|
void Unselect();
|
|
void UnselectAll();
|
|
|
|
// select this item
|
|
void SelectItem(const wxTreeItemId& item, bool unselect_others=TRUE,
|
|
bool extended_select=FALSE);
|
|
|
|
// make sure this item is visible (expanding the parent item and/or
|
|
// scrolling to this item if necessary)
|
|
void EnsureVisible(const wxTreeItemId& item);
|
|
|
|
// scroll to this item (but don't expand its parent)
|
|
void ScrollTo(const wxTreeItemId& item);
|
|
|
|
// Returns wxTreeItemId, flags, and column
|
|
wxTreeItemId HitTest(const wxPoint& point, int& OUTPUT, int& OUTPUT);
|
|
|
|
%extend {
|
|
// get the bounding rectangle of the item (or of its label only)
|
|
PyObject* GetBoundingRect(const wxTreeItemId& item, bool textOnly = FALSE) {
|
|
wxRect rect;
|
|
if (self->GetBoundingRect(item, rect, textOnly)) {
|
|
wxPyBeginBlockThreads();
|
|
wxRect* r = new wxRect(rect);
|
|
PyObject* val = wxPyConstructObject((void*)r, wxT("wxRect"), 1);
|
|
wxPyEndBlockThreads();
|
|
return val;
|
|
}
|
|
else {
|
|
RETURN_NONE();
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
// Start editing the item label: this (temporarily) replaces the item
|
|
// with a one line edit control. The item will be selected if it hadn't
|
|
// been before.
|
|
void EditLabel( const wxTreeItemId& item );
|
|
void Edit( const wxTreeItemId& item );
|
|
|
|
// sort the children of this item using OnCompareItems
|
|
void SortChildren(const wxTreeItemId& item);
|
|
|
|
// get the selected item image
|
|
int GetItemSelectedImage(const wxTreeItemId& item) const;
|
|
|
|
// set the selected item image
|
|
void SetItemSelectedImage(const wxTreeItemId& item, int image);
|
|
|
|
|
|
wxWindow* GetHeaderWindow() const;
|
|
wxWindow* GetMainWindow() const;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
//----------------------------------------------------------------------
|
|
//----------------------------------------------------------------------
|
|
|
|
%init %{
|
|
|
|
wxPyPtrTypeMap_Add("wxTreeCompanionWindow", "wxPyTreeCompanionWindow");
|
|
wxPyPtrTypeMap_Add("wxTreeListCtrl", "wxPyTreeListCtrl");
|
|
%}
|
|
|
|
|
|
%pragma(python) include="_gizmoextras.py";
|
|
|
|
//----------------------------------------------------------------------
|
|
//----------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
|