1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/frame.cpp
4 // Author: Julian Smart
7 // Copyright: (c) Julian Smart
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
11 // ============================================================================
13 // ============================================================================
15 // ----------------------------------------------------------------------------
17 // ----------------------------------------------------------------------------
19 // For compilers that support precompilation, includes "wx.h".
20 #include "wx/wxprec.h"
29 #include "wx/msw/wrapcctl.h" // include <commctrl.h> "properly"
33 #include "wx/dialog.h"
34 #include "wx/settings.h"
35 #include "wx/dcclient.h"
39 #include "wx/toolbar.h"
40 #include "wx/statusbr.h"
41 #include "wx/menuitem.h"
44 #include "wx/msw/private.h"
46 #if defined(__POCKETPC__) || defined(__SMARTPHONE__)
49 #include "wx/msw/winundef.h"
52 #include "wx/generic/statusbr.h"
54 #ifdef __WXUNIVERSAL__
55 #include "wx/univ/theme.h"
56 #include "wx/univ/colschem.h"
57 #endif // __WXUNIVERSAL__
59 // ----------------------------------------------------------------------------
61 // ----------------------------------------------------------------------------
63 #if wxUSE_MENUS || wxUSE_MENUS_NATIVE
64 extern wxMenu
*wxCurrentPopupMenu
;
65 #endif // wxUSE_MENUS || wxUSE_MENUS_NATIVE
67 // ----------------------------------------------------------------------------
69 // ----------------------------------------------------------------------------
71 BEGIN_EVENT_TABLE(wxFrame
, wxFrameBase
)
72 EVT_SYS_COLOUR_CHANGED(wxFrame::OnSysColourChanged
)
75 // ============================================================================
77 // ============================================================================
79 // ----------------------------------------------------------------------------
80 // static class members
81 // ----------------------------------------------------------------------------
84 #if wxUSE_NATIVE_STATUSBAR
85 bool wxFrame::m_useNativeStatusBar
= true;
87 bool wxFrame::m_useNativeStatusBar
= false;
89 #endif // wxUSE_NATIVE_STATUSBAR
91 // ----------------------------------------------------------------------------
92 // creation/destruction
93 // ----------------------------------------------------------------------------
105 m_wasMinimized
= false;
108 bool wxFrame::Create(wxWindow
*parent
,
110 const wxString
& title
,
114 const wxString
& name
)
116 if ( !wxTopLevelWindow::Create(parent
, id
, title
, pos
, size
, style
, name
) )
119 SetOwnBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_APPWORKSPACE
));
121 #if defined(__SMARTPHONE__)
122 SetLeftMenu(wxID_EXIT
, _("Done"));
125 #if wxUSE_ACCEL && defined(__POCKETPC__)
126 // The guidelines state that Ctrl+Q should quit the app.
127 // Let's define an accelerator table to send wxID_EXIT.
128 wxAcceleratorEntry entries
[1];
129 entries
[0].Set(wxACCEL_CTRL
, 'Q', wxID_EXIT
);
130 wxAcceleratorTable
accel(1, entries
);
131 SetAcceleratorTable(accel
);
132 #endif // wxUSE_ACCEL && __POCKETPC__
144 // ----------------------------------------------------------------------------
145 // wxFrame client size calculations
146 // ----------------------------------------------------------------------------
148 void wxFrame::DoSetClientSize(int width
, int height
)
150 // leave enough space for the status bar if we have (and show) it
152 wxStatusBar
*statbar
= GetStatusBar();
153 if ( statbar
&& statbar
->IsShown() )
155 height
+= statbar
->GetSize().y
;
157 #endif // wxUSE_STATUSBAR
159 // call GetClientAreaOrigin() to take the toolbar into account
160 wxPoint pt
= GetClientAreaOrigin();
165 wxToolBar
* const toolbar
= GetToolBar();
168 if ( toolbar
->HasFlag(wxTB_RIGHT
| wxTB_BOTTOM
) )
170 const wxSize sizeTB
= toolbar
->GetSize();
171 if ( toolbar
->HasFlag(wxTB_RIGHT
) )
176 //else: toolbar already taken into account by GetClientAreaOrigin()
178 #endif // wxUSE_TOOLBAR
180 wxTopLevelWindow::DoSetClientSize(width
, height
);
183 // Get size *available for subwindows* i.e. excluding menu bar, toolbar etc.
184 void wxFrame::DoGetClientSize(int *x
, int *y
) const
186 wxTopLevelWindow::DoGetClientSize(x
, y
);
188 // account for the possible toolbar
189 wxPoint pt
= GetClientAreaOrigin();
197 wxToolBar
* const toolbar
= GetToolBar();
200 if ( toolbar
->HasFlag(wxTB_RIGHT
| wxTB_BOTTOM
) )
202 const wxSize sizeTB
= toolbar
->GetSize();
203 if ( toolbar
->HasFlag(wxTB_RIGHT
) )
214 //else: toolbar already taken into account by GetClientAreaOrigin()
216 #endif // wxUSE_TOOLBAR
219 // adjust client area height to take the status bar into account
222 wxStatusBar
*statbar
= GetStatusBar();
223 if ( statbar
&& statbar
->IsShown() )
225 *y
-= statbar
->GetSize().y
;
228 #endif // wxUSE_STATUSBAR
231 // ----------------------------------------------------------------------------
232 // wxFrame: various geometry-related functions
233 // ----------------------------------------------------------------------------
235 // generate an artificial resize event
236 void wxFrame::SendSizeEvent(int flags
)
240 RECT r
= wxGetWindowRect(GetHwnd());
242 if ( flags
& wxSEND_EVENT_POST
)
244 ::PostMessage(GetHwnd(), WM_SIZE
,
245 IsMaximized() ? SIZE_MAXIMIZED
: SIZE_RESTORED
,
246 MAKELPARAM(r
.right
- r
.left
, r
.bottom
- r
.top
));
250 ::SendMessage(GetHwnd(), WM_SIZE
,
251 IsMaximized() ? SIZE_MAXIMIZED
: SIZE_RESTORED
,
252 MAKELPARAM(r
.right
- r
.left
, r
.bottom
- r
.top
));
258 wxStatusBar
*wxFrame::OnCreateStatusBar(int number
,
261 const wxString
& name
)
263 wxStatusBar
*statusBar
wxDUMMY_INITIALIZE(NULL
);
265 #if wxUSE_NATIVE_STATUSBAR
266 if ( !UsesNativeStatusBar() )
268 statusBar
= (wxStatusBar
*)new wxStatusBarGeneric(this, id
, style
);
273 statusBar
= new wxStatusBar(this, id
, style
, name
);
276 statusBar
->SetFieldsCount(number
);
281 void wxFrame::PositionStatusBar()
283 if ( !m_frameStatusBar
|| !m_frameStatusBar
->IsShown() )
287 GetClientSize(&w
, &h
);
290 m_frameStatusBar
->GetSize(&sw
, &sh
);
294 wxToolBar
* const toolbar
= GetToolBar();
295 if ( toolbar
&& !toolbar
->HasFlag(wxTB_TOP
) )
297 const wxSize sizeTB
= toolbar
->GetSize();
299 if ( toolbar
->HasFlag(wxTB_LEFT
| wxTB_RIGHT
) )
301 if ( toolbar
->HasFlag(wxTB_LEFT
) )
308 // we need to position the status bar below the toolbar
312 //else: no adjustments necessary for the toolbar on top
313 #endif // wxUSE_TOOLBAR
315 // Since we wish the status bar to be directly under the client area,
316 // we use the adjusted sizes without using wxSIZE_NO_ADJUSTMENTS.
317 m_frameStatusBar
->SetSize(x
, h
, w
, sh
);
320 #endif // wxUSE_STATUSBAR
322 #if wxUSE_MENUS_NATIVE
324 void wxFrame::AttachMenuBar(wxMenuBar
*menubar
)
326 #if defined(__SMARTPHONE__) && defined(__WXWINCE__)
328 wxMenu
*autoMenu
= NULL
;
330 if( menubar
->GetMenuCount() == 1 )
332 autoMenu
= wxTopLevelWindowMSW::ButtonMenu::DuplicateMenu(menubar
->GetMenu(0));
333 SetRightMenu(wxID_ANY
, menubar
->GetMenuLabel(0), autoMenu
);
337 autoMenu
= new wxMenu
;
339 for( size_t n
= 0; n
< menubar
->GetMenuCount(); n
++ )
341 wxMenu
*item
= menubar
->GetMenu(n
);
342 wxString label
= menubar
->GetMenuLabel(n
);
343 wxMenu
*new_item
= wxTopLevelWindowMSW::ButtonMenu::DuplicateMenu(item
);
344 autoMenu
->Append(wxID_ANY
, label
, new_item
);
347 SetRightMenu(wxID_ANY
, _("Menu"), autoMenu
);
350 #elif defined(WINCE_WITHOUT_COMMANDBAR)
353 wxToolMenuBar
* toolBar
= new wxToolMenuBar(this, wxID_ANY
,
354 wxDefaultPosition
, wxDefaultSize
,
355 wxBORDER_NONE
| wxTB_HORIZONTAL
,
356 wxToolBarNameStr
, menubar
);
358 menubar
->SetToolBar(toolBar
);
361 // When the main window is created using CW_USEDEFAULT the height of the
362 // menubar is not taken into account, so we resize it afterwards if a
363 // menubar is present
364 HWND hwndMenuBar
= SHFindMenuBar(GetHwnd());
368 ::GetWindowRect(hwndMenuBar
, &mbRect
);
369 const int menuHeight
= mbRect
.bottom
- mbRect
.top
;
372 ::GetWindowRect(GetHwnd(), &rc
);
373 // adjust for menu / titlebar height
374 rc
.bottom
-= (2*menuHeight
-1);
376 ::MoveWindow(GetHwnd(), rc
.left
, rc
.top
, rc
.right
, rc
.bottom
, FALSE
);
380 wxFrameBase::AttachMenuBar(menubar
);
384 // actually remove the menu from the frame
385 m_hMenu
= (WXHMENU
)0;
386 InternalSetMenuBar();
388 else // set new non NULL menu bar
390 #if !defined(__WXWINCE__) || defined(WINCE_WITH_COMMANDBAR)
391 // Can set a menubar several times.
392 if ( menubar
->GetHMenu() )
394 m_hMenu
= menubar
->GetHMenu();
398 m_hMenu
= menubar
->Create();
402 wxFAIL_MSG( wxT("failed to create menu bar") );
407 InternalSetMenuBar();
411 void wxFrame::InternalSetMenuBar()
413 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
416 if ( !::SetMenu(GetHwnd(), (HMENU
)m_hMenu
) )
418 wxLogLastError(wxT("SetMenu"));
423 #endif // wxUSE_MENUS_NATIVE
426 wxMenu
* wxFrame::MSWFindMenuFromHMENU(WXHMENU hMenu
)
428 return GetMenuBar() ? GetMenuBar()->MSWGetMenu(hMenu
) : NULL
;
430 #endif // wxUSE_MENUS
432 // Responds to colour changes, and passes event on to children.
433 void wxFrame::OnSysColourChanged(wxSysColourChangedEvent
& event
)
435 // Don't override the colour explicitly set by the user, if any.
438 SetOwnBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_APPWORKSPACE
));
443 if ( m_frameStatusBar
)
445 wxSysColourChangedEvent event2
;
446 event2
.SetEventObject( m_frameStatusBar
);
447 m_frameStatusBar
->HandleWindowEvent(event2
);
449 #endif // wxUSE_STATUSBAR
451 // Propagate the event to the non-top-level children
452 wxWindow::OnSysColourChanged(event
);
455 // Pass true to show full screen, false to restore.
456 bool wxFrame::ShowFullScreen(bool show
, long style
)
458 // TODO-CE: add support for CE
459 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
460 if ( IsFullScreen() == show
)
465 // zap the toolbar, menubar, and statusbar if needed
467 // TODO: hide commandbar for WINCE_WITH_COMMANDBAR
469 wxToolBar
*theToolBar
= GetToolBar();
471 if ((style
& wxFULLSCREEN_NOTOOLBAR
) && theToolBar
)
473 if ( theToolBar
->IsShown() )
475 theToolBar
->SetSize(wxDefaultCoord
,0);
476 theToolBar
->Show(false);
478 else // prevent it from being restored later
480 style
&= ~wxFULLSCREEN_NOTOOLBAR
;
483 #endif // wxUSE_TOOLBAR
485 if (style
& wxFULLSCREEN_NOMENUBAR
)
486 SetMenu((HWND
)GetHWND(), (HMENU
) NULL
);
489 wxStatusBar
*theStatusBar
= GetStatusBar();
491 // Save the number of fields in the statusbar
492 if ((style
& wxFULLSCREEN_NOSTATUSBAR
) && theStatusBar
)
494 if ( theStatusBar
->IsShown() )
495 theStatusBar
->Show(false);
497 style
&= ~wxFULLSCREEN_NOSTATUSBAR
;
499 #endif // wxUSE_STATUSBAR
501 else // restore to normal
503 // restore the toolbar, menubar, and statusbar if we had hid them
505 wxToolBar
*theToolBar
= GetToolBar();
507 if ((m_fsStyle
& wxFULLSCREEN_NOTOOLBAR
) && theToolBar
)
509 theToolBar
->Show(true);
511 #endif // wxUSE_TOOLBAR
514 if (m_fsStyle
& wxFULLSCREEN_NOMENUBAR
)
516 const WXHMENU hmenu
= MSWGetActiveMenu();
518 ::SetMenu(GetHwnd(), (HMENU
)hmenu
);
520 #endif // wxUSE_MENUS
523 wxStatusBar
*theStatusBar
= GetStatusBar();
525 if ((m_fsStyle
& wxFULLSCREEN_NOSTATUSBAR
) && theStatusBar
)
527 theStatusBar
->Show(true);
530 #endif // wxUSE_STATUSBAR
532 #endif // !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
534 return wxFrameBase::ShowFullScreen(show
, style
);
537 // ----------------------------------------------------------------------------
538 // tool/status bar stuff
539 // ----------------------------------------------------------------------------
543 wxToolBar
* wxFrame::CreateToolBar(long style
, wxWindowID id
, const wxString
& name
)
545 #if defined(WINCE_WITHOUT_COMMANDBAR)
546 // We may already have a toolbar from calling SetMenuBar.
550 if ( wxFrameBase::CreateToolBar(style
, id
, name
) )
555 return m_frameToolBar
;
558 void wxFrame::PositionToolBar()
560 // TODO: we want to do something different in WinCE, because the toolbar
561 // should be associated with the commandbar, instead of being
562 // independent window.
563 #if !defined(WINCE_WITHOUT_COMMANDBAR)
564 wxToolBar
*toolbar
= GetToolBar();
565 if ( toolbar
&& toolbar
->IsShown() )
567 // don't call our (or even wxTopLevelWindow) version because we want
568 // the real (full) client area size, not excluding the tool/status bar
570 wxWindow::DoGetClientSize(&width
, &height
);
573 wxStatusBar
*statbar
= GetStatusBar();
574 if ( statbar
&& statbar
->IsShown() )
576 height
-= statbar
->GetClientSize().y
;
578 #endif // wxUSE_STATUSBAR
581 toolbar
->GetPosition( &tx
, &ty
);
582 toolbar
->GetSize( &tw
, &th
);
585 if ( toolbar
->HasFlag(wxTB_BOTTOM
) )
590 else if ( toolbar
->HasFlag(wxTB_RIGHT
) )
601 #if defined(WINCE_WITH_COMMANDBAR)
602 // We're using a commandbar - so we have to allow for it.
603 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
606 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
607 y
= rect
.bottom
- rect
.top
;
609 #endif // WINCE_WITH_COMMANDBAR
611 if ( toolbar
->HasFlag(wxTB_BOTTOM
) )
613 if ( ty
< 0 && ( -ty
== th
) )
615 if ( tx
< 0 && (-tx
== tw
) )
618 else if ( toolbar
->HasFlag(wxTB_RIGHT
) )
620 if( ty
< 0 && ( -ty
== th
) )
622 if( tx
< 0 && ( -tx
== tw
) )
627 if (ty
< 0 && (-ty
== th
))
629 if (tx
< 0 && (-tx
== tw
))
636 if ( toolbar
->IsVertical() )
647 // use the 'real' MSW position here, don't offset relatively to the
648 // client area origin
649 toolbar
->SetSize(x
, y
, desiredW
, desiredH
, wxSIZE_NO_ADJUSTMENTS
);
652 #endif // !WINCE_WITH_COMMANDBAR
655 #endif // wxUSE_TOOLBAR
657 // ----------------------------------------------------------------------------
658 // frame state (iconized/maximized/...)
659 // ----------------------------------------------------------------------------
661 // propagate our state change to all child frames: this allows us to emulate X
662 // Windows behaviour where child frames float independently of the parent one
663 // on the desktop, but are iconized/restored with it
664 void wxFrame::IconizeChildFrames(bool bIconize
)
666 m_iconized
= bIconize
;
668 for ( wxWindowList::compatibility_iterator node
= GetChildren().GetFirst();
670 node
= node
->GetNext() )
672 wxWindow
*win
= node
->GetData();
674 // iconizing the frames with this style under Win95 shell puts them at
675 // the bottom of the screen (as the MDI children) instead of making
676 // them appear in the taskbar because they are, by virtue of this
677 // style, not managed by the taskbar - instead leave Windows take care
679 if ( win
->GetWindowStyle() & wxFRAME_TOOL_WINDOW
)
682 // the child MDI frames are a special case and should not be touched by
683 // the parent frame - instead, they are managed by the user
684 wxFrame
*frame
= wxDynamicCast(win
, wxFrame
);
686 #if wxUSE_MDI_ARCHITECTURE
687 && !frame
->IsMDIChild()
688 #endif // wxUSE_MDI_ARCHITECTURE
691 // we don't want to restore the child frames which had been
692 // iconized even before we were iconized, so save the child frame
693 // status when iconizing the parent frame and check it when
697 frame
->m_wasMinimized
= frame
->IsIconized();
700 // note that we shouldn't touch the hidden frames neither because
701 // iconizing/restoring them would show them as a side effect
702 if ( !frame
->m_wasMinimized
&& frame
->IsShown() )
703 frame
->Iconize(bIconize
);
708 WXHICON
wxFrame::GetDefaultIcon() const
710 // we don't have any standard icons (any more)
714 // ===========================================================================
715 // message processing
716 // ===========================================================================
718 // ---------------------------------------------------------------------------
720 // ---------------------------------------------------------------------------
722 bool wxFrame::MSWDoTranslateMessage(wxFrame
*frame
, WXMSG
*pMsg
)
724 if ( wxWindow::MSWTranslateMessage(pMsg
) )
727 #if wxUSE_MENUS && wxUSE_ACCEL && !defined(__WXUNIVERSAL__)
728 // try the menu bar accelerators
729 wxMenuBar
*menuBar
= GetMenuBar();
730 if ( menuBar
&& menuBar
->GetAcceleratorTable()->Translate(frame
, pMsg
) )
732 #endif // wxUSE_MENUS && wxUSE_ACCEL
737 // ---------------------------------------------------------------------------
738 // our private (non virtual) message handlers
739 // ---------------------------------------------------------------------------
741 bool wxFrame::HandleSize(int WXUNUSED(x
), int WXUNUSED(y
), WXUINT id
)
743 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
748 // only do it it if we were iconized before, otherwise resizing the
749 // parent frame has a curious side effect of bringing it under it's
754 // restore all child frames too
755 IconizeChildFrames(false);
757 (void)SendIconizeEvent(false);
761 // iconize all child frames too
762 IconizeChildFrames(true);
767 #endif // !__WXWINCE__
773 #endif // wxUSE_STATUSBAR
777 #endif // wxUSE_TOOLBAR
779 #if defined(WINCE_WITH_COMMANDBAR)
780 // Position the menu command bar
781 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
784 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
785 wxSize clientSz
= GetClientSize();
787 if ( !::MoveWindow((HWND
) GetMenuBar()->GetCommandBar(), 0, 0, clientSz
.x
, rect
.bottom
- rect
.top
, true ) )
789 wxLogLastError(wxT("MoveWindow"));
793 #endif // WINCE_WITH_COMMANDBAR
796 // call the base class version to generate the appropriate events
800 bool wxFrame::HandleCommand(WXWORD id
, WXWORD cmd
, WXHWND control
)
804 #if defined(WINCE_WITHOUT_COMMANDBAR)
805 if (GetToolBar() && GetToolBar()->FindById(id
))
806 return GetToolBar()->MSWCommand(cmd
, id
);
809 // we only need to handle the menu and accelerator commands from the items
810 // of our menu bar, base wxWindow class already handles the rest
811 if ( !control
&& (cmd
== 0 /* menu */ || cmd
== 1 /* accel */) )
813 #if wxUSE_MENUS_NATIVE
814 if ( !wxCurrentPopupMenu
)
815 #endif // wxUSE_MENUS_NATIVE
817 wxMenuItem
* const mitem
= FindItemInMenuBar((signed short)id
);
819 return ProcessCommand(mitem
);
822 #endif // wxUSE_MENUS
824 return wxFrameBase::HandleCommand(id
, cmd
, control
);;
827 // ---------------------------------------------------------------------------
828 // the window proc for wxFrame
829 // ---------------------------------------------------------------------------
831 WXLRESULT
wxFrame::MSWWindowProc(WXUINT message
, WXWPARAM wParam
, WXLPARAM lParam
)
834 bool processed
= false;
839 // if we can't close, tell the system that we processed the
840 // message - otherwise it would close us
841 processed
= !Close();
845 processed
= HandleSize(LOWORD(lParam
), HIWORD(lParam
), wParam
);
852 UnpackCommand((WXWPARAM
)wParam
, (WXLPARAM
)lParam
,
855 HandleCommand(id
, cmd
, (WXHWND
)hwnd
);
857 // don't pass WM_COMMAND to the base class whether we processed
858 // it or not because we did generate an event for it (our
859 // HandleCommand() calls the base class version) and we must
860 // not do it again or the handlers which skip the event would
866 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
867 case WM_QUERYDRAGICON
:
869 const wxIcon
& icon
= GetIcon();
870 HICON hIcon
= icon
.IsOk() ? GetHiconOf(icon
)
871 : (HICON
)GetDefaultIcon();
872 rc
= (WXLRESULT
)hIcon
;
876 #endif // !__WXMICROWIN__
880 rc
= wxFrameBase::MSWWindowProc(message
, wParam
, lParam
);
885 // ----------------------------------------------------------------------------
886 // wxFrame size management: we exclude the areas taken by menu/status/toolbars
887 // from the client area, so the client area is what's really available for the
889 // ----------------------------------------------------------------------------
891 // get the origin of the client area in the client coordinates
892 wxPoint
wxFrame::GetClientAreaOrigin() const
894 wxPoint pt
= wxTopLevelWindow::GetClientAreaOrigin();
896 #if wxUSE_TOOLBAR && !defined(__WXUNIVERSAL__) && \
897 (!defined(__WXWINCE__) || (_WIN32_WCE >= 400 && !defined(__POCKETPC__) && !defined(__SMARTPHONE__)))
898 wxToolBar
* const toolbar
= GetToolBar();
899 if ( toolbar
&& toolbar
->IsShown() )
901 const wxSize sizeTB
= toolbar
->GetSize();
903 if ( toolbar
->HasFlag(wxTB_TOP
) )
907 else if ( toolbar
->HasFlag(wxTB_LEFT
) )
912 #endif // wxUSE_TOOLBAR
914 #if defined(WINCE_WITH_COMMANDBAR)
915 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
918 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
919 pt
.y
+= (rect
.bottom
- rect
.top
);