1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Classes to achieve a remotely-scrolled tree in a splitter
4 // window that can be scrolled by a scrolled window higher in the
6 // Author: Julian Smart
10 // Copyright: (c) Julian Smart
11 // Licence: wxWindows licence
12 /////////////////////////////////////////////////////////////////////////////
14 #ifndef _WX_SPLITTREE_H_
15 #define _WX_SPLITTREE_H_
17 #if defined(__GNUG__) && !defined(__APPLE__)
18 #pragma interface "splittree.h"
21 // Set this to 1 to use generic tree control (doesn't yet work properly)
22 #define USE_GENERIC_TREECTRL 0
25 #include "wx/treectrl.h"
26 #include "wx/splitter.h"
27 #include "wx/scrolwin.h"
29 #if USE_GENERIC_TREECTRL
30 #include "wx/generic/treectlg.h"
32 #define wxTreeCtrl wxGenericTreeCtrl
33 #define sm_classwxTreeCtrl sm_classwxGenericTreeCtrl
37 class wxRemotelyScrolledTreeCtrl
;
38 class wxThinSplitterWindow
;
39 class wxSplitterScrolledWindow
;
42 * wxRemotelyScrolledTreeCtrl
44 * This tree control disables its vertical scrollbar and catches scroll
45 * events passed by a scrolled window higher in the hierarchy.
46 * It also updates the scrolled window vertical scrollbar as appropriate.
49 class wxRemotelyScrolledTreeCtrl
: public wxTreeCtrl
51 DECLARE_CLASS(wxRemotelyScrolledTreeCtrl
)
53 wxRemotelyScrolledTreeCtrl(wxWindow
* parent
, wxWindowID id
, const wxPoint
& pt
= wxDefaultPosition
,
54 const wxSize
& sz
= wxDefaultSize
, long style
= wxTR_HAS_BUTTONS
);
55 ~wxRemotelyScrolledTreeCtrl();
58 void OnSize(wxSizeEvent
& event
);
59 void OnExpand(wxTreeEvent
& event
);
60 void OnScroll(wxScrollWinEvent
& event
);
63 // Override this in case we're using the generic tree control.
64 // Calls to this should disable the vertical scrollbar.
66 // Number of pixels per user unit (0 or -1 for no scrollbar)
67 // Length of virtual canvas in user units
68 // Length of page in user units
69 virtual void SetScrollbars(int pixelsPerUnitX
, int pixelsPerUnitY
,
70 int noUnitsX
, int noUnitsY
,
71 int xPos
= 0, int yPos
= 0,
72 bool noRefresh
= FALSE
);
74 // In case we're using the generic tree control.
76 virtual void GetViewStart(int *x
, int *y
) const;
78 // In case we're using the generic tree control.
79 virtual void PrepareDC(wxDC
& dc
);
81 // In case we're using the generic tree control.
82 virtual int GetScrollPos(int orient
) const;
85 void HideVScrollbar();
87 // Calculate the tree overall size so we can set the scrollbar
89 void CalcTreeSize(wxRect
& rect
);
90 void CalcTreeSize(const wxTreeItemId
& id
, wxRect
& rect
);
92 // Adjust the containing wxScrolledWindow's scrollbars appropriately
93 void AdjustRemoteScrollbars();
95 // Find the scrolled window that contains this control
96 wxScrolledWindow
* GetScrolledWindow() const;
98 // Scroll to the given line (in scroll units where each unit is
99 // the height of an item)
100 void ScrollToLine(int posHoriz
, int posVert
);
104 // The companion window is one which will get notified when certain
105 // events happen such as node expansion
106 void SetCompanionWindow(wxWindow
* companion
) { m_companionWindow
= companion
; }
107 wxWindow
* GetCompanionWindow() const { return m_companionWindow
; }
110 DECLARE_EVENT_TABLE()
112 wxWindow
* m_companionWindow
;
116 * wxTreeCompanionWindow
118 * A window displaying values associated with tree control items.
121 class wxTreeCompanionWindow
: public wxWindow
124 DECLARE_CLASS(wxTreeCompanionWindow
)
126 wxTreeCompanionWindow(wxWindow
* parent
, wxWindowID id
= -1,
127 const wxPoint
& pos
= wxDefaultPosition
,
128 const wxSize
& sz
= wxDefaultSize
,
132 virtual void DrawItem(wxDC
& dc
, wxTreeItemId id
, const wxRect
& rect
);
135 void OnPaint(wxPaintEvent
& event
);
136 void OnScroll(wxScrollWinEvent
& event
);
137 void OnExpand(wxTreeEvent
& event
);
142 wxRemotelyScrolledTreeCtrl
* GetTreeCtrl() const { return m_treeCtrl
; };
143 void SetTreeCtrl(wxRemotelyScrolledTreeCtrl
* treeCtrl
) { m_treeCtrl
= treeCtrl
; }
147 wxRemotelyScrolledTreeCtrl
* m_treeCtrl
;
149 DECLARE_EVENT_TABLE()
154 * wxThinSplitterWindow
156 * Implements a splitter with a less obvious sash
157 * than the usual one.
160 class wxThinSplitterWindow
: public wxSplitterWindow
163 DECLARE_DYNAMIC_CLASS(wxThinSplitterWindow
)
165 wxThinSplitterWindow(wxWindow
* parent
, wxWindowID id
= -1,
166 const wxPoint
& pos
= wxDefaultPosition
,
167 const wxSize
& sz
= wxDefaultSize
,
168 long style
= wxSP_3D
| wxCLIP_CHILDREN
);
169 ~wxThinSplitterWindow();
174 // Tests for x, y over sash. Overriding this allows us to increase
176 bool SashHitTest(int x
, int y
, int tolerance
= 2);
177 void DrawSash(wxDC
& dc
);
181 void OnSize(wxSizeEvent
& event
);
189 DECLARE_EVENT_TABLE()
193 * wxSplitterScrolledWindow
195 * This scrolled window is aware of the fact that one of its
196 * children is a splitter window. It passes on its scroll events
197 * (after some processing) to both splitter children for them
198 * scroll appropriately.
201 class wxSplitterScrolledWindow
: public wxScrolledWindow
204 DECLARE_DYNAMIC_CLASS(wxSplitterScrolledWindow
)
206 wxSplitterScrolledWindow(wxWindow
* parent
, wxWindowID id
= -1,
207 const wxPoint
& pos
= wxDefaultPosition
,
208 const wxSize
& sz
= wxDefaultSize
,
215 void OnScroll(wxScrollWinEvent
& event
);
216 void OnSize(wxSizeEvent
& event
);
224 DECLARE_EVENT_TABLE()