]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: sashwin.h | |
3 | // Purpose: wxSashWindow implementation. A sash window has an optional | |
4 | // sash on each edge, allowing it to be dragged. An event | |
5 | // is generated when the sash is released. | |
6 | // Author: Julian Smart | |
7 | // Modified by: | |
8 | // Created: 01/02/97 | |
9 | // RCS-ID: $Id$ | |
10 | // Copyright: (c) Julian Smart | |
11 | // Licence: wxWindows license | |
12 | ///////////////////////////////////////////////////////////////////////////// | |
13 | ||
14 | #ifndef _WX_SASHWIN_H_G_ | |
15 | #define _WX_SASHWIN_H_G_ | |
16 | ||
17 | #ifdef __GNUG__ | |
18 | #pragma interface "sashwin.h" | |
19 | #endif | |
20 | ||
21 | #if wxUSE_SASH | |
22 | ||
23 | #include "wx/defs.h" | |
24 | #include "wx/window.h" | |
25 | #include "wx/string.h" | |
26 | ||
27 | #define wxSASH_DRAG_NONE 0 | |
28 | #define wxSASH_DRAG_DRAGGING 1 | |
29 | #define wxSASH_DRAG_LEFT_DOWN 2 | |
30 | ||
31 | enum wxSashEdgePosition { | |
32 | wxSASH_TOP = 0, | |
33 | wxSASH_RIGHT, | |
34 | wxSASH_BOTTOM, | |
35 | wxSASH_LEFT, | |
36 | wxSASH_NONE = 100 | |
37 | }; | |
38 | ||
39 | /* | |
40 | * wxSashEdge represents one of the four edges of a window. | |
41 | */ | |
42 | ||
43 | class WXDLLEXPORT wxSashEdge | |
44 | { | |
45 | public: | |
46 | wxSashEdge() { m_show = FALSE; m_border = FALSE; m_margin = 0; } | |
47 | ||
48 | bool m_show; // Is the sash showing? | |
49 | bool m_border; // Do we draw a border? | |
50 | int m_margin; // The margin size | |
51 | }; | |
52 | ||
53 | /* | |
54 | * wxSashWindow flags | |
55 | */ | |
56 | ||
57 | #define wxSW_NOBORDER 0x0000 | |
58 | //#define wxSW_3D 0x0010 | |
59 | #define wxSW_BORDER 0x0020 | |
60 | #define wxSW_3DSASH 0x0040 | |
61 | #define wxSW_3DBORDER 0x0080 | |
62 | #define wxSW_3D (wxSW_3DSASH | wxSW_3DBORDER) | |
63 | ||
64 | /* | |
65 | * wxSashWindow allows any of its edges to have a sash which can be dragged | |
66 | * to resize the window. The actual content window will be created as a child | |
67 | * of wxSashWindow. | |
68 | */ | |
69 | ||
70 | class WXDLLEXPORT wxSashWindow: public wxWindow | |
71 | { | |
72 | DECLARE_DYNAMIC_CLASS(wxSashWindow) | |
73 | ||
74 | public: | |
75 | ||
76 | //////////////////////////////////////////////////////////////////////////// | |
77 | // Public API | |
78 | ||
79 | // Default constructor | |
80 | wxSashWindow() | |
81 | { | |
82 | Init(); | |
83 | } | |
84 | ||
85 | // Normal constructor | |
86 | wxSashWindow(wxWindow *parent, wxWindowID id = -1, const wxPoint& pos = wxDefaultPosition, | |
87 | const wxSize& size = wxDefaultSize, long style = wxSW_3D|wxCLIP_CHILDREN, const wxString& name = "sashWindow") | |
88 | { | |
89 | Init(); | |
90 | Create(parent, id, pos, size, style, name); | |
91 | } | |
92 | ||
93 | ~wxSashWindow(); | |
94 | ||
95 | bool Create(wxWindow *parent, wxWindowID id = -1, const wxPoint& pos = wxDefaultPosition, | |
96 | const wxSize& size = wxDefaultSize, long style = wxSW_3D|wxCLIP_CHILDREN, const wxString& name = "sashWindow"); | |
97 | ||
98 | // Set whether there's a sash in this position | |
99 | void SetSashVisible(wxSashEdgePosition edge, bool sash); | |
100 | ||
101 | // Get whether there's a sash in this position | |
102 | inline bool GetSashVisible(wxSashEdgePosition edge) const { return m_sashes[edge].m_show; } | |
103 | ||
104 | // Set whether there's a border in this position | |
105 | inline void SetSashBorder(wxSashEdgePosition edge, bool border) { m_sashes[edge].m_border = border; } | |
106 | ||
107 | // Get whether there's a border in this position | |
108 | inline bool HasBorder(wxSashEdgePosition edge) const { return m_sashes[edge].m_border; } | |
109 | ||
110 | // Get border size | |
111 | inline int GetEdgeMargin(wxSashEdgePosition edge) const { return m_sashes[edge].m_margin; } | |
112 | ||
113 | // Sets the default sash border size | |
114 | inline void SetDefaultBorderSize(int width) { m_borderSize = width; } | |
115 | ||
116 | // Gets the default sash border size | |
117 | inline int GetDefaultBorderSize() const { return m_borderSize; } | |
118 | ||
119 | // Sets the addition border size between child and sash window | |
120 | inline void SetExtraBorderSize(int width) { m_extraBorderSize = width; } | |
121 | ||
122 | // Gets the addition border size between child and sash window | |
123 | inline int GetExtraBorderSize() const { return m_extraBorderSize; } | |
124 | ||
125 | virtual void SetMinimumSizeX(int min) { m_minimumPaneSizeX = min; } | |
126 | virtual void SetMinimumSizeY(int min) { m_minimumPaneSizeY = min; } | |
127 | virtual int GetMinimumSizeX() const { return m_minimumPaneSizeX; } | |
128 | virtual int GetMinimumSizeY() const { return m_minimumPaneSizeY; } | |
129 | ||
130 | virtual void SetMaximumSizeX(int max) { m_maximumPaneSizeX = max; } | |
131 | virtual void SetMaximumSizeY(int max) { m_maximumPaneSizeY = max; } | |
132 | virtual int GetMaximumSizeX() const { return m_maximumPaneSizeX; } | |
133 | virtual int GetMaximumSizeY() const { return m_maximumPaneSizeY; } | |
134 | ||
135 | //////////////////////////////////////////////////////////////////////////// | |
136 | // Implementation | |
137 | ||
138 | // Paints the border and sash | |
139 | void OnPaint(wxPaintEvent& event); | |
140 | ||
141 | // Handles mouse events | |
142 | void OnMouseEvent(wxMouseEvent& ev); | |
143 | ||
144 | // Adjusts the panes | |
145 | void OnSize(wxSizeEvent& event); | |
146 | ||
147 | // Draws borders | |
148 | void DrawBorders(wxDC& dc); | |
149 | ||
150 | // Draws the sashes | |
151 | void DrawSash(wxSashEdgePosition edge, wxDC& dc); | |
152 | ||
153 | // Draws the sashes | |
154 | void DrawSashes(wxDC& dc); | |
155 | ||
156 | // Draws the sash tracker (for whilst moving the sash) | |
157 | void DrawSashTracker(wxSashEdgePosition edge, int x, int y); | |
158 | ||
159 | // Tests for x, y over sash | |
160 | wxSashEdgePosition SashHitTest(int x, int y, int tolerance = 2); | |
161 | ||
162 | // Resizes subwindows | |
163 | void SizeWindows(); | |
164 | ||
165 | // Initialize colours | |
166 | void InitColours(); | |
167 | ||
168 | private: | |
169 | void Init(); | |
170 | ||
171 | wxSashEdge m_sashes[4]; | |
172 | int m_dragMode; | |
173 | wxSashEdgePosition m_draggingEdge; | |
174 | int m_oldX; | |
175 | int m_oldY; | |
176 | int m_borderSize; | |
177 | int m_extraBorderSize; | |
178 | int m_firstX; | |
179 | int m_firstY; | |
180 | int m_minimumPaneSizeX; | |
181 | int m_minimumPaneSizeY; | |
182 | int m_maximumPaneSizeX; | |
183 | int m_maximumPaneSizeY; | |
184 | wxCursor* m_sashCursorWE; | |
185 | wxCursor* m_sashCursorNS; | |
186 | wxColour m_lightShadowColour; | |
187 | wxColour m_mediumShadowColour; | |
188 | wxColour m_darkShadowColour; | |
189 | wxColour m_hilightColour; | |
190 | wxColour m_faceColour; | |
191 | bool m_mouseCaptured; | |
192 | ||
193 | DECLARE_EVENT_TABLE() | |
194 | }; | |
195 | ||
196 | #define wxEVT_SASH_DRAGGED (wxEVT_FIRST + 1200) | |
197 | ||
198 | enum wxSashDragStatus | |
199 | { | |
200 | wxSASH_STATUS_OK, | |
201 | wxSASH_STATUS_OUT_OF_RANGE | |
202 | }; | |
203 | ||
204 | class WXDLLEXPORT wxSashEvent: public wxCommandEvent | |
205 | { | |
206 | DECLARE_DYNAMIC_CLASS(wxSashEvent) | |
207 | ||
208 | public: | |
209 | inline wxSashEvent(int id = 0, wxSashEdgePosition edge = wxSASH_NONE) { | |
210 | m_eventType = (wxEventType) wxEVT_SASH_DRAGGED; m_id = id; m_edge = edge; } | |
211 | ||
212 | inline void SetEdge(wxSashEdgePosition edge) { m_edge = edge; } | |
213 | inline wxSashEdgePosition GetEdge() const { return m_edge; } | |
214 | ||
215 | //// The rectangle formed by the drag operation | |
216 | inline void SetDragRect(const wxRect& rect) { m_dragRect = rect; } | |
217 | inline wxRect GetDragRect() const { return m_dragRect; } | |
218 | ||
219 | //// Whether the drag caused the rectangle to be reversed (e.g. | |
220 | //// dragging the top below the bottom) | |
221 | inline void SetDragStatus(wxSashDragStatus status) { m_dragStatus = status; } | |
222 | inline wxSashDragStatus GetDragStatus() const { return m_dragStatus; } | |
223 | private: | |
224 | wxSashEdgePosition m_edge; | |
225 | wxRect m_dragRect; | |
226 | wxSashDragStatus m_dragStatus; | |
227 | }; | |
228 | ||
229 | typedef void (wxEvtHandler::*wxSashEventFunction)(wxSashEvent&); | |
230 | ||
231 | #define EVT_SASH_DRAGGED(id, fn) { wxEVT_SASH_DRAGGED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxSashEventFunction) & fn, NULL }, | |
232 | #define EVT_SASH_DRAGGED_RANGE(id1, id2, fn) { wxEVT_SASH_DRAGGED, id1, id2, (wxObjectEventFunction) (wxEventFunction) (wxSashEventFunction) & fn, NULL }, | |
233 | ||
234 | #endif // wxUSE_SASH | |
235 | ||
236 | #endif | |
237 | // _WX_SASHWIN_H_G_ |