1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/aui/tabmdi.cpp
3 // Purpose: Generic MDI (Multiple Document Interface) classes
4 // Author: Hans Van Leemputten
5 // Modified by: Benjamin I. Williams / Kirix Corporation
8 // Copyright: (c) Hans Van Leemputten
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ===========================================================================
14 // ===========================================================================
16 // ---------------------------------------------------------------------------
18 // ---------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
30 #include "wx/aui/tabmdi.h"
37 #include "wx/settings.h"
40 #include "wx/stockitem.h"
50 //-----------------------------------------------------------------------------
51 // wxAuiMDIParentFrame
52 //-----------------------------------------------------------------------------
54 IMPLEMENT_DYNAMIC_CLASS(wxAuiMDIParentFrame
, wxFrame
)
56 BEGIN_EVENT_TABLE(wxAuiMDIParentFrame
, wxFrame
)
58 EVT_MENU (wxID_ANY
, wxAuiMDIParentFrame::DoHandleMenu
)
62 wxAuiMDIParentFrame::wxAuiMDIParentFrame()
67 wxAuiMDIParentFrame::wxAuiMDIParentFrame(wxWindow
*parent
,
69 const wxString
& title
,
76 (void)Create(parent
, id
, title
, pos
, size
, style
, name
);
79 wxAuiMDIParentFrame::~wxAuiMDIParentFrame()
81 // Make sure the client window is destructed before the menu bars are!
82 wxDELETE(m_pClientWindow
);
85 wxDELETE(m_pMyMenuBar
);
86 RemoveWindowMenu(GetMenuBar());
87 wxDELETE(m_pWindowMenu
);
91 bool wxAuiMDIParentFrame::Create(wxWindow
*parent
,
93 const wxString
& title
,
100 // this style can be used to prevent a window from having the standard MDI
102 if (!(style
& wxFRAME_NO_WINDOW_MENU
))
104 m_pWindowMenu
= new wxMenu
;
105 m_pWindowMenu
->Append(wxWINDOWCLOSE
, _("Cl&ose"));
106 m_pWindowMenu
->Append(wxWINDOWCLOSEALL
, _("Close All"));
107 m_pWindowMenu
->AppendSeparator();
108 m_pWindowMenu
->Append(wxWINDOWNEXT
, _("&Next"));
109 m_pWindowMenu
->Append(wxWINDOWPREV
, _("&Previous"));
111 #endif // wxUSE_MENUS
113 if ( !wxFrame::Create(parent
, id
, title
, pos
, size
, style
, name
) )
116 m_pClientWindow
= OnCreateClient();
117 return m_pClientWindow
!= NULL
;
121 void wxAuiMDIParentFrame::SetArtProvider(wxAuiTabArt
* provider
)
125 m_pClientWindow
->SetArtProvider(provider
);
129 wxAuiTabArt
* wxAuiMDIParentFrame::GetArtProvider()
131 if (!m_pClientWindow
)
134 return m_pClientWindow
->GetArtProvider();
137 wxAuiNotebook
* wxAuiMDIParentFrame::GetNotebook() const
139 return static_cast<wxAuiNotebook
*>(m_pClientWindow
);
145 void wxAuiMDIParentFrame::SetWindowMenu(wxMenu
* pMenu
)
147 // Replace the window menu from the currently loaded menu bar.
148 wxMenuBar
*pMenuBar
= GetMenuBar();
152 RemoveWindowMenu(pMenuBar
);
153 wxDELETE(m_pWindowMenu
);
158 m_pWindowMenu
= pMenu
;
159 AddWindowMenu(pMenuBar
);
163 void wxAuiMDIParentFrame::SetMenuBar(wxMenuBar
* pMenuBar
)
165 // Remove the Window menu from the old menu bar
166 RemoveWindowMenu(GetMenuBar());
168 // Add the Window menu to the new menu bar.
169 AddWindowMenu(pMenuBar
);
171 wxFrame::SetMenuBar(pMenuBar
);
172 //m_pMyMenuBar = GetMenuBar();
174 #endif // wxUSE_MENUS
176 void wxAuiMDIParentFrame::SetChildMenuBar(wxAuiMDIChildFrame
* pChild
)
181 // No Child, set Our menu bar back.
183 SetMenuBar(m_pMyMenuBar
);
185 SetMenuBar(GetMenuBar());
187 // Make sure we know our menu bar is in use
192 if (pChild
->GetMenuBar() == NULL
)
195 // Do we need to save the current bar?
196 if (m_pMyMenuBar
== NULL
)
197 m_pMyMenuBar
= GetMenuBar();
199 SetMenuBar(pChild
->GetMenuBar());
201 #endif // wxUSE_MENUS
204 bool wxAuiMDIParentFrame::ProcessEvent(wxEvent
& event
)
206 // stops the same event being processed repeatedly
207 if (m_pLastEvt
== &event
)
211 // let the active child (if any) process the event first.
213 if (m_pActiveChild
&&
214 event
.IsCommandEvent() &&
215 event
.GetEventObject() != m_pClientWindow
&&
216 !(event
.GetEventType() == wxEVT_ACTIVATE
||
217 event
.GetEventType() == wxEVT_SET_FOCUS
||
218 event
.GetEventType() == wxEVT_KILL_FOCUS
||
219 event
.GetEventType() == wxEVT_CHILD_FOCUS
||
220 event
.GetEventType() == wxEVT_COMMAND_SET_FOCUS
||
221 event
.GetEventType() == wxEVT_COMMAND_KILL_FOCUS
)
224 res
= m_pActiveChild
->GetEventHandler()->ProcessEvent(event
);
229 // if the event was not handled this frame will handle it,
230 // which is why we need the protection code at the beginning
232 res
= wxEvtHandler::ProcessEvent(event
);
240 wxAuiMDIChildFrame
*wxAuiMDIParentFrame::GetActiveChild() const
242 return m_pActiveChild
;
245 void wxAuiMDIParentFrame::SetActiveChild(wxAuiMDIChildFrame
* pChildFrame
)
247 m_pActiveChild
= pChildFrame
;
250 wxAuiMDIClientWindow
*wxAuiMDIParentFrame::GetClientWindow() const
252 return m_pClientWindow
;
255 wxAuiMDIClientWindow
*wxAuiMDIParentFrame::OnCreateClient()
257 return new wxAuiMDIClientWindow( this );
260 void wxAuiMDIParentFrame::ActivateNext()
262 if (m_pClientWindow
&& m_pClientWindow
->GetSelection() != wxNOT_FOUND
)
264 size_t active
= m_pClientWindow
->GetSelection() + 1;
265 if (active
>= m_pClientWindow
->GetPageCount())
268 m_pClientWindow
->SetSelection(active
);
272 void wxAuiMDIParentFrame::ActivatePrevious()
274 if (m_pClientWindow
&& m_pClientWindow
->GetSelection() != wxNOT_FOUND
)
276 int active
= m_pClientWindow
->GetSelection() - 1;
278 active
= m_pClientWindow
->GetPageCount() - 1;
280 m_pClientWindow
->SetSelection(active
);
284 void wxAuiMDIParentFrame::Init()
287 m_pClientWindow
= NULL
;
288 m_pActiveChild
= NULL
;
290 m_pWindowMenu
= NULL
;
292 #endif // wxUSE_MENUS
296 void wxAuiMDIParentFrame::RemoveWindowMenu(wxMenuBar
* pMenuBar
)
298 if (pMenuBar
&& m_pWindowMenu
)
300 // Remove old window menu
301 int pos
= pMenuBar
->FindMenu(_("&Window"));
302 if (pos
!= wxNOT_FOUND
)
304 // DBG:: We're going to delete the wrong menu!!!
305 wxASSERT(m_pWindowMenu
== pMenuBar
->GetMenu(pos
));
306 pMenuBar
->Remove(pos
);
311 void wxAuiMDIParentFrame::AddWindowMenu(wxMenuBar
*pMenuBar
)
313 if (pMenuBar
&& m_pWindowMenu
)
315 int pos
= pMenuBar
->FindMenu(wxGetStockLabel(wxID_HELP
,wxSTOCK_NOFLAGS
));
316 if (pos
== wxNOT_FOUND
)
317 pMenuBar
->Append(m_pWindowMenu
, _("&Window"));
319 pMenuBar
->Insert(pos
, m_pWindowMenu
, _("&Window"));
323 void wxAuiMDIParentFrame::DoHandleMenu(wxCommandEvent
& event
)
325 switch (event
.GetId())
329 m_pActiveChild
->Close();
331 case wxWINDOWCLOSEALL
:
332 while (m_pActiveChild
)
334 if (!m_pActiveChild
->Close())
350 #endif // wxUSE_MENUS
352 void wxAuiMDIParentFrame::DoGetClientSize(int* width
, int* height
) const
354 wxFrame::DoGetClientSize(width
, height
);
357 void wxAuiMDIParentFrame::Tile(wxOrientation orient
)
359 wxAuiMDIClientWindow
* client_window
= GetClientWindow();
360 wxASSERT_MSG(client_window
, wxT("Missing MDI Client Window"));
362 int cur_idx
= client_window
->GetSelection();
366 if (orient
== wxVERTICAL
)
368 client_window
->Split(cur_idx
, wxLEFT
);
370 else if (orient
== wxHORIZONTAL
)
372 client_window
->Split(cur_idx
, wxTOP
);
377 //-----------------------------------------------------------------------------
378 // wxAuiMDIChildFrame
379 //-----------------------------------------------------------------------------
381 IMPLEMENT_DYNAMIC_CLASS(wxAuiMDIChildFrame
, wxPanel
)
383 BEGIN_EVENT_TABLE(wxAuiMDIChildFrame
, wxPanel
)
384 EVT_MENU_HIGHLIGHT_ALL(wxAuiMDIChildFrame::OnMenuHighlight
)
385 EVT_ACTIVATE(wxAuiMDIChildFrame::OnActivate
)
386 EVT_CLOSE(wxAuiMDIChildFrame::OnCloseWindow
)
389 wxAuiMDIChildFrame::wxAuiMDIChildFrame()
394 wxAuiMDIChildFrame::wxAuiMDIChildFrame(wxAuiMDIParentFrame
*parent
,
396 const wxString
& title
,
397 const wxPoint
& WXUNUSED(pos
),
400 const wxString
& name
)
404 // There are two ways to create an tabbed mdi child fram without
405 // making it the active document. Either Show(false) can be called
406 // before Create() (as is customary on some ports with wxFrame-type
407 // windows), or wxMINIMIZE can be passed in the style flags. Note that
408 // wxAuiMDIChildFrame is not really derived from wxFrame, as wxMDIChildFrame
409 // is, but those are the expected symantics. No style flag is passed
410 // onto the panel underneath.
411 if (style
& wxMINIMIZE
)
412 m_activate_on_create
= false;
414 Create(parent
, id
, title
, wxDefaultPosition
, size
, 0, name
);
417 wxAuiMDIChildFrame::~wxAuiMDIChildFrame()
419 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
420 if (pParentFrame
&& pParentFrame
->GetActiveChild() == this)
422 pParentFrame
->SetActiveChild(NULL
);
423 pParentFrame
->SetChildMenuBar(NULL
);
427 wxDELETE(m_pMenuBar
);
428 #endif // wxUSE_MENUS
431 bool wxAuiMDIChildFrame::Create(wxAuiMDIParentFrame
* parent
,
433 const wxString
& title
,
434 const wxPoint
& WXUNUSED(pos
),
437 const wxString
& name
)
439 wxAuiMDIClientWindow
* pClientWindow
= parent
->GetClientWindow();
440 wxASSERT_MSG((pClientWindow
!= (wxWindow
*) NULL
), wxT("Missing MDI client window."));
442 // see comment in constructor
443 if (style
& wxMINIMIZE
)
444 m_activate_on_create
= false;
446 wxSize cli_size
= pClientWindow
->GetClientSize();
448 // create the window off-screen to prevent flicker
449 wxPanel::Create(pClientWindow
,
451 wxPoint(cli_size
.x
+1, cli_size
.y
+1),
457 SetMDIParentFrame(parent
);
459 // this is the currently active child
460 parent
->SetActiveChild(this);
464 pClientWindow
->AddPage(this, title
, m_activate_on_create
);
465 pClientWindow
->Refresh();
470 bool wxAuiMDIChildFrame::Destroy()
472 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
473 wxASSERT_MSG(pParentFrame
, wxT("Missing MDI Parent Frame"));
475 wxAuiMDIClientWindow
* pClientWindow
= pParentFrame
->GetClientWindow();
476 wxASSERT_MSG(pClientWindow
, wxT("Missing MDI Client Window"));
478 if (pParentFrame
->GetActiveChild() == this)
480 // deactivate ourself
481 wxActivateEvent
event(wxEVT_ACTIVATE
, false, GetId());
482 event
.SetEventObject(this);
483 GetEventHandler()->ProcessEvent(event
);
485 pParentFrame
->SetActiveChild(NULL
);
486 pParentFrame
->SetChildMenuBar(NULL
);
489 size_t page_count
= pClientWindow
->GetPageCount();
490 for (size_t pos
= 0; pos
< page_count
; pos
++)
492 if (pClientWindow
->GetPage(pos
) == this)
493 return pClientWindow
->DeletePage(pos
);
500 void wxAuiMDIChildFrame::SetMenuBar(wxMenuBar
*menu_bar
)
502 wxMenuBar
*pOldMenuBar
= m_pMenuBar
;
503 m_pMenuBar
= menu_bar
;
507 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
508 wxASSERT_MSG(pParentFrame
, wxT("Missing MDI Parent Frame"));
510 m_pMenuBar
->SetParent(pParentFrame
);
511 if (pParentFrame
->GetActiveChild() == this)
513 // replace current menu bars
515 pParentFrame
->SetChildMenuBar(NULL
);
516 pParentFrame
->SetChildMenuBar(this);
521 wxMenuBar
*wxAuiMDIChildFrame::GetMenuBar() const
525 #endif // wxUSE_MENUS
527 void wxAuiMDIChildFrame::SetTitle(const wxString
& title
)
531 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
532 wxASSERT_MSG(pParentFrame
, wxT("Missing MDI Parent Frame"));
534 wxAuiMDIClientWindow
* pClientWindow
= pParentFrame
->GetClientWindow();
535 if (pClientWindow
!= NULL
)
538 for (pos
= 0; pos
< pClientWindow
->GetPageCount(); pos
++)
540 if (pClientWindow
->GetPage(pos
) == this)
542 pClientWindow
->SetPageText(pos
, m_title
);
549 wxString
wxAuiMDIChildFrame::GetTitle() const
554 void wxAuiMDIChildFrame::SetIcons(const wxIconBundle
& icons
)
556 // get icon with the system icon size
557 SetIcon(icons
.GetIcon(-1));
558 m_icon_bundle
= icons
;
561 const wxIconBundle
& wxAuiMDIChildFrame::GetIcons() const
563 return m_icon_bundle
;
566 void wxAuiMDIChildFrame::SetIcon(const wxIcon
& icon
)
568 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
569 wxASSERT_MSG(pParentFrame
, wxT("Missing MDI Parent Frame"));
574 bmp
.CopyFromIcon(m_icon
);
576 wxAuiMDIClientWindow
* pClientWindow
= pParentFrame
->GetClientWindow();
577 if (pClientWindow
!= NULL
)
579 int idx
= pClientWindow
->GetPageIndex(this);
583 pClientWindow
->SetPageBitmap((size_t)idx
, bmp
);
588 const wxIcon
& wxAuiMDIChildFrame::GetIcon() const
594 void wxAuiMDIChildFrame::Activate()
596 wxAuiMDIParentFrame
* pParentFrame
= GetMDIParentFrame();
597 wxASSERT_MSG(pParentFrame
, wxT("Missing MDI Parent Frame"));
599 wxAuiMDIClientWindow
* pClientWindow
= pParentFrame
->GetClientWindow();
601 if (pClientWindow
!= NULL
)
604 for (pos
= 0; pos
< pClientWindow
->GetPageCount(); pos
++)
606 if (pClientWindow
->GetPage(pos
) == this)
608 pClientWindow
->SetSelection(pos
);
615 void wxAuiMDIChildFrame::OnMenuHighlight(wxMenuEvent
& event
)
618 if (m_pMDIParentFrame
)
620 // we don't have any help text for this item,
621 // but may be the MDI frame does?
622 m_pMDIParentFrame
->OnMenuHighlight(event
);
626 #endif // wxUSE_STATUSBAR
629 void wxAuiMDIChildFrame::OnActivate(wxActivateEvent
& WXUNUSED(event
))
634 void wxAuiMDIChildFrame::OnCloseWindow(wxCloseEvent
& WXUNUSED(event
))
639 void wxAuiMDIChildFrame::SetMDIParentFrame(wxAuiMDIParentFrame
* parentFrame
)
641 m_pMDIParentFrame
= parentFrame
;
644 wxAuiMDIParentFrame
* wxAuiMDIChildFrame::GetMDIParentFrame() const
646 return m_pMDIParentFrame
;
649 void wxAuiMDIChildFrame::Init()
651 m_activate_on_create
= true;
652 m_pMDIParentFrame
= NULL
;
655 #endif // wxUSE_MENUS
658 bool wxAuiMDIChildFrame::Show(bool show
)
660 m_activate_on_create
= show
;
666 void wxAuiMDIChildFrame::DoShow(bool show
)
668 wxWindow::Show(show
);
671 void wxAuiMDIChildFrame::DoSetSize(int x
, int y
, int width
, int height
, int sizeFlags
)
673 m_mdi_newrect
= wxRect(x
, y
, width
, height
);
675 wxPanel::DoSetSize(x
,y
,width
, height
, sizeFlags
);
677 wxUnusedVar(sizeFlags
);
681 void wxAuiMDIChildFrame::DoMoveWindow(int x
, int y
, int width
, int height
)
683 m_mdi_newrect
= wxRect(x
, y
, width
, height
);
686 void wxAuiMDIChildFrame::ApplyMDIChildFrameRect()
688 if (m_mdi_currect
!= m_mdi_newrect
)
690 wxPanel::DoMoveWindow(m_mdi_newrect
.x
, m_mdi_newrect
.y
,
691 m_mdi_newrect
.width
, m_mdi_newrect
.height
);
692 m_mdi_currect
= m_mdi_newrect
;
697 //-----------------------------------------------------------------------------
698 // wxAuiMDIClientWindow
699 //-----------------------------------------------------------------------------
701 IMPLEMENT_DYNAMIC_CLASS(wxAuiMDIClientWindow
, wxAuiNotebook
)
703 BEGIN_EVENT_TABLE(wxAuiMDIClientWindow
, wxAuiNotebook
)
704 EVT_AUINOTEBOOK_PAGE_CHANGED(wxID_ANY
, wxAuiMDIClientWindow::OnPageChanged
)
705 EVT_AUINOTEBOOK_PAGE_CLOSE(wxID_ANY
, wxAuiMDIClientWindow::OnPageClose
)
706 EVT_SIZE(wxAuiMDIClientWindow::OnSize
)
709 wxAuiMDIClientWindow::wxAuiMDIClientWindow()
713 wxAuiMDIClientWindow::wxAuiMDIClientWindow(wxAuiMDIParentFrame
* parent
, long style
)
715 CreateClient(parent
, style
);
718 wxAuiMDIClientWindow::~wxAuiMDIClientWindow()
723 bool wxAuiMDIClientWindow::CreateClient(wxAuiMDIParentFrame
* parent
, long style
)
725 SetWindowStyleFlag(style
);
727 wxSize caption_icon_size
=
728 wxSize(wxSystemSettings::GetMetric(wxSYS_SMALLICON_X
),
729 wxSystemSettings::GetMetric(wxSYS_SMALLICON_Y
));
730 SetUniformBitmapSize(caption_icon_size
);
732 if (!wxAuiNotebook::Create(parent
,
736 wxAUI_NB_DEFAULT_STYLE
| wxNO_BORDER
))
741 wxColour bkcolour
= wxSystemSettings::GetColour(wxSYS_COLOUR_APPWORKSPACE
);
742 SetOwnBackgroundColour(bkcolour
);
744 m_mgr
.GetArtProvider()->SetColour(wxAUI_DOCKART_BACKGROUND_COLOUR
, bkcolour
);
749 int wxAuiMDIClientWindow::SetSelection(size_t nPage
)
751 return wxAuiNotebook::SetSelection(nPage
);
754 void wxAuiMDIClientWindow::PageChanged(int old_selection
, int new_selection
)
756 // don't do anything if the page doesn't actually change
757 if (old_selection
== new_selection
)
761 // don't do anything if the new page is already active
762 if (new_selection != -1)
764 wxAuiMDIChildFrame* child = (wxAuiMDIChildFrame*)GetPage(new_selection);
765 if (child->GetMDIParentFrame()->GetActiveChild() == child)
770 // notify old active child that it has been deactivated
771 if (old_selection
!= -1)
773 wxAuiMDIChildFrame
* old_child
= (wxAuiMDIChildFrame
*)GetPage(old_selection
);
774 wxASSERT_MSG(old_child
, wxT("wxAuiMDIClientWindow::PageChanged - null page pointer"));
776 wxActivateEvent
event(wxEVT_ACTIVATE
, false, old_child
->GetId());
777 event
.SetEventObject(old_child
);
778 old_child
->GetEventHandler()->ProcessEvent(event
);
781 // notify new active child that it has been activated
782 if (new_selection
!= -1)
784 wxAuiMDIChildFrame
* active_child
= (wxAuiMDIChildFrame
*)GetPage(new_selection
);
785 wxASSERT_MSG(active_child
, wxT("wxAuiMDIClientWindow::PageChanged - null page pointer"));
787 wxActivateEvent
event(wxEVT_ACTIVATE
, true, active_child
->GetId());
788 event
.SetEventObject(active_child
);
789 active_child
->GetEventHandler()->ProcessEvent(event
);
791 if (active_child
->GetMDIParentFrame())
793 active_child
->GetMDIParentFrame()->SetActiveChild(active_child
);
794 active_child
->GetMDIParentFrame()->SetChildMenuBar(active_child
);
801 void wxAuiMDIClientWindow::OnPageClose(wxAuiNotebookEvent
& evt
)
803 wxAuiMDIChildFrame
* wnd
;
804 wnd
= static_cast<wxAuiMDIChildFrame
*>(GetPage(evt
.GetSelection()));
808 // regardless of the result of wnd->Close(), we've
809 // already taken care of the close operations, so
810 // suppress further processing
814 void wxAuiMDIClientWindow::OnPageChanged(wxAuiNotebookEvent
& evt
)
816 PageChanged(evt
.GetOldSelection(), evt
.GetSelection());
819 void wxAuiMDIClientWindow::OnSize(wxSizeEvent
& evt
)
821 wxAuiNotebook::OnSize(evt
);
823 for (size_t pos
= 0; pos
< GetPageCount(); pos
++)
824 ((wxAuiMDIChildFrame
*)GetPage(pos
))->ApplyMDIChildFrameRect();