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