]> git.saurik.com Git - wxWidgets.git/blob - src/aui/framemanager.cpp
Correct wxDataViewListModel::RowPrepended
[wxWidgets.git] / src / aui / framemanager.cpp
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/aui/framemanager.cpp
3 // Purpose: wxaui: wx advanced user interface - docking window manager
4 // Author: Benjamin I. Williams
5 // Modified by:
6 // Created: 2005-05-17
7 // RCS-ID: $Id$
8 // Copyright: (C) Copyright 2005-2006, Kirix Corporation, All Rights Reserved
9 // Licence: wxWindows Library Licence, Version 3.1
10 ///////////////////////////////////////////////////////////////////////////////
11
12 // ============================================================================
13 // declarations
14 // ============================================================================
15
16 // ----------------------------------------------------------------------------
17 // headers
18 // ----------------------------------------------------------------------------
19
20 #include "wx/wxprec.h"
21
22 #ifdef __BORLANDC__
23 #pragma hdrstop
24 #endif
25
26 #if wxUSE_AUI
27
28 #include "wx/aui/framemanager.h"
29 #include "wx/aui/dockart.h"
30 #include "wx/aui/floatpane.h"
31 #include "wx/aui/tabmdi.h"
32 #include "wx/aui/auibar.h"
33 #include "wx/mdi.h"
34
35 #ifndef WX_PRECOMP
36 #include "wx/panel.h"
37 #include "wx/settings.h"
38 #include "wx/app.h"
39 #include "wx/dcclient.h"
40 #include "wx/dcscreen.h"
41 #include "wx/toolbar.h"
42 #include "wx/image.h"
43 #include "wx/statusbr.h"
44 #endif
45
46 WX_CHECK_BUILD_OPTIONS("wxAUI")
47
48 #include "wx/arrimpl.cpp"
49 WX_DECLARE_OBJARRAY(wxRect, wxAuiRectArray);
50 WX_DEFINE_OBJARRAY(wxAuiRectArray)
51 WX_DEFINE_OBJARRAY(wxAuiDockUIPartArray)
52 WX_DEFINE_OBJARRAY(wxAuiDockInfoArray)
53 WX_DEFINE_OBJARRAY(wxAuiPaneButtonArray)
54 WX_DEFINE_OBJARRAY(wxAuiPaneInfoArray)
55
56 wxAuiPaneInfo wxAuiNullPaneInfo;
57 wxAuiDockInfo wxAuiNullDockInfo;
58 wxDEFINE_EVENT( wxEVT_AUI_PANE_BUTTON, wxAuiManagerEvent );
59 wxDEFINE_EVENT( wxEVT_AUI_PANE_CLOSE, wxAuiManagerEvent );
60 wxDEFINE_EVENT( wxEVT_AUI_PANE_MAXIMIZE, wxAuiManagerEvent );
61 wxDEFINE_EVENT( wxEVT_AUI_PANE_RESTORE, wxAuiManagerEvent );
62 wxDEFINE_EVENT( wxEVT_AUI_RENDER, wxAuiManagerEvent );
63 wxDEFINE_EVENT( wxEVT_AUI_FIND_MANAGER, wxAuiManagerEvent );
64
65 #ifdef __WXMAC__
66 // a few defines to avoid nameclashes
67 #define __MAC_OS_X_MEMORY_MANAGER_CLEAN__ 1
68 #define __AIFF__
69 #include "wx/osx/private.h"
70 #endif
71
72 #ifdef __WXMSW__
73 #include "wx/msw/wrapwin.h"
74 #include "wx/msw/private.h"
75 #include "wx/msw/dc.h"
76 #endif
77
78 IMPLEMENT_DYNAMIC_CLASS(wxAuiManagerEvent, wxEvent)
79 IMPLEMENT_CLASS(wxAuiManager, wxEvtHandler)
80
81
82
83 const int auiToolBarLayer = 10;
84
85 #ifndef __WXGTK20__
86
87
88 class wxPseudoTransparentFrame : public wxFrame
89 {
90 public:
91 wxPseudoTransparentFrame(wxWindow* parent = NULL,
92 wxWindowID id = wxID_ANY,
93 const wxString& title = wxEmptyString,
94 const wxPoint& pos = wxDefaultPosition,
95 const wxSize& size = wxDefaultSize,
96 long style = wxDEFAULT_FRAME_STYLE,
97 const wxString &name = wxT("frame"))
98 : wxFrame(parent, id, title, pos, size, style | wxFRAME_SHAPED, name)
99 {
100 SetBackgroundStyle(wxBG_STYLE_CUSTOM);
101 m_Amount=0;
102 m_MaxWidth=0;
103 m_MaxHeight=0;
104 m_lastWidth=0;
105 m_lastHeight=0;
106 #ifdef __WXGTK__
107 m_CanSetShape = false; // have to wait for window create event on GTK
108 #else
109 m_CanSetShape = true;
110 #endif
111 m_Region = wxRegion(0, 0, 0, 0);
112 SetTransparent(0);
113 }
114
115 virtual bool SetTransparent(wxByte alpha)
116 {
117 if (m_CanSetShape)
118 {
119 int w=100; // some defaults
120 int h=100;
121 GetClientSize(&w, &h);
122
123 m_MaxWidth = w;
124 m_MaxHeight = h;
125 m_Amount = alpha;
126 m_Region.Clear();
127 // m_Region.Union(0, 0, 1, m_MaxWidth);
128 if (m_Amount)
129 {
130 for (int y=0; y<m_MaxHeight; y++)
131 {
132 // Reverse the order of the bottom 4 bits
133 int j=((y&8)?1:0)|((y&4)?2:0)|((y&2)?4:0)|((y&1)?8:0);
134 if ((j*16+8)<m_Amount)
135 m_Region.Union(0, y, m_MaxWidth, 1);
136 }
137 }
138 SetShape(m_Region);
139 Refresh();
140 }
141 return true;
142 }
143
144 void OnPaint(wxPaintEvent& WXUNUSED(event))
145 {
146 wxPaintDC dc(this);
147
148 if (m_Region.IsEmpty())
149 return;
150
151 #ifdef __WXMAC__
152 dc.SetBrush(wxColour(128, 192, 255));
153 #else
154 dc.SetBrush(wxSystemSettings::GetColour(wxSYS_COLOUR_ACTIVECAPTION));
155 #endif
156 dc.SetPen(*wxTRANSPARENT_PEN);
157
158 wxRegionIterator upd(GetUpdateRegion()); // get the update rect list
159
160 while (upd)
161 {
162 wxRect rect(upd.GetRect());
163 dc.DrawRectangle(rect.x, rect.y, rect.width, rect.height);
164
165 ++upd;
166 }
167 }
168
169 #ifdef __WXGTK__
170 void OnWindowCreate(wxWindowCreateEvent& WXUNUSED(event))
171 {
172 m_CanSetShape=true;
173 SetTransparent(0);
174 }
175 #endif
176
177 void OnSize(wxSizeEvent& event)
178 {
179 // We sometimes get surplus size events
180 if ((event.GetSize().GetWidth() == m_lastWidth) &&
181 (event.GetSize().GetHeight() == m_lastHeight))
182 {
183 event.Skip();
184 return;
185 }
186 m_lastWidth = event.GetSize().GetWidth();
187 m_lastHeight = event.GetSize().GetHeight();
188
189 SetTransparent(m_Amount);
190 m_Region.Intersect(0, 0, event.GetSize().GetWidth(),
191 event.GetSize().GetHeight());
192 SetShape(m_Region);
193 Refresh();
194 event.Skip();
195 }
196
197 private:
198 wxByte m_Amount;
199 int m_MaxWidth;
200 int m_MaxHeight;
201 bool m_CanSetShape;
202 int m_lastWidth,m_lastHeight;
203
204 wxRegion m_Region;
205
206 DECLARE_DYNAMIC_CLASS(wxPseudoTransparentFrame)
207 DECLARE_EVENT_TABLE()
208 };
209
210
211 IMPLEMENT_DYNAMIC_CLASS(wxPseudoTransparentFrame, wxFrame)
212
213 BEGIN_EVENT_TABLE(wxPseudoTransparentFrame, wxFrame)
214 EVT_PAINT(wxPseudoTransparentFrame::OnPaint)
215 EVT_SIZE(wxPseudoTransparentFrame::OnSize)
216 #ifdef __WXGTK__
217 EVT_WINDOW_CREATE(wxPseudoTransparentFrame::OnWindowCreate)
218 #endif
219 END_EVENT_TABLE()
220
221
222 #else
223 // __WXGTK20__
224
225 #include <gtk/gtk.h>
226
227 static void
228 gtk_pseudo_window_realized_callback( GtkWidget *m_widget, void *WXUNUSED(win) )
229 {
230 wxSize disp = wxGetDisplaySize();
231 int amount = 128;
232 wxRegion region;
233 for (int y=0; y<disp.y; y++)
234 {
235 // Reverse the order of the bottom 4 bits
236 int j=((y&8)?1:0)|((y&4)?2:0)|((y&2)?4:0)|((y&1)?8:0);
237 if ((j*16+8)<amount)
238 region.Union(0, y, disp.x, 1);
239 }
240 gdk_window_shape_combine_region(m_widget->window, region.GetRegion(), 0, 0);
241 }
242
243
244 class wxPseudoTransparentFrame: public wxFrame
245 {
246 public:
247 wxPseudoTransparentFrame(wxWindow* parent = NULL,
248 wxWindowID id = wxID_ANY,
249 const wxString& title = wxEmptyString,
250 const wxPoint& pos = wxDefaultPosition,
251 const wxSize& size = wxDefaultSize,
252 long style = wxDEFAULT_FRAME_STYLE,
253 const wxString &name = wxT("frame"))
254 {
255 if (!CreateBase( parent, id, pos, size, style, wxDefaultValidator, name ))
256 return;
257
258 m_title = title;
259
260 m_widget = gtk_window_new( GTK_WINDOW_POPUP );
261 g_object_ref(m_widget);
262
263 if (parent) parent->AddChild(this);
264
265 g_signal_connect( m_widget, "realize",
266 G_CALLBACK (gtk_pseudo_window_realized_callback), this );
267
268 GdkColor col;
269 col.red = 128 * 256;
270 col.green = 192 * 256;
271 col.blue = 255 * 256;
272 gtk_widget_modify_bg( m_widget, GTK_STATE_NORMAL, &col );
273 }
274
275 bool SetTransparent(wxByte WXUNUSED(alpha))
276 {
277 return true;
278 }
279
280 private:
281 DECLARE_DYNAMIC_CLASS(wxPseudoTransparentFrame)
282 };
283
284 IMPLEMENT_DYNAMIC_CLASS(wxPseudoTransparentFrame, wxFrame)
285
286 #endif
287 // __WXGTK20__
288
289
290
291 // -- static utility functions --
292
293 static wxBitmap wxPaneCreateStippleBitmap()
294 {
295 unsigned char data[] = { 0,0,0,192,192,192, 192,192,192,0,0,0 };
296 wxImage img(2,2,data,true);
297 return wxBitmap(img);
298 }
299
300 static void DrawResizeHint(wxDC& dc, const wxRect& rect)
301 {
302 wxBitmap stipple = wxPaneCreateStippleBitmap();
303 wxBrush brush(stipple);
304 dc.SetBrush(brush);
305 #ifdef __WXMSW__
306 wxMSWDCImpl *impl = (wxMSWDCImpl*) dc.GetImpl();
307 PatBlt(GetHdcOf(*impl), rect.GetX(), rect.GetY(), rect.GetWidth(), rect.GetHeight(), PATINVERT);
308 #else
309 dc.SetPen(*wxTRANSPARENT_PEN);
310
311 dc.SetLogicalFunction(wxXOR);
312 dc.DrawRectangle(rect);
313 #endif
314 }
315
316
317
318 // CopyDocksAndPanes() - this utility function creates copies of
319 // the dock and pane info. wxAuiDockInfo's usually contain pointers
320 // to wxAuiPaneInfo classes, thus this function is necessary to reliably
321 // reconstruct that relationship in the new dock info and pane info arrays
322
323 static void CopyDocksAndPanes(wxAuiDockInfoArray& dest_docks,
324 wxAuiPaneInfoArray& dest_panes,
325 const wxAuiDockInfoArray& src_docks,
326 const wxAuiPaneInfoArray& src_panes)
327 {
328 dest_docks = src_docks;
329 dest_panes = src_panes;
330 int i, j, k, dock_count, pc1, pc2;
331 for (i = 0, dock_count = dest_docks.GetCount(); i < dock_count; ++i)
332 {
333 wxAuiDockInfo& dock = dest_docks.Item(i);
334 for (j = 0, pc1 = dock.panes.GetCount(); j < pc1; ++j)
335 for (k = 0, pc2 = src_panes.GetCount(); k < pc2; ++k)
336 if (dock.panes.Item(j) == &src_panes.Item(k))
337 dock.panes.Item(j) = &dest_panes.Item(k);
338 }
339 }
340
341 // GetMaxLayer() is an internal function which returns
342 // the highest layer inside the specified dock
343 static int GetMaxLayer(const wxAuiDockInfoArray& docks,
344 int dock_direction)
345 {
346 int i, dock_count, max_layer = 0;
347 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
348 {
349 wxAuiDockInfo& dock = docks.Item(i);
350 if (dock.dock_direction == dock_direction &&
351 dock.dock_layer > max_layer && !dock.fixed)
352 max_layer = dock.dock_layer;
353 }
354 return max_layer;
355 }
356
357
358 // GetMaxRow() is an internal function which returns
359 // the highest layer inside the specified dock
360 static int GetMaxRow(const wxAuiPaneInfoArray& panes, int direction, int layer)
361 {
362 int i, pane_count, max_row = 0;
363 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
364 {
365 wxAuiPaneInfo& pane = panes.Item(i);
366 if (pane.dock_direction == direction &&
367 pane.dock_layer == layer &&
368 pane.dock_row > max_row)
369 max_row = pane.dock_row;
370 }
371 return max_row;
372 }
373
374
375
376 // DoInsertDockLayer() is an internal function that inserts a new dock
377 // layer by incrementing all existing dock layer values by one
378 static void DoInsertDockLayer(wxAuiPaneInfoArray& panes,
379 int dock_direction,
380 int dock_layer)
381 {
382 int i, pane_count;
383 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
384 {
385 wxAuiPaneInfo& pane = panes.Item(i);
386 if (!pane.IsFloating() &&
387 pane.dock_direction == dock_direction &&
388 pane.dock_layer >= dock_layer)
389 pane.dock_layer++;
390 }
391 }
392
393 // DoInsertDockLayer() is an internal function that inserts a new dock
394 // row by incrementing all existing dock row values by one
395 static void DoInsertDockRow(wxAuiPaneInfoArray& panes,
396 int dock_direction,
397 int dock_layer,
398 int dock_row)
399 {
400 int i, pane_count;
401 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
402 {
403 wxAuiPaneInfo& pane = panes.Item(i);
404 if (!pane.IsFloating() &&
405 pane.dock_direction == dock_direction &&
406 pane.dock_layer == dock_layer &&
407 pane.dock_row >= dock_row)
408 pane.dock_row++;
409 }
410 }
411
412 // DoInsertDockLayer() is an internal function that inserts a space for
413 // another dock pane by incrementing all existing dock row values by one
414 static void DoInsertPane(wxAuiPaneInfoArray& panes,
415 int dock_direction,
416 int dock_layer,
417 int dock_row,
418 int dock_pos)
419 {
420 int i, pane_count;
421 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
422 {
423 wxAuiPaneInfo& pane = panes.Item(i);
424 if (!pane.IsFloating() &&
425 pane.dock_direction == dock_direction &&
426 pane.dock_layer == dock_layer &&
427 pane.dock_row == dock_row &&
428 pane.dock_pos >= dock_pos)
429 pane.dock_pos++;
430 }
431 }
432
433 // FindDocks() is an internal function that returns a list of docks which meet
434 // the specified conditions in the parameters and returns a sorted array
435 // (sorted by layer and then row)
436 static void FindDocks(wxAuiDockInfoArray& docks,
437 int dock_direction,
438 int dock_layer,
439 int dock_row,
440 wxAuiDockInfoPtrArray& arr)
441 {
442 int begin_layer = dock_layer;
443 int end_layer = dock_layer;
444 int begin_row = dock_row;
445 int end_row = dock_row;
446 int dock_count = docks.GetCount();
447 int layer, row, i, max_row = 0, max_layer = 0;
448
449 // discover the maximum dock layer and the max row
450 for (i = 0; i < dock_count; ++i)
451 {
452 max_row = wxMax(max_row, docks.Item(i).dock_row);
453 max_layer = wxMax(max_layer, docks.Item(i).dock_layer);
454 }
455
456 // if no dock layer was specified, search all dock layers
457 if (dock_layer == -1)
458 {
459 begin_layer = 0;
460 end_layer = max_layer;
461 }
462
463 // if no dock row was specified, search all dock row
464 if (dock_row == -1)
465 {
466 begin_row = 0;
467 end_row = max_row;
468 }
469
470 arr.Clear();
471
472 for (layer = begin_layer; layer <= end_layer; ++layer)
473 for (row = begin_row; row <= end_row; ++row)
474 for (i = 0; i < dock_count; ++i)
475 {
476 wxAuiDockInfo& d = docks.Item(i);
477 if (dock_direction == -1 || dock_direction == d.dock_direction)
478 {
479 if (d.dock_layer == layer && d.dock_row == row)
480 arr.Add(&d);
481 }
482 }
483 }
484
485 // FindPaneInDock() looks up a specified window pointer inside a dock.
486 // If found, the corresponding wxAuiPaneInfo pointer is returned, otherwise NULL.
487 static wxAuiPaneInfo* FindPaneInDock(const wxAuiDockInfo& dock, wxWindow* window)
488 {
489 int i, count = dock.panes.GetCount();
490 for (i = 0; i < count; ++i)
491 {
492 wxAuiPaneInfo* p = dock.panes.Item(i);
493 if (p->window == window)
494 return p;
495 }
496 return NULL;
497 }
498
499 // RemovePaneFromDocks() removes a pane window from all docks
500 // with a possible exception specified by parameter "ex_cept"
501 static void RemovePaneFromDocks(wxAuiDockInfoArray& docks,
502 wxAuiPaneInfo& pane,
503 wxAuiDockInfo* ex_cept = NULL )
504 {
505 int i, dock_count;
506 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
507 {
508 wxAuiDockInfo& d = docks.Item(i);
509 if (&d == ex_cept)
510 continue;
511 wxAuiPaneInfo* pi = FindPaneInDock(d, pane.window);
512 if (pi)
513 d.panes.Remove(pi);
514 }
515 }
516
517 /*
518 // This function works fine, and may be used in the future
519
520 // RenumberDockRows() takes a dock and assigns sequential numbers
521 // to existing rows. Basically it takes out the gaps; so if a
522 // dock has rows with numbers 0,2,5, they will become 0,1,2
523 static void RenumberDockRows(wxAuiDockInfoPtrArray& docks)
524 {
525 int i, dock_count;
526 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
527 {
528 wxAuiDockInfo& dock = *docks.Item(i);
529 dock.dock_row = i;
530
531 int j, pane_count;
532 for (j = 0, pane_count = dock.panes.GetCount(); j < pane_count; ++j)
533 dock.panes.Item(j)->dock_row = i;
534 }
535 }
536 */
537
538
539 // SetActivePane() sets the active pane, as well as cycles through
540 // every other pane and makes sure that all others' active flags
541 // are turned off
542 static void SetActivePane(wxAuiPaneInfoArray& panes, wxWindow* active_pane)
543 {
544 int i, pane_count;
545 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
546 {
547 wxAuiPaneInfo& pane = panes.Item(i);
548 pane.state &= ~wxAuiPaneInfo::optionActive;
549 if (pane.window == active_pane)
550 pane.state |= wxAuiPaneInfo::optionActive;
551 }
552 }
553
554
555 // this function is used to sort panes by dock position
556 static int PaneSortFunc(wxAuiPaneInfo** p1, wxAuiPaneInfo** p2)
557 {
558 return ((*p1)->dock_pos < (*p2)->dock_pos) ? -1 : 1;
559 }
560
561
562
563
564 // this utility class implements a proportional sizer
565 // as it existed in wxWidgets 2.8 and before.
566
567 class wxAuiProportionalBoxSizer : public wxBoxSizer
568 {
569 public:
570 wxAuiProportionalBoxSizer(int orientation) : wxBoxSizer(orientation) { }
571
572 void RecalcSizes()
573 {
574 if (m_children.GetCount() == 0)
575 return;
576
577 int fixed_height = 0;
578 int fixed_width = 0;
579 int stretchable = 0;
580 wxSizerItemList::compatibility_iterator node;
581
582 // find fixed width and height, as well
583 // as the total stretchable proportions
584 node = m_children.GetFirst();
585 while (node)
586 {
587 wxSizerItem *item = node->GetData();
588
589 if (item->IsShown())
590 {
591 stretchable += item->GetProportion();
592
593 wxSize size(item->GetMinSizeWithBorder());
594 if (item->GetProportion() == 0)
595 {
596 if (m_orient == wxVERTICAL)
597 {
598 fixed_height += size.y;
599 fixed_width = wxMax(fixed_width, size.x);
600 }
601 else
602 {
603 fixed_width += size.x;
604 fixed_height = wxMax(fixed_height, size.y);
605 }
606 }
607 }
608
609 node = node->GetNext();
610 }
611
612
613 // delta specifies the total amount to be allocated to stretch spaces
614 int delta = 0;
615 if (stretchable)
616 {
617 if (m_orient == wxHORIZONTAL)
618 delta = m_size.x - fixed_width;
619 else
620 delta = m_size.y - fixed_height;
621 }
622
623 // go through each item and assign sizes
624 wxPoint pt(m_position);
625 node = m_children.GetFirst();
626 while (node)
627 {
628 wxSizerItem* item = node->GetData();
629
630 if (item->IsShown())
631 {
632 wxSize size(item->GetMinSizeWithBorder());
633
634 if (m_orient == wxVERTICAL)
635 {
636 wxCoord height = size.y;
637 if (item->GetProportion())
638 {
639 height = (delta * item->GetProportion()) / stretchable;
640 delta -= height;
641 stretchable -= item->GetProportion();
642 }
643
644 wxPoint child_pos(pt);
645 wxSize child_size(size.x, height);
646
647 if (item->GetFlag() & (wxEXPAND | wxSHAPED))
648 child_size.x = m_size.x;
649 else if (item->GetFlag() & wxALIGN_RIGHT)
650 child_pos.x += m_size.x - size.x;
651 else if (item->GetFlag() & (wxCENTER | wxALIGN_CENTER_HORIZONTAL))
652 child_pos.x += (m_size.x - size.x) / 2;
653
654 item->SetDimension(child_pos, child_size);
655
656 pt.y += height;
657 }
658 else
659 {
660 wxCoord width = size.x;
661 if (item->GetProportion())
662 {
663 width = (delta * item->GetProportion()) / stretchable;
664 delta -= width;
665 stretchable -= item->GetProportion();
666 }
667
668 wxPoint child_pos(pt);
669 wxSize child_size(width, size.y);
670
671 if (item->GetFlag() & (wxEXPAND | wxSHAPED))
672 child_size.y = m_size.y;
673 else if (item->GetFlag() & wxALIGN_BOTTOM)
674 child_pos.y += m_size.y - size.y;
675 else if (item->GetFlag() & (wxCENTER | wxALIGN_CENTER_VERTICAL))
676 child_pos.y += (m_size.y - size.y) / 2;
677
678 item->SetDimension(child_pos, child_size);
679
680 pt.x += width;
681 }
682 }
683
684 node = node->GetNext();
685 }
686 }
687 };
688
689
690
691
692 // -- wxAuiManager class implementation --
693
694
695 BEGIN_EVENT_TABLE(wxAuiManager, wxEvtHandler)
696 EVT_AUI_PANE_BUTTON(wxAuiManager::OnPaneButton)
697 EVT_AUI_RENDER(wxAuiManager::OnRender)
698 EVT_PAINT(wxAuiManager::OnPaint)
699 EVT_ERASE_BACKGROUND(wxAuiManager::OnEraseBackground)
700 EVT_SIZE(wxAuiManager::OnSize)
701 EVT_SET_CURSOR(wxAuiManager::OnSetCursor)
702 EVT_LEFT_DOWN(wxAuiManager::OnLeftDown)
703 EVT_LEFT_UP(wxAuiManager::OnLeftUp)
704 EVT_MOTION(wxAuiManager::OnMotion)
705 EVT_LEAVE_WINDOW(wxAuiManager::OnLeaveWindow)
706 EVT_MOUSE_CAPTURE_LOST(wxAuiManager::OnCaptureLost)
707 EVT_CHILD_FOCUS(wxAuiManager::OnChildFocus)
708 EVT_AUI_FIND_MANAGER(wxAuiManager::OnFindManager)
709 EVT_TIMER(101, wxAuiManager::OnHintFadeTimer)
710 END_EVENT_TABLE()
711
712
713 wxAuiManager::wxAuiManager(wxWindow* managed_wnd, unsigned int flags)
714 {
715 m_action = actionNone;
716 m_action_window = NULL;
717 m_last_mouse_move = wxPoint();
718 m_hover_button = NULL;
719 m_art = new wxAuiDefaultDockArt;
720 m_hint_wnd = NULL;
721 m_flags = flags;
722 m_skipping = false;
723 m_has_maximized = false;
724 m_frame = NULL;
725 m_dock_constraint_x = 0.3;
726 m_dock_constraint_y = 0.3;
727 m_reserved = NULL;
728 m_currentDragItem = -1;
729
730 if (managed_wnd)
731 {
732 SetManagedWindow(managed_wnd);
733 }
734 }
735
736 wxAuiManager::~wxAuiManager()
737 {
738 // NOTE: It's possible that the windows have already been destroyed by the
739 // time this dtor is called, so this loop can result in memory access via
740 // invalid pointers, resulting in a crash. So it will be disabled while
741 // waiting for a better solution.
742 #if 0
743 for ( size_t i = 0; i < m_panes.size(); i++ )
744 {
745 wxAuiPaneInfo& pinfo = m_panes[i];
746 if (pinfo.window && !pinfo.window->GetParent())
747 delete pinfo.window;
748 }
749 #endif
750
751 delete m_art;
752 }
753
754 // creates a floating frame for the windows
755 wxAuiFloatingFrame* wxAuiManager::CreateFloatingFrame(wxWindow* parent,
756 const wxAuiPaneInfo& pane_info)
757 {
758 return new wxAuiFloatingFrame(parent, this, pane_info);
759 }
760
761 bool wxAuiManager::CanDockPanel(const wxAuiPaneInfo & WXUNUSED(p))
762 {
763 // if a key modifier is pressed while dragging the frame,
764 // don't dock the window
765 return !(wxGetKeyState(WXK_CONTROL) || wxGetKeyState(WXK_ALT));
766 }
767
768 // GetPane() looks up a wxAuiPaneInfo structure based
769 // on the supplied window pointer. Upon failure, GetPane()
770 // returns an empty wxAuiPaneInfo, a condition which can be checked
771 // by calling wxAuiPaneInfo::IsOk().
772 //
773 // The pane info's structure may then be modified. Once a pane's
774 // info is modified, wxAuiManager::Update() must be called to
775 // realize the changes in the UI.
776
777 wxAuiPaneInfo& wxAuiManager::GetPane(wxWindow* window)
778 {
779 int i, pane_count;
780 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
781 {
782 wxAuiPaneInfo& p = m_panes.Item(i);
783 if (p.window == window)
784 return p;
785 }
786 return wxAuiNullPaneInfo;
787 }
788
789 // this version of GetPane() looks up a pane based on a
790 // 'pane name', see above comment for more info
791 wxAuiPaneInfo& wxAuiManager::GetPane(const wxString& name)
792 {
793 int i, pane_count;
794 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
795 {
796 wxAuiPaneInfo& p = m_panes.Item(i);
797 if (p.name == name)
798 return p;
799 }
800 return wxAuiNullPaneInfo;
801 }
802
803 // GetAllPanes() returns a reference to all the pane info structures
804 wxAuiPaneInfoArray& wxAuiManager::GetAllPanes()
805 {
806 return m_panes;
807 }
808
809 // HitTest() is an internal function which determines
810 // which UI item the specified coordinates are over
811 // (x,y) specify a position in client coordinates
812 wxAuiDockUIPart* wxAuiManager::HitTest(int x, int y)
813 {
814 wxAuiDockUIPart* result = NULL;
815
816 int i, part_count;
817 for (i = 0, part_count = m_uiparts.GetCount(); i < part_count; ++i)
818 {
819 wxAuiDockUIPart* item = &m_uiparts.Item(i);
820
821 // we are not interested in typeDock, because this space
822 // isn't used to draw anything, just for measurements;
823 // besides, the entire dock area is covered with other
824 // rectangles, which we are interested in.
825 if (item->type == wxAuiDockUIPart::typeDock)
826 continue;
827
828 // if we already have a hit on a more specific item, we are not
829 // interested in a pane hit. If, however, we don't already have
830 // a hit, returning a pane hit is necessary for some operations
831 if ((item->type == wxAuiDockUIPart::typePane ||
832 item->type == wxAuiDockUIPart::typePaneBorder) && result)
833 continue;
834
835 // if the point is inside the rectangle, we have a hit
836 if (item->rect.Contains(x,y))
837 result = item;
838 }
839
840 return result;
841 }
842
843
844 // SetFlags() and GetFlags() allow the owner to set various
845 // options which are global to wxAuiManager
846 void wxAuiManager::SetFlags(unsigned int flags)
847 {
848 // find out if we have to call UpdateHintWindowConfig()
849 bool update_hint_wnd = false;
850 unsigned int hint_mask = wxAUI_MGR_TRANSPARENT_HINT |
851 wxAUI_MGR_VENETIAN_BLINDS_HINT |
852 wxAUI_MGR_RECTANGLE_HINT;
853 if ((flags & hint_mask) != (m_flags & hint_mask))
854 update_hint_wnd = true;
855
856
857 // set the new flags
858 m_flags = flags;
859
860 if (update_hint_wnd)
861 {
862 UpdateHintWindowConfig();
863 }
864 }
865
866 unsigned int wxAuiManager::GetFlags() const
867 {
868 return m_flags;
869 }
870
871 // Convenience function
872 bool wxAuiManager_HasLiveResize(wxAuiManager& manager)
873 {
874 // With Core Graphics on Mac, it's not possible to show sash feedback,
875 // so we'll always use live update instead.
876 #if defined(__WXMAC__)
877 return true;
878 #else
879 return (manager.GetFlags() & wxAUI_MGR_LIVE_RESIZE) == wxAUI_MGR_LIVE_RESIZE;
880 #endif
881 }
882
883 // don't use these anymore as they are deprecated
884 // use Set/GetManagedFrame() instead
885 void wxAuiManager::SetFrame(wxFrame* frame)
886 {
887 SetManagedWindow((wxWindow*)frame);
888 }
889
890 wxFrame* wxAuiManager::GetFrame() const
891 {
892 return (wxFrame*)m_frame;
893 }
894
895
896 // this function will return the aui manager for a given
897 // window. The |window| parameter should be any child window
898 // or grand-child window (and so on) of the frame/window
899 // managed by wxAuiManager. The |window| parameter does not
900 // need to be managed by the manager itself.
901 wxAuiManager* wxAuiManager::GetManager(wxWindow* window)
902 {
903 wxAuiManagerEvent evt(wxEVT_AUI_FIND_MANAGER);
904 evt.SetManager(NULL);
905 evt.ResumePropagation(wxEVENT_PROPAGATE_MAX);
906 if (!window->GetEventHandler()->ProcessEvent(evt))
907 return NULL;
908
909 return evt.GetManager();
910 }
911
912
913 void wxAuiManager::UpdateHintWindowConfig()
914 {
915 // find out if the the system can do transparent frames
916 bool can_do_transparent = false;
917
918 wxWindow* w = m_frame;
919 while (w)
920 {
921 if (w->IsKindOf(CLASSINFO(wxFrame)))
922 {
923 wxFrame* f = static_cast<wxFrame*>(w);
924 can_do_transparent = f->CanSetTransparent();
925
926 break;
927 }
928
929 w = w->GetParent();
930 }
931
932 // if there is an existing hint window, delete it
933 if (m_hint_wnd)
934 {
935 m_hint_wnd->Destroy();
936 m_hint_wnd = NULL;
937 }
938
939 m_hint_fademax = 50;
940 m_hint_wnd = NULL;
941
942 if ((m_flags & wxAUI_MGR_TRANSPARENT_HINT) && can_do_transparent)
943 {
944 // Make a window to use for a transparent hint
945 #if defined(__WXMSW__) || defined(__WXGTK__)
946 m_hint_wnd = new wxFrame(m_frame, wxID_ANY, wxEmptyString,
947 wxDefaultPosition, wxSize(1,1),
948 wxFRAME_TOOL_WINDOW |
949 wxFRAME_FLOAT_ON_PARENT |
950 wxFRAME_NO_TASKBAR |
951 wxNO_BORDER);
952
953 m_hint_wnd->SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_ACTIVECAPTION));
954 #elif defined(__WXMAC__)
955 // Using a miniframe with float and tool styles keeps the parent
956 // frame activated and highlighted as such...
957 m_hint_wnd = new wxMiniFrame(m_frame, wxID_ANY, wxEmptyString,
958 wxDefaultPosition, wxSize(1,1),
959 wxFRAME_FLOAT_ON_PARENT
960 | wxFRAME_TOOL_WINDOW );
961 m_hint_wnd->Connect(wxEVT_ACTIVATE,
962 wxActivateEventHandler(wxAuiManager::OnHintActivate), NULL, this);
963
964 // Can't set the bg colour of a Frame in wxMac
965 wxPanel* p = new wxPanel(m_hint_wnd);
966
967 // The default wxSYS_COLOUR_ACTIVECAPTION colour is a light silver
968 // color that is really hard to see, especially transparent.
969 // Until a better system color is decided upon we'll just use
970 // blue.
971 p->SetBackgroundColour(*wxBLUE);
972 #endif
973
974 }
975 else
976 {
977 if ((m_flags & wxAUI_MGR_TRANSPARENT_HINT) != 0 ||
978 (m_flags & wxAUI_MGR_VENETIAN_BLINDS_HINT) != 0)
979 {
980 // system can't support transparent fade, or the venetian
981 // blinds effect was explicitly requested
982 m_hint_wnd = new wxPseudoTransparentFrame(m_frame,
983 wxID_ANY,
984 wxEmptyString,
985 wxDefaultPosition,
986 wxSize(1,1),
987 wxFRAME_TOOL_WINDOW |
988 wxFRAME_FLOAT_ON_PARENT |
989 wxFRAME_NO_TASKBAR |
990 wxNO_BORDER);
991 m_hint_fademax = 128;
992 }
993 }
994 }
995
996
997 // SetManagedWindow() is usually called once when the frame
998 // manager class is being initialized. "frame" specifies
999 // the frame which should be managed by the frame mananger
1000 void wxAuiManager::SetManagedWindow(wxWindow* wnd)
1001 {
1002 wxASSERT_MSG(wnd, wxT("specified window must be non-NULL"));
1003
1004 m_frame = wnd;
1005 m_frame->PushEventHandler(this);
1006
1007 #if wxUSE_MDI
1008 // if the owner is going to manage an MDI parent frame,
1009 // we need to add the MDI client window as the default
1010 // center pane
1011
1012 if (m_frame->IsKindOf(CLASSINFO(wxMDIParentFrame)))
1013 {
1014 wxMDIParentFrame* mdi_frame = (wxMDIParentFrame*)m_frame;
1015 wxWindow* client_window = mdi_frame->GetClientWindow();
1016
1017 wxASSERT_MSG(client_window, wxT("Client window is NULL!"));
1018
1019 AddPane(client_window,
1020 wxAuiPaneInfo().Name(wxT("mdiclient")).
1021 CenterPane().PaneBorder(false));
1022 }
1023 else if (m_frame->IsKindOf(CLASSINFO(wxAuiMDIParentFrame)))
1024 {
1025 wxAuiMDIParentFrame* mdi_frame = (wxAuiMDIParentFrame*)m_frame;
1026 wxAuiMDIClientWindow* client_window = mdi_frame->GetClientWindow();
1027 wxASSERT_MSG(client_window, wxT("Client window is NULL!"));
1028
1029 AddPane(client_window,
1030 wxAuiPaneInfo().Name(wxT("mdiclient")).
1031 CenterPane().PaneBorder(false));
1032 }
1033
1034 #endif
1035
1036 UpdateHintWindowConfig();
1037 }
1038
1039
1040 // UnInit() must be called, usually in the destructor
1041 // of the frame class. If it is not called, usually this
1042 // will result in a crash upon program exit
1043 void wxAuiManager::UnInit()
1044 {
1045 if (m_frame)
1046 {
1047 m_frame->RemoveEventHandler(this);
1048 }
1049 }
1050
1051 // GetManagedWindow() returns the window pointer being managed
1052 wxWindow* wxAuiManager::GetManagedWindow() const
1053 {
1054 return m_frame;
1055 }
1056
1057 wxAuiDockArt* wxAuiManager::GetArtProvider() const
1058 {
1059 return m_art;
1060 }
1061
1062 void wxAuiManager::ProcessMgrEvent(wxAuiManagerEvent& event)
1063 {
1064 // first, give the owner frame a chance to override
1065 if (m_frame)
1066 {
1067 if (m_frame->GetEventHandler()->ProcessEvent(event))
1068 return;
1069 }
1070
1071 ProcessEvent(event);
1072 }
1073
1074 // SetArtProvider() instructs wxAuiManager to use the
1075 // specified art provider for all drawing calls. This allows
1076 // plugable look-and-feel features. The pointer that is
1077 // passed to this method subsequently belongs to wxAuiManager,
1078 // and is deleted in the frame manager destructor
1079 void wxAuiManager::SetArtProvider(wxAuiDockArt* art_provider)
1080 {
1081 // delete the last art provider, if any
1082 delete m_art;
1083
1084 // assign the new art provider
1085 m_art = art_provider;
1086 }
1087
1088
1089 bool wxAuiManager::AddPane(wxWindow* window, const wxAuiPaneInfo& pane_info)
1090 {
1091 wxASSERT_MSG(window, wxT("NULL window ptrs are not allowed"));
1092
1093 // check if the pane has a valid window
1094 if (!window)
1095 return false;
1096
1097 // check if the window is already managed by us
1098 if (GetPane(pane_info.window).IsOk())
1099 return false;
1100
1101 // check if the pane name already exists, this could reveal a
1102 // bug in the library user's application
1103 bool already_exists = false;
1104 if (!pane_info.name.empty() && GetPane(pane_info.name).IsOk())
1105 {
1106 wxFAIL_MSG(wxT("A pane with that name already exists in the manager!"));
1107 already_exists = true;
1108 }
1109
1110 // if the new pane is docked then we should undo maximize
1111 if (pane_info.IsDocked())
1112 RestoreMaximizedPane();
1113
1114 m_panes.Add(pane_info);
1115
1116 wxAuiPaneInfo& pinfo = m_panes.Last();
1117
1118 // set the pane window
1119 pinfo.window = window;
1120
1121
1122 // if the pane's name identifier is blank, create a random string
1123 if (pinfo.name.empty() || already_exists)
1124 {
1125 pinfo.name.Printf(wxT("%08lx%08x%08x%08lx"),
1126 wxPtrToUInt(pinfo.window) & 0xffffffff,
1127 (unsigned int)time(NULL),
1128 #ifdef __WXWINCE__
1129 (unsigned int)GetTickCount(),
1130 #else
1131 (unsigned int)clock(),
1132 #endif
1133 (unsigned long)m_panes.GetCount());
1134 }
1135
1136 // set initial proportion (if not already set)
1137 if (pinfo.dock_proportion == 0)
1138 pinfo.dock_proportion = 100000;
1139
1140 if (pinfo.HasMaximizeButton())
1141 {
1142 wxAuiPaneButton button;
1143 button.button_id = wxAUI_BUTTON_MAXIMIZE_RESTORE;
1144 pinfo.buttons.Add(button);
1145 }
1146
1147 if (pinfo.HasPinButton())
1148 {
1149 wxAuiPaneButton button;
1150 button.button_id = wxAUI_BUTTON_PIN;
1151 pinfo.buttons.Add(button);
1152 }
1153
1154 if (pinfo.HasCloseButton())
1155 {
1156 wxAuiPaneButton button;
1157 button.button_id = wxAUI_BUTTON_CLOSE;
1158 pinfo.buttons.Add(button);
1159 }
1160
1161 if (pinfo.HasGripper())
1162 {
1163 if (pinfo.window->IsKindOf(CLASSINFO(wxAuiToolBar)))
1164 {
1165 // prevent duplicate gripper -- both wxAuiManager and wxAuiToolBar
1166 // have a gripper control. The toolbar's built-in gripper
1167 // meshes better with the look and feel of the control than ours,
1168 // so turn wxAuiManager's gripper off, and the toolbar's on.
1169
1170 wxAuiToolBar* tb = static_cast<wxAuiToolBar*>(pinfo.window);
1171 pinfo.SetFlag(wxAuiPaneInfo::optionGripper, false);
1172 tb->SetGripperVisible(true);
1173 }
1174 }
1175
1176
1177 if (pinfo.best_size == wxDefaultSize &&
1178 pinfo.window)
1179 {
1180 pinfo.best_size = pinfo.window->GetClientSize();
1181
1182 if (pinfo.window->IsKindOf(CLASSINFO(wxToolBar)))
1183 {
1184 // GetClientSize() doesn't get the best size for
1185 // a toolbar under some newer versions of wxWidgets,
1186 // so use GetBestSize()
1187 pinfo.best_size = pinfo.window->GetBestSize();
1188
1189 // for some reason, wxToolBar::GetBestSize() is returning
1190 // a size that is a pixel shy of the correct amount.
1191 // I believe this to be the correct action, until
1192 // wxToolBar::GetBestSize() is fixed. Is this assumption
1193 // correct?
1194 // commented out by JACS 2007-9-08 after having added a pixel in wxMSW's wxToolBar::DoGetBestSize()
1195 // pinfo.best_size.y++;
1196 }
1197
1198 if (pinfo.min_size != wxDefaultSize)
1199 {
1200 if (pinfo.best_size.x < pinfo.min_size.x)
1201 pinfo.best_size.x = pinfo.min_size.x;
1202 if (pinfo.best_size.y < pinfo.min_size.y)
1203 pinfo.best_size.y = pinfo.min_size.y;
1204 }
1205 }
1206
1207
1208
1209 return true;
1210 }
1211
1212 bool wxAuiManager::AddPane(wxWindow* window,
1213 int direction,
1214 const wxString& caption)
1215 {
1216 wxAuiPaneInfo pinfo;
1217 pinfo.Caption(caption);
1218 switch (direction)
1219 {
1220 case wxTOP: pinfo.Top(); break;
1221 case wxBOTTOM: pinfo.Bottom(); break;
1222 case wxLEFT: pinfo.Left(); break;
1223 case wxRIGHT: pinfo.Right(); break;
1224 case wxCENTER: pinfo.CenterPane(); break;
1225 }
1226 return AddPane(window, pinfo);
1227 }
1228
1229 bool wxAuiManager::AddPane(wxWindow* window,
1230 const wxAuiPaneInfo& pane_info,
1231 const wxPoint& drop_pos)
1232 {
1233 if (!AddPane(window, pane_info))
1234 return false;
1235
1236 wxAuiPaneInfo& pane = GetPane(window);
1237
1238 DoDrop(m_docks, m_panes, pane, drop_pos, wxPoint(0,0));
1239
1240 return true;
1241 }
1242
1243 bool wxAuiManager::InsertPane(wxWindow* window, const wxAuiPaneInfo& pane_info,
1244 int insert_level)
1245 {
1246 wxASSERT_MSG(window, wxT("NULL window ptrs are not allowed"));
1247
1248 // shift the panes around, depending on the insert level
1249 switch (insert_level)
1250 {
1251 case wxAUI_INSERT_PANE:
1252 DoInsertPane(m_panes,
1253 pane_info.dock_direction,
1254 pane_info.dock_layer,
1255 pane_info.dock_row,
1256 pane_info.dock_pos);
1257 break;
1258 case wxAUI_INSERT_ROW:
1259 DoInsertDockRow(m_panes,
1260 pane_info.dock_direction,
1261 pane_info.dock_layer,
1262 pane_info.dock_row);
1263 break;
1264 case wxAUI_INSERT_DOCK:
1265 DoInsertDockLayer(m_panes,
1266 pane_info.dock_direction,
1267 pane_info.dock_layer);
1268 break;
1269 }
1270
1271 // if the window already exists, we are basically just moving/inserting the
1272 // existing window. If it doesn't exist, we need to add it and insert it
1273 wxAuiPaneInfo& existing_pane = GetPane(window);
1274 if (!existing_pane.IsOk())
1275 {
1276 return AddPane(window, pane_info);
1277 }
1278 else
1279 {
1280 if (pane_info.IsFloating())
1281 {
1282 existing_pane.Float();
1283 if (pane_info.floating_pos != wxDefaultPosition)
1284 existing_pane.FloatingPosition(pane_info.floating_pos);
1285 if (pane_info.floating_size != wxDefaultSize)
1286 existing_pane.FloatingSize(pane_info.floating_size);
1287 }
1288 else
1289 {
1290 // if the new pane is docked then we should undo maximize
1291 RestoreMaximizedPane();
1292
1293 existing_pane.Direction(pane_info.dock_direction);
1294 existing_pane.Layer(pane_info.dock_layer);
1295 existing_pane.Row(pane_info.dock_row);
1296 existing_pane.Position(pane_info.dock_pos);
1297 }
1298 }
1299
1300 return true;
1301 }
1302
1303
1304 // DetachPane() removes a pane from the frame manager. This
1305 // method will not destroy the window that is removed.
1306 bool wxAuiManager::DetachPane(wxWindow* window)
1307 {
1308 wxASSERT_MSG(window, wxT("NULL window ptrs are not allowed"));
1309
1310 int i, count;
1311 for (i = 0, count = m_panes.GetCount(); i < count; ++i)
1312 {
1313 wxAuiPaneInfo& p = m_panes.Item(i);
1314 if (p.window == window)
1315 {
1316 if (p.frame)
1317 {
1318 // we have a floating frame which is being detached. We need to
1319 // reparent it to m_frame and destroy the floating frame
1320
1321 // reduce flicker
1322 p.window->SetSize(1,1);
1323
1324 if (p.frame->IsShown())
1325 p.frame->Show(false);
1326
1327 // reparent to m_frame and destroy the pane
1328 if (m_action_window == p.frame)
1329 {
1330 m_action_window = NULL;
1331 }
1332
1333 p.window->Reparent(m_frame);
1334 p.frame->SetSizer(NULL);
1335 p.frame->Destroy();
1336 p.frame = NULL;
1337 }
1338
1339 // make sure there are no references to this pane in our uiparts,
1340 // just in case the caller doesn't call Update() immediately after
1341 // the DetachPane() call. This prevets obscure crashes which would
1342 // happen at window repaint if the caller forgets to call Update()
1343 int pi, part_count;
1344 for (pi = 0, part_count = (int)m_uiparts.GetCount(); pi < part_count; ++pi)
1345 {
1346 wxAuiDockUIPart& part = m_uiparts.Item(pi);
1347 if (part.pane == &p)
1348 {
1349 m_uiparts.RemoveAt(pi);
1350 part_count--;
1351 pi--;
1352 continue;
1353 }
1354 }
1355
1356 m_panes.RemoveAt(i);
1357 return true;
1358 }
1359 }
1360 return false;
1361 }
1362
1363 // ClosePane() destroys or hides the pane depending on its flags
1364 void wxAuiManager::ClosePane(wxAuiPaneInfo& pane_info)
1365 {
1366 // if we were maximized, restore
1367 if (pane_info.IsMaximized())
1368 {
1369 RestorePane(pane_info);
1370 }
1371
1372 // first, hide the window
1373 if (pane_info.window && pane_info.window->IsShown())
1374 {
1375 pane_info.window->Show(false);
1376 }
1377
1378 // make sure that we are the parent of this window
1379 if (pane_info.window && pane_info.window->GetParent() != m_frame)
1380 {
1381 pane_info.window->Reparent(m_frame);
1382 }
1383
1384 // if we have a frame, destroy it
1385 if (pane_info.frame)
1386 {
1387 pane_info.frame->Destroy();
1388 pane_info.frame = NULL;
1389 }
1390
1391 // now we need to either destroy or hide the pane
1392 if (pane_info.IsDestroyOnClose())
1393 {
1394 wxWindow * window = pane_info.window;
1395 DetachPane(window);
1396 if (window)
1397 {
1398 window->Destroy();
1399 }
1400 }
1401 else
1402 {
1403 pane_info.Hide();
1404 }
1405 }
1406
1407 void wxAuiManager::MaximizePane(wxAuiPaneInfo& pane_info)
1408 {
1409 int i, pane_count;
1410
1411 // un-maximize and hide all other panes
1412 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
1413 {
1414 wxAuiPaneInfo& p = m_panes.Item(i);
1415 if (!p.IsToolbar() && !p.IsFloating())
1416 {
1417 p.Restore();
1418
1419 // save hidden state
1420 p.SetFlag(wxAuiPaneInfo::savedHiddenState,
1421 p.HasFlag(wxAuiPaneInfo::optionHidden));
1422
1423 // hide the pane, because only the newly
1424 // maximized pane should show
1425 p.Hide();
1426 }
1427 }
1428
1429 // mark ourselves maximized
1430 pane_info.Maximize();
1431 pane_info.Show();
1432 m_has_maximized = true;
1433
1434 // last, show the window
1435 if (pane_info.window && !pane_info.window->IsShown())
1436 {
1437 pane_info.window->Show(true);
1438 }
1439 }
1440
1441 void wxAuiManager::RestorePane(wxAuiPaneInfo& pane_info)
1442 {
1443 int i, pane_count;
1444
1445 // restore all the panes
1446 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
1447 {
1448 wxAuiPaneInfo& p = m_panes.Item(i);
1449 if (!p.IsToolbar())
1450 {
1451 p.SetFlag(wxAuiPaneInfo::optionHidden,
1452 p.HasFlag(wxAuiPaneInfo::savedHiddenState));
1453 }
1454 }
1455
1456 // mark ourselves non-maximized
1457 pane_info.Restore();
1458 m_has_maximized = false;
1459
1460 // last, show the window
1461 if (pane_info.window && !pane_info.window->IsShown())
1462 {
1463 pane_info.window->Show(true);
1464 }
1465 }
1466
1467 void wxAuiManager::RestoreMaximizedPane()
1468 {
1469 int i, pane_count;
1470
1471 // restore all the panes
1472 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
1473 {
1474 wxAuiPaneInfo& p = m_panes.Item(i);
1475 if (p.IsMaximized())
1476 {
1477 RestorePane(p);
1478 break;
1479 }
1480 }
1481 }
1482
1483 // EscapeDelimiters() changes ";" into "\;" and "|" into "\|"
1484 // in the input string. This is an internal functions which is
1485 // used for saving perspectives
1486 static wxString EscapeDelimiters(const wxString& s)
1487 {
1488 wxString result;
1489 result.Alloc(s.length());
1490 const wxChar* ch = s.c_str();
1491 while (*ch)
1492 {
1493 if (*ch == wxT(';') || *ch == wxT('|'))
1494 result += wxT('\\');
1495 result += *ch;
1496 ++ch;
1497 }
1498 return result;
1499 }
1500
1501 wxString wxAuiManager::SavePaneInfo(wxAuiPaneInfo& pane)
1502 {
1503 wxString result = wxT("name=");
1504 result += EscapeDelimiters(pane.name);
1505 result += wxT(";");
1506
1507 result += wxT("caption=");
1508 result += EscapeDelimiters(pane.caption);
1509 result += wxT(";");
1510
1511 result += wxString::Format(wxT("state=%u;"), pane.state);
1512 result += wxString::Format(wxT("dir=%d;"), pane.dock_direction);
1513 result += wxString::Format(wxT("layer=%d;"), pane.dock_layer);
1514 result += wxString::Format(wxT("row=%d;"), pane.dock_row);
1515 result += wxString::Format(wxT("pos=%d;"), pane.dock_pos);
1516 result += wxString::Format(wxT("prop=%d;"), pane.dock_proportion);
1517 result += wxString::Format(wxT("bestw=%d;"), pane.best_size.x);
1518 result += wxString::Format(wxT("besth=%d;"), pane.best_size.y);
1519 result += wxString::Format(wxT("minw=%d;"), pane.min_size.x);
1520 result += wxString::Format(wxT("minh=%d;"), pane.min_size.y);
1521 result += wxString::Format(wxT("maxw=%d;"), pane.max_size.x);
1522 result += wxString::Format(wxT("maxh=%d;"), pane.max_size.y);
1523 result += wxString::Format(wxT("floatx=%d;"), pane.floating_pos.x);
1524 result += wxString::Format(wxT("floaty=%d;"), pane.floating_pos.y);
1525 result += wxString::Format(wxT("floatw=%d;"), pane.floating_size.x);
1526 result += wxString::Format(wxT("floath=%d"), pane.floating_size.y);
1527
1528 return result;
1529 }
1530
1531 // Load a "pane" with the pane infor settings in pane_part
1532 void wxAuiManager::LoadPaneInfo(wxString pane_part, wxAuiPaneInfo &pane)
1533 {
1534 // replace escaped characters so we can
1535 // split up the string easily
1536 pane_part.Replace(wxT("\\|"), wxT("\a"));
1537 pane_part.Replace(wxT("\\;"), wxT("\b"));
1538
1539 while(1)
1540 {
1541 wxString val_part = pane_part.BeforeFirst(wxT(';'));
1542 pane_part = pane_part.AfterFirst(wxT(';'));
1543 wxString val_name = val_part.BeforeFirst(wxT('='));
1544 wxString value = val_part.AfterFirst(wxT('='));
1545 val_name.MakeLower();
1546 val_name.Trim(true);
1547 val_name.Trim(false);
1548 value.Trim(true);
1549 value.Trim(false);
1550
1551 if (val_name.empty())
1552 break;
1553
1554 if (val_name == wxT("name"))
1555 pane.name = value;
1556 else if (val_name == wxT("caption"))
1557 pane.caption = value;
1558 else if (val_name == wxT("state"))
1559 pane.state = (unsigned int)wxAtoi(value.c_str());
1560 else if (val_name == wxT("dir"))
1561 pane.dock_direction = wxAtoi(value.c_str());
1562 else if (val_name == wxT("layer"))
1563 pane.dock_layer = wxAtoi(value.c_str());
1564 else if (val_name == wxT("row"))
1565 pane.dock_row = wxAtoi(value.c_str());
1566 else if (val_name == wxT("pos"))
1567 pane.dock_pos = wxAtoi(value.c_str());
1568 else if (val_name == wxT("prop"))
1569 pane.dock_proportion = wxAtoi(value.c_str());
1570 else if (val_name == wxT("bestw"))
1571 pane.best_size.x = wxAtoi(value.c_str());
1572 else if (val_name == wxT("besth"))
1573 pane.best_size.y = wxAtoi(value.c_str());
1574 else if (val_name == wxT("minw"))
1575 pane.min_size.x = wxAtoi(value.c_str());
1576 else if (val_name == wxT("minh"))
1577 pane.min_size.y = wxAtoi(value.c_str());
1578 else if (val_name == wxT("maxw"))
1579 pane.max_size.x = wxAtoi(value.c_str());
1580 else if (val_name == wxT("maxh"))
1581 pane.max_size.y = wxAtoi(value.c_str());
1582 else if (val_name == wxT("floatx"))
1583 pane.floating_pos.x = wxAtoi(value.c_str());
1584 else if (val_name == wxT("floaty"))
1585 pane.floating_pos.y = wxAtoi(value.c_str());
1586 else if (val_name == wxT("floatw"))
1587 pane.floating_size.x = wxAtoi(value.c_str());
1588 else if (val_name == wxT("floath"))
1589 pane.floating_size.y = wxAtoi(value.c_str());
1590 else {
1591 wxFAIL_MSG(wxT("Bad Perspective String"));
1592 }
1593 }
1594
1595 // replace escaped characters so we can
1596 // split up the string easily
1597 pane.name.Replace(wxT("\a"), wxT("|"));
1598 pane.name.Replace(wxT("\b"), wxT(";"));
1599 pane.caption.Replace(wxT("\a"), wxT("|"));
1600 pane.caption.Replace(wxT("\b"), wxT(";"));
1601 pane_part.Replace(wxT("\a"), wxT("|"));
1602 pane_part.Replace(wxT("\b"), wxT(";"));
1603
1604 return;
1605 }
1606
1607
1608 // SavePerspective() saves all pane information as a single string.
1609 // This string may later be fed into LoadPerspective() to restore
1610 // all pane settings. This save and load mechanism allows an
1611 // exact pane configuration to be saved and restored at a later time
1612
1613 wxString wxAuiManager::SavePerspective()
1614 {
1615 wxString result;
1616 result.Alloc(500);
1617 result = wxT("layout2|");
1618
1619 int pane_i, pane_count = m_panes.GetCount();
1620 for (pane_i = 0; pane_i < pane_count; ++pane_i)
1621 {
1622 wxAuiPaneInfo& pane = m_panes.Item(pane_i);
1623 result += SavePaneInfo(pane)+wxT("|");
1624 }
1625
1626 int dock_i, dock_count = m_docks.GetCount();
1627 for (dock_i = 0; dock_i < dock_count; ++dock_i)
1628 {
1629 wxAuiDockInfo& dock = m_docks.Item(dock_i);
1630
1631 result += wxString::Format(wxT("dock_size(%d,%d,%d)=%d|"),
1632 dock.dock_direction, dock.dock_layer,
1633 dock.dock_row, dock.size);
1634 }
1635
1636 return result;
1637 }
1638
1639 // LoadPerspective() loads a layout which was saved with SavePerspective()
1640 // If the "update" flag parameter is true, the GUI will immediately be updated
1641
1642 bool wxAuiManager::LoadPerspective(const wxString& layout, bool update)
1643 {
1644 wxString input = layout;
1645 wxString part;
1646
1647 // check layout string version
1648 // 'layout1' = wxAUI 0.9.0 - wxAUI 0.9.2
1649 // 'layout2' = wxAUI 0.9.2 (wxWidgets 2.8)
1650 part = input.BeforeFirst(wxT('|'));
1651 input = input.AfterFirst(wxT('|'));
1652 part.Trim(true);
1653 part.Trim(false);
1654 if (part != wxT("layout2"))
1655 return false;
1656
1657 // mark all panes currently managed as docked and hidden
1658 int pane_i, pane_count = m_panes.GetCount();
1659 for (pane_i = 0; pane_i < pane_count; ++pane_i)
1660 m_panes.Item(pane_i).Dock().Hide();
1661
1662 // clear out the dock array; this will be reconstructed
1663 m_docks.Clear();
1664
1665 // replace escaped characters so we can
1666 // split up the string easily
1667 input.Replace(wxT("\\|"), wxT("\a"));
1668 input.Replace(wxT("\\;"), wxT("\b"));
1669
1670 while (1)
1671 {
1672 wxAuiPaneInfo pane;
1673
1674 wxString pane_part = input.BeforeFirst(wxT('|'));
1675 input = input.AfterFirst(wxT('|'));
1676 pane_part.Trim(true);
1677
1678 // if the string is empty, we're done parsing
1679 if (pane_part.empty())
1680 break;
1681
1682 if (pane_part.Left(9) == wxT("dock_size"))
1683 {
1684 wxString val_name = pane_part.BeforeFirst(wxT('='));
1685 wxString value = pane_part.AfterFirst(wxT('='));
1686
1687 long dir, layer, row, size;
1688 wxString piece = val_name.AfterFirst(wxT('('));
1689 piece = piece.BeforeLast(wxT(')'));
1690 piece.BeforeFirst(wxT(',')).ToLong(&dir);
1691 piece = piece.AfterFirst(wxT(','));
1692 piece.BeforeFirst(wxT(',')).ToLong(&layer);
1693 piece.AfterFirst(wxT(',')).ToLong(&row);
1694 value.ToLong(&size);
1695
1696 wxAuiDockInfo dock;
1697 dock.dock_direction = dir;
1698 dock.dock_layer = layer;
1699 dock.dock_row = row;
1700 dock.size = size;
1701 m_docks.Add(dock);
1702 continue;
1703 }
1704
1705 // Undo our escaping as LoadPaneInfo needs to take an unescaped
1706 // name so it can be called by external callers
1707 pane_part.Replace(wxT("\a"), wxT("|"));
1708 pane_part.Replace(wxT("\b"), wxT(";"));
1709
1710 LoadPaneInfo(pane_part, pane);
1711
1712 wxAuiPaneInfo& p = GetPane(pane.name);
1713 if (!p.IsOk())
1714 {
1715 // the pane window couldn't be found
1716 // in the existing layout -- skip it
1717 continue;
1718 }
1719
1720 p.SafeSet(pane);
1721 }
1722
1723 if (update)
1724 Update();
1725
1726 return true;
1727 }
1728
1729 void wxAuiManager::GetPanePositionsAndSizes(wxAuiDockInfo& dock,
1730 wxArrayInt& positions,
1731 wxArrayInt& sizes)
1732 {
1733 int caption_size = m_art->GetMetric(wxAUI_DOCKART_CAPTION_SIZE);
1734 int pane_border_size = m_art->GetMetric(wxAUI_DOCKART_PANE_BORDER_SIZE);
1735 int gripper_size = m_art->GetMetric(wxAUI_DOCKART_GRIPPER_SIZE);
1736
1737 positions.Empty();
1738 sizes.Empty();
1739
1740 int offset, action_pane = -1;
1741 int pane_i, pane_count = dock.panes.GetCount();
1742
1743 // find the pane marked as our action pane
1744 for (pane_i = 0; pane_i < pane_count; ++pane_i)
1745 {
1746 wxAuiPaneInfo& pane = *(dock.panes.Item(pane_i));
1747
1748 if (pane.HasFlag(wxAuiPaneInfo::actionPane))
1749 {
1750 wxASSERT_MSG(action_pane==-1, wxT("Too many fixed action panes"));
1751 action_pane = pane_i;
1752 }
1753 }
1754
1755 // set up each panes default position, and
1756 // determine the size (width or height, depending
1757 // on the dock's orientation) of each pane
1758 for (pane_i = 0; pane_i < pane_count; ++pane_i)
1759 {
1760 wxAuiPaneInfo& pane = *(dock.panes.Item(pane_i));
1761 positions.Add(pane.dock_pos);
1762 int size = 0;
1763
1764 if (pane.HasBorder())
1765 size += (pane_border_size*2);
1766
1767 if (dock.IsHorizontal())
1768 {
1769 if (pane.HasGripper() && !pane.HasGripperTop())
1770 size += gripper_size;
1771 size += pane.best_size.x;
1772 }
1773 else
1774 {
1775 if (pane.HasGripper() && pane.HasGripperTop())
1776 size += gripper_size;
1777
1778 if (pane.HasCaption())
1779 size += caption_size;
1780 size += pane.best_size.y;
1781 }
1782
1783 sizes.Add(size);
1784 }
1785
1786 // if there is no action pane, just return the default
1787 // positions (as specified in pane.pane_pos)
1788 if (action_pane == -1)
1789 return;
1790
1791 offset = 0;
1792 for (pane_i = action_pane-1; pane_i >= 0; --pane_i)
1793 {
1794 int amount = positions[pane_i+1] - (positions[pane_i] + sizes[pane_i]);
1795
1796 if (amount >= 0)
1797 offset += amount;
1798 else
1799 positions[pane_i] -= -amount;
1800
1801 offset += sizes[pane_i];
1802 }
1803
1804 // if the dock mode is fixed, make sure none of the panes
1805 // overlap; we will bump panes that overlap
1806 offset = 0;
1807 for (pane_i = action_pane; pane_i < pane_count; ++pane_i)
1808 {
1809 int amount = positions[pane_i] - offset;
1810 if (amount >= 0)
1811 offset += amount;
1812 else
1813 positions[pane_i] += -amount;
1814
1815 offset += sizes[pane_i];
1816 }
1817 }
1818
1819
1820 void wxAuiManager::LayoutAddPane(wxSizer* cont,
1821 wxAuiDockInfo& dock,
1822 wxAuiPaneInfo& pane,
1823 wxAuiDockUIPartArray& uiparts,
1824 bool spacer_only)
1825 {
1826 wxAuiDockUIPart part;
1827 wxSizerItem* sizer_item;
1828
1829 int caption_size = m_art->GetMetric(wxAUI_DOCKART_CAPTION_SIZE);
1830 int gripper_size = m_art->GetMetric(wxAUI_DOCKART_GRIPPER_SIZE);
1831 int pane_border_size = m_art->GetMetric(wxAUI_DOCKART_PANE_BORDER_SIZE);
1832 int pane_button_size = m_art->GetMetric(wxAUI_DOCKART_PANE_BUTTON_SIZE);
1833
1834 // find out the orientation of the item (orientation for panes
1835 // is the same as the dock's orientation)
1836 int orientation;
1837 if (dock.IsHorizontal())
1838 orientation = wxHORIZONTAL;
1839 else
1840 orientation = wxVERTICAL;
1841
1842 // this variable will store the proportion
1843 // value that the pane will receive
1844 int pane_proportion = pane.dock_proportion;
1845
1846 wxAuiProportionalBoxSizer* horz_pane_sizer = new wxAuiProportionalBoxSizer(wxHORIZONTAL);
1847 wxAuiProportionalBoxSizer* vert_pane_sizer = new wxAuiProportionalBoxSizer(wxVERTICAL);
1848
1849 if (pane.HasGripper())
1850 {
1851 if (pane.HasGripperTop())
1852 sizer_item = vert_pane_sizer ->Add(1, gripper_size, 0, wxEXPAND);
1853 else
1854 sizer_item = horz_pane_sizer ->Add(gripper_size, 1, 0, wxEXPAND);
1855
1856 part.type = wxAuiDockUIPart::typeGripper;
1857 part.dock = &dock;
1858 part.pane = &pane;
1859 part.button = NULL;
1860 part.orientation = orientation;
1861 part.cont_sizer = horz_pane_sizer;
1862 part.sizer_item = sizer_item;
1863 uiparts.Add(part);
1864 }
1865
1866 if (pane.HasCaption())
1867 {
1868 // create the caption sizer
1869 wxAuiProportionalBoxSizer* caption_sizer = new wxAuiProportionalBoxSizer(wxHORIZONTAL);
1870
1871 sizer_item = caption_sizer->Add(1, caption_size, 1, wxEXPAND);
1872
1873 part.type = wxAuiDockUIPart::typeCaption;
1874 part.dock = &dock;
1875 part.pane = &pane;
1876 part.button = NULL;
1877 part.orientation = orientation;
1878 part.cont_sizer = vert_pane_sizer;
1879 part.sizer_item = sizer_item;
1880 int caption_part_idx = uiparts.GetCount();
1881 uiparts.Add(part);
1882
1883 // add pane buttons to the caption
1884 int i, button_count;
1885 for (i = 0, button_count = pane.buttons.GetCount();
1886 i < button_count; ++i)
1887 {
1888 wxAuiPaneButton& button = pane.buttons.Item(i);
1889
1890 sizer_item = caption_sizer->Add(pane_button_size,
1891 caption_size,
1892 0, wxEXPAND);
1893
1894 part.type = wxAuiDockUIPart::typePaneButton;
1895 part.dock = &dock;
1896 part.pane = &pane;
1897 part.button = &button;
1898 part.orientation = orientation;
1899 part.cont_sizer = caption_sizer;
1900 part.sizer_item = sizer_item;
1901 uiparts.Add(part);
1902 }
1903
1904 // if we have buttons, add a little space to the right
1905 // of them to ease visual crowding
1906 if (button_count >= 1)
1907 {
1908 caption_sizer->Add(3,1);
1909 }
1910
1911 // add the caption sizer
1912 sizer_item = vert_pane_sizer->Add(caption_sizer, 0, wxEXPAND);
1913
1914 uiparts.Item(caption_part_idx).sizer_item = sizer_item;
1915 }
1916
1917 // add the pane window itself
1918 if (spacer_only)
1919 {
1920 sizer_item = vert_pane_sizer->Add(1, 1, 1, wxEXPAND);
1921 }
1922 else
1923 {
1924 sizer_item = vert_pane_sizer->Add(pane.window, 1, wxEXPAND);
1925 // Don't do this because it breaks the pane size in floating windows
1926 // BIW: Right now commenting this out is causing problems with
1927 // an mdi client window as the center pane.
1928 vert_pane_sizer->SetItemMinSize(pane.window, 1, 1);
1929 }
1930
1931 part.type = wxAuiDockUIPart::typePane;
1932 part.dock = &dock;
1933 part.pane = &pane;
1934 part.button = NULL;
1935 part.orientation = orientation;
1936 part.cont_sizer = vert_pane_sizer;
1937 part.sizer_item = sizer_item;
1938 uiparts.Add(part);
1939
1940
1941 // determine if the pane should have a minimum size; if the pane is
1942 // non-resizable (fixed) then we must set a minimum size. Alternatively,
1943 // if the pane.min_size is set, we must use that value as well
1944
1945 wxSize min_size = pane.min_size;
1946 if (pane.IsFixed())
1947 {
1948 if (min_size == wxDefaultSize)
1949 {
1950 min_size = pane.best_size;
1951 pane_proportion = 0;
1952 }
1953 }
1954
1955 if (min_size != wxDefaultSize)
1956 {
1957 vert_pane_sizer->SetItemMinSize(
1958 vert_pane_sizer->GetChildren().GetCount()-1,
1959 min_size.x, min_size.y);
1960 }
1961
1962
1963 // add the verticle sizer (caption, pane window) to the
1964 // horizontal sizer (gripper, verticle sizer)
1965 horz_pane_sizer->Add(vert_pane_sizer, 1, wxEXPAND);
1966
1967 // finally, add the pane sizer to the dock sizer
1968
1969 if (pane.HasBorder())
1970 {
1971 // allowing space for the pane's border
1972 sizer_item = cont->Add(horz_pane_sizer, pane_proportion,
1973 wxEXPAND | wxALL, pane_border_size);
1974
1975 part.type = wxAuiDockUIPart::typePaneBorder;
1976 part.dock = &dock;
1977 part.pane = &pane;
1978 part.button = NULL;
1979 part.orientation = orientation;
1980 part.cont_sizer = cont;
1981 part.sizer_item = sizer_item;
1982 uiparts.Add(part);
1983 }
1984 else
1985 {
1986 sizer_item = cont->Add(horz_pane_sizer, pane_proportion, wxEXPAND);
1987 }
1988 }
1989
1990 void wxAuiManager::LayoutAddDock(wxSizer* cont,
1991 wxAuiDockInfo& dock,
1992 wxAuiDockUIPartArray& uiparts,
1993 bool spacer_only)
1994 {
1995 wxSizerItem* sizer_item;
1996 wxAuiDockUIPart part;
1997
1998 int sash_size = m_art->GetMetric(wxAUI_DOCKART_SASH_SIZE);
1999 int orientation = dock.IsHorizontal() ? wxHORIZONTAL : wxVERTICAL;
2000
2001 // resizable bottom and right docks have a sash before them
2002 if (!m_has_maximized && !dock.fixed && (dock.dock_direction == wxAUI_DOCK_BOTTOM ||
2003 dock.dock_direction == wxAUI_DOCK_RIGHT))
2004 {
2005 sizer_item = cont->Add(sash_size, sash_size, 0, wxEXPAND);
2006
2007 part.type = wxAuiDockUIPart::typeDockSizer;
2008 part.orientation = orientation;
2009 part.dock = &dock;
2010 part.pane = NULL;
2011 part.button = NULL;
2012 part.cont_sizer = cont;
2013 part.sizer_item = sizer_item;
2014 uiparts.Add(part);
2015 }
2016
2017 // create the sizer for the dock
2018 wxSizer* dock_sizer = new wxAuiProportionalBoxSizer(orientation);
2019
2020 // add each pane to the dock
2021 bool has_maximized_pane = false;
2022 int pane_i, pane_count = dock.panes.GetCount();
2023
2024 if (dock.fixed)
2025 {
2026 wxArrayInt pane_positions, pane_sizes;
2027
2028 // figure out the real pane positions we will
2029 // use, without modifying the each pane's pane_pos member
2030 GetPanePositionsAndSizes(dock, pane_positions, pane_sizes);
2031
2032 int offset = 0;
2033 for (pane_i = 0; pane_i < pane_count; ++pane_i)
2034 {
2035 wxAuiPaneInfo& pane = *(dock.panes.Item(pane_i));
2036 int pane_pos = pane_positions.Item(pane_i);
2037
2038 if (pane.IsMaximized())
2039 has_maximized_pane = true;
2040
2041
2042 int amount = pane_pos - offset;
2043 if (amount > 0)
2044 {
2045 if (dock.IsVertical())
2046 sizer_item = dock_sizer->Add(1, amount, 0, wxEXPAND);
2047 else
2048 sizer_item = dock_sizer->Add(amount, 1, 0, wxEXPAND);
2049
2050 part.type = wxAuiDockUIPart::typeBackground;
2051 part.dock = &dock;
2052 part.pane = NULL;
2053 part.button = NULL;
2054 part.orientation = (orientation==wxHORIZONTAL) ? wxVERTICAL:wxHORIZONTAL;
2055 part.cont_sizer = dock_sizer;
2056 part.sizer_item = sizer_item;
2057 uiparts.Add(part);
2058
2059 offset += amount;
2060 }
2061
2062 LayoutAddPane(dock_sizer, dock, pane, uiparts, spacer_only);
2063
2064 offset += pane_sizes.Item(pane_i);
2065 }
2066
2067 // at the end add a very small stretchable background area
2068 sizer_item = dock_sizer->Add(0,0, 1, wxEXPAND);
2069
2070 part.type = wxAuiDockUIPart::typeBackground;
2071 part.dock = &dock;
2072 part.pane = NULL;
2073 part.button = NULL;
2074 part.orientation = orientation;
2075 part.cont_sizer = dock_sizer;
2076 part.sizer_item = sizer_item;
2077 uiparts.Add(part);
2078 }
2079 else
2080 {
2081 for (pane_i = 0; pane_i < pane_count; ++pane_i)
2082 {
2083 wxAuiPaneInfo& pane = *(dock.panes.Item(pane_i));
2084
2085 if (pane.IsMaximized())
2086 has_maximized_pane = true;
2087
2088 // if this is not the first pane being added,
2089 // we need to add a pane sizer
2090 if (!m_has_maximized && pane_i > 0)
2091 {
2092 sizer_item = dock_sizer->Add(sash_size, sash_size, 0, wxEXPAND);
2093
2094 part.type = wxAuiDockUIPart::typePaneSizer;
2095 part.dock = &dock;
2096 part.pane = dock.panes.Item(pane_i-1);
2097 part.button = NULL;
2098 part.orientation = (orientation==wxHORIZONTAL) ? wxVERTICAL:wxHORIZONTAL;
2099 part.cont_sizer = dock_sizer;
2100 part.sizer_item = sizer_item;
2101 uiparts.Add(part);
2102 }
2103
2104 LayoutAddPane(dock_sizer, dock, pane, uiparts, spacer_only);
2105 }
2106 }
2107
2108 if (dock.dock_direction == wxAUI_DOCK_CENTER || has_maximized_pane)
2109 sizer_item = cont->Add(dock_sizer, 1, wxEXPAND);
2110 else
2111 sizer_item = cont->Add(dock_sizer, 0, wxEXPAND);
2112
2113 part.type = wxAuiDockUIPart::typeDock;
2114 part.dock = &dock;
2115 part.pane = NULL;
2116 part.button = NULL;
2117 part.orientation = orientation;
2118 part.cont_sizer = cont;
2119 part.sizer_item = sizer_item;
2120 uiparts.Add(part);
2121
2122 if (dock.IsHorizontal())
2123 cont->SetItemMinSize(dock_sizer, 0, dock.size);
2124 else
2125 cont->SetItemMinSize(dock_sizer, dock.size, 0);
2126
2127 // top and left docks have a sash after them
2128 if (!m_has_maximized &&
2129 !dock.fixed &&
2130 (dock.dock_direction == wxAUI_DOCK_TOP ||
2131 dock.dock_direction == wxAUI_DOCK_LEFT))
2132 {
2133 sizer_item = cont->Add(sash_size, sash_size, 0, wxEXPAND);
2134
2135 part.type = wxAuiDockUIPart::typeDockSizer;
2136 part.dock = &dock;
2137 part.pane = NULL;
2138 part.button = NULL;
2139 part.orientation = orientation;
2140 part.cont_sizer = cont;
2141 part.sizer_item = sizer_item;
2142 uiparts.Add(part);
2143 }
2144 }
2145
2146 wxSizer* wxAuiManager::LayoutAll(wxAuiPaneInfoArray& panes,
2147 wxAuiDockInfoArray& docks,
2148 wxAuiDockUIPartArray& uiparts,
2149 bool spacer_only)
2150 {
2151 wxAuiProportionalBoxSizer* container = new wxAuiProportionalBoxSizer(wxVERTICAL);
2152
2153 int pane_border_size = m_art->GetMetric(wxAUI_DOCKART_PANE_BORDER_SIZE);
2154 int caption_size = m_art->GetMetric(wxAUI_DOCKART_CAPTION_SIZE);
2155 wxSize cli_size = m_frame->GetClientSize();
2156 int i, dock_count, pane_count;
2157
2158
2159 // empty all docks out
2160 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
2161 {
2162 wxAuiDockInfo& dock = docks.Item(i);
2163
2164 // empty out all panes, as they will be readded below
2165 dock.panes.Empty();
2166
2167 if (dock.fixed)
2168 {
2169 // always reset fixed docks' sizes, because
2170 // the contained windows may have been resized
2171 dock.size = 0;
2172 }
2173 }
2174
2175
2176 // iterate through all known panes, filing each
2177 // of them into the appropriate dock. If the
2178 // pane does not exist in the dock, add it
2179 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
2180 {
2181 wxAuiPaneInfo& p = panes.Item(i);
2182
2183 // find any docks with the same dock direction, dock layer, and
2184 // dock row as the pane we are working on
2185 wxAuiDockInfo* dock;
2186 wxAuiDockInfoPtrArray arr;
2187 FindDocks(docks, p.dock_direction, p.dock_layer, p.dock_row, arr);
2188
2189 if (arr.GetCount() > 0)
2190 {
2191 // found the right dock
2192 dock = arr.Item(0);
2193 }
2194 else
2195 {
2196 // dock was not found, so we need to create a new one
2197 wxAuiDockInfo d;
2198 d.dock_direction = p.dock_direction;
2199 d.dock_layer = p.dock_layer;
2200 d.dock_row = p.dock_row;
2201 docks.Add(d);
2202 dock = &docks.Last();
2203 }
2204
2205
2206 if (p.IsDocked() && p.IsShown())
2207 {
2208 // remove the pane from any existing docks except this one
2209 RemovePaneFromDocks(docks, p, dock);
2210
2211 // pane needs to be added to the dock,
2212 // if it doesn't already exist
2213 if (!FindPaneInDock(*dock, p.window))
2214 dock->panes.Add(&p);
2215 }
2216 else
2217 {
2218 // remove the pane from any existing docks
2219 RemovePaneFromDocks(docks, p);
2220 }
2221
2222 }
2223
2224 // remove any empty docks
2225 for (i = docks.GetCount()-1; i >= 0; --i)
2226 {
2227 if (docks.Item(i).panes.GetCount() == 0)
2228 docks.RemoveAt(i);
2229 }
2230
2231 // configure the docks further
2232 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
2233 {
2234 wxAuiDockInfo& dock = docks.Item(i);
2235 int j, dock_pane_count = dock.panes.GetCount();
2236
2237 // sort the dock pane array by the pane's
2238 // dock position (dock_pos), in ascending order
2239 dock.panes.Sort(PaneSortFunc);
2240
2241 // for newly created docks, set up their initial size
2242 if (dock.size == 0)
2243 {
2244 int size = 0;
2245
2246 for (j = 0; j < dock_pane_count; ++j)
2247 {
2248 wxAuiPaneInfo& pane = *dock.panes.Item(j);
2249 wxSize pane_size = pane.best_size;
2250 if (pane_size == wxDefaultSize)
2251 pane_size = pane.min_size;
2252 if (pane_size == wxDefaultSize)
2253 pane_size = pane.window->GetSize();
2254
2255 if (dock.IsHorizontal())
2256 size = wxMax(pane_size.y, size);
2257 else
2258 size = wxMax(pane_size.x, size);
2259 }
2260
2261 // add space for the border (two times), but only
2262 // if at least one pane inside the dock has a pane border
2263 for (j = 0; j < dock_pane_count; ++j)
2264 {
2265 if (dock.panes.Item(j)->HasBorder())
2266 {
2267 size += (pane_border_size*2);
2268 break;
2269 }
2270 }
2271
2272 // if pane is on the top or bottom, add the caption height,
2273 // but only if at least one pane inside the dock has a caption
2274 if (dock.IsHorizontal())
2275 {
2276 for (j = 0; j < dock_pane_count; ++j)
2277 {
2278 if (dock.panes.Item(j)->HasCaption())
2279 {
2280 size += caption_size;
2281 break;
2282 }
2283 }
2284 }
2285
2286
2287 // new dock's size may not be more than the dock constraint
2288 // parameter specifies. See SetDockSizeConstraint()
2289
2290 int max_dock_x_size = (int)(m_dock_constraint_x * ((double)cli_size.x));
2291 int max_dock_y_size = (int)(m_dock_constraint_y * ((double)cli_size.y));
2292
2293 if (dock.IsHorizontal())
2294 size = wxMin(size, max_dock_y_size);
2295 else
2296 size = wxMin(size, max_dock_x_size);
2297
2298 // absolute minimum size for a dock is 10 pixels
2299 if (size < 10)
2300 size = 10;
2301
2302 dock.size = size;
2303 }
2304
2305
2306 // determine the dock's minimum size
2307 bool plus_border = false;
2308 bool plus_caption = false;
2309 int dock_min_size = 0;
2310 for (j = 0; j < dock_pane_count; ++j)
2311 {
2312 wxAuiPaneInfo& pane = *dock.panes.Item(j);
2313 if (pane.min_size != wxDefaultSize)
2314 {
2315 if (pane.HasBorder())
2316 plus_border = true;
2317 if (pane.HasCaption())
2318 plus_caption = true;
2319 if (dock.IsHorizontal())
2320 {
2321 if (pane.min_size.y > dock_min_size)
2322 dock_min_size = pane.min_size.y;
2323 }
2324 else
2325 {
2326 if (pane.min_size.x > dock_min_size)
2327 dock_min_size = pane.min_size.x;
2328 }
2329 }
2330 }
2331
2332 if (plus_border)
2333 dock_min_size += (pane_border_size*2);
2334 if (plus_caption && dock.IsHorizontal())
2335 dock_min_size += (caption_size);
2336
2337 dock.min_size = dock_min_size;
2338
2339
2340 // if the pane's current size is less than it's
2341 // minimum, increase the dock's size to it's minimum
2342 if (dock.size < dock.min_size)
2343 dock.size = dock.min_size;
2344
2345
2346 // determine the dock's mode (fixed or proportional);
2347 // determine whether the dock has only toolbars
2348 bool action_pane_marked = false;
2349 dock.fixed = true;
2350 dock.toolbar = true;
2351 for (j = 0; j < dock_pane_count; ++j)
2352 {
2353 wxAuiPaneInfo& pane = *dock.panes.Item(j);
2354 if (!pane.IsFixed())
2355 dock.fixed = false;
2356 if (!pane.IsToolbar())
2357 dock.toolbar = false;
2358 if (pane.HasFlag(wxAuiPaneInfo::optionDockFixed))
2359 dock.fixed = true;
2360 if (pane.HasFlag(wxAuiPaneInfo::actionPane))
2361 action_pane_marked = true;
2362 }
2363
2364
2365 // if the dock mode is proportional and not fixed-pixel,
2366 // reassign the dock_pos to the sequential 0, 1, 2, 3;
2367 // e.g. remove gaps like 1, 2, 30, 500
2368 if (!dock.fixed)
2369 {
2370 for (j = 0; j < dock_pane_count; ++j)
2371 {
2372 wxAuiPaneInfo& pane = *dock.panes.Item(j);
2373 pane.dock_pos = j;
2374 }
2375 }
2376
2377 // if the dock mode is fixed, and none of the panes
2378 // are being moved right now, make sure the panes
2379 // do not overlap each other. If they do, we will
2380 // adjust the positions of the panes
2381 if (dock.fixed && !action_pane_marked)
2382 {
2383 wxArrayInt pane_positions, pane_sizes;
2384 GetPanePositionsAndSizes(dock, pane_positions, pane_sizes);
2385
2386 int offset = 0;
2387 for (j = 0; j < dock_pane_count; ++j)
2388 {
2389 wxAuiPaneInfo& pane = *(dock.panes.Item(j));
2390 pane.dock_pos = pane_positions[j];
2391
2392 int amount = pane.dock_pos - offset;
2393 if (amount >= 0)
2394 offset += amount;
2395 else
2396 pane.dock_pos += -amount;
2397
2398 offset += pane_sizes[j];
2399 }
2400 }
2401 }
2402
2403 // discover the maximum dock layer
2404 int max_layer = 0;
2405 for (i = 0; i < dock_count; ++i)
2406 max_layer = wxMax(max_layer, docks.Item(i).dock_layer);
2407
2408
2409 // clear out uiparts
2410 uiparts.Empty();
2411
2412 // create a bunch of box sizers,
2413 // from the innermost level outwards.
2414 wxSizer* cont = NULL;
2415 wxSizer* middle = NULL;
2416 int layer = 0;
2417 int row, row_count;
2418
2419 for (layer = 0; layer <= max_layer; ++layer)
2420 {
2421 wxAuiDockInfoPtrArray arr;
2422
2423 // find any docks in this layer
2424 FindDocks(docks, -1, layer, -1, arr);
2425
2426 // if there aren't any, skip to the next layer
2427 if (arr.IsEmpty())
2428 continue;
2429
2430 wxSizer* old_cont = cont;
2431
2432 // create a container which will hold this layer's
2433 // docks (top, bottom, left, right)
2434 cont = new wxAuiProportionalBoxSizer(wxVERTICAL);
2435
2436
2437 // find any top docks in this layer
2438 FindDocks(docks, wxAUI_DOCK_TOP, layer, -1, arr);
2439 if (!arr.IsEmpty())
2440 {
2441 for (row = 0, row_count = arr.GetCount(); row < row_count; ++row)
2442 LayoutAddDock(cont, *arr.Item(row), uiparts, spacer_only);
2443 }
2444
2445
2446 // fill out the middle layer (which consists
2447 // of left docks, content area and right docks)
2448
2449 middle = new wxAuiProportionalBoxSizer(wxHORIZONTAL);
2450
2451 // find any left docks in this layer
2452 FindDocks(docks, wxAUI_DOCK_LEFT, layer, -1, arr);
2453 if (!arr.IsEmpty())
2454 {
2455 for (row = 0, row_count = arr.GetCount(); row < row_count; ++row)
2456 LayoutAddDock(middle, *arr.Item(row), uiparts, spacer_only);
2457 }
2458
2459 // add content dock (or previous layer's sizer
2460 // to the middle
2461 if (!old_cont)
2462 {
2463 // find any center docks
2464 FindDocks(docks, wxAUI_DOCK_CENTER, -1, -1, arr);
2465 if (!arr.IsEmpty())
2466 {
2467 for (row = 0,row_count = arr.GetCount(); row<row_count; ++row)
2468 LayoutAddDock(middle, *arr.Item(row), uiparts, spacer_only);
2469 }
2470 else if (!m_has_maximized)
2471 {
2472 // there are no center docks, add a background area
2473 wxSizerItem* sizer_item = middle->Add(1,1, 1, wxEXPAND);
2474 wxAuiDockUIPart part;
2475 part.type = wxAuiDockUIPart::typeBackground;
2476 part.pane = NULL;
2477 part.dock = NULL;
2478 part.button = NULL;
2479 part.cont_sizer = middle;
2480 part.sizer_item = sizer_item;
2481 uiparts.Add(part);
2482 }
2483 }
2484 else
2485 {
2486 middle->Add(old_cont, 1, wxEXPAND);
2487 }
2488
2489 // find any right docks in this layer
2490 FindDocks(docks, wxAUI_DOCK_RIGHT, layer, -1, arr);
2491 if (!arr.IsEmpty())
2492 {
2493 for (row = arr.GetCount()-1; row >= 0; --row)
2494 LayoutAddDock(middle, *arr.Item(row), uiparts, spacer_only);
2495 }
2496
2497 if (middle->GetChildren().GetCount() > 0)
2498 cont->Add(middle, 1, wxEXPAND);
2499 else
2500 delete middle;
2501
2502
2503
2504 // find any bottom docks in this layer
2505 FindDocks(docks, wxAUI_DOCK_BOTTOM, layer, -1, arr);
2506 if (!arr.IsEmpty())
2507 {
2508 for (row = arr.GetCount()-1; row >= 0; --row)
2509 LayoutAddDock(cont, *arr.Item(row), uiparts, spacer_only);
2510 }
2511
2512 }
2513
2514 if (!cont)
2515 {
2516 // no sizer available, because there are no docks,
2517 // therefore we will create a simple background area
2518 cont = new wxAuiProportionalBoxSizer(wxVERTICAL);
2519 wxSizerItem* sizer_item = cont->Add(1,1, 1, wxEXPAND);
2520 wxAuiDockUIPart part;
2521 part.type = wxAuiDockUIPart::typeBackground;
2522 part.pane = NULL;
2523 part.dock = NULL;
2524 part.button = NULL;
2525 part.cont_sizer = middle;
2526 part.sizer_item = sizer_item;
2527 uiparts.Add(part);
2528 }
2529
2530 container->Add(cont, 1, wxEXPAND);
2531 return container;
2532 }
2533
2534
2535 // SetDockSizeConstraint() allows the dock constraints to be set. For example,
2536 // specifying values of 0.5, 0.5 will mean that upon dock creation, a dock may
2537 // not be larger than half of the window's size
2538
2539 void wxAuiManager::SetDockSizeConstraint(double width_pct, double height_pct)
2540 {
2541 m_dock_constraint_x = wxMax(0.0, wxMin(1.0, width_pct));
2542 m_dock_constraint_y = wxMax(0.0, wxMin(1.0, height_pct));
2543 }
2544
2545 void wxAuiManager::GetDockSizeConstraint(double* width_pct, double* height_pct) const
2546 {
2547 if (width_pct)
2548 *width_pct = m_dock_constraint_x;
2549
2550 if (height_pct)
2551 *height_pct = m_dock_constraint_y;
2552 }
2553
2554
2555
2556 // Update() updates the layout. Whenever changes are made to
2557 // one or more panes, this function should be called. It is the
2558 // external entry point for running the layout engine.
2559
2560 void wxAuiManager::Update()
2561 {
2562 m_hover_button = NULL;
2563 m_action_part = NULL;
2564
2565 wxSizer* sizer;
2566 int i, pane_count = m_panes.GetCount();
2567
2568
2569 // destroy floating panes which have been
2570 // redocked or are becoming non-floating
2571 for (i = 0; i < pane_count; ++i)
2572 {
2573 wxAuiPaneInfo& p = m_panes.Item(i);
2574
2575 if (!p.IsFloating() && p.frame)
2576 {
2577 // because the pane is no longer in a floating, we need to
2578 // reparent it to m_frame and destroy the floating frame
2579
2580 // reduce flicker
2581 p.window->SetSize(1,1);
2582
2583
2584 // the following block is a workaround for bug #1531361
2585 // (see wxWidgets sourceforge page). On wxGTK (only), when
2586 // a frame is shown/hidden, a move event unfortunately
2587 // also gets fired. Because we may be dragging around
2588 // a pane, we need to cancel that action here to prevent
2589 // a spurious crash.
2590 if (m_action_window == p.frame)
2591 {
2592 if (wxWindow::GetCapture() == m_frame)
2593 m_frame->ReleaseMouse();
2594 m_action = actionNone;
2595 m_action_window = NULL;
2596 }
2597
2598 // hide the frame
2599 if (p.frame->IsShown())
2600 p.frame->Show(false);
2601
2602 // reparent to m_frame and destroy the pane
2603 if (m_action_window == p.frame)
2604 {
2605 m_action_window = NULL;
2606 }
2607
2608 p.window->Reparent(m_frame);
2609 p.frame->SetSizer(NULL);
2610 p.frame->Destroy();
2611 p.frame = NULL;
2612 }
2613 }
2614
2615
2616 // delete old sizer first
2617 m_frame->SetSizer(NULL);
2618
2619 // create a layout for all of the panes
2620 sizer = LayoutAll(m_panes, m_docks, m_uiparts, false);
2621
2622 // hide or show panes as necessary,
2623 // and float panes as necessary
2624 for (i = 0; i < pane_count; ++i)
2625 {
2626 wxAuiPaneInfo& p = m_panes.Item(i);
2627
2628 if (p.IsFloating())
2629 {
2630 if (p.frame == NULL)
2631 {
2632 // we need to create a frame for this
2633 // pane, which has recently been floated
2634 wxAuiFloatingFrame* frame = CreateFloatingFrame(m_frame, p);
2635
2636 // on MSW and Mac, if the owner desires transparent dragging, and
2637 // the dragging is happening right now, then the floating
2638 // window should have this style by default
2639 if (m_action == actionDragFloatingPane &&
2640 (m_flags & wxAUI_MGR_TRANSPARENT_DRAG))
2641 frame->SetTransparent(150);
2642
2643 frame->SetPaneWindow(p);
2644 p.frame = frame;
2645
2646 if (p.IsShown() && !frame->IsShown())
2647 frame->Show();
2648 }
2649 else
2650 {
2651 // frame already exists, make sure it's position
2652 // and size reflect the information in wxAuiPaneInfo
2653 if ((p.frame->GetPosition() != p.floating_pos) || (p.frame->GetSize() != p.floating_size))
2654 {
2655 p.frame->SetSize(p.floating_pos.x, p.floating_pos.y,
2656 p.floating_size.x, p.floating_size.y,
2657 wxSIZE_USE_EXISTING);
2658 /*
2659 p.frame->SetSize(p.floating_pos.x, p.floating_pos.y,
2660 wxDefaultCoord, wxDefaultCoord,
2661 wxSIZE_USE_EXISTING);
2662 //p.frame->Move(p.floating_pos.x, p.floating_pos.y);
2663 */
2664 }
2665
2666 if (p.frame->IsShown() != p.IsShown())
2667 p.frame->Show(p.IsShown());
2668 }
2669 }
2670 else
2671 {
2672 if (p.window->IsShown() != p.IsShown())
2673 p.window->Show(p.IsShown());
2674 }
2675
2676 // if "active panes" are no longer allowed, clear
2677 // any optionActive values from the pane states
2678 if ((m_flags & wxAUI_MGR_ALLOW_ACTIVE_PANE) == 0)
2679 {
2680 p.state &= ~wxAuiPaneInfo::optionActive;
2681 }
2682 }
2683
2684
2685 // keep track of the old window rectangles so we can
2686 // refresh those windows whose rect has changed
2687 wxAuiRectArray old_pane_rects;
2688 for (i = 0; i < pane_count; ++i)
2689 {
2690 wxRect r;
2691 wxAuiPaneInfo& p = m_panes.Item(i);
2692
2693 if (p.window && p.IsShown() && p.IsDocked())
2694 r = p.rect;
2695
2696 old_pane_rects.Add(r);
2697 }
2698
2699
2700
2701
2702 // apply the new sizer
2703 m_frame->SetSizer(sizer);
2704 m_frame->SetAutoLayout(false);
2705 DoFrameLayout();
2706
2707
2708
2709 // now that the frame layout is done, we need to check
2710 // the new pane rectangles against the old rectangles that
2711 // we saved a few lines above here. If the rectangles have
2712 // changed, the corresponding panes must also be updated
2713 for (i = 0; i < pane_count; ++i)
2714 {
2715 wxAuiPaneInfo& p = m_panes.Item(i);
2716 if (p.window && p.window->IsShown() && p.IsDocked())
2717 {
2718 if (p.rect != old_pane_rects[i])
2719 {
2720 p.window->Refresh();
2721 p.window->Update();
2722 }
2723 }
2724 }
2725
2726
2727 Repaint();
2728
2729 // set frame's minimum size
2730
2731 /*
2732 // N.B. More work needs to be done on frame minimum sizes;
2733 // this is some intresting code that imposes the minimum size,
2734 // but we may want to include a more flexible mechanism or
2735 // options for multiple minimum-size modes, e.g. strict or lax
2736 wxSize min_size = sizer->GetMinSize();
2737 wxSize frame_size = m_frame->GetSize();
2738 wxSize client_size = m_frame->GetClientSize();
2739
2740 wxSize minframe_size(min_size.x+frame_size.x-client_size.x,
2741 min_size.y+frame_size.y-client_size.y );
2742
2743 m_frame->SetMinSize(minframe_size);
2744
2745 if (frame_size.x < minframe_size.x ||
2746 frame_size.y < minframe_size.y)
2747 sizer->Fit(m_frame);
2748 */
2749 }
2750
2751
2752 // DoFrameLayout() is an internal function which invokes wxSizer::Layout
2753 // on the frame's main sizer, then measures all the various UI items
2754 // and updates their internal rectangles. This should always be called
2755 // instead of calling m_frame->Layout() directly
2756
2757 void wxAuiManager::DoFrameLayout()
2758 {
2759 m_frame->Layout();
2760
2761 int i, part_count;
2762 for (i = 0, part_count = m_uiparts.GetCount(); i < part_count; ++i)
2763 {
2764 wxAuiDockUIPart& part = m_uiparts.Item(i);
2765
2766 // get the rectangle of the UI part
2767 // originally, this code looked like this:
2768 // part.rect = wxRect(part.sizer_item->GetPosition(),
2769 // part.sizer_item->GetSize());
2770 // this worked quite well, with one exception: the mdi
2771 // client window had a "deferred" size variable
2772 // that returned the wrong size. It looks like
2773 // a bug in wx, because the former size of the window
2774 // was being returned. So, we will retrieve the part's
2775 // rectangle via other means
2776
2777
2778 part.rect = part.sizer_item->GetRect();
2779 int flag = part.sizer_item->GetFlag();
2780 int border = part.sizer_item->GetBorder();
2781 if (flag & wxTOP)
2782 {
2783 part.rect.y -= border;
2784 part.rect.height += border;
2785 }
2786 if (flag & wxLEFT)
2787 {
2788 part.rect.x -= border;
2789 part.rect.width += border;
2790 }
2791 if (flag & wxBOTTOM)
2792 part.rect.height += border;
2793 if (flag & wxRIGHT)
2794 part.rect.width += border;
2795
2796
2797 if (part.type == wxAuiDockUIPart::typeDock)
2798 part.dock->rect = part.rect;
2799 if (part.type == wxAuiDockUIPart::typePane)
2800 part.pane->rect = part.rect;
2801 }
2802 }
2803
2804 // GetPanePart() looks up the pane the pane border UI part (or the regular
2805 // pane part if there is no border). This allows the caller to get the exact
2806 // rectangle of the pane in question, including decorations like
2807 // caption and border (if any).
2808
2809 wxAuiDockUIPart* wxAuiManager::GetPanePart(wxWindow* wnd)
2810 {
2811 int i, part_count;
2812 for (i = 0, part_count = m_uiparts.GetCount(); i < part_count; ++i)
2813 {
2814 wxAuiDockUIPart& part = m_uiparts.Item(i);
2815 if (part.type == wxAuiDockUIPart::typePaneBorder &&
2816 part.pane && part.pane->window == wnd)
2817 return &part;
2818 }
2819 for (i = 0, part_count = m_uiparts.GetCount(); i < part_count; ++i)
2820 {
2821 wxAuiDockUIPart& part = m_uiparts.Item(i);
2822 if (part.type == wxAuiDockUIPart::typePane &&
2823 part.pane && part.pane->window == wnd)
2824 return &part;
2825 }
2826 return NULL;
2827 }
2828
2829
2830
2831 // GetDockPixelOffset() is an internal function which returns
2832 // a dock's offset in pixels from the left side of the window
2833 // (for horizontal docks) or from the top of the window (for
2834 // vertical docks). This value is necessary for calculating
2835 // fixel-pane/toolbar offsets when they are dragged.
2836
2837 int wxAuiManager::GetDockPixelOffset(wxAuiPaneInfo& test)
2838 {
2839 // the only way to accurately calculate the dock's
2840 // offset is to actually run a theoretical layout
2841
2842 int i, part_count, dock_count;
2843 wxAuiDockInfoArray docks;
2844 wxAuiPaneInfoArray panes;
2845 wxAuiDockUIPartArray uiparts;
2846 CopyDocksAndPanes(docks, panes, m_docks, m_panes);
2847 panes.Add(test);
2848
2849 wxSizer* sizer = LayoutAll(panes, docks, uiparts, true);
2850 wxSize client_size = m_frame->GetClientSize();
2851 sizer->SetDimension(0, 0, client_size.x, client_size.y);
2852 sizer->Layout();
2853
2854 for (i = 0, part_count = uiparts.GetCount(); i < part_count; ++i)
2855 {
2856 wxAuiDockUIPart& part = uiparts.Item(i);
2857 part.rect = wxRect(part.sizer_item->GetPosition(),
2858 part.sizer_item->GetSize());
2859 if (part.type == wxAuiDockUIPart::typeDock)
2860 part.dock->rect = part.rect;
2861 }
2862
2863 delete sizer;
2864
2865 for (i = 0, dock_count = docks.GetCount(); i < dock_count; ++i)
2866 {
2867 wxAuiDockInfo& dock = docks.Item(i);
2868 if (test.dock_direction == dock.dock_direction &&
2869 test.dock_layer==dock.dock_layer && test.dock_row==dock.dock_row)
2870 {
2871 if (dock.IsVertical())
2872 return dock.rect.y;
2873 else
2874 return dock.rect.x;
2875 }
2876 }
2877
2878 return 0;
2879 }
2880
2881
2882
2883 // ProcessDockResult() is a utility function used by DoDrop() - it checks
2884 // if a dock operation is allowed, the new dock position is copied into
2885 // the target info. If the operation was allowed, the function returns true.
2886
2887 bool wxAuiManager::ProcessDockResult(wxAuiPaneInfo& target,
2888 const wxAuiPaneInfo& new_pos)
2889 {
2890 bool allowed = false;
2891 switch (new_pos.dock_direction)
2892 {
2893 case wxAUI_DOCK_TOP: allowed = target.IsTopDockable(); break;
2894 case wxAUI_DOCK_BOTTOM: allowed = target.IsBottomDockable(); break;
2895 case wxAUI_DOCK_LEFT: allowed = target.IsLeftDockable(); break;
2896 case wxAUI_DOCK_RIGHT: allowed = target.IsRightDockable(); break;
2897 }
2898
2899 if (allowed)
2900 target = new_pos;
2901
2902 return allowed;
2903 }
2904
2905
2906 // DoDrop() is an important function. It basically takes a mouse position,
2907 // and determines where the pane's new position would be. If the pane is to be
2908 // dropped, it performs the drop operation using the specified dock and pane
2909 // arrays. By specifying copied dock and pane arrays when calling, a "what-if"
2910 // scenario can be performed, giving precise coordinates for drop hints.
2911 // If, however, wxAuiManager:m_docks and wxAuiManager::m_panes are specified
2912 // as parameters, the changes will be made to the main state arrays
2913
2914 const int auiInsertRowPixels = 10;
2915 const int auiNewRowPixels = 40;
2916 const int auiLayerInsertPixels = 40;
2917 const int auiLayerInsertOffset = 5;
2918
2919 bool wxAuiManager::DoDrop(wxAuiDockInfoArray& docks,
2920 wxAuiPaneInfoArray& panes,
2921 wxAuiPaneInfo& target,
2922 const wxPoint& pt,
2923 const wxPoint& offset)
2924 {
2925 wxSize cli_size = m_frame->GetClientSize();
2926
2927 wxAuiPaneInfo drop = target;
2928
2929
2930 // The result should always be shown
2931 drop.Show();
2932
2933
2934 // Check to see if the pane has been dragged outside of the window
2935 // (or near to the outside of the window), if so, dock it along the edge
2936
2937
2938 int layer_insert_offset = auiLayerInsertOffset;
2939 if (drop.IsToolbar())
2940 layer_insert_offset = 0;
2941
2942
2943 if (pt.x < layer_insert_offset &&
2944 pt.x > layer_insert_offset-auiLayerInsertPixels)
2945 {
2946 int new_layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_LEFT),
2947 GetMaxLayer(docks, wxAUI_DOCK_BOTTOM)),
2948 GetMaxLayer(docks, wxAUI_DOCK_TOP)) + 1;
2949
2950 if (drop.IsToolbar())
2951 new_layer = auiToolBarLayer;
2952
2953 drop.Dock().Left().
2954 Layer(new_layer).
2955 Row(0).
2956 Position(pt.y - GetDockPixelOffset(drop) - offset.y);
2957 return ProcessDockResult(target, drop);
2958 }
2959 else if (pt.y < layer_insert_offset &&
2960 pt.y > layer_insert_offset-auiLayerInsertPixels)
2961 {
2962 int new_layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_TOP),
2963 GetMaxLayer(docks, wxAUI_DOCK_LEFT)),
2964 GetMaxLayer(docks, wxAUI_DOCK_RIGHT)) + 1;
2965
2966 if (drop.IsToolbar())
2967 new_layer = auiToolBarLayer;
2968
2969 drop.Dock().Top().
2970 Layer(new_layer).
2971 Row(0).
2972 Position(pt.x - GetDockPixelOffset(drop) - offset.x);
2973 return ProcessDockResult(target, drop);
2974 }
2975 else if (pt.x >= cli_size.x - layer_insert_offset &&
2976 pt.x < cli_size.x - layer_insert_offset + auiLayerInsertPixels)
2977 {
2978 int new_layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_RIGHT),
2979 GetMaxLayer(docks, wxAUI_DOCK_TOP)),
2980 GetMaxLayer(docks, wxAUI_DOCK_BOTTOM)) + 1;
2981
2982 if (drop.IsToolbar())
2983 new_layer = auiToolBarLayer;
2984
2985 drop.Dock().Right().
2986 Layer(new_layer).
2987 Row(0).
2988 Position(pt.y - GetDockPixelOffset(drop) - offset.y);
2989 return ProcessDockResult(target, drop);
2990 }
2991 else if (pt.y >= cli_size.y - layer_insert_offset &&
2992 pt.y < cli_size.y - layer_insert_offset + auiLayerInsertPixels)
2993 {
2994 int new_layer = wxMax( wxMax( GetMaxLayer(docks, wxAUI_DOCK_BOTTOM),
2995 GetMaxLayer(docks, wxAUI_DOCK_LEFT)),
2996 GetMaxLayer(docks, wxAUI_DOCK_RIGHT)) + 1;
2997
2998 if (drop.IsToolbar())
2999 new_layer = auiToolBarLayer;
3000
3001 drop.Dock().Bottom().
3002 Layer(new_layer).
3003 Row(0).
3004 Position(pt.x - GetDockPixelOffset(drop) - offset.x);
3005 return ProcessDockResult(target, drop);
3006 }
3007
3008
3009 wxAuiDockUIPart* part = HitTest(pt.x, pt.y);
3010
3011
3012 if (drop.IsToolbar())
3013 {
3014 if (!part || !part->dock)
3015 return false;
3016
3017 // calculate the offset from where the dock begins
3018 // to the point where the user dropped the pane
3019 int dock_drop_offset = 0;
3020 if (part->dock->IsHorizontal())
3021 dock_drop_offset = pt.x - part->dock->rect.x - offset.x;
3022 else
3023 dock_drop_offset = pt.y - part->dock->rect.y - offset.y;
3024
3025
3026 // toolbars may only be moved in and to fixed-pane docks,
3027 // otherwise we will try to float the pane. Also, the pane
3028 // should float if being dragged over center pane windows
3029 if (!part->dock->fixed || part->dock->dock_direction == wxAUI_DOCK_CENTER ||
3030 pt.x >= cli_size.x || pt.x <= 0 || pt.y >= cli_size.y || pt.y <= 0)
3031 {
3032 if (m_last_rect.IsEmpty() || m_last_rect.Contains(pt.x, pt.y ))
3033 {
3034 m_skipping = true;
3035 }
3036 else
3037 {
3038 if ((m_flags & wxAUI_MGR_ALLOW_FLOATING) && drop.IsFloatable())
3039 {
3040 drop.Float();
3041 }
3042
3043 m_skipping = false;
3044
3045 return ProcessDockResult(target, drop);
3046 }
3047
3048 drop.Position(pt.x - GetDockPixelOffset(drop) - offset.x);
3049
3050 return ProcessDockResult(target, drop);
3051 }
3052
3053 m_skipping = false;
3054
3055 m_last_rect = part->dock->rect;
3056 m_last_rect.Inflate( 15, 15 );
3057
3058 drop.Dock().
3059 Direction(part->dock->dock_direction).
3060 Layer(part->dock->dock_layer).
3061 Row(part->dock->dock_row).
3062 Position(dock_drop_offset);
3063
3064 if ((
3065 ((pt.y < part->dock->rect.y + 1) && part->dock->IsHorizontal()) ||
3066 ((pt.x < part->dock->rect.x + 1) && part->dock->IsVertical())
3067 ) && part->dock->panes.GetCount() > 1)
3068 {
3069 if ((part->dock->dock_direction == wxAUI_DOCK_TOP) ||
3070 (part->dock->dock_direction == wxAUI_DOCK_LEFT))
3071 {
3072 int row = drop.dock_row;
3073 DoInsertDockRow(panes, part->dock->dock_direction,
3074 part->dock->dock_layer,
3075 part->dock->dock_row);
3076 drop.dock_row = row;
3077 }
3078 else
3079 {
3080 DoInsertDockRow(panes, part->dock->dock_direction,
3081 part->dock->dock_layer,
3082 part->dock->dock_row+1);
3083 drop.dock_row = part->dock->dock_row+1;
3084 }
3085 }
3086
3087 if ((
3088 ((pt.y > part->dock->rect.y + part->dock->rect.height - 2 ) && part->dock->IsHorizontal()) ||
3089 ((pt.x > part->dock->rect.x + part->dock->rect.width - 2 ) && part->dock->IsVertical())
3090 ) && part->dock->panes.GetCount() > 1)
3091 {
3092 if ((part->dock->dock_direction == wxAUI_DOCK_TOP) ||
3093 (part->dock->dock_direction == wxAUI_DOCK_LEFT))
3094 {
3095 DoInsertDockRow(panes, part->dock->dock_direction,
3096 part->dock->dock_layer,
3097 part->dock->dock_row+1);
3098 drop.dock_row = part->dock->dock_row+1;
3099 }
3100 else
3101 {
3102 int row = drop.dock_row;
3103 DoInsertDockRow(panes, part->dock->dock_direction,
3104 part->dock->dock_layer,
3105 part->dock->dock_row);
3106 drop.dock_row = row;
3107 }
3108 }
3109
3110 return ProcessDockResult(target, drop);
3111 }
3112
3113
3114
3115
3116 if (!part)
3117 return false;
3118
3119 if (part->type == wxAuiDockUIPart::typePaneBorder ||
3120 part->type == wxAuiDockUIPart::typeCaption ||
3121 part->type == wxAuiDockUIPart::typeGripper ||
3122 part->type == wxAuiDockUIPart::typePaneButton ||
3123 part->type == wxAuiDockUIPart::typePane ||
3124 part->type == wxAuiDockUIPart::typePaneSizer ||
3125 part->type == wxAuiDockUIPart::typeDockSizer ||
3126 part->type == wxAuiDockUIPart::typeBackground)
3127 {
3128 if (part->type == wxAuiDockUIPart::typeDockSizer)
3129 {
3130 if (part->dock->panes.GetCount() != 1)
3131 return false;
3132 part = GetPanePart(part->dock->panes.Item(0)->window);
3133 if (!part)
3134 return false;
3135 }
3136
3137
3138
3139 // If a normal frame is being dragged over a toolbar, insert it
3140 // along the edge under the toolbar, but over all other panes.
3141 // (this could be done much better, but somehow factoring this
3142 // calculation with the one at the beginning of this function)
3143 if (part->dock && part->dock->toolbar)
3144 {
3145 int layer = 0;
3146
3147 switch (part->dock->dock_direction)
3148 {
3149 case wxAUI_DOCK_LEFT:
3150 layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_LEFT),
3151 GetMaxLayer(docks, wxAUI_DOCK_BOTTOM)),
3152 GetMaxLayer(docks, wxAUI_DOCK_TOP));
3153 break;
3154 case wxAUI_DOCK_TOP:
3155 layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_TOP),
3156 GetMaxLayer(docks, wxAUI_DOCK_LEFT)),
3157 GetMaxLayer(docks, wxAUI_DOCK_RIGHT));
3158 break;
3159 case wxAUI_DOCK_RIGHT:
3160 layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_RIGHT),
3161 GetMaxLayer(docks, wxAUI_DOCK_TOP)),
3162 GetMaxLayer(docks, wxAUI_DOCK_BOTTOM));
3163 break;
3164 case wxAUI_DOCK_BOTTOM:
3165 layer = wxMax(wxMax(GetMaxLayer(docks, wxAUI_DOCK_BOTTOM),
3166 GetMaxLayer(docks, wxAUI_DOCK_LEFT)),
3167 GetMaxLayer(docks, wxAUI_DOCK_RIGHT));
3168 break;
3169 }
3170
3171 DoInsertDockRow(panes, part->dock->dock_direction,
3172 layer, 0);
3173 drop.Dock().
3174 Direction(part->dock->dock_direction).
3175 Layer(layer).Row(0).Position(0);
3176 return ProcessDockResult(target, drop);
3177 }
3178
3179
3180 if (!part->pane)
3181 return false;
3182
3183 part = GetPanePart(part->pane->window);
3184 if (!part)
3185 return false;
3186
3187 bool insert_dock_row = false;
3188 int insert_row = part->pane->dock_row;
3189 int insert_dir = part->pane->dock_direction;
3190 int insert_layer = part->pane->dock_layer;
3191
3192 switch (part->pane->dock_direction)
3193 {
3194 case wxAUI_DOCK_TOP:
3195 if (pt.y >= part->rect.y &&
3196 pt.y < part->rect.y+auiInsertRowPixels)
3197 insert_dock_row = true;
3198 break;
3199 case wxAUI_DOCK_BOTTOM:
3200 if (pt.y > part->rect.y+part->rect.height-auiInsertRowPixels &&
3201 pt.y <= part->rect.y + part->rect.height)
3202 insert_dock_row = true;
3203 break;
3204 case wxAUI_DOCK_LEFT:
3205 if (pt.x >= part->rect.x &&
3206 pt.x < part->rect.x+auiInsertRowPixels)
3207 insert_dock_row = true;
3208 break;
3209 case wxAUI_DOCK_RIGHT:
3210 if (pt.x > part->rect.x+part->rect.width-auiInsertRowPixels &&
3211 pt.x <= part->rect.x+part->rect.width)
3212 insert_dock_row = true;
3213 break;
3214 case wxAUI_DOCK_CENTER:
3215 {
3216 // "new row pixels" will be set to the default, but
3217 // must never exceed 20% of the window size
3218 int new_row_pixels_x = auiNewRowPixels;
3219 int new_row_pixels_y = auiNewRowPixels;
3220
3221 if (new_row_pixels_x > (part->rect.width*20)/100)
3222 new_row_pixels_x = (part->rect.width*20)/100;
3223
3224 if (new_row_pixels_y > (part->rect.height*20)/100)
3225 new_row_pixels_y = (part->rect.height*20)/100;
3226
3227
3228 // determine if the mouse pointer is in a location that
3229 // will cause a new row to be inserted. The hot spot positions
3230 // are along the borders of the center pane
3231
3232 insert_layer = 0;
3233 insert_dock_row = true;
3234 const wxRect& pr = part->rect;
3235 if (pt.x >= pr.x && pt.x < pr.x + new_row_pixels_x)
3236 insert_dir = wxAUI_DOCK_LEFT;
3237 else if (pt.y >= pr.y && pt.y < pr.y + new_row_pixels_y)
3238 insert_dir = wxAUI_DOCK_TOP;
3239 else if (pt.x >= pr.x + pr.width - new_row_pixels_x &&
3240 pt.x < pr.x + pr.width)
3241 insert_dir = wxAUI_DOCK_RIGHT;
3242 else if (pt.y >= pr.y+ pr.height - new_row_pixels_y &&
3243 pt.y < pr.y + pr.height)
3244 insert_dir = wxAUI_DOCK_BOTTOM;
3245 else
3246 return false;
3247
3248 insert_row = GetMaxRow(panes, insert_dir, insert_layer) + 1;
3249 }
3250 }
3251
3252 if (insert_dock_row)
3253 {
3254 DoInsertDockRow(panes, insert_dir, insert_layer, insert_row);
3255 drop.Dock().Direction(insert_dir).
3256 Layer(insert_layer).
3257 Row(insert_row).
3258 Position(0);
3259 return ProcessDockResult(target, drop);
3260 }
3261
3262 // determine the mouse offset and the pane size, both in the
3263 // direction of the dock itself, and perpendicular to the dock
3264
3265 int offset, size;
3266
3267 if (part->orientation == wxVERTICAL)
3268 {
3269 offset = pt.y - part->rect.y;
3270 size = part->rect.GetHeight();
3271 }
3272 else
3273 {
3274 offset = pt.x - part->rect.x;
3275 size = part->rect.GetWidth();
3276 }
3277
3278 int drop_position = part->pane->dock_pos;
3279
3280 // if we are in the top/left part of the pane,
3281 // insert the pane before the pane being hovered over
3282 if (offset <= size/2)
3283 {
3284 drop_position = part->pane->dock_pos;
3285 DoInsertPane(panes,
3286 part->pane->dock_direction,
3287 part->pane->dock_layer,
3288 part->pane->dock_row,
3289 part->pane->dock_pos);
3290 }
3291
3292 // if we are in the bottom/right part of the pane,
3293 // insert the pane before the pane being hovered over
3294 if (offset > size/2)
3295 {
3296 drop_position = part->pane->dock_pos+1;
3297 DoInsertPane(panes,
3298 part->pane->dock_direction,
3299 part->pane->dock_layer,
3300 part->pane->dock_row,
3301 part->pane->dock_pos+1);
3302 }
3303
3304 drop.Dock().
3305 Direction(part->dock->dock_direction).
3306 Layer(part->dock->dock_layer).
3307 Row(part->dock->dock_row).
3308 Position(drop_position);
3309 return ProcessDockResult(target, drop);
3310 }
3311
3312 return false;
3313 }
3314
3315
3316 void wxAuiManager::OnHintFadeTimer(wxTimerEvent& WXUNUSED(event))
3317 {
3318 if (!m_hint_wnd || m_hint_fadeamt >= m_hint_fademax)
3319 {
3320 m_hint_fadetimer.Stop();
3321 return;
3322 }
3323
3324 m_hint_fadeamt += 4;
3325 m_hint_wnd->SetTransparent(m_hint_fadeamt);
3326 }
3327
3328 void wxAuiManager::ShowHint(const wxRect& rect)
3329 {
3330 if (m_hint_wnd)
3331 {
3332 // if the hint rect is the same as last time, don't do anything
3333 if (m_last_hint == rect)
3334 return;
3335 m_last_hint = rect;
3336
3337 m_hint_fadeamt = m_hint_fademax;
3338
3339 if ((m_flags & wxAUI_MGR_HINT_FADE)
3340 && !((m_hint_wnd->IsKindOf(CLASSINFO(wxPseudoTransparentFrame))) &&
3341 (m_flags & wxAUI_MGR_NO_VENETIAN_BLINDS_FADE))
3342 )
3343 m_hint_fadeamt = 0;
3344
3345 m_hint_wnd->SetSize(rect);
3346 m_hint_wnd->SetTransparent(m_hint_fadeamt);
3347
3348 if (!m_hint_wnd->IsShown())
3349 m_hint_wnd->Show();
3350
3351 // if we are dragging a floating pane, set the focus
3352 // back to that floating pane (otherwise it becomes unfocused)
3353 if (m_action == actionDragFloatingPane && m_action_window)
3354 m_action_window->SetFocus();
3355
3356 m_hint_wnd->Raise();
3357
3358
3359 if (m_hint_fadeamt != m_hint_fademax) // Only fade if we need to
3360 {
3361 // start fade in timer
3362 m_hint_fadetimer.SetOwner(this, 101);
3363 m_hint_fadetimer.Start(5);
3364 }
3365 }
3366 else // Not using a transparent hint window...
3367 {
3368 if (!(m_flags & wxAUI_MGR_RECTANGLE_HINT))
3369 return;
3370
3371 if (m_last_hint != rect)
3372 {
3373 // remove the last hint rectangle
3374 m_last_hint = rect;
3375 m_frame->Refresh();
3376 m_frame->Update();
3377 }
3378
3379 wxScreenDC screendc;
3380 wxRegion clip(1, 1, 10000, 10000);
3381
3382 // clip all floating windows, so we don't draw over them
3383 int i, pane_count;
3384 for (i = 0, pane_count = m_panes.GetCount(); i < pane_count; ++i)
3385 {
3386 wxAuiPaneInfo& pane = m_panes.Item(i);
3387
3388 if (pane.IsFloating() &&
3389 pane.frame->IsShown())
3390 {
3391 wxRect rect = pane.frame->GetRect();
3392 #ifdef __WXGTK__
3393 // wxGTK returns the client size, not the whole frame size
3394 rect.width += 15;
3395 rect.height += 35;
3396 rect.Inflate(5);
3397 #endif
3398
3399 clip.Subtract(rect);
3400 }
3401 }
3402
3403 // As we can only hide the hint by redrawing the managed window, we
3404 // need to clip the region to the managed window too or we get
3405 // nasty redrawn problems.
3406 clip.Intersect(m_frame->GetRect());
3407
3408 screendc.SetDeviceClippingRegion(clip);
3409
3410 wxBitmap stipple = wxPaneCreateStippleBitmap();
3411 wxBrush brush(stipple);
3412 screendc.SetBrush(brush);
3413 screendc.SetPen(*wxTRANSPARENT_PEN);
3414
3415 screendc.DrawRectangle(rect.x, rect.y, 5, rect.height);
3416 screendc.DrawRectangle(rect.x+5, rect.y, rect.width-10, 5);
3417 screendc.DrawRectangle(rect.x+rect.width-5, rect.y, 5, rect.height);
3418 screendc.DrawRectangle(rect.x+5, rect.y+rect.height-5, rect.width-10, 5);
3419 }
3420 }
3421
3422 void wxAuiManager::HideHint()
3423 {
3424 // hides a transparent window hint, if there is one
3425 if (m_hint_wnd)
3426 {
3427 if (m_hint_wnd->IsShown())
3428 m_hint_wnd->Show(false);
3429 m_hint_wnd->SetTransparent(0);
3430 m_hint_fadetimer.Stop();
3431 m_last_hint = wxRect();
3432 return;
3433 }
3434
3435 // hides a painted hint by redrawing the frame window
3436 if (!m_last_hint.IsEmpty())
3437 {
3438 m_frame->Refresh();
3439 m_frame->Update();
3440 m_last_hint = wxRect();
3441 }
3442 }
3443
3444 void wxAuiManager::OnHintActivate(wxActivateEvent& WXUNUSED(event))
3445 {
3446 // Do nothing so this event isn't handled in the base handlers.
3447
3448 // Letting the hint window activate without this handler can lead to
3449 // weird behavior on Mac where the menu is switched out to the top
3450 // window's menu in MDI applications when it shouldn't be. So since
3451 // we don't want user interaction with the hint window anyway, we just
3452 // prevent it from activating here.
3453 }
3454
3455
3456
3457 void wxAuiManager::StartPaneDrag(wxWindow* pane_window,
3458 const wxPoint& offset)
3459 {
3460 wxAuiPaneInfo& pane = GetPane(pane_window);
3461 if (!pane.IsOk())
3462 return;
3463
3464 if (pane.IsToolbar())
3465 {
3466 m_action = actionDragToolbarPane;
3467 }
3468 else
3469 {
3470 m_action = actionDragFloatingPane;
3471 }
3472
3473 m_action_window = pane_window;
3474 m_action_offset = offset;
3475 m_frame->CaptureMouse();
3476 }
3477
3478
3479 // CalculateHintRect() calculates the drop hint rectangle. The method
3480 // first calls DoDrop() to determine the exact position the pane would
3481 // be at were if dropped. If the pane would indeed become docked at the
3482 // specified drop point, the the rectangle hint will be returned in
3483 // screen coordinates. Otherwise, an empty rectangle is returned.
3484 // |pane_window| is the window pointer of the pane being dragged, |pt| is
3485 // the mouse position, in client coordinates. |offset| describes the offset
3486 // that the mouse is from the upper-left corner of the item being dragged
3487
3488 wxRect wxAuiManager::CalculateHintRect(wxWindow* pane_window,
3489 const wxPoint& pt,
3490 const wxPoint& offset)
3491 {
3492 wxRect rect;
3493
3494 // we need to paint a hint rectangle; to find out the exact hint rectangle,
3495 // we will create a new temporary layout and then measure the resulting
3496 // rectangle; we will create a copy of the docking structures (m_dock)
3497 // so that we don't modify the real thing on screen
3498
3499 int i, pane_count, part_count;
3500 wxAuiDockInfoArray docks;
3501 wxAuiPaneInfoArray panes;
3502 wxAuiDockUIPartArray uiparts;
3503 wxAuiPaneInfo hint = GetPane(pane_window);
3504 hint.name = wxT("__HINT__");
3505 hint.PaneBorder(true);
3506 hint.Show();
3507
3508 if (!hint.IsOk())
3509 return rect;
3510
3511 CopyDocksAndPanes(docks, panes, m_docks, m_panes);
3512
3513 // remove any pane already there which bears the same window;
3514 // this happens when you are moving a pane around in a dock
3515 for (i = 0, pane_count = panes.GetCount(); i < pane_count; ++i)
3516 {
3517 if (panes.Item(i).window == pane_window)
3518 {
3519 RemovePaneFromDocks(docks, panes.Item(i));
3520 panes.RemoveAt(i);
3521 break;
3522 }
3523 }
3524
3525 // find out where the new pane would be
3526 if (!DoDrop(docks, panes, hint, pt, offset))
3527 {
3528 return rect;
3529 }
3530
3531 panes.Add(hint);
3532
3533 wxSizer* sizer = LayoutAll(panes, docks, uiparts, true);
3534 wxSize client_size = m_frame->GetClientSize();
3535 sizer->SetDimension(0, 0, client_size.x, client_size.y);
3536 sizer->Layout();
3537
3538 for (i = 0, part_count = uiparts.GetCount();
3539 i < part_count; ++i)
3540 {
3541 wxAuiDockUIPart& part = uiparts.Item(i);
3542
3543 if (part.type == wxAuiDockUIPart::typePaneBorder &&
3544 part.pane && part.pane->name == wxT("__HINT__"))
3545 {
3546 rect = wxRect(part.sizer_item->GetPosition(),
3547 part.sizer_item->GetSize());
3548 break;
3549 }
3550 }
3551
3552 delete sizer;
3553
3554 if (rect.IsEmpty())
3555 {
3556 return rect;
3557 }
3558
3559 // actually show the hint rectangle on the screen
3560 m_frame->ClientToScreen(&rect.x, &rect.y);
3561
3562 if ( m_frame->GetLayoutDirection() == wxLayout_RightToLeft )
3563 {
3564 // Mirror rectangle in RTL mode
3565 rect.x -= rect.GetWidth();
3566 }
3567
3568 return rect;
3569 }
3570
3571 // DrawHintRect() calculates the hint rectangle by calling
3572 // CalculateHintRect(). If there is a rectangle, it shows it
3573 // by calling ShowHint(), otherwise it hides any hint
3574 // rectangle currently shown
3575 void wxAuiManager::DrawHintRect(wxWindow* pane_window,
3576 const wxPoint& pt,
3577 const wxPoint& offset)
3578 {
3579 wxRect rect = CalculateHintRect(pane_window, pt, offset);
3580
3581 if (rect.IsEmpty())
3582 {
3583 HideHint();
3584 }
3585 else
3586 {
3587 ShowHint(rect);
3588 }
3589 }
3590
3591 void wxAuiManager::OnFloatingPaneMoveStart(wxWindow* wnd)
3592 {
3593 // try to find the pane
3594 wxAuiPaneInfo& pane = GetPane(wnd);
3595 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
3596
3597 if (m_flags & wxAUI_MGR_TRANSPARENT_DRAG)
3598 pane.frame->SetTransparent(150);
3599 }
3600
3601 void wxAuiManager::OnFloatingPaneMoving(wxWindow* wnd, wxDirection dir)
3602 {
3603 // try to find the pane
3604 wxAuiPaneInfo& pane = GetPane(wnd);
3605 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
3606
3607 if(!pane.frame)
3608 return;
3609
3610 wxPoint pt = ::wxGetMousePosition();
3611
3612 #if 0
3613 // Adapt pt to direction
3614 if (dir == wxNORTH)
3615 {
3616 // move to pane's upper border
3617 wxPoint pos( 0,0 );
3618 pos = wnd->ClientToScreen( pos );
3619 pt.y = pos.y;
3620 // and some more pixels for the title bar
3621 pt.y -= 5;
3622 }
3623 else if (dir == wxWEST)
3624 {
3625 // move to pane's left border
3626 wxPoint pos( 0,0 );
3627 pos = wnd->ClientToScreen( pos );
3628 pt.x = pos.x;
3629 }
3630 else if (dir == wxEAST)
3631 {
3632 // move to pane's right border
3633 wxPoint pos( wnd->GetSize().x, 0 );
3634 pos = wnd->ClientToScreen( pos );
3635 pt.x = pos.x;
3636 }
3637 else if (dir == wxSOUTH)
3638 {
3639 // move to pane's bottom border
3640 wxPoint pos( 0, wnd->GetSize().y );
3641 pos = wnd->ClientToScreen( pos );
3642 pt.y = pos.y;
3643 }
3644 #else
3645 wxUnusedVar(dir);
3646 #endif
3647
3648 wxPoint client_pt = m_frame->ScreenToClient(pt);
3649
3650 // calculate the offset from the upper left-hand corner
3651 // of the frame to the mouse pointer
3652 wxPoint frame_pos = pane.frame->GetPosition();
3653 wxPoint action_offset(pt.x-frame_pos.x, pt.y-frame_pos.y);
3654
3655 // no hint for toolbar floating windows
3656 if (pane.IsToolbar() && m_action == actionDragFloatingPane)
3657 {
3658 wxAuiDockInfoArray docks;
3659 wxAuiPaneInfoArray panes;
3660 wxAuiDockUIPartArray uiparts;
3661 wxAuiPaneInfo hint = pane;
3662
3663 CopyDocksAndPanes(docks, panes, m_docks, m_panes);
3664
3665 // find out where the new pane would be
3666 if (!DoDrop(docks, panes, hint, client_pt))
3667 return;
3668 if (hint.IsFloating())
3669 return;
3670
3671 pane = hint;
3672 m_action = actionDragToolbarPane;
3673 m_action_window = pane.window;
3674
3675 Update();
3676
3677 return;
3678 }
3679
3680
3681 // if a key modifier is pressed while dragging the frame,
3682 // don't dock the window
3683 if (!CanDockPanel(pane))
3684 {
3685 HideHint();
3686 return;
3687 }
3688
3689
3690 DrawHintRect(wnd, client_pt, action_offset);
3691
3692 #ifdef __WXGTK__
3693 // this cleans up some screen artifacts that are caused on GTK because
3694 // we aren't getting the exact size of the window (see comment
3695 // in DrawHintRect)
3696 //Refresh();
3697 #endif
3698
3699
3700 // reduces flicker
3701 m_frame->Update();
3702 }
3703
3704 void wxAuiManager::OnFloatingPaneMoved(wxWindow* wnd, wxDirection dir)
3705 {
3706 // try to find the pane
3707 wxAuiPaneInfo& pane = GetPane(wnd);
3708 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
3709
3710 if(!pane.frame)
3711 return;
3712
3713 wxPoint pt = ::wxGetMousePosition();
3714
3715 #if 0
3716 // Adapt pt to direction
3717 if (dir == wxNORTH)
3718 {
3719 // move to pane's upper border
3720 wxPoint pos( 0,0 );
3721 pos = wnd->ClientToScreen( pos );
3722 pt.y = pos.y;
3723 // and some more pixels for the title bar
3724 pt.y -= 10;
3725 }
3726 else if (dir == wxWEST)
3727 {
3728 // move to pane's left border
3729 wxPoint pos( 0,0 );
3730 pos = wnd->ClientToScreen( pos );
3731 pt.x = pos.x;
3732 }
3733 else if (dir == wxEAST)
3734 {
3735 // move to pane's right border
3736 wxPoint pos( wnd->GetSize().x, 0 );
3737 pos = wnd->ClientToScreen( pos );
3738 pt.x = pos.x;
3739 }
3740 else if (dir == wxSOUTH)
3741 {
3742 // move to pane's bottom border
3743 wxPoint pos( 0, wnd->GetSize().y );
3744 pos = wnd->ClientToScreen( pos );
3745 pt.y = pos.y;
3746 }
3747 #else
3748 wxUnusedVar(dir);
3749 #endif
3750
3751 wxPoint client_pt = m_frame->ScreenToClient(pt);
3752
3753 // calculate the offset from the upper left-hand corner
3754 // of the frame to the mouse pointer
3755 wxPoint frame_pos = pane.frame->GetPosition();
3756 wxPoint action_offset(pt.x-frame_pos.x, pt.y-frame_pos.y);
3757
3758 // if a key modifier is pressed while dragging the frame,
3759 // don't dock the window
3760 if (CanDockPanel(pane))
3761 {
3762 // do the drop calculation
3763 DoDrop(m_docks, m_panes, pane, client_pt, action_offset);
3764 }
3765
3766 // if the pane is still floating, update it's floating
3767 // position (that we store)
3768 if (pane.IsFloating())
3769 {
3770 pane.floating_pos = pane.frame->GetPosition();
3771
3772 if (m_flags & wxAUI_MGR_TRANSPARENT_DRAG)
3773 pane.frame->SetTransparent(255);
3774 }
3775 else if (m_has_maximized)
3776 {
3777 RestoreMaximizedPane();
3778 }
3779
3780 Update();
3781
3782 HideHint();
3783 }
3784
3785 void wxAuiManager::OnFloatingPaneResized(wxWindow* wnd, const wxSize& size)
3786 {
3787 // try to find the pane
3788 wxAuiPaneInfo& pane = GetPane(wnd);
3789 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
3790
3791 pane.floating_size = size;
3792 }
3793
3794
3795 void wxAuiManager::OnFloatingPaneClosed(wxWindow* wnd, wxCloseEvent& evt)
3796 {
3797 // try to find the pane
3798 wxAuiPaneInfo& pane = GetPane(wnd);
3799 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
3800
3801
3802 // fire pane close event
3803 wxAuiManagerEvent e(wxEVT_AUI_PANE_CLOSE);
3804 e.SetPane(&pane);
3805 e.SetCanVeto(evt.CanVeto());
3806 ProcessMgrEvent(e);
3807
3808 if (e.GetVeto())
3809 {
3810 evt.Veto();
3811 return;
3812 }
3813 else
3814 {
3815 // close the pane, but check that it
3816 // still exists in our pane array first
3817 // (the event handler above might have removed it)
3818
3819 wxAuiPaneInfo& check = GetPane(wnd);
3820 if (check.IsOk())
3821 {
3822 ClosePane(pane);
3823 }
3824 }
3825 }
3826
3827
3828
3829 void wxAuiManager::OnFloatingPaneActivated(wxWindow* wnd)
3830 {
3831 if ((GetFlags() & wxAUI_MGR_ALLOW_ACTIVE_PANE) && GetPane(wnd).IsOk())
3832 {
3833 SetActivePane(m_panes, wnd);
3834 Repaint();
3835 }
3836 }
3837
3838 // OnRender() draws all of the pane captions, sashes,
3839 // backgrounds, captions, grippers, pane borders and buttons.
3840 // It renders the entire user interface.
3841
3842 void wxAuiManager::OnRender(wxAuiManagerEvent& evt)
3843 {
3844 // if the frame is about to be deleted, don't bother
3845 if (!m_frame || wxPendingDelete.Member(m_frame))
3846 return;
3847
3848 wxDC* dc = evt.GetDC();
3849
3850 #ifdef __WXMAC__
3851 dc->Clear() ;
3852 #endif
3853 int i, part_count;
3854 for (i = 0, part_count = m_uiparts.GetCount();
3855 i < part_count; ++i)
3856 {
3857 wxAuiDockUIPart& part = m_uiparts.Item(i);
3858
3859 // don't draw hidden pane items or items that aren't windows
3860 if (part.sizer_item && ((!part.sizer_item->IsWindow() && !part.sizer_item->IsSpacer() && !part.sizer_item->IsSizer()) || !part.sizer_item->IsShown()))
3861 continue;
3862
3863 switch (part.type)
3864 {
3865 case wxAuiDockUIPart::typeDockSizer:
3866 case wxAuiDockUIPart::typePaneSizer:
3867 m_art->DrawSash(*dc, m_frame, part.orientation, part.rect);
3868 break;
3869 case wxAuiDockUIPart::typeBackground:
3870 m_art->DrawBackground(*dc, m_frame, part.orientation, part.rect);
3871 break;
3872 case wxAuiDockUIPart::typeCaption:
3873 m_art->DrawCaption(*dc, m_frame, part.pane->caption, part.rect, *part.pane);
3874 break;
3875 case wxAuiDockUIPart::typeGripper:
3876 m_art->DrawGripper(*dc, m_frame, part.rect, *part.pane);
3877 break;
3878 case wxAuiDockUIPart::typePaneBorder:
3879 m_art->DrawBorder(*dc, m_frame, part.rect, *part.pane);
3880 break;
3881 case wxAuiDockUIPart::typePaneButton:
3882 m_art->DrawPaneButton(*dc, m_frame, part.button->button_id,
3883 wxAUI_BUTTON_STATE_NORMAL, part.rect, *part.pane);
3884 break;
3885 }
3886 }
3887 }
3888
3889
3890 // Render() fire a render event, which is normally handled by
3891 // wxAuiManager::OnRender(). This allows the render function to
3892 // be overridden via the render event. This can be useful for paintin
3893 // custom graphics in the main window. Default behavior can be
3894 // invoked in the overridden function by calling OnRender()
3895
3896 void wxAuiManager::Render(wxDC* dc)
3897 {
3898 wxAuiManagerEvent e(wxEVT_AUI_RENDER);
3899 e.SetManager(this);
3900 e.SetDC(dc);
3901 ProcessMgrEvent(e);
3902 }
3903
3904 void wxAuiManager::Repaint(wxDC* dc)
3905 {
3906 #ifdef __WXMAC__
3907 if ( dc == NULL )
3908 {
3909 m_frame->Refresh() ;
3910 m_frame->Update() ;
3911 return ;
3912 }
3913 #endif
3914 int w, h;
3915 m_frame->GetClientSize(&w, &h);
3916
3917 // figure out which dc to use; if one
3918 // has been specified, use it, otherwise
3919 // make a client dc
3920 wxClientDC* client_dc = NULL;
3921 if (!dc)
3922 {
3923 client_dc = new wxClientDC(m_frame);
3924 dc = client_dc;
3925 }
3926
3927 // if the frame has a toolbar, the client area
3928 // origin will not be (0,0).
3929 wxPoint pt = m_frame->GetClientAreaOrigin();
3930 if (pt.x != 0 || pt.y != 0)
3931 dc->SetDeviceOrigin(pt.x, pt.y);
3932
3933 // render all the items
3934 Render(dc);
3935
3936 // if we created a client_dc, delete it
3937 if (client_dc)
3938 delete client_dc;
3939 }
3940
3941 void wxAuiManager::OnPaint(wxPaintEvent& WXUNUSED(event))
3942 {
3943 wxPaintDC dc(m_frame);
3944 Repaint(&dc);
3945 }
3946
3947 void wxAuiManager::OnEraseBackground(wxEraseEvent& event)
3948 {
3949 #ifdef __WXMAC__
3950 event.Skip() ;
3951 #else
3952 wxUnusedVar(event);
3953 #endif
3954 }
3955
3956 void wxAuiManager::OnSize(wxSizeEvent& event)
3957 {
3958 if (m_frame)
3959 {
3960 DoFrameLayout();
3961 Repaint();
3962
3963 #if wxUSE_MDI
3964 if (m_frame->IsKindOf(CLASSINFO(wxMDIParentFrame)))
3965 {
3966 // for MDI parent frames, this event must not
3967 // be "skipped". In other words, the parent frame
3968 // must not be allowed to resize the client window
3969 // after we are finished processing sizing changes
3970 return;
3971 }
3972 #endif
3973 }
3974 event.Skip();
3975 }
3976
3977 void wxAuiManager::OnFindManager(wxAuiManagerEvent& evt)
3978 {
3979 // get the window we are managing, if none, return NULL
3980 wxWindow* window = GetManagedWindow();
3981 if (!window)
3982 {
3983 evt.SetManager(NULL);
3984 return;
3985 }
3986
3987 // if we are managing a child frame, get the 'real' manager
3988 if (window->IsKindOf(CLASSINFO(wxAuiFloatingFrame)))
3989 {
3990 wxAuiFloatingFrame* float_frame = static_cast<wxAuiFloatingFrame*>(window);
3991 evt.SetManager(float_frame->GetOwnerManager());
3992 return;
3993 }
3994
3995 // return pointer to ourself
3996 evt.SetManager(this);
3997 }
3998
3999 void wxAuiManager::OnSetCursor(wxSetCursorEvent& event)
4000 {
4001 // determine cursor
4002 wxAuiDockUIPart* part = HitTest(event.GetX(), event.GetY());
4003 wxCursor cursor = wxNullCursor;
4004
4005 if (part)
4006 {
4007 if (part->type == wxAuiDockUIPart::typeDockSizer ||
4008 part->type == wxAuiDockUIPart::typePaneSizer)
4009 {
4010 // a dock may not be resized if it has a single
4011 // pane which is not resizable
4012 if (part->type == wxAuiDockUIPart::typeDockSizer && part->dock &&
4013 part->dock->panes.GetCount() == 1 &&
4014 part->dock->panes.Item(0)->IsFixed())
4015 return;
4016
4017 // panes that may not be resized do not get a sizing cursor
4018 if (part->pane && part->pane->IsFixed())
4019 return;
4020
4021 if (part->orientation == wxVERTICAL)
4022 cursor = wxCursor(wxCURSOR_SIZEWE);
4023 else
4024 cursor = wxCursor(wxCURSOR_SIZENS);
4025 }
4026 else if (part->type == wxAuiDockUIPart::typeGripper)
4027 {
4028 cursor = wxCursor(wxCURSOR_SIZING);
4029 }
4030 }
4031
4032 event.SetCursor(cursor);
4033 }
4034
4035
4036
4037 void wxAuiManager::UpdateButtonOnScreen(wxAuiDockUIPart* button_ui_part,
4038 const wxMouseEvent& event)
4039 {
4040 wxAuiDockUIPart* hit_test = HitTest(event.GetX(), event.GetY());
4041 if (!hit_test || !button_ui_part)
4042 return;
4043
4044 int state = wxAUI_BUTTON_STATE_NORMAL;
4045
4046 if (hit_test == button_ui_part)
4047 {
4048 if (event.LeftDown())
4049 state = wxAUI_BUTTON_STATE_PRESSED;
4050 else
4051 state = wxAUI_BUTTON_STATE_HOVER;
4052 }
4053 else
4054 {
4055 if (event.LeftDown())
4056 state = wxAUI_BUTTON_STATE_HOVER;
4057 }
4058
4059 // now repaint the button with hover state
4060 wxClientDC cdc(m_frame);
4061
4062 // if the frame has a toolbar, the client area
4063 // origin will not be (0,0).
4064 wxPoint pt = m_frame->GetClientAreaOrigin();
4065 if (pt.x != 0 || pt.y != 0)
4066 cdc.SetDeviceOrigin(pt.x, pt.y);
4067
4068 if (hit_test->pane)
4069 {
4070 m_art->DrawPaneButton(cdc, m_frame,
4071 button_ui_part->button->button_id,
4072 state,
4073 button_ui_part->rect,
4074 *hit_test->pane);
4075 }
4076 }
4077
4078 void wxAuiManager::OnLeftDown(wxMouseEvent& event)
4079 {
4080 m_currentDragItem = -1;
4081
4082 wxAuiDockUIPart* part = HitTest(event.GetX(), event.GetY());
4083 if (part)
4084 {
4085 if (part->type == wxAuiDockUIPart::typeDockSizer ||
4086 part->type == wxAuiDockUIPart::typePaneSizer)
4087 {
4088 // Removing this restriction so that a centre pane can be resized
4089 //if (part->dock && part->dock->dock_direction == wxAUI_DOCK_CENTER)
4090 // return;
4091
4092 // a dock may not be resized if it has a single
4093 // pane which is not resizable
4094 if (part->type == wxAuiDockUIPart::typeDockSizer && part->dock &&
4095 part->dock->panes.GetCount() == 1 &&
4096 part->dock->panes.Item(0)->IsFixed())
4097 return;
4098
4099 // panes that may not be resized should be ignored here
4100 if (part->pane && part->pane->IsFixed())
4101 return;
4102
4103 m_action = actionResize;
4104 m_action_part = part;
4105 m_action_hintrect = wxRect();
4106 m_action_start = wxPoint(event.m_x, event.m_y);
4107 m_action_offset = wxPoint(event.m_x - part->rect.x,
4108 event.m_y - part->rect.y);
4109 m_frame->CaptureMouse();
4110 }
4111 else if (part->type == wxAuiDockUIPart::typePaneButton)
4112 {
4113 m_action = actionClickButton;
4114 m_action_part = part;
4115 m_action_start = wxPoint(event.m_x, event.m_y);
4116 m_frame->CaptureMouse();
4117
4118 UpdateButtonOnScreen(part, event);
4119 }
4120 else if (part->type == wxAuiDockUIPart::typeCaption ||
4121 part->type == wxAuiDockUIPart::typeGripper)
4122 {
4123 // if we are managing a wxAuiFloatingFrame window, then
4124 // we are an embedded wxAuiManager inside the wxAuiFloatingFrame.
4125 // We want to initiate a toolbar drag in our owner manager
4126 wxWindow* managed_wnd = GetManagedWindow();
4127
4128 if (part->pane &&
4129 part->pane->window &&
4130 managed_wnd &&
4131 managed_wnd->IsKindOf(CLASSINFO(wxAuiFloatingFrame)))
4132 {
4133 wxAuiFloatingFrame* floating_frame = (wxAuiFloatingFrame*)managed_wnd;
4134 wxAuiManager* owner_mgr = floating_frame->GetOwnerManager();
4135 owner_mgr->StartPaneDrag(part->pane->window,
4136 wxPoint(event.m_x - part->rect.x,
4137 event.m_y - part->rect.y));
4138 return;
4139 }
4140
4141
4142
4143 if (GetFlags() & wxAUI_MGR_ALLOW_ACTIVE_PANE)
4144 {
4145 // set the caption as active
4146 SetActivePane(m_panes, part->pane->window);
4147 Repaint();
4148 }
4149
4150 if (part->dock && part->dock->dock_direction == wxAUI_DOCK_CENTER)
4151 return;
4152
4153 m_action = actionClickCaption;
4154 m_action_part = part;
4155 m_action_start = wxPoint(event.m_x, event.m_y);
4156 m_action_offset = wxPoint(event.m_x - part->rect.x,
4157 event.m_y - part->rect.y);
4158 m_frame->CaptureMouse();
4159 }
4160 #ifdef __WXMAC__
4161 else
4162 {
4163 event.Skip();
4164 }
4165 #endif
4166 }
4167 #ifdef __WXMAC__
4168 else
4169 {
4170 event.Skip();
4171 }
4172 #else
4173 event.Skip();
4174 #endif
4175 }
4176
4177 /// Ends a resize action, or for live update, resizes the sash
4178 bool wxAuiManager::DoEndResizeAction(wxMouseEvent& event)
4179 {
4180 // resize the dock or the pane
4181 if (m_action_part && m_action_part->type==wxAuiDockUIPart::typeDockSizer)
4182 {
4183 // first, we must calculate the maximum size the dock may be
4184 int sash_size = m_art->GetMetric(wxAUI_DOCKART_SASH_SIZE);
4185
4186 int used_width = 0, used_height = 0;
4187
4188 wxSize client_size = m_frame->GetClientSize();
4189
4190 size_t dock_i, dock_count = m_docks.GetCount();
4191 for (dock_i = 0; dock_i < dock_count; ++dock_i)
4192 {
4193 wxAuiDockInfo& dock = m_docks.Item(dock_i);
4194 if (dock.dock_direction == wxAUI_DOCK_TOP ||
4195 dock.dock_direction == wxAUI_DOCK_BOTTOM)
4196 {
4197 used_height += dock.size;
4198 }
4199 if (dock.dock_direction == wxAUI_DOCK_LEFT ||
4200 dock.dock_direction == wxAUI_DOCK_RIGHT)
4201 {
4202 used_width += dock.size;
4203 }
4204 if (dock.resizable)
4205 used_width += sash_size;
4206 }
4207
4208
4209 int available_width = client_size.GetWidth() - used_width;
4210 int available_height = client_size.GetHeight() - used_height;
4211
4212
4213 #if wxUSE_STATUSBAR
4214 // if there's a status control, the available
4215 // height decreases accordingly
4216 if (m_frame && m_frame->IsKindOf(CLASSINFO(wxFrame)))
4217 {
4218 wxFrame* frame = static_cast<wxFrame*>(m_frame);
4219 wxStatusBar* status = frame->GetStatusBar();
4220 if (status)
4221 {
4222 wxSize status_client_size = status->GetClientSize();
4223 available_height -= status_client_size.GetHeight();
4224 }
4225 }
4226 #endif
4227
4228 wxRect& rect = m_action_part->dock->rect;
4229
4230 wxPoint new_pos(event.m_x - m_action_offset.x,
4231 event.m_y - m_action_offset.y);
4232 int new_size, old_size = m_action_part->dock->size;
4233
4234 switch (m_action_part->dock->dock_direction)
4235 {
4236 case wxAUI_DOCK_LEFT:
4237 new_size = new_pos.x - rect.x;
4238 if (new_size-old_size > available_width)
4239 new_size = old_size+available_width;
4240 m_action_part->dock->size = new_size;
4241 break;
4242 case wxAUI_DOCK_TOP:
4243 new_size = new_pos.y - rect.y;
4244 if (new_size-old_size > available_height)
4245 new_size = old_size+available_height;
4246 m_action_part->dock->size = new_size;
4247 break;
4248 case wxAUI_DOCK_RIGHT:
4249 new_size = rect.x + rect.width - new_pos.x -
4250 m_action_part->rect.GetWidth();
4251 if (new_size-old_size > available_width)
4252 new_size = old_size+available_width;
4253 m_action_part->dock->size = new_size;
4254 break;
4255 case wxAUI_DOCK_BOTTOM:
4256 new_size = rect.y + rect.height -
4257 new_pos.y - m_action_part->rect.GetHeight();
4258 if (new_size-old_size > available_height)
4259 new_size = old_size+available_height;
4260 m_action_part->dock->size = new_size;
4261 break;
4262 }
4263
4264 Update();
4265 Repaint(NULL);
4266 }
4267 else if (m_action_part &&
4268 m_action_part->type == wxAuiDockUIPart::typePaneSizer)
4269 {
4270 wxAuiDockInfo& dock = *m_action_part->dock;
4271 wxAuiPaneInfo& pane = *m_action_part->pane;
4272
4273 int total_proportion = 0;
4274 int dock_pixels = 0;
4275 int new_pixsize = 0;
4276
4277 int caption_size = m_art->GetMetric(wxAUI_DOCKART_CAPTION_SIZE);
4278 int pane_border_size = m_art->GetMetric(wxAUI_DOCKART_PANE_BORDER_SIZE);
4279 int sash_size = m_art->GetMetric(wxAUI_DOCKART_SASH_SIZE);
4280
4281 wxPoint new_pos(event.m_x - m_action_offset.x,
4282 event.m_y - m_action_offset.y);
4283
4284 // determine the pane rectangle by getting the pane part
4285 wxAuiDockUIPart* pane_part = GetPanePart(pane.window);
4286 wxASSERT_MSG(pane_part,
4287 wxT("Pane border part not found -- shouldn't happen"));
4288
4289 // determine the new pixel size that the user wants;
4290 // this will help us recalculate the pane's proportion
4291 if (dock.IsHorizontal())
4292 new_pixsize = new_pos.x - pane_part->rect.x;
4293 else
4294 new_pixsize = new_pos.y - pane_part->rect.y;
4295
4296 // determine the size of the dock, based on orientation
4297 if (dock.IsHorizontal())
4298 dock_pixels = dock.rect.GetWidth();
4299 else
4300 dock_pixels = dock.rect.GetHeight();
4301
4302 // determine the total proportion of all resizable panes,
4303 // and the total size of the dock minus the size of all
4304 // the fixed panes
4305 int i, dock_pane_count = dock.panes.GetCount();
4306 int pane_position = -1;
4307 for (i = 0; i < dock_pane_count; ++i)
4308 {
4309 wxAuiPaneInfo& p = *dock.panes.Item(i);
4310 if (p.window == pane.window)
4311 pane_position = i;
4312
4313 // while we're at it, subtract the pane sash
4314 // width from the dock width, because this would
4315 // skew our proportion calculations
4316 if (i > 0)
4317 dock_pixels -= sash_size;
4318
4319 // also, the whole size (including decorations) of
4320 // all fixed panes must also be subtracted, because they
4321 // are not part of the proportion calculation
4322 if (p.IsFixed())
4323 {
4324 if (dock.IsHorizontal())
4325 dock_pixels -= p.best_size.x;
4326 else
4327 dock_pixels -= p.best_size.y;
4328 }
4329 else
4330 {
4331 total_proportion += p.dock_proportion;
4332 }
4333 }
4334
4335 // new size can never be more than the number of dock pixels
4336 if (new_pixsize > dock_pixels)
4337 new_pixsize = dock_pixels;
4338
4339
4340 // find a pane in our dock to 'steal' space from or to 'give'
4341 // space to -- this is essentially what is done when a pane is
4342 // resized; the pane should usually be the first non-fixed pane
4343 // to the right of the action pane
4344 int borrow_pane = -1;
4345 for (i = pane_position+1; i < dock_pane_count; ++i)
4346 {
4347 wxAuiPaneInfo& p = *dock.panes.Item(i);
4348 if (!p.IsFixed())
4349 {
4350 borrow_pane = i;
4351 break;
4352 }
4353 }
4354
4355
4356 // demand that the pane being resized is found in this dock
4357 // (this assert really never should be raised)
4358 wxASSERT_MSG(pane_position != -1, wxT("Pane not found in dock"));
4359
4360 // prevent division by zero
4361 if (dock_pixels == 0 || total_proportion == 0 || borrow_pane == -1)
4362 {
4363 m_action = actionNone;
4364 return false;
4365 }
4366
4367 // calculate the new proportion of the pane
4368 int new_proportion = (new_pixsize*total_proportion)/dock_pixels;
4369
4370 // default minimum size
4371 int min_size = 0;
4372
4373 // check against the pane's minimum size, if specified. please note
4374 // that this is not enough to ensure that the minimum size will
4375 // not be violated, because the whole frame might later be shrunk,
4376 // causing the size of the pane to violate it's minimum size
4377 if (pane.min_size.IsFullySpecified())
4378 {
4379 min_size = 0;
4380
4381 if (pane.HasBorder())
4382 min_size += (pane_border_size*2);
4383
4384 // calculate minimum size with decorations (border,caption)
4385 if (pane_part->orientation == wxVERTICAL)
4386 {
4387 min_size += pane.min_size.y;
4388 if (pane.HasCaption())
4389 min_size += caption_size;
4390 }
4391 else
4392 {
4393 min_size += pane.min_size.x;
4394 }
4395 }
4396
4397
4398 // for some reason, an arithmatic error somewhere is causing
4399 // the proportion calculations to always be off by 1 pixel;
4400 // for now we will add the 1 pixel on, but we really should
4401 // determine what's causing this.
4402 min_size++;
4403
4404 int min_proportion = (min_size*total_proportion)/dock_pixels;
4405
4406 if (new_proportion < min_proportion)
4407 new_proportion = min_proportion;
4408
4409
4410
4411 int prop_diff = new_proportion - pane.dock_proportion;
4412
4413 // borrow the space from our neighbor pane to the
4414 // right or bottom (depending on orientation);
4415 // also make sure we don't make the neighbor too small
4416 int prop_borrow = dock.panes.Item(borrow_pane)->dock_proportion;
4417
4418 if (prop_borrow - prop_diff < 0)
4419 {
4420 // borrowing from other pane would make it too small,
4421 // so cancel the resize operation
4422 prop_borrow = min_proportion;
4423 }
4424 else
4425 {
4426 prop_borrow -= prop_diff;
4427 }
4428
4429
4430 dock.panes.Item(borrow_pane)->dock_proportion = prop_borrow;
4431 pane.dock_proportion = new_proportion;
4432
4433
4434 // repaint
4435 Update();
4436 Repaint(NULL);
4437 }
4438
4439 return true;
4440 }
4441
4442 void wxAuiManager::OnLeftUp(wxMouseEvent& event)
4443 {
4444 if (m_action == actionResize)
4445 {
4446 m_frame->ReleaseMouse();
4447
4448 if (!wxAuiManager_HasLiveResize(*this))
4449 {
4450 // get rid of the hint rectangle
4451 wxScreenDC dc;
4452 DrawResizeHint(dc, m_action_hintrect);
4453 }
4454 if (m_currentDragItem != -1 && wxAuiManager_HasLiveResize(*this))
4455 m_action_part = & (m_uiparts.Item(m_currentDragItem));
4456
4457 DoEndResizeAction(event);
4458
4459 m_currentDragItem = -1;
4460
4461 }
4462 else if (m_action == actionClickButton)
4463 {
4464 m_hover_button = NULL;
4465 m_frame->ReleaseMouse();
4466
4467 if (m_action_part)
4468 {
4469 UpdateButtonOnScreen(m_action_part, event);
4470
4471 // make sure we're still over the item that was originally clicked
4472 if (m_action_part == HitTest(event.GetX(), event.GetY()))
4473 {
4474 // fire button-click event
4475 wxAuiManagerEvent e(wxEVT_AUI_PANE_BUTTON);
4476 e.SetManager(this);
4477 e.SetPane(m_action_part->pane);
4478 e.SetButton(m_action_part->button->button_id);
4479 ProcessMgrEvent(e);
4480 }
4481 }
4482 }
4483 else if (m_action == actionClickCaption)
4484 {
4485 m_frame->ReleaseMouse();
4486 }
4487 else if (m_action == actionDragFloatingPane)
4488 {
4489 m_frame->ReleaseMouse();
4490 }
4491 else if (m_action == actionDragToolbarPane)
4492 {
4493 m_frame->ReleaseMouse();
4494
4495 wxAuiPaneInfo& pane = GetPane(m_action_window);
4496 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
4497
4498 // save the new positions
4499 wxAuiDockInfoPtrArray docks;
4500 FindDocks(m_docks, pane.dock_direction,
4501 pane.dock_layer, pane.dock_row, docks);
4502 if (docks.GetCount() == 1)
4503 {
4504 wxAuiDockInfo& dock = *docks.Item(0);
4505
4506 wxArrayInt pane_positions, pane_sizes;
4507 GetPanePositionsAndSizes(dock, pane_positions, pane_sizes);
4508
4509 int i, dock_pane_count = dock.panes.GetCount();
4510 for (i = 0; i < dock_pane_count; ++i)
4511 dock.panes.Item(i)->dock_pos = pane_positions[i];
4512 }
4513
4514 pane.state &= ~wxAuiPaneInfo::actionPane;
4515 Update();
4516 }
4517 else
4518 {
4519 event.Skip();
4520 }
4521
4522 m_action = actionNone;
4523 m_last_mouse_move = wxPoint(); // see comment in OnMotion()
4524 }
4525
4526
4527 void wxAuiManager::OnMotion(wxMouseEvent& event)
4528 {
4529 // sometimes when Update() is called from inside this method,
4530 // a spurious mouse move event is generated; this check will make
4531 // sure that only real mouse moves will get anywhere in this method;
4532 // this appears to be a bug somewhere, and I don't know where the
4533 // mouse move event is being generated. only verified on MSW
4534
4535 wxPoint mouse_pos = event.GetPosition();
4536 if (m_last_mouse_move == mouse_pos)
4537 return;
4538 m_last_mouse_move = mouse_pos;
4539
4540
4541 if (m_action == actionResize)
4542 {
4543 // It's necessary to reset m_action_part since it destroyed
4544 // by the Update within DoEndResizeAction.
4545 if (m_currentDragItem != -1)
4546 m_action_part = & (m_uiparts.Item(m_currentDragItem));
4547 else
4548 m_currentDragItem = m_uiparts.Index(* m_action_part);
4549
4550 if (m_action_part)
4551 {
4552 wxPoint pos = m_action_part->rect.GetPosition();
4553 if (m_action_part->orientation == wxHORIZONTAL)
4554 pos.y = wxMax(0, event.m_y - m_action_offset.y);
4555 else
4556 pos.x = wxMax(0, event.m_x - m_action_offset.x);
4557
4558 if (wxAuiManager_HasLiveResize(*this))
4559 {
4560 m_frame->ReleaseMouse();
4561 DoEndResizeAction(event);
4562 m_frame->CaptureMouse();
4563 }
4564 else
4565 {
4566 wxRect rect(m_frame->ClientToScreen(pos),
4567 m_action_part->rect.GetSize());
4568 wxScreenDC dc;
4569
4570 if (!m_action_hintrect.IsEmpty())
4571 {
4572 // remove old resize hint
4573 DrawResizeHint(dc, m_action_hintrect);
4574 m_action_hintrect = wxRect();
4575 }
4576
4577 // draw new resize hint, if it's inside the managed frame
4578 wxRect frame_screen_rect = m_frame->GetScreenRect();
4579 if (frame_screen_rect.Contains(rect))
4580 {
4581 DrawResizeHint(dc, rect);
4582 m_action_hintrect = rect;
4583 }
4584 }
4585 }
4586 }
4587 else if (m_action == actionClickCaption)
4588 {
4589 int drag_x_threshold = wxSystemSettings::GetMetric(wxSYS_DRAG_X);
4590 int drag_y_threshold = wxSystemSettings::GetMetric(wxSYS_DRAG_Y);
4591
4592 // caption has been clicked. we need to check if the mouse
4593 // is now being dragged. if it is, we need to change the
4594 // mouse action to 'drag'
4595 if (m_action_part &&
4596 (abs(event.m_x - m_action_start.x) > drag_x_threshold ||
4597 abs(event.m_y - m_action_start.y) > drag_y_threshold))
4598 {
4599 wxAuiPaneInfo* pane_info = m_action_part->pane;
4600
4601 if (!pane_info->IsToolbar())
4602 {
4603 if ((m_flags & wxAUI_MGR_ALLOW_FLOATING) &&
4604 pane_info->IsFloatable())
4605 {
4606 m_action = actionDragFloatingPane;
4607
4608 // set initial float position
4609 wxPoint pt = m_frame->ClientToScreen(event.GetPosition());
4610 pane_info->floating_pos = wxPoint(pt.x - m_action_offset.x,
4611 pt.y - m_action_offset.y);
4612
4613 // float the window
4614 if (pane_info->IsMaximized())
4615 RestorePane(*pane_info);
4616 pane_info->Float();
4617 Update();
4618
4619 m_action_window = pane_info->frame;
4620
4621 // action offset is used here to make it feel "natural" to the user
4622 // to drag a docked pane and suddenly have it become a floating frame.
4623 // Sometimes, however, the offset where the user clicked on the docked
4624 // caption is bigger than the width of the floating frame itself, so
4625 // in that case we need to set the action offset to a sensible value
4626 wxSize frame_size = m_action_window->GetSize();
4627 if (frame_size.x <= m_action_offset.x)
4628 m_action_offset.x = 30;
4629 }
4630 }
4631 else
4632 {
4633 m_action = actionDragToolbarPane;
4634 m_action_window = pane_info->window;
4635 }
4636 }
4637 }
4638 else if (m_action == actionDragFloatingPane)
4639 {
4640 if (m_action_window)
4641 {
4642 wxPoint pt = m_frame->ClientToScreen(event.GetPosition());
4643 m_action_window->Move(pt.x - m_action_offset.x,
4644 pt.y - m_action_offset.y);
4645 }
4646 }
4647 else if (m_action == actionDragToolbarPane)
4648 {
4649 wxAuiPaneInfo& pane = GetPane(m_action_window);
4650 wxASSERT_MSG(pane.IsOk(), wxT("Pane window not found"));
4651
4652 pane.SetFlag(wxAuiPaneInfo::actionPane, true);
4653
4654 wxPoint pt = event.GetPosition();
4655 DoDrop(m_docks, m_panes, pane, pt, m_action_offset);
4656
4657 // if DoDrop() decided to float the pane, set up
4658 // the floating pane's initial position
4659 if (pane.IsFloating())
4660 {
4661 wxPoint pt = m_frame->ClientToScreen(event.GetPosition());
4662 pane.floating_pos = wxPoint(pt.x - m_action_offset.x,
4663 pt.y - m_action_offset.y);
4664 }
4665
4666 // this will do the actiual move operation;
4667 // in the case that the pane has been floated,
4668 // this call will create the floating pane
4669 // and do the reparenting
4670 Update();
4671
4672 // if the pane has been floated, change the mouse
4673 // action actionDragFloatingPane so that subsequent
4674 // EVT_MOTION() events will move the floating pane
4675 if (pane.IsFloating())
4676 {
4677 pane.state &= ~wxAuiPaneInfo::actionPane;
4678 m_action = actionDragFloatingPane;
4679 m_action_window = pane.frame;
4680 }
4681 }
4682 else
4683 {
4684 wxAuiDockUIPart* part = HitTest(event.GetX(), event.GetY());
4685 if (part && part->type == wxAuiDockUIPart::typePaneButton)
4686 {
4687 if (part != m_hover_button)
4688 {
4689 // make the old button normal
4690 if (m_hover_button)
4691 {
4692 UpdateButtonOnScreen(m_hover_button, event);
4693 Repaint();
4694 }
4695
4696 // mouse is over a button, so repaint the
4697 // button in hover mode
4698 UpdateButtonOnScreen(part, event);
4699 m_hover_button = part;
4700
4701 }
4702 }
4703 else
4704 {
4705 if (m_hover_button)
4706 {
4707 m_hover_button = NULL;
4708 Repaint();
4709 }
4710 else
4711 {
4712 event.Skip();
4713 }
4714 }
4715 }
4716 }
4717
4718 void wxAuiManager::OnLeaveWindow(wxMouseEvent& WXUNUSED(event))
4719 {
4720 if (m_hover_button)
4721 {
4722 m_hover_button = NULL;
4723 Repaint();
4724 }
4725 }
4726
4727 void wxAuiManager::OnCaptureLost(wxMouseCaptureLostEvent& WXUNUSED(event))
4728 {
4729 // cancel the operation in progress, if any
4730 if ( m_action != actionNone )
4731 {
4732 m_action = actionNone;
4733 HideHint();
4734 }
4735 }
4736
4737 void wxAuiManager::OnChildFocus(wxChildFocusEvent& event)
4738 {
4739 // when a child pane has it's focus set, we should change the
4740 // pane's active state to reflect this. (this is only true if
4741 // active panes are allowed by the owner)
4742 if (GetFlags() & wxAUI_MGR_ALLOW_ACTIVE_PANE)
4743 {
4744 wxAuiPaneInfo& pane = GetPane(event.GetWindow());
4745 if (pane.IsOk() && (pane.state & wxAuiPaneInfo::optionActive) == 0)
4746 {
4747 SetActivePane(m_panes, event.GetWindow());
4748 m_frame->Refresh();
4749 }
4750 }
4751
4752 event.Skip();
4753 }
4754
4755
4756 // OnPaneButton() is an event handler that is called
4757 // when a pane button has been pressed.
4758 void wxAuiManager::OnPaneButton(wxAuiManagerEvent& evt)
4759 {
4760 wxASSERT_MSG(evt.pane, wxT("Pane Info passed to wxAuiManager::OnPaneButton must be non-null"));
4761
4762 wxAuiPaneInfo& pane = *(evt.pane);
4763
4764 if (evt.button == wxAUI_BUTTON_CLOSE)
4765 {
4766 // fire pane close event
4767 wxAuiManagerEvent e(wxEVT_AUI_PANE_CLOSE);
4768 e.SetManager(this);
4769 e.SetPane(evt.pane);
4770 ProcessMgrEvent(e);
4771
4772 if (!e.GetVeto())
4773 {
4774 // close the pane, but check that it
4775 // still exists in our pane array first
4776 // (the event handler above might have removed it)
4777
4778 wxAuiPaneInfo& check = GetPane(pane.window);
4779 if (check.IsOk())
4780 {
4781 ClosePane(pane);
4782 }
4783
4784 Update();
4785 }
4786 }
4787 else if (evt.button == wxAUI_BUTTON_MAXIMIZE_RESTORE && !pane.IsMaximized())
4788 {
4789 // fire pane close event
4790 wxAuiManagerEvent e(wxEVT_AUI_PANE_MAXIMIZE);
4791 e.SetManager(this);
4792 e.SetPane(evt.pane);
4793 ProcessMgrEvent(e);
4794
4795 if (!e.GetVeto())
4796 {
4797 MaximizePane(pane);
4798 Update();
4799 }
4800 }
4801 else if (evt.button == wxAUI_BUTTON_MAXIMIZE_RESTORE && pane.IsMaximized())
4802 {
4803 // fire pane close event
4804 wxAuiManagerEvent e(wxEVT_AUI_PANE_RESTORE);
4805 e.SetManager(this);
4806 e.SetPane(evt.pane);
4807 ProcessMgrEvent(e);
4808
4809 if (!e.GetVeto())
4810 {
4811 RestorePane(pane);
4812 Update();
4813 }
4814 }
4815 else if (evt.button == wxAUI_BUTTON_PIN)
4816 {
4817 if ((m_flags & wxAUI_MGR_ALLOW_FLOATING) &&
4818 pane.IsFloatable())
4819 pane.Float();
4820 Update();
4821 }
4822 }
4823
4824 #endif // wxUSE_AUI