]> git.saurik.com Git - wxWidgets.git/blob - src/generic/splitter.cpp
Some doc tweaks
[wxWidgets.git] / src / generic / splitter.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: splitter.cpp
3 // Purpose: wxSplitterWindow implementation
4 // Author: Julian Smart
5 // Modified by:
6 // Created: 01/02/97
7 // RCS-ID: $Id$
8 // Copyright: (c) Julian Smart and Markus Holzem
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifdef __GNUG__
13 #pragma implementation "splitter.h"
14 #endif
15
16 // For compilers that support precompilation, includes "wx.h".
17 #include "wx/wxprec.h"
18
19 #ifdef __BORLANDC__
20 #pragma hdrstop
21 #endif
22
23 #ifndef WX_PRECOMP
24 #include "wx/window.h"
25 #include "wx/dialog.h"
26 #include "wx/frame.h"
27 #endif
28
29 #include <stdlib.h>
30
31 #include "wx/string.h"
32 #include "wx/splitter.h"
33 #include "wx/dcscreen.h"
34 #include "wx/settings.h"
35 #include "wx/log.h"
36 #include "wx/utils.h"
37
38 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED)
39 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING)
40 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPLITTER_DOUBLECLICKED)
41 DEFINE_EVENT_TYPE(wxEVT_COMMAND_SPLITTER_UNSPLIT)
42
43 IMPLEMENT_DYNAMIC_CLASS(wxSplitterWindow, wxWindow)
44 IMPLEMENT_DYNAMIC_CLASS(wxSplitterEvent, wxCommandEvent)
45
46 BEGIN_EVENT_TABLE(wxSplitterWindow, wxWindow)
47 EVT_PAINT(wxSplitterWindow::OnPaint)
48 EVT_SIZE(wxSplitterWindow::OnSize)
49 EVT_IDLE(wxSplitterWindow::OnIdle)
50 EVT_MOUSE_EVENTS(wxSplitterWindow::OnMouseEvent)
51
52 EVT_SET_CURSOR(wxSplitterWindow::OnSetCursor)
53
54 EVT_SPLITTER_SASH_POS_CHANGED(-1, wxSplitterWindow::OnSashPosChanged)
55 // NB: we borrow OnSashPosChanged for purposes of
56 // EVT_SPLITTER_SASH_POS_CHANGING since default implementation is identical
57 EVT_SPLITTER_SASH_POS_CHANGING(-1, wxSplitterWindow::OnSashPosChanged)
58 EVT_SPLITTER_DCLICK(-1, wxSplitterWindow::OnDoubleClick)
59 EVT_SPLITTER_UNSPLIT(-1, wxSplitterWindow::OnUnsplitEvent)
60
61 WX_EVENT_TABLE_CONTROL_CONTAINER(wxSplitterWindow)
62 END_EVENT_TABLE()
63
64 WX_DELEGATE_TO_CONTROL_CONTAINER(wxSplitterWindow);
65
66 bool wxSplitterWindow::Create(wxWindow *parent, wxWindowID id,
67 const wxPoint& pos,
68 const wxSize& size,
69 long style,
70 const wxString& name)
71 {
72 // allow TABbing from one window to the other
73 style |= wxTAB_TRAVERSAL;
74
75 if (!wxWindow::Create(parent, id, pos, size, style, name))
76 return FALSE;
77
78 m_permitUnsplitAlways = (style & wxSP_PERMIT_UNSPLIT) != 0;
79
80 if ( style & wxSP_3DSASH )
81 m_sashSize = 7;
82 else
83 m_sashSize = 3;
84
85 if ( style & wxSP_3DBORDER )
86 m_borderSize = 2;
87 else if ( style & wxSP_BORDER )
88 m_borderSize = 1;
89 else
90 m_borderSize = 0;
91
92 #ifdef __WXMAC__
93 int major,minor;
94 wxGetOsVersion( &major, &minor );
95 if (major >= 10)
96 m_windowStyle |= wxSP_SASH_AQUA;
97 #endif
98
99 return TRUE;
100 }
101
102 void wxSplitterWindow::Init()
103 {
104 m_container.SetContainerWindow(this);
105
106 m_splitMode = wxSPLIT_VERTICAL;
107 m_permitUnsplitAlways = TRUE;
108 m_windowOne = (wxWindow *) NULL;
109 m_windowTwo = (wxWindow *) NULL;
110 m_dragMode = wxSPLIT_DRAG_NONE;
111 m_oldX = 0;
112 m_oldY = 0;
113 m_firstX = 0;
114 m_firstY = 0;
115 m_sashSize = 7;
116 m_borderSize = 2;
117 m_sashPosition = 0;
118 m_minimumPaneSize = 0;
119 m_sashCursorWE = new wxCursor(wxCURSOR_SIZEWE);
120 m_sashCursorNS = new wxCursor(wxCURSOR_SIZENS);
121 m_sashTrackerPen = new wxPen(*wxBLACK, 2, wxSOLID);
122 m_lightShadowPen = (wxPen *) NULL;
123 m_mediumShadowPen = (wxPen *) NULL;
124 m_darkShadowPen = (wxPen *) NULL;
125 m_faceBrush = (wxBrush *) NULL;
126 m_facePen = (wxPen *) NULL;
127 m_hilightPen = (wxPen *) NULL;
128
129 m_borderSize = 0;
130 m_sashSize = 3;
131
132 InitColours();
133
134 m_needUpdating = FALSE;
135 }
136
137 wxSplitterWindow::~wxSplitterWindow()
138 {
139 delete m_sashCursorWE;
140 delete m_sashCursorNS;
141 delete m_sashTrackerPen;
142 delete m_lightShadowPen;
143 delete m_darkShadowPen;
144 delete m_mediumShadowPen;
145 delete m_hilightPen;
146 delete m_facePen;
147 delete m_faceBrush;
148 }
149
150 void wxSplitterWindow::OnPaint(wxPaintEvent& WXUNUSED(event))
151 {
152 wxPaintDC dc(this);
153
154 if ( m_borderSize > 0 )
155 DrawBorders(dc);
156 DrawSash(dc);
157 }
158
159 void wxSplitterWindow::OnIdle(wxIdleEvent& event)
160 {
161 if (m_needUpdating)
162 SizeWindows();
163
164 event.Skip();
165 }
166
167 void wxSplitterWindow::OnMouseEvent(wxMouseEvent& event)
168 {
169 wxCoord x = (wxCoord)event.GetX(),
170 y = (wxCoord)event.GetY();
171
172 // reset the cursor
173 #ifdef __WXMOTIF__
174 SetCursor(* wxSTANDARD_CURSOR);
175 #endif
176 #ifdef __WXMSW__
177 SetCursor(wxCursor());
178 #endif
179
180 if (GetWindowStyle() & wxSP_NOSASH)
181 return;
182
183 if (event.LeftDown())
184 {
185 if ( SashHitTest(x, y) )
186 {
187 CaptureMouse();
188
189 m_dragMode = wxSPLIT_DRAG_DRAGGING;
190
191 if ((GetWindowStyleFlag() & wxSP_LIVE_UPDATE) == 0)
192 {
193 DrawSashTracker(x, y);
194 }
195
196 m_oldX = x;
197 m_oldY = y;
198
199 if ( m_splitMode == wxSPLIT_VERTICAL )
200 {
201 SetCursor(*m_sashCursorWE);
202 }
203 else
204 {
205 SetCursor(*m_sashCursorNS);
206 }
207 return;
208 }
209 }
210 else if (event.LeftUp() && m_dragMode == wxSPLIT_DRAG_DRAGGING)
211 {
212 // We can stop dragging now and see what we've got.
213 m_dragMode = wxSPLIT_DRAG_NONE;
214 ReleaseMouse();
215
216 // Erase old tracker
217 if ((GetWindowStyleFlag() & wxSP_LIVE_UPDATE) == 0)
218 {
219 DrawSashTracker(m_oldX, m_oldY);
220 }
221
222 // Obtain window size. We are only interested in the dimension the sash
223 // splits up
224 int w, h;
225 GetClientSize(&w, &h);
226 int window_size = (m_splitMode == wxSPLIT_VERTICAL ? w : h );
227 int new_sash_position =
228 (int) ( m_splitMode == wxSPLIT_VERTICAL ? x : y );
229
230 wxSplitterEvent eventSplitter(wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGED,
231 this);
232 eventSplitter.m_data.pos = new_sash_position;
233 if ( GetEventHandler()->ProcessEvent(eventSplitter) )
234 {
235 new_sash_position = eventSplitter.GetSashPosition();
236 if ( new_sash_position == -1 )
237 {
238 // change not allowed
239 return;
240 }
241 }
242
243 if ( m_permitUnsplitAlways || m_minimumPaneSize == 0 )
244 {
245 // Deal with possible unsplit scenarios
246 if ( new_sash_position == 0 )
247 {
248 // We remove the first window from the view
249 wxWindow *removedWindow = m_windowOne;
250 m_windowOne = m_windowTwo;
251 m_windowTwo = (wxWindow *) NULL;
252 SendUnsplitEvent(removedWindow);
253 m_sashPosition = 0;
254 }
255 else if ( new_sash_position == window_size )
256 {
257 // We remove the second window from the view
258 wxWindow *removedWindow = m_windowTwo;
259 m_windowTwo = (wxWindow *) NULL;
260 SendUnsplitEvent(removedWindow);
261 m_sashPosition = 0;
262 }
263 else
264 {
265 m_sashPosition = new_sash_position;
266 }
267 }
268 else
269 {
270 m_sashPosition = new_sash_position;
271 }
272
273 SizeWindows();
274 } // left up && dragging
275 else if (event.Moving() && !event.Dragging())
276 {
277 // Just change the cursor if required
278 if ( SashHitTest(x, y) )
279 {
280 if ( m_splitMode == wxSPLIT_VERTICAL )
281 {
282 SetCursor(*m_sashCursorWE);
283 }
284 else
285 {
286 SetCursor(*m_sashCursorNS);
287 }
288 }
289 #if defined(__WXGTK__) || defined(__WXMSW__)
290 else
291 {
292 // We must set the normal cursor in MSW, because
293 // if the child window doesn't have a cursor, the
294 // parent's (splitter window) will be used, and this
295 // must be the standard cursor.
296
297 // where else do we unset the cursor?
298 SetCursor(* wxSTANDARD_CURSOR);
299 }
300 #endif // __WXGTK__
301 }
302 else if (event.Dragging() && (m_dragMode == wxSPLIT_DRAG_DRAGGING))
303 {
304 #ifdef __WXMSW__
305 // Otherwise, the cursor sometimes reverts to the normal cursor
306 // during dragging.
307 if ( m_splitMode == wxSPLIT_VERTICAL )
308 {
309 SetCursor(*m_sashCursorWE);
310 }
311 else
312 {
313 SetCursor(*m_sashCursorNS);
314 }
315 #endif
316
317 // Obtain window size. We are only interested in the dimension the sash
318 // splits up
319 int new_sash_position =
320 (int) ( m_splitMode == wxSPLIT_VERTICAL ? x : y );
321
322 wxSplitterEvent eventSplitter(wxEVT_COMMAND_SPLITTER_SASH_POS_CHANGING,
323 this);
324 eventSplitter.m_data.pos = new_sash_position;
325 if ( GetEventHandler()->ProcessEvent(eventSplitter) )
326 {
327 new_sash_position = eventSplitter.GetSashPosition();
328 if ( new_sash_position == -1 )
329 {
330 // change not allowed
331 return;
332 }
333 }
334
335 if (new_sash_position == m_sashPosition)
336 return;
337
338 // Erase old tracker
339 if ((GetWindowStyleFlag() & wxSP_LIVE_UPDATE) == 0)
340 {
341 DrawSashTracker(m_oldX, m_oldY);
342 }
343
344 if (m_splitMode == wxSPLIT_VERTICAL)
345 x = new_sash_position;
346 else
347 y = new_sash_position;
348
349 // Remember old positions
350 m_oldX = x;
351 m_oldY = y;
352
353 #ifdef __WXMSW__
354 // As we captured the mouse, we may get the mouse events from outside
355 // our window - for example, negative values in x, y. This has a weird
356 // consequence under MSW where we use unsigned values sometimes and
357 // signed ones other times: the coordinates turn as big positive
358 // numbers and so the sash is drawn on the *right* side of the window
359 // instead of the left (or bottom instead of top). Correct this.
360 if ( (short)m_oldX < 0 )
361 m_oldX = 0;
362 if ( (short)m_oldY < 0 )
363 m_oldY = 0;
364 #endif // __WXMSW__
365
366 // Draw new one
367 if ((GetWindowStyleFlag() & wxSP_LIVE_UPDATE) == 0)
368 {
369 DrawSashTracker(m_oldX, m_oldY);
370 }
371 else
372 {
373 m_sashPosition = new_sash_position;
374 m_needUpdating = TRUE;
375 }
376 }
377 else if ( event.LeftDClick() )
378 {
379 wxSplitterEvent eventSplitter(wxEVT_COMMAND_SPLITTER_DOUBLECLICKED,
380 this);
381 eventSplitter.m_data.pt.x = x;
382 eventSplitter.m_data.pt.y = y;
383
384 (void)GetEventHandler()->ProcessEvent(eventSplitter);
385 }
386 }
387
388 void wxSplitterWindow::OnSize(wxSizeEvent& event)
389 {
390 // only process this message if we're not iconized - otherwise iconizing
391 // and restoring a window containing the splitter has a funny side effect
392 // of changing the splitter position!
393 wxWindow *parent = GetParent();
394 while ( parent && !parent->IsTopLevel() )
395 {
396 parent = parent->GetParent();
397 }
398
399 bool iconized = FALSE;
400 wxFrame *frame = wxDynamicCast(parent, wxFrame);
401 if ( frame )
402 iconized = frame->IsIconized();
403 else
404 {
405 wxDialog *dialog = wxDynamicCast(parent, wxDialog);
406 if ( dialog )
407 iconized = dialog->IsIconized();
408 else
409 wxFAIL_MSG(wxT("should have a top level frame or dialog parent!"));
410 }
411
412 if ( iconized )
413 {
414 event.Skip();
415 }
416 else
417 {
418 int cw, ch;
419 GetClientSize( &cw, &ch );
420 if ( m_windowTwo )
421 {
422 if ( m_splitMode == wxSPLIT_VERTICAL )
423 {
424 if ( m_sashPosition >= (cw - 5) )
425 m_sashPosition = wxMax(10, cw - 40);
426 }
427 if ( m_splitMode == wxSPLIT_HORIZONTAL )
428 {
429 if ( m_sashPosition >= (ch - 5) )
430 m_sashPosition = wxMax(10, ch - 40);
431 }
432 }
433
434 SizeWindows();
435 }
436 }
437
438 bool wxSplitterWindow::SashHitTest(int x, int y, int tolerance)
439 {
440 if ( m_windowTwo == NULL || m_sashPosition == 0)
441 return FALSE; // No sash
442
443 if ( m_splitMode == wxSPLIT_VERTICAL )
444 {
445 if ( (x >= m_sashPosition - tolerance) && (x <= m_sashPosition + m_sashSize + tolerance) )
446 return TRUE;
447 else
448 return FALSE;
449 }
450 else
451 {
452 if ( (y >= (m_sashPosition- tolerance)) && (y <= (m_sashPosition + m_sashSize + tolerance)) )
453 return TRUE;
454 else
455 return FALSE;
456 }
457 }
458
459 // Draw 3D effect borders
460 void wxSplitterWindow::DrawBorders(wxDC& dc)
461 {
462 int w, h;
463 GetClientSize(&w, &h);
464
465 if ( GetWindowStyleFlag() & wxSP_3DBORDER )
466 {
467
468 dc.SetPen(*m_facePen);
469 dc.SetBrush(*m_faceBrush);
470 dc.DrawRectangle(1, 1 , w-1, m_borderSize-2 ); //high
471 dc.DrawRectangle(1, m_borderSize-2 , m_borderSize-2, h-1 ); // left
472 dc.DrawRectangle(w-m_borderSize+2, m_borderSize-2 , w-1, h-1 ); // right
473 dc.DrawRectangle(m_borderSize-2, h-m_borderSize+2 , w-m_borderSize+2, h-1 ); //bottom
474
475 dc.SetPen(*m_mediumShadowPen);
476 dc.DrawLine(m_borderSize-2, m_borderSize-2, w-m_borderSize+1, m_borderSize-2);
477 dc.DrawLine(m_borderSize-2, m_borderSize-2, m_borderSize-2, h-m_borderSize+1);
478
479 dc.SetPen(*m_darkShadowPen);
480 dc.DrawLine(m_borderSize-1, m_borderSize-1, w-m_borderSize, m_borderSize-1);
481 dc.DrawLine(m_borderSize-1, m_borderSize-1, m_borderSize-1, h-m_borderSize);
482
483 dc.SetPen(*m_hilightPen);
484 dc.DrawLine(m_borderSize - 2, h-m_borderSize+1, w-m_borderSize+1, h-m_borderSize+1);
485 dc.DrawLine(w-m_borderSize+1, m_borderSize - 2, w-m_borderSize+1, h-m_borderSize+2); // Surely the maximum y pos. should be h - 1.
486 /// Anyway, h is required for MSW.
487
488 dc.SetPen(*m_lightShadowPen);
489 dc.DrawLine(w-m_borderSize, m_borderSize-1, w-m_borderSize, h-m_borderSize); // Right hand side
490 dc.DrawLine(m_borderSize-1, h-m_borderSize, w-m_borderSize+1, h-m_borderSize); // Bottom
491 }
492 else if ( GetWindowStyleFlag() & wxSP_BORDER )
493 {
494 dc.SetBrush(*wxTRANSPARENT_BRUSH);
495 dc.SetPen(*wxBLACK_PEN);
496 dc.DrawRectangle(0, 0, w-1, h-1);
497 }
498
499 dc.SetPen(wxNullPen);
500 dc.SetBrush(wxNullBrush);
501 }
502
503 // Draw the sash
504 void wxSplitterWindow::DrawSash(wxDC& dc)
505 {
506 if ( m_sashPosition == 0 || !m_windowTwo)
507 return;
508 if (GetWindowStyle() & wxSP_NOSASH)
509 return;
510
511 int w, h;
512 GetClientSize(&w, &h);
513
514 if ( GetWindowStyleFlag() & wxSP_3DSASH )
515 {
516 if ( m_splitMode == wxSPLIT_VERTICAL )
517 {
518 dc.SetPen(*m_facePen);
519
520 if (HasFlag( wxSP_SASH_AQUA ))
521 dc.SetBrush(*wxWHITE_BRUSH);
522 else
523 dc.SetBrush(*m_faceBrush);
524 dc.DrawRectangle(m_sashPosition + 2, 0 , m_sashSize - 4, h );
525
526 dc.SetBrush(*wxTRANSPARENT_BRUSH);
527
528 dc.SetPen(*m_lightShadowPen);
529 int xShadow = m_borderSize ? m_borderSize - 1 : 0 ;
530 dc.DrawLine(m_sashPosition, xShadow , m_sashPosition, h-m_borderSize);
531
532 dc.SetPen(*m_hilightPen);
533 dc.DrawLine(m_sashPosition+1, m_borderSize - 2, m_sashPosition+1, h - m_borderSize+2);
534
535 if (!HasFlag( wxSP_SASH_AQUA ))
536 dc.SetPen(*m_mediumShadowPen);
537
538 int yMedium = m_borderSize ? h-m_borderSize+1 : h ;
539 dc.DrawLine(m_sashPosition+m_sashSize-2, xShadow, m_sashPosition+m_sashSize-2, yMedium);
540
541 if (HasFlag( wxSP_SASH_AQUA ))
542 dc.SetPen(*m_lightShadowPen);
543 else
544 dc.SetPen(*m_darkShadowPen);
545 dc.DrawLine(m_sashPosition+m_sashSize-1, m_borderSize, m_sashPosition+m_sashSize-1, h-m_borderSize );
546
547 // Draw the top and bottom edges of the sash, if requested
548 if (GetWindowStyle() & wxSP_FULLSASH)
549 {
550 // Top
551 dc.SetPen(*m_hilightPen);
552 dc.DrawLine(m_sashPosition+1, m_borderSize, m_sashPosition+m_sashSize-1, m_borderSize);
553
554 // Bottom
555 dc.SetPen(*m_darkShadowPen);
556 dc.DrawLine(m_sashPosition+1, h-m_borderSize-1, m_sashPosition+m_sashSize-1, h-m_borderSize-1);
557 }
558 }
559 else
560 {
561 dc.SetPen(*m_facePen);
562 if (HasFlag( wxSP_SASH_AQUA ))
563 dc.SetBrush(*wxWHITE_BRUSH);
564 else
565 dc.SetBrush(*m_faceBrush);
566 dc.DrawRectangle( m_borderSize-2, m_sashPosition + 2, w-m_borderSize+2, m_sashSize - 4);
567
568 dc.SetBrush(*wxTRANSPARENT_BRUSH);
569
570 dc.SetPen(*m_lightShadowPen);
571 dc.DrawLine(m_borderSize-1, m_sashPosition, w-m_borderSize, m_sashPosition);
572
573 dc.SetPen(*m_hilightPen);
574 dc.DrawLine(m_borderSize-2, m_sashPosition+1, w-m_borderSize+1, m_sashPosition+1);
575
576 if (!HasFlag( wxSP_SASH_AQUA ))
577 dc.SetPen(*m_mediumShadowPen);
578 dc.DrawLine(m_borderSize-1, m_sashPosition+m_sashSize-2, w-m_borderSize+1, m_sashPosition+m_sashSize-2);
579
580 if (HasFlag( wxSP_SASH_AQUA ))
581 dc.SetPen(*m_lightShadowPen);
582 else
583 dc.SetPen(*m_darkShadowPen);
584 dc.DrawLine(m_borderSize, m_sashPosition+m_sashSize-1, w-m_borderSize, m_sashPosition+m_sashSize-1);
585
586 // Draw the left and right edges of the sash, if requested
587 if (GetWindowStyle() & wxSP_FULLSASH)
588 {
589 // Left
590 dc.SetPen(*m_hilightPen);
591 dc.DrawLine(m_borderSize, m_sashPosition, m_borderSize, m_sashPosition+m_sashSize);
592
593 // Right
594 dc.SetPen(*m_darkShadowPen);
595 dc.DrawLine(w-m_borderSize-1, m_sashPosition+1, w-m_borderSize-1, m_sashPosition+m_sashSize-1);
596 }
597 }
598 }
599 else
600 {
601 if ( m_splitMode == wxSPLIT_VERTICAL )
602 {
603 dc.SetPen(*wxBLACK_PEN);
604 dc.SetBrush(*wxBLACK_BRUSH);
605 int h1 = h-1;
606 int y1 = 0;
607 if ( (GetWindowStyleFlag() & wxSP_BORDER) != wxSP_BORDER && (GetWindowStyleFlag() & wxSP_3DBORDER) != wxSP_3DBORDER )
608 h1 += 1; // Not sure why this is necessary...
609 if ( (GetWindowStyleFlag() & wxSP_3DBORDER) == wxSP_3DBORDER)
610 {
611 y1 = 2; h1 -= 3;
612 }
613 dc.DrawRectangle(m_sashPosition, y1, m_sashSize, h1);
614 }
615 else
616 {
617 dc.SetPen(*wxBLACK_PEN);
618 dc.SetBrush(*wxBLACK_BRUSH);
619 int w1 = w-1;
620 int x1 = 0;
621 if ( (GetWindowStyleFlag() & wxSP_BORDER) != wxSP_BORDER && (GetWindowStyleFlag() & wxSP_3DBORDER) != wxSP_3DBORDER )
622 w1 ++;
623 if ( (GetWindowStyleFlag() & wxSP_3DBORDER) == wxSP_3DBORDER)
624 {
625 x1 = 2; w1 -= 3;
626 }
627 dc.DrawRectangle(x1, m_sashPosition, w1, m_sashSize);
628 }
629
630 }
631
632 dc.SetPen(wxNullPen);
633 dc.SetBrush(wxNullBrush);
634 }
635
636 // Draw the sash tracker (for whilst moving the sash)
637 void wxSplitterWindow::DrawSashTracker(int x, int y)
638 {
639 int w, h;
640 GetClientSize(&w, &h);
641
642 wxScreenDC screenDC;
643 int x1, y1;
644 int x2, y2;
645
646 if ( m_splitMode == wxSPLIT_VERTICAL )
647 {
648 x1 = x; y1 = 2;
649 x2 = x; y2 = h-2;
650
651 if ( x1 > w )
652 {
653 x1 = w; x2 = w;
654 }
655 else if ( x1 < 0 )
656 {
657 x1 = 0; x2 = 0;
658 }
659 }
660 else
661 {
662 x1 = 2; y1 = y;
663 x2 = w-2; y2 = y;
664
665 if ( y1 > h )
666 {
667 y1 = h;
668 y2 = h;
669 }
670 else if ( y1 < 0 )
671 {
672 y1 = 0;
673 y2 = 0;
674 }
675 }
676
677 ClientToScreen(&x1, &y1);
678 ClientToScreen(&x2, &y2);
679
680 screenDC.SetLogicalFunction(wxINVERT);
681 screenDC.SetPen(*m_sashTrackerPen);
682 screenDC.SetBrush(*wxTRANSPARENT_BRUSH);
683
684 screenDC.DrawLine(x1, y1, x2, y2);
685
686 screenDC.SetLogicalFunction(wxCOPY);
687
688 screenDC.SetPen(wxNullPen);
689 screenDC.SetBrush(wxNullBrush);
690 }
691
692 // Position and size subwindows.
693 // Note that the border size applies to each subwindow, not
694 // including the edges next to the sash.
695 void wxSplitterWindow::SizeWindows()
696 {
697 int w, h;
698 GetClientSize(&w, &h);
699
700 if ( GetWindow1() && !GetWindow2() )
701 {
702 GetWindow1()->SetSize(GetBorderSize(), GetBorderSize(), w - 2*GetBorderSize(), h - 2*GetBorderSize());
703
704 }
705 else if ( GetWindow1() && GetWindow2() )
706 {
707 if (GetSplitMode() == wxSPLIT_VERTICAL)
708 {
709 int x1 = GetBorderSize();
710 int y1 = GetBorderSize();
711 int w1 = GetSashPosition() - GetBorderSize();
712 int h1 = h - 2*GetBorderSize();
713
714 int x2 = GetSashPosition() + GetSashSize();
715 int y2 = GetBorderSize();
716 int w2 = w - 2*GetBorderSize() - GetSashSize() - w1;
717 int h2 = h - 2*GetBorderSize();
718
719 GetWindow1()->SetSize(x1, y1, w1, h1);
720 GetWindow2()->SetSize(x2, y2, w2, h2);
721 }
722 else
723 {
724 GetWindow1()->SetSize(GetBorderSize(), GetBorderSize(),
725 w - 2*GetBorderSize(), GetSashPosition() - GetBorderSize());
726 GetWindow2()->SetSize(GetBorderSize(), GetSashPosition() + GetSashSize(),
727 w - 2*GetBorderSize(), h - 2*GetBorderSize() - GetSashSize() - (GetSashPosition() - GetBorderSize()));
728 }
729 }
730 wxClientDC dc(this);
731 if ( GetBorderSize() > 0 )
732 DrawBorders(dc);
733 DrawSash(dc);
734
735 SetNeedUpdating(FALSE);
736 }
737
738 // Set pane for unsplit window
739 void wxSplitterWindow::Initialize(wxWindow *window)
740 {
741 m_windowOne = window;
742 m_windowTwo = (wxWindow *) NULL;
743 m_sashPosition = 0;
744 }
745
746 // Associates the given window with window 2, drawing the appropriate sash
747 // and changing the split mode.
748 // Does nothing and returns FALSE if the window is already split.
749 bool wxSplitterWindow::SplitVertically(wxWindow *window1, wxWindow *window2, int sashPosition)
750 {
751 if ( IsSplit() )
752 return FALSE;
753
754 int w, h;
755 GetClientSize(&w, &h);
756
757 m_splitMode = wxSPLIT_VERTICAL;
758 m_windowOne = window1;
759 m_windowTwo = window2;
760 if ( sashPosition > 0 )
761 m_sashPosition = sashPosition;
762 else if ( sashPosition < 0 )
763 m_sashPosition = w + sashPosition; // It's negative so adding is subtracting
764 else // default
765 m_sashPosition = w/2;
766
767 SizeWindows();
768
769 return TRUE;
770 }
771
772 bool wxSplitterWindow::SplitHorizontally(wxWindow *window1, wxWindow *window2, int sashPosition)
773 {
774 if ( IsSplit() )
775 return FALSE;
776
777 int w, h;
778 GetClientSize(&w, &h);
779
780 m_splitMode = wxSPLIT_HORIZONTAL;
781 m_windowOne = window1;
782 m_windowTwo = window2;
783 if ( sashPosition > 0 )
784 m_sashPosition = sashPosition;
785 else if ( sashPosition < 0 )
786 m_sashPosition = h + sashPosition; // It's negative so adding is subtracting
787 else // default
788 m_sashPosition = h/2;
789
790 SizeWindows();
791
792 return TRUE;
793 }
794
795
796 // Remove the specified (or second) window from the view
797 // Doesn't actually delete the window.
798 bool wxSplitterWindow::Unsplit(wxWindow *toRemove)
799 {
800 if ( ! IsSplit() )
801 return FALSE;
802
803 wxWindow *win = NULL;
804 if ( toRemove == NULL || toRemove == m_windowTwo)
805 {
806 win = m_windowTwo ;
807 m_windowTwo = (wxWindow *) NULL;
808 }
809 else if ( toRemove == m_windowOne )
810 {
811 win = m_windowOne ;
812 m_windowOne = m_windowTwo;
813 m_windowTwo = (wxWindow *) NULL;
814 }
815 else
816 {
817 wxFAIL_MSG(wxT("splitter: attempt to remove a non-existent window"));
818
819 return FALSE;
820 }
821
822 SendUnsplitEvent(win);
823 m_sashPosition = 0;
824 SizeWindows();
825
826 return TRUE;
827 }
828
829 // Replace a window with another one
830 bool wxSplitterWindow::ReplaceWindow(wxWindow *winOld, wxWindow *winNew)
831 {
832 wxCHECK_MSG( winOld, FALSE, wxT("use one of Split() functions instead") );
833 wxCHECK_MSG( winNew, FALSE, wxT("use Unsplit() functions instead") );
834
835 if ( winOld == m_windowTwo )
836 {
837 m_windowTwo = winNew;
838 }
839 else if ( winOld == m_windowOne )
840 {
841 m_windowOne = winNew;
842 }
843 else
844 {
845 wxFAIL_MSG(wxT("splitter: attempt to replace a non-existent window"));
846
847 return FALSE;
848 }
849
850 SizeWindows();
851
852 return TRUE;
853 }
854
855 void wxSplitterWindow::SetSashPosition(int position, bool redraw)
856 {
857 m_sashPosition = position;
858
859 if ( redraw )
860 {
861 SizeWindows();
862 }
863 }
864
865 // Initialize colours
866 void wxSplitterWindow::InitColours()
867 {
868 wxDELETE( m_facePen );
869 wxDELETE( m_faceBrush );
870 wxDELETE( m_mediumShadowPen );
871 wxDELETE( m_darkShadowPen );
872 wxDELETE( m_lightShadowPen );
873 wxDELETE( m_hilightPen );
874
875 // Shadow colours
876 #ifndef __WIN16__
877 wxColour faceColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DFACE));
878 m_facePen = new wxPen(faceColour, 1, wxSOLID);
879 m_faceBrush = new wxBrush(faceColour, wxSOLID);
880
881 wxColour mediumShadowColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DSHADOW));
882 m_mediumShadowPen = new wxPen(mediumShadowColour, 1, wxSOLID);
883
884 wxColour darkShadowColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DDKSHADOW));
885 m_darkShadowPen = new wxPen(darkShadowColour, 1, wxSOLID);
886
887 wxColour lightShadowColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DLIGHT));
888 m_lightShadowPen = new wxPen(lightShadowColour, 1, wxSOLID);
889
890 wxColour hilightColour(wxSystemSettings::GetColour(wxSYS_COLOUR_3DHILIGHT));
891 m_hilightPen = new wxPen(hilightColour, 1, wxSOLID);
892 #else
893 m_facePen = new wxPen("LIGHT GREY", 1, wxSOLID);
894 m_faceBrush = new wxBrush("LIGHT GREY", wxSOLID);
895 m_mediumShadowPen = new wxPen("GREY", 1, wxSOLID);
896 m_darkShadowPen = new wxPen("BLACK", 1, wxSOLID);
897 m_lightShadowPen = new wxPen("LIGHT GREY", 1, wxSOLID);
898 m_hilightPen = new wxPen("WHITE", 1, wxSOLID);
899 #endif // __WIN16__
900 }
901
902 void wxSplitterWindow::SendUnsplitEvent(wxWindow *winRemoved)
903 {
904 wxSplitterEvent event(wxEVT_COMMAND_SPLITTER_UNSPLIT, this);
905 event.m_data.win = winRemoved;
906
907 (void)GetEventHandler()->ProcessEvent(event);
908 }
909
910 // ---------------------------------------------------------------------------
911 // splitter event handlers
912 // ---------------------------------------------------------------------------
913
914 void wxSplitterWindow::OnSashPosChanged(wxSplitterEvent& event)
915 {
916 // If within UNSPLIT_THRESHOLD from edge, set to edge to cause closure.
917 const int UNSPLIT_THRESHOLD = 4;
918
919 int newSashPosition = event.GetSashPosition();
920
921 // Obtain relevant window dimension for bottom / right threshold check
922 int w, h;
923 GetClientSize(&w, &h);
924 int window_size = (m_splitMode == wxSPLIT_VERTICAL) ? w : h ;
925
926 bool unsplit_scenario = FALSE;
927 if ( m_permitUnsplitAlways
928 || m_minimumPaneSize == 0 )
929 {
930 // Do edge detection if unsplit premitted
931 if ( newSashPosition <= UNSPLIT_THRESHOLD )
932 {
933 // threshold top / left check
934 newSashPosition = 0;
935 unsplit_scenario = TRUE;
936 }
937 if ( newSashPosition >= window_size - UNSPLIT_THRESHOLD )
938 {
939 // threshold bottom/right check
940 newSashPosition = window_size;
941 unsplit_scenario = TRUE;
942 }
943 }
944
945 if ( !unsplit_scenario )
946 {
947 // If resultant pane would be too small, enlarge it
948 if ( newSashPosition < m_minimumPaneSize )
949 newSashPosition = m_minimumPaneSize;
950 if ( newSashPosition > window_size - m_minimumPaneSize )
951 newSashPosition = window_size - m_minimumPaneSize;
952 }
953
954 // If the result is out of bounds it means minimum size is too big,
955 // so split window in half as best compromise.
956 if ( newSashPosition < 0 || newSashPosition > window_size )
957 newSashPosition = window_size / 2;
958
959 // for compatibility, call the virtual function
960 if ( !OnSashPositionChange(newSashPosition) )
961 {
962 newSashPosition = -1;
963 }
964
965 event.SetSashPosition(newSashPosition);
966 }
967
968 // Called when the sash is double-clicked. The default behaviour is to remove
969 // the sash if the minimum pane size is zero.
970 void wxSplitterWindow::OnDoubleClick(wxSplitterEvent& event)
971 {
972 // for compatibility, call the virtual function
973 OnDoubleClickSash(event.GetX(), event.GetY());
974
975 if ( GetMinimumPaneSize() == 0 || m_permitUnsplitAlways )
976 {
977 Unsplit();
978 }
979 }
980
981 void wxSplitterWindow::OnUnsplitEvent(wxSplitterEvent& event)
982 {
983 wxWindow *win = event.GetWindowBeingRemoved();
984
985 // do it before calling OnUnsplit() which may delete the window
986 win->Show(FALSE);
987
988 // for compatibility, call the virtual function
989 OnUnsplit(win);
990 }
991
992 #if defined(__WXMSW__)
993 #define WXUNUSED_UNLESS_MSW(identifier) identifier
994 #else
995 #define WXUNUSED_UNLESS_MSW(identifier) WXUNUSED(identifier)
996 #endif
997
998 void wxSplitterWindow::OnSetCursor(wxSetCursorEvent& WXUNUSED_UNLESS_MSW(event))
999 {
1000 // this is currently called (and needed) under MSW only...
1001 #ifdef __WXMSW__
1002
1003 // if we don't do it, the resizing cursor might be set for child window:
1004 // and like this we explicitly say that our cursor should not be used for
1005 // children windows which overlap us
1006
1007 if ( SashHitTest(event.GetX(), event.GetY()) )
1008 {
1009 // default processing is ok
1010 event.Skip();
1011 }
1012 //else: do nothing, in particular, don't call Skip()
1013 #endif // wxMSW
1014 }