1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/frame.cpp
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
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/msw/wrapcctl.h" // include <commctrl.h> "properly"
34 #include "wx/dialog.h"
35 #include "wx/settings.h"
36 #include "wx/dcclient.h"
40 #include "wx/toolbar.h"
41 #include "wx/statusbr.h"
42 #include "wx/menuitem.h"
45 #include "wx/msw/private.h"
47 #if defined(__POCKETPC__) || defined(__SMARTPHONE__)
50 #include "wx/msw/winundef.h"
53 #include "wx/generic/statusbr.h"
55 #ifdef __WXUNIVERSAL__
56 #include "wx/univ/theme.h"
57 #include "wx/univ/colschem.h"
58 #endif // __WXUNIVERSAL__
60 // ----------------------------------------------------------------------------
62 // ----------------------------------------------------------------------------
64 #if wxUSE_MENUS || wxUSE_MENUS_NATIVE
65 extern wxMenu
*wxCurrentPopupMenu
;
66 #endif // wxUSE_MENUS || wxUSE_MENUS_NATIVE
68 // ----------------------------------------------------------------------------
70 // ----------------------------------------------------------------------------
72 BEGIN_EVENT_TABLE(wxFrame
, wxFrameBase
)
73 EVT_SYS_COLOUR_CHANGED(wxFrame::OnSysColourChanged
)
76 // ============================================================================
78 // ============================================================================
80 // ----------------------------------------------------------------------------
81 // static class members
82 // ----------------------------------------------------------------------------
85 #if wxUSE_NATIVE_STATUSBAR
86 bool wxFrame::m_useNativeStatusBar
= true;
88 bool wxFrame::m_useNativeStatusBar
= false;
90 #endif // wxUSE_NATIVE_STATUSBAR
92 // ----------------------------------------------------------------------------
93 // creation/destruction
94 // ----------------------------------------------------------------------------
100 #endif // wxUSE_MENUS
106 m_wasMinimized
= false;
109 bool wxFrame::Create(wxWindow
*parent
,
111 const wxString
& title
,
115 const wxString
& name
)
117 if ( !wxTopLevelWindow::Create(parent
, id
, title
, pos
, size
, style
, name
) )
120 SetOwnBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_APPWORKSPACE
));
122 #if defined(__SMARTPHONE__)
123 SetLeftMenu(wxID_EXIT
, _("Done"));
126 #if wxUSE_ACCEL && defined(__POCKETPC__)
127 // The guidelines state that Ctrl+Q should quit the app.
128 // Let's define an accelerator table to send wxID_EXIT.
129 wxAcceleratorEntry entries
[1];
130 entries
[0].Set(wxACCEL_CTRL
, 'Q', wxID_EXIT
);
131 wxAcceleratorTable
accel(1, entries
);
132 SetAcceleratorTable(accel
);
133 #endif // wxUSE_ACCEL && __POCKETPC__
145 // ----------------------------------------------------------------------------
146 // wxFrame client size calculations
147 // ----------------------------------------------------------------------------
149 void wxFrame::DoSetClientSize(int width
, int height
)
151 // leave enough space for the status bar if we have (and show) it
153 wxStatusBar
*statbar
= GetStatusBar();
154 if ( statbar
&& statbar
->IsShown() )
156 height
+= statbar
->GetSize().y
;
158 #endif // wxUSE_STATUSBAR
160 // call GetClientAreaOrigin() to take the toolbar into account
161 wxPoint pt
= GetClientAreaOrigin();
166 wxToolBar
* const toolbar
= GetToolBar();
169 if ( toolbar
->HasFlag(wxTB_RIGHT
| wxTB_BOTTOM
) )
171 const wxSize sizeTB
= toolbar
->GetSize();
172 if ( toolbar
->HasFlag(wxTB_RIGHT
) )
177 //else: toolbar already taken into account by GetClientAreaOrigin()
179 #endif // wxUSE_TOOLBAR
181 wxTopLevelWindow::DoSetClientSize(width
, height
);
184 // Get size *available for subwindows* i.e. excluding menu bar, toolbar etc.
185 void wxFrame::DoGetClientSize(int *x
, int *y
) const
187 wxTopLevelWindow::DoGetClientSize(x
, y
);
189 // account for the possible toolbar
190 wxPoint pt
= GetClientAreaOrigin();
198 wxToolBar
* const toolbar
= GetToolBar();
201 if ( toolbar
->HasFlag(wxTB_RIGHT
| wxTB_BOTTOM
) )
203 const wxSize sizeTB
= toolbar
->GetSize();
204 if ( toolbar
->HasFlag(wxTB_RIGHT
) )
215 //else: toolbar already taken into account by GetClientAreaOrigin()
217 #endif // wxUSE_TOOLBAR
220 // adjust client area height to take the status bar into account
223 wxStatusBar
*statbar
= GetStatusBar();
224 if ( statbar
&& statbar
->IsShown() )
226 *y
-= statbar
->GetSize().y
;
229 #endif // wxUSE_STATUSBAR
232 // ----------------------------------------------------------------------------
233 // wxFrame: various geometry-related functions
234 // ----------------------------------------------------------------------------
236 // generate an artificial resize event
237 void wxFrame::SendSizeEvent(int flags
)
241 RECT r
= wxGetWindowRect(GetHwnd());
243 if ( flags
& wxSEND_EVENT_POST
)
245 ::PostMessage(GetHwnd(), WM_SIZE
,
246 IsMaximized() ? SIZE_MAXIMIZED
: SIZE_RESTORED
,
247 MAKELPARAM(r
.right
- r
.left
, r
.bottom
- r
.top
));
251 ::SendMessage(GetHwnd(), WM_SIZE
,
252 IsMaximized() ? SIZE_MAXIMIZED
: SIZE_RESTORED
,
253 MAKELPARAM(r
.right
- r
.left
, r
.bottom
- r
.top
));
259 wxStatusBar
*wxFrame::OnCreateStatusBar(int number
,
262 const wxString
& name
)
264 wxStatusBar
*statusBar
wxDUMMY_INITIALIZE(NULL
);
266 #if wxUSE_NATIVE_STATUSBAR
267 if ( !UsesNativeStatusBar() )
269 statusBar
= (wxStatusBar
*)new wxStatusBarGeneric(this, id
, style
);
274 statusBar
= new wxStatusBar(this, id
, style
, name
);
277 statusBar
->SetFieldsCount(number
);
282 void wxFrame::PositionStatusBar()
284 if ( !m_frameStatusBar
|| !m_frameStatusBar
->IsShown() )
288 GetClientSize(&w
, &h
);
291 m_frameStatusBar
->GetSize(&sw
, &sh
);
295 wxToolBar
* const toolbar
= GetToolBar();
296 if ( toolbar
&& !toolbar
->HasFlag(wxTB_TOP
) )
298 const wxSize sizeTB
= toolbar
->GetSize();
300 if ( toolbar
->HasFlag(wxTB_LEFT
| wxTB_RIGHT
) )
302 if ( toolbar
->HasFlag(wxTB_LEFT
) )
309 // we need to position the status bar below the toolbar
313 //else: no adjustments necessary for the toolbar on top
314 #endif // wxUSE_TOOLBAR
316 // Since we wish the status bar to be directly under the client area,
317 // we use the adjusted sizes without using wxSIZE_NO_ADJUSTMENTS.
318 m_frameStatusBar
->SetSize(x
, h
, w
, sh
);
321 #endif // wxUSE_STATUSBAR
323 #if wxUSE_MENUS_NATIVE
325 void wxFrame::AttachMenuBar(wxMenuBar
*menubar
)
327 #if defined(__SMARTPHONE__) && defined(__WXWINCE__)
329 wxMenu
*autoMenu
= NULL
;
331 if( menubar
->GetMenuCount() == 1 )
333 autoMenu
= wxTopLevelWindowMSW::ButtonMenu::DuplicateMenu(menubar
->GetMenu(0));
334 SetRightMenu(wxID_ANY
, menubar
->GetMenuLabel(0), autoMenu
);
338 autoMenu
= new wxMenu
;
340 for( size_t n
= 0; n
< menubar
->GetMenuCount(); n
++ )
342 wxMenu
*item
= menubar
->GetMenu(n
);
343 wxString label
= menubar
->GetMenuLabel(n
);
344 wxMenu
*new_item
= wxTopLevelWindowMSW::ButtonMenu::DuplicateMenu(item
);
345 autoMenu
->Append(wxID_ANY
, label
, new_item
);
348 SetRightMenu(wxID_ANY
, _("Menu"), autoMenu
);
351 #elif defined(WINCE_WITHOUT_COMMANDBAR)
354 wxToolMenuBar
* toolBar
= new wxToolMenuBar(this, wxID_ANY
,
355 wxDefaultPosition
, wxDefaultSize
,
356 wxBORDER_NONE
| wxTB_HORIZONTAL
,
357 wxToolBarNameStr
, menubar
);
359 menubar
->SetToolBar(toolBar
);
362 // When the main window is created using CW_USEDEFAULT the height of the
363 // menubar is not taken into account, so we resize it afterwards if a
364 // menubar is present
365 HWND hwndMenuBar
= SHFindMenuBar(GetHwnd());
369 ::GetWindowRect(hwndMenuBar
, &mbRect
);
370 const int menuHeight
= mbRect
.bottom
- mbRect
.top
;
373 ::GetWindowRect(GetHwnd(), &rc
);
374 // adjust for menu / titlebar height
375 rc
.bottom
-= (2*menuHeight
-1);
377 ::MoveWindow(GetHwnd(), rc
.left
, rc
.top
, rc
.right
, rc
.bottom
, FALSE
);
381 wxFrameBase::AttachMenuBar(menubar
);
385 // actually remove the menu from the frame
386 m_hMenu
= (WXHMENU
)0;
387 InternalSetMenuBar();
389 else // set new non NULL menu bar
391 #if !defined(__WXWINCE__) || defined(WINCE_WITH_COMMANDBAR)
392 // Can set a menubar several times.
393 if ( menubar
->GetHMenu() )
395 m_hMenu
= menubar
->GetHMenu();
399 m_hMenu
= menubar
->Create();
403 wxFAIL_MSG( wxT("failed to create menu bar") );
408 InternalSetMenuBar();
412 void wxFrame::InternalSetMenuBar()
414 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
417 if ( !::SetMenu(GetHwnd(), (HMENU
)m_hMenu
) )
419 wxLogLastError(wxT("SetMenu"));
424 #endif // wxUSE_MENUS_NATIVE
427 wxMenu
* wxFrame::MSWFindMenuFromHMENU(WXHMENU hMenu
)
429 return GetMenuBar() ? GetMenuBar()->MSWGetMenu(hMenu
) : NULL
;
431 #endif // wxUSE_MENUS
433 // Responds to colour changes, and passes event on to children.
434 void wxFrame::OnSysColourChanged(wxSysColourChangedEvent
& event
)
436 // Don't override the colour explicitly set by the user, if any.
439 SetOwnBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_APPWORKSPACE
));
444 if ( m_frameStatusBar
)
446 wxSysColourChangedEvent event2
;
447 event2
.SetEventObject( m_frameStatusBar
);
448 m_frameStatusBar
->HandleWindowEvent(event2
);
450 #endif // wxUSE_STATUSBAR
452 // Propagate the event to the non-top-level children
453 wxWindow::OnSysColourChanged(event
);
456 // Pass true to show full screen, false to restore.
457 bool wxFrame::ShowFullScreen(bool show
, long style
)
459 // TODO-CE: add support for CE
460 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
461 if ( IsFullScreen() == show
)
466 // zap the toolbar, menubar, and statusbar if needed
468 // TODO: hide commandbar for WINCE_WITH_COMMANDBAR
470 wxToolBar
*theToolBar
= GetToolBar();
472 if ((style
& wxFULLSCREEN_NOTOOLBAR
) && theToolBar
)
474 if ( theToolBar
->IsShown() )
476 theToolBar
->SetSize(wxDefaultCoord
,0);
477 theToolBar
->Show(false);
479 else // prevent it from being restored later
481 style
&= ~wxFULLSCREEN_NOTOOLBAR
;
484 #endif // wxUSE_TOOLBAR
486 if (style
& wxFULLSCREEN_NOMENUBAR
)
487 SetMenu((HWND
)GetHWND(), (HMENU
) NULL
);
490 wxStatusBar
*theStatusBar
= GetStatusBar();
492 // Save the number of fields in the statusbar
493 if ((style
& wxFULLSCREEN_NOSTATUSBAR
) && theStatusBar
)
495 if ( theStatusBar
->IsShown() )
496 theStatusBar
->Show(false);
498 style
&= ~wxFULLSCREEN_NOSTATUSBAR
;
500 #endif // wxUSE_STATUSBAR
502 else // restore to normal
504 // restore the toolbar, menubar, and statusbar if we had hid them
506 wxToolBar
*theToolBar
= GetToolBar();
508 if ((m_fsStyle
& wxFULLSCREEN_NOTOOLBAR
) && theToolBar
)
510 theToolBar
->Show(true);
512 #endif // wxUSE_TOOLBAR
515 if (m_fsStyle
& wxFULLSCREEN_NOMENUBAR
)
517 const WXHMENU hmenu
= MSWGetActiveMenu();
519 ::SetMenu(GetHwnd(), (HMENU
)hmenu
);
521 #endif // wxUSE_MENUS
524 wxStatusBar
*theStatusBar
= GetStatusBar();
526 if ((m_fsStyle
& wxFULLSCREEN_NOSTATUSBAR
) && theStatusBar
)
528 theStatusBar
->Show(true);
531 #endif // wxUSE_STATUSBAR
533 #endif // !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
535 return wxFrameBase::ShowFullScreen(show
, style
);
538 // ----------------------------------------------------------------------------
539 // tool/status bar stuff
540 // ----------------------------------------------------------------------------
544 wxToolBar
* wxFrame::CreateToolBar(long style
, wxWindowID id
, const wxString
& name
)
546 #if defined(WINCE_WITHOUT_COMMANDBAR)
547 // We may already have a toolbar from calling SetMenuBar.
551 if ( wxFrameBase::CreateToolBar(style
, id
, name
) )
556 return m_frameToolBar
;
559 void wxFrame::PositionToolBar()
561 // TODO: we want to do something different in WinCE, because the toolbar
562 // should be associated with the commandbar, instead of being
563 // independent window.
564 #if !defined(WINCE_WITHOUT_COMMANDBAR)
565 wxToolBar
*toolbar
= GetToolBar();
566 if ( toolbar
&& toolbar
->IsShown() )
568 // don't call our (or even wxTopLevelWindow) version because we want
569 // the real (full) client area size, not excluding the tool/status bar
571 wxWindow::DoGetClientSize(&width
, &height
);
574 wxStatusBar
*statbar
= GetStatusBar();
575 if ( statbar
&& statbar
->IsShown() )
577 height
-= statbar
->GetClientSize().y
;
579 #endif // wxUSE_STATUSBAR
582 toolbar
->GetPosition( &tx
, &ty
);
583 toolbar
->GetSize( &tw
, &th
);
586 if ( toolbar
->HasFlag(wxTB_BOTTOM
) )
591 else if ( toolbar
->HasFlag(wxTB_RIGHT
) )
602 #if defined(WINCE_WITH_COMMANDBAR)
603 // We're using a commandbar - so we have to allow for it.
604 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
607 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
608 y
= rect
.bottom
- rect
.top
;
610 #endif // WINCE_WITH_COMMANDBAR
612 if ( toolbar
->HasFlag(wxTB_BOTTOM
) )
614 if ( ty
< 0 && ( -ty
== th
) )
616 if ( tx
< 0 && (-tx
== tw
) )
619 else if ( toolbar
->HasFlag(wxTB_RIGHT
) )
621 if( ty
< 0 && ( -ty
== th
) )
623 if( tx
< 0 && ( -tx
== tw
) )
628 if (ty
< 0 && (-ty
== th
))
630 if (tx
< 0 && (-tx
== tw
))
637 if ( toolbar
->IsVertical() )
648 // use the 'real' MSW position here, don't offset relatively to the
649 // client area origin
650 toolbar
->SetSize(x
, y
, desiredW
, desiredH
, wxSIZE_NO_ADJUSTMENTS
);
653 #endif // !WINCE_WITH_COMMANDBAR
656 #endif // wxUSE_TOOLBAR
658 // ----------------------------------------------------------------------------
659 // frame state (iconized/maximized/...)
660 // ----------------------------------------------------------------------------
662 // propagate our state change to all child frames: this allows us to emulate X
663 // Windows behaviour where child frames float independently of the parent one
664 // on the desktop, but are iconized/restored with it
665 void wxFrame::IconizeChildFrames(bool bIconize
)
667 m_iconized
= bIconize
;
669 for ( wxWindowList::compatibility_iterator node
= GetChildren().GetFirst();
671 node
= node
->GetNext() )
673 wxWindow
*win
= node
->GetData();
675 // iconizing the frames with this style under Win95 shell puts them at
676 // the bottom of the screen (as the MDI children) instead of making
677 // them appear in the taskbar because they are, by virtue of this
678 // style, not managed by the taskbar - instead leave Windows take care
680 if ( win
->GetWindowStyle() & wxFRAME_TOOL_WINDOW
)
683 // the child MDI frames are a special case and should not be touched by
684 // the parent frame - instead, they are managed by the user
685 wxFrame
*frame
= wxDynamicCast(win
, wxFrame
);
687 #if wxUSE_MDI_ARCHITECTURE
688 && !frame
->IsMDIChild()
689 #endif // wxUSE_MDI_ARCHITECTURE
692 // we don't want to restore the child frames which had been
693 // iconized even before we were iconized, so save the child frame
694 // status when iconizing the parent frame and check it when
698 frame
->m_wasMinimized
= frame
->IsIconized();
701 // note that we shouldn't touch the hidden frames neither because
702 // iconizing/restoring them would show them as a side effect
703 if ( !frame
->m_wasMinimized
&& frame
->IsShown() )
704 frame
->Iconize(bIconize
);
709 WXHICON
wxFrame::GetDefaultIcon() const
711 // we don't have any standard icons (any more)
715 // ===========================================================================
716 // message processing
717 // ===========================================================================
719 // ---------------------------------------------------------------------------
721 // ---------------------------------------------------------------------------
723 bool wxFrame::MSWDoTranslateMessage(wxFrame
*frame
, WXMSG
*pMsg
)
725 if ( wxWindow::MSWTranslateMessage(pMsg
) )
728 #if wxUSE_MENUS && wxUSE_ACCEL && !defined(__WXUNIVERSAL__)
729 // try the menu bar accelerators
730 wxMenuBar
*menuBar
= GetMenuBar();
731 if ( menuBar
&& menuBar
->GetAcceleratorTable()->Translate(frame
, pMsg
) )
733 #endif // wxUSE_MENUS && wxUSE_ACCEL
738 // ---------------------------------------------------------------------------
739 // our private (non virtual) message handlers
740 // ---------------------------------------------------------------------------
742 bool wxFrame::HandleSize(int WXUNUSED(x
), int WXUNUSED(y
), WXUINT id
)
744 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
749 // only do it it if we were iconized before, otherwise resizing the
750 // parent frame has a curious side effect of bringing it under it's
755 // restore all child frames too
756 IconizeChildFrames(false);
758 (void)SendIconizeEvent(false);
762 // iconize all child frames too
763 IconizeChildFrames(true);
768 #endif // !__WXWINCE__
774 #endif // wxUSE_STATUSBAR
778 #endif // wxUSE_TOOLBAR
780 #if defined(WINCE_WITH_COMMANDBAR)
781 // Position the menu command bar
782 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
785 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
786 wxSize clientSz
= GetClientSize();
788 if ( !::MoveWindow((HWND
) GetMenuBar()->GetCommandBar(), 0, 0, clientSz
.x
, rect
.bottom
- rect
.top
, true ) )
790 wxLogLastError(wxT("MoveWindow"));
794 #endif // WINCE_WITH_COMMANDBAR
797 // call the base class version to generate the appropriate events
801 bool wxFrame::HandleCommand(WXWORD id
, WXWORD cmd
, WXHWND control
)
805 #if defined(WINCE_WITHOUT_COMMANDBAR)
806 if (GetToolBar() && GetToolBar()->FindById(id
))
807 return GetToolBar()->MSWCommand(cmd
, id
);
810 // we only need to handle the menu and accelerator commands from the items
811 // of our menu bar, base wxWindow class already handles the rest
812 if ( !control
&& (cmd
== 0 /* menu */ || cmd
== 1 /* accel */) )
814 #if wxUSE_MENUS_NATIVE
815 if ( !wxCurrentPopupMenu
)
816 #endif // wxUSE_MENUS_NATIVE
818 wxMenuItem
* const mitem
= FindItemInMenuBar((signed short)id
);
820 return ProcessCommand(mitem
);
823 #endif // wxUSE_MENUS
825 return wxFrameBase::HandleCommand(id
, cmd
, control
);;
828 // ---------------------------------------------------------------------------
829 // the window proc for wxFrame
830 // ---------------------------------------------------------------------------
832 WXLRESULT
wxFrame::MSWWindowProc(WXUINT message
, WXWPARAM wParam
, WXLPARAM lParam
)
835 bool processed
= false;
840 // if we can't close, tell the system that we processed the
841 // message - otherwise it would close us
842 processed
= !Close();
846 processed
= HandleSize(LOWORD(lParam
), HIWORD(lParam
), wParam
);
853 UnpackCommand((WXWPARAM
)wParam
, (WXLPARAM
)lParam
,
856 HandleCommand(id
, cmd
, (WXHWND
)hwnd
);
858 // don't pass WM_COMMAND to the base class whether we processed
859 // it or not because we did generate an event for it (our
860 // HandleCommand() calls the base class version) and we must
861 // not do it again or the handlers which skip the event would
867 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
868 case WM_QUERYDRAGICON
:
870 const wxIcon
& icon
= GetIcon();
871 HICON hIcon
= icon
.IsOk() ? GetHiconOf(icon
)
872 : (HICON
)GetDefaultIcon();
873 rc
= (WXLRESULT
)hIcon
;
877 #endif // !__WXMICROWIN__
881 rc
= wxFrameBase::MSWWindowProc(message
, wParam
, lParam
);
886 // ----------------------------------------------------------------------------
887 // wxFrame size management: we exclude the areas taken by menu/status/toolbars
888 // from the client area, so the client area is what's really available for the
890 // ----------------------------------------------------------------------------
892 // get the origin of the client area in the client coordinates
893 wxPoint
wxFrame::GetClientAreaOrigin() const
895 wxPoint pt
= wxTopLevelWindow::GetClientAreaOrigin();
897 #if wxUSE_TOOLBAR && !defined(__WXUNIVERSAL__) && \
898 (!defined(__WXWINCE__) || (_WIN32_WCE >= 400 && !defined(__POCKETPC__) && !defined(__SMARTPHONE__)))
899 wxToolBar
* const toolbar
= GetToolBar();
900 if ( toolbar
&& toolbar
->IsShown() )
902 const wxSize sizeTB
= toolbar
->GetSize();
904 if ( toolbar
->HasFlag(wxTB_TOP
) )
908 else if ( toolbar
->HasFlag(wxTB_LEFT
) )
913 #endif // wxUSE_TOOLBAR
915 #if defined(WINCE_WITH_COMMANDBAR)
916 if (GetMenuBar() && GetMenuBar()->GetCommandBar())
919 ::GetWindowRect((HWND
) GetMenuBar()->GetCommandBar(), &rect
);
920 pt
.y
+= (rect
.bottom
- rect
.top
);