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