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