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