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