1 /////////////////////////////////////////////////////////////////////////////
4 // Author: David Webster
8 // Copyright: (c) David Webster
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // For compilers that support precompilation, includes "wx.h".
13 #include "wx/wxprec.h"
19 #include "wx/gdicmn.h"
22 #include "wx/cursor.h"
24 #include "wx/palette.h"
26 #include "wx/dialog.h"
27 #include "wx/msgdlg.h"
29 #include "wx/dynarray.h"
30 # include "wx/wxchar.h"
35 #include "wx/module.h"
37 #include "wx/os2/private.h"
40 #include "wx/thread.h"
42 // define the array of QMSG strutures
43 WX_DECLARE_OBJARRAY(QMSG
, wxMsgArray
);
45 #include "wx/arrimpl.cpp"
47 WX_DEFINE_OBJARRAY(wxMsgArray
);
48 #endif // wxUSE_THREADS
50 #if wxUSE_WX_RESOURCES
51 #include "wx/resource.h"
57 // ---------------------------------------------------------------------------
59 // ---------------------------------------------------------------------------
61 extern wxChar
* wxBuffer
;
62 extern wxChar
* wxOsVersion
;
63 extern wxList
* wxWinHandleList
;
64 extern wxList WXDLLEXPORT wxPendingDelete
;
65 extern void wxSetKeyboardHook(bool doIt
);
66 extern wxCursor
* g_globalCursor
;
68 HINSTANCE wxhInstance
= 0;
70 wxApp
* wxTheApp
= NULL
;
73 // FIXME why not const? and not static?
75 // NB: all "NoRedraw" classes must have the same names as the "normal" classes
76 // with NR suffix - wxWindow::OS2Create() supposes this
77 wxChar wxFrameClassName
[] = wxT("wxFrameClass");
78 wxChar wxFrameClassNameNoRedraw
[] = wxT("wxFrameClassNR");
79 wxChar wxMDIFrameClassName
[] = wxT("wxMDIFrameClass");
80 wxChar wxMDIFrameClassNameNoRedraw
[] = wxT("wxMDIFrameClassNR");
81 wxChar wxMDIChildFrameClassName
[] = wxT("wxMDIChildFrameClass");
82 wxChar wxMDIChildFrameClassNameNoRedraw
[] = wxT("wxMDIChildFrameClassNR");
83 wxChar wxPanelClassName
[] = wxT("wxPanelClass");
84 wxChar wxCanvasClassName
[] = wxT("wxCanvasClass");
86 HICON wxSTD_FRAME_ICON
= (HICON
) NULL
;
87 HICON wxSTD_MDICHILDFRAME_ICON
= (HICON
) NULL
;
88 HICON wxSTD_MDIPARENTFRAME_ICON
= (HICON
) NULL
;
90 HICON wxDEFAULT_FRAME_ICON
= (HICON
) NULL
;
91 HICON wxDEFAULT_MDICHILDFRAME_ICON
= (HICON
) NULL
;
92 HICON wxDEFAULT_MDIPARENTFRAME_ICON
= (HICON
) NULL
;
94 HBRUSH wxDisableButtonBrush
= (HBRUSH
) 0;
96 MRESULT
wxWndProc( HWND
102 // ===========================================================================
104 // ===========================================================================
106 // ---------------------------------------------------------------------------
108 // ---------------------------------------------------------------------------
110 #if !USE_SHARED_LIBRARY
111 IMPLEMENT_DYNAMIC_CLASS(wxApp
, wxEvtHandler
)
113 BEGIN_EVENT_TABLE(wxApp
, wxEvtHandler
)
114 EVT_IDLE(wxApp::OnIdle
)
115 EVT_END_SESSION(wxApp::OnEndSession
)
116 EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession
)
121 bool wxApp::Initialize(
125 // Some people may wish to use this, but
126 // probably it shouldn't be here by default.
128 // wxRedirectIOToConsole();
131 wxBuffer
= new wxChar
[1500]; // FIXME; why?
133 wxClassInfo::InitializeClasses();
136 wxGetResource(wxT("wxWindows"), wxT("OsVersion"), &wxOsVersion
);
139 // I'm annoyed ... I don't know where to put this and I don't want to
140 // create a module for that as it's part of the core.
141 wxTheColourDatabase
= new wxColourDatabase(wxKEY_STRING
);
142 wxTheColourDatabase
->Initialize();
144 wxInitializeStockLists();
145 wxInitializeStockObjects();
147 #if wxUSE_WX_RESOURCES
148 wxInitializeResourceSystem();
151 wxBitmap::InitStandardHandlers();
153 g_globalCursor
= new wxCursor
;
156 wxSTD_FRAME_ICON
= ::WinLoadFileIcon(wxT("wxSTD_FRAME"), TRUE
);
157 wxSTD_MDIPARENTFRAME_ICON
= ::WinLoadFileIcon(wxT("wxSTD_MDIPARENTFRAME"), TRUE
);
158 wxSTD_MDICHILDFRAME_ICON
= ::WinLoadFileIcon(wxT("wxSTD_MDICHILDFRAME"), TRUE
);
160 wxDEFAULT_FRAME_ICON
= ::WinLoadFileIcon(wxT("wxDEFAULT_FRAME"), TRUE
);
161 wxDEFAULT_MDIPARENTFRAME_ICON
= ::WinLoadFileIcon(wxT("wxDEFAULT_MDIPARENTFRAME"), TRUE
);
162 wxDEFAULT_MDICHILDFRAME_ICON
= ::WinLoadFileIcon(wxT("wxDEFAULT_MDICHILDFRAME"), TRUE
);
164 RegisterWindowClasses(vHab
);
165 wxWinHandleList
= new wxList(wxKEY_INTEGER
);
167 // This is to foil optimizations in Visual C++ that throw out dummy.obj.
168 // PLEASE DO NOT ALTER THIS.
169 #if !defined(WXMAKINGDLL)
170 extern char wxDummyChar
;
171 if (wxDummyChar
) wxDummyChar
++;
174 wxSetKeyboardHook(TRUE
);
176 wxModule::RegisterModules();
177 if (!wxModule::InitializeModules())
182 // ---------------------------------------------------------------------------
183 // RegisterWindowClasses
184 // ---------------------------------------------------------------------------
186 // TODO we should only register classes really used by the app. For this it
187 // would be enough to just delay the class registration until an attempt
188 // to create a window of this class is made.
189 bool wxApp::RegisterWindowClasses(
195 if ((rc
= ::WinRegisterClass( vHab
198 ,CS_SIZEREDRAW
| CS_SYNCPAINT
| CS_HITTEST
| CS_CLIPCHILDREN
| CS_FRAME
202 wxLogLastError("RegisterClass(frame)");
207 if (!::WinRegisterClass( vHab
208 ,wxFrameClassNameNoRedraw
210 ,CS_HITTEST
| CS_CLIPCHILDREN
| CS_FRAME
214 wxLogLastError("RegisterClass(no redraw frame)");
219 if (!::WinRegisterClass( vHab
222 ,CS_SIZEREDRAW
| CS_SYNCPAINT
| CS_HITTEST
| CS_CLIPCHILDREN
| CS_FRAME
226 wxLogLastError("RegisterClass(MDI parent)");
231 if (!::WinRegisterClass( vHab
232 ,wxMDIFrameClassNameNoRedraw
234 ,CS_HITTEST
| CS_CLIPCHILDREN
| CS_FRAME
238 wxLogLastError("RegisterClass(no redraw MDI parent)");
243 if (!::WinRegisterClass( vHab
244 ,wxMDIChildFrameClassName
246 ,CS_MOVENOTIFY
| CS_SIZEREDRAW
| CS_SYNCPAINT
| CS_HITTEST
| CS_CLIPSIBLINGS
| CS_FRAME
250 wxLogLastError("RegisterClass(MDI child)");
255 if (!::WinRegisterClass( vHab
256 ,wxMDIChildFrameClassNameNoRedraw
258 ,CS_HITTEST
| CS_CLIPSIBLINGS
| CS_FRAME
262 wxLogLastError("RegisterClass(no redraw MDI child)");
267 if (!::WinRegisterClass( vHab
270 ,CS_MOVENOTIFY
| CS_SIZEREDRAW
| CS_HITTEST
| CS_CLIPSIBLINGS
| CS_SAVEBITS
| CS_SYNCPAINT
274 wxLogLastError("RegisterClass(Panel)");
279 if (!::WinRegisterClass( vHab
282 ,CS_MOVENOTIFY
| CS_SIZEREDRAW
| CS_HITTEST
| CS_CLIPSIBLINGS
| CS_SAVEBITS
| CS_SYNCPAINT
286 wxLogLastError("RegisterClass(Canvas)");
293 //// Cleans up any wxWindows internal structures left lying around
295 void wxApp::CleanUp()
300 // flush the logged messages if any and install a 'safer' log target: the
301 // default one (wxLogGui) can't be used after the resources are freed just
302 // below and the user suppliedo ne might be even more unsafe (using any
303 // wxWindows GUI function is unsafe starting from now)
304 wxLog::DontCreateOnDemand();
306 // this will flush the old messages if any
307 delete wxLog::SetActiveTarget(new wxLogStderr
);
310 // One last chance for pending objects to be cleaned up
311 wxTheApp
->DeletePendingObjects();
313 wxModule::CleanUpModules();
315 #if wxUSE_WX_RESOURCES
316 wxCleanUpResourceSystem();
318 // wxDefaultResourceTable->ClearTable();
321 // Indicate that the cursor can be freed, so that cursor won't be deleted
322 // by deleting the bitmap list before g_globalCursor goes out of scope
323 // (double deletion of the cursor).
324 wxSetCursor(wxNullCursor
);
325 delete g_globalCursor
;
326 g_globalCursor
= NULL
;
328 wxDeleteStockObjects();
330 // Destroy all GDI lists, etc.
331 wxDeleteStockLists();
333 delete wxTheColourDatabase
;
334 wxTheColourDatabase
= NULL
;
336 wxBitmap::CleanUpHandlers();
341 //// WINDOWS-SPECIFIC CLEANUP
343 wxSetKeyboardHook(FALSE
);
345 if (wxSTD_FRAME_ICON
)
346 ::WinFreeFileIcon(wxSTD_FRAME_ICON
);
347 if (wxSTD_MDICHILDFRAME_ICON
)
348 ::WinFreeFileIcon(wxSTD_MDICHILDFRAME_ICON
);
349 if (wxSTD_MDIPARENTFRAME_ICON
)
350 ::WinFreeFileIcon(wxSTD_MDIPARENTFRAME_ICON
);
352 if (wxDEFAULT_FRAME_ICON
)
353 ::WinFreeFileIcon(wxDEFAULT_FRAME_ICON
);
354 if (wxDEFAULT_MDICHILDFRAME_ICON
)
355 ::WinFreeFileIcon(wxDEFAULT_MDICHILDFRAME_ICON
);
356 if (wxDEFAULT_MDIPARENTFRAME_ICON
)
357 ::WinFreeFileIcon(wxDEFAULT_MDIPARENTFRAME_ICON
);
359 if ( wxDisableButtonBrush
)
361 // TODO: ::DeleteObject( wxDisableButtonBrush );
365 delete wxWinHandleList
;
367 // GL: I'm annoyed ... I don't know where to put this and I don't want to
368 // create a module for that as it's part of the core.
370 delete wxPendingEvents
;
371 delete wxPendingEventsLocker
;
372 // If we don't do the following, we get an apparent memory leak.
373 ((wxEvtHandler
&) wxDefaultValidator
).ClearEventLocker();
376 wxClassInfo::CleanUpClasses();
381 #if (defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING) || wxUSE_DEBUG_CONTEXT
382 // At this point we want to check if there are any memory
383 // blocks that aren't part of the wxDebugContext itself,
384 // as a special case. Then when dumping we need to ignore
385 // wxDebugContext, too.
386 if (wxDebugContext::CountObjectsLeft(TRUE
) > 0)
388 wxLogDebug(wxT("There were memory leaks."));
389 wxDebugContext::Dump();
390 wxDebugContext::PrintStatistics();
392 // wxDebugContext::SetStream(NULL, NULL);
396 // do it as the very last thing because everything else can log messages
397 delete wxLog::SetActiveTarget(NULL
);
408 if (!wxApp::Initialize(vHab
))
412 // create the application object or ensure that one already exists
416 wxCHECK_MSG( wxApp::GetInitializerFunction()
418 ,wxT("wxWindows error: No initializer - use IMPLEMENT_APP macro.\n")
421 wxAppInitializerFunction fnAppIni
= wxApp::GetInitializerFunction();
422 wxObject
* pTest_app
= fnAppIni();
424 wxTheApp
= (wxApp
*)pTest_app
;
426 wxCHECK_MSG( wxTheApp
, -1, wxT("wxWindows error: no application object") );
427 wxTheApp
->argc
= argc
;
430 wxTheApp
->argv
= new wxChar
*[argc
+1];
436 wxTheApp
->argv
[nArgc
] = wxStrdup(wxConvLibc
.cMB2WX(argv
[nArgc
]));
439 wxTheApp
->argv
[nArgc
] = (wxChar
*)NULL
;
441 wxTheApp
->argv
= argv
;
444 wxString
sName(wxFileNameFromPath(argv
[0]));
446 wxStripExtension(sName
);
447 wxTheApp
->SetAppName(sName
);
451 if (!wxTheApp
->OnInitGui())
456 if (wxTheApp
->OnInit())
464 wxWindow
* pTopWindow
= wxTheApp
->GetTopWindow();
468 // Forcibly delete the window.
469 if (pTopWindow
->IsKindOf(CLASSINFO(wxFrame
)) ||
470 pTopWindow
->IsKindOf(CLASSINFO(wxDialog
)) )
472 pTopWindow
->Close(TRUE
);
473 wxTheApp
->DeletePendingObjects();
478 wxTheApp
->SetTopWindow(NULL
);
487 bool wxApp::OnInitGui()
489 vHabmain
= WinInitialize(0);
490 m_hMq
= WinCreateMsgQueue(vHabmain
, 0);
496 // Static member initialization
498 wxAppInitializerFunction
wxAppBase::m_appInitFn
= (wxAppInitializerFunction
) NULL
;
504 m_wantDebugOutput
= TRUE
;
508 m_nPrintMode
= wxPRINT_WINDOWS
;
509 m_exitOnFrameDelete
= TRUE
;
515 // Delete command-line args
517 for (i
= 0; i
< argc
; i
++)
524 bool wxApp::Initialized()
533 // Get and process a message, returning FALSE if WM_QUIT
534 // received (and also set the flag telling the app to exit the main loop)
536 bool wxApp::DoMessage()
538 BOOL bRc
= ::WinGetMsg(vHabmain
, &m_vMsg
, HWND(NULL
), 0, 0);
543 m_bKeepGoing
= FALSE
;
548 // should never happen, but let's test for it nevertheless
549 wxLogLastError("GetMessage");
554 wxASSERT_MSG( wxThread::IsMain()
555 ,wxT("only the main thread can process Windows messages")
558 static bool sbHadGuiLock
= TRUE
;
559 static wxMsgArray svSavedMessages
;
562 // if a secondary thread owns is doing GUI calls, save all messages for
563 // later processing - we can't process them right now because it will
564 // lead to recursive library calls (and we're not reentrant)
566 if (!wxGuiOwnedByMainThread())
568 sbHadGuiLock
= FALSE
;
570 // leave out WM_COMMAND messages: too dangerous, sometimes
571 // the message will be processed twice
572 if ( !wxIsWaitingForThread() ||
573 svCurrentMsg
.msg
!= WM_COMMAND
)
575 svSavedMessages
.Add(svCurrentMsg
);
582 // have we just regained the GUI lock? if so, post all of the saved
585 // FIXME of course, it's not _exactly_ the same as processing the
586 // messages normally - expect some things to break...
592 size_t nCount
= svSavedMessages
.Count();
594 for (size_t n
= 0; n
< nCount
; n
++)
596 QMSG vMsg
= svSavedMessages
[n
];
598 if ( !ProcessMessage((WXMSG
*)&vMsg
) )
600 ::WinDispatchMsg(vHabmain
, &vMsg
);
603 svSavedMessages
.Empty();
606 #endif // wxUSE_THREADS
608 // Process the message
609 if (!ProcessMessage((WXMSG
*)&svCurrentMsg
) )
611 ::WinDispatchMsg(vHabmain
, (PQMSG
)&svCurrentMsg
);
617 //////////////////////////////////////////////////////////////////////////////
619 // Keep trying to process messages until WM_QUIT
622 // If there are messages to be processed, they will all be
623 // processed and OnIdle will not be called.
624 // When there are no more messages, OnIdle is called.
625 // If OnIdle requests more time,
626 // it will be repeatedly called so long as there are no pending messages.
627 // A 'feature' of this is that once OnIdle has decided that no more processing
628 // is required, then it won't get processing time until further messages
629 // are processed (it'll sit in DoMessage).
631 //////////////////////////////////////////////////////////////////////////////
632 int wxApp::MainLoop()
639 wxMutexGuiLeaveOrEnter();
640 #endif // wxUSE_THREADS
641 while (!::WinPeekMsg(vHabmain
, &svCurrentMsg
, (HWND
)NULL
, 0, 0, PM_NOREMOVE
) &&
647 return (int)svCurrentMsg
.mp1
;
651 // Returns TRUE if more time is needed.
653 bool wxApp::ProcessIdle()
657 vEvent
.SetEventObject(this);
658 ProcessEvent(vEvent
);
659 return vEvent
.MoreRequested();
663 void wxApp::ProcessPendingEvents()
665 wxNode
* pNode
= wxPendingEvents
->First();
666 wxCriticalSectionLocker
vLocker(*wxPendingEventsLocker
);
670 wxEvtHandler
* pHandler
= (wxEvtHandler
*)pNode
->Data();
671 pHandler
->ProcessPendingEvents();
674 pNode
= wxPendingEvents
->First();
679 void wxApp::ExitMainLoop()
681 m_bKeepGoing
= FALSE
;
684 bool wxApp::Pending()
686 return (::WinPeekMsg(vHabmain
, (PQMSG
)&svCurrentMsg
, (HWND
)NULL
, 0, 0, PM_NOREMOVE
) != 0);
689 void wxApp::Dispatch()
694 //////////////////////////////////////////////////////////////////////////////
696 // Give all windows a chance to preprocess
697 // the message. Some may have accelerator tables, or have
698 // MDI complications.
700 //////////////////////////////////////////////////////////////////////////////
701 bool wxApp::ProcessMessage(
705 QMSG
* vMsg
= (PQMSG
)pWxmsg
;
706 HWND hWnd
= vMsg
->hwnd
;
707 wxWindow
* pWndThis
= wxFindWinFromHandle((WXHWND
)hWnd
);
711 // for some composite controls (like a combobox), wndThis might be NULL
712 // because the subcontrol is not a wxWindow, but only the control itself
713 // is - try to catch this case
715 while (hWnd
&& !pWndThis
)
717 hWnd
= ::WinQueryWindow(hWnd
, QW_PARENT
);
718 pWndThis
= wxFindWinFromHandle((WXHWND
)hWnd
);
721 // Anyone for a non-translation message? Try youngest descendants first.
722 for (pWnd
= pWndThis
; pWnd
; pWnd
= pWnd
->GetParent())
724 if (pWnd
->OS2ProcessMessage(pWxmsg
))
734 static bool sbInOnIdle
= FALSE
;
737 // Avoid recursion (via ProcessEvent default case)
745 // 'Garbage' collection of windows deleted with Close().
747 DeletePendingObjects();
750 // flush the logged messages if any
751 wxLog
* pLog
= wxLog::GetActiveTarget();
753 if (pLog
!= NULL
&& pLog
->HasPendingMessages())
757 // Send OnIdle events to all windows
758 if (SendIdleEvents())
761 // SendIdleEvents() returns TRUE if at least one window requested more
764 rEvent
.RequestMore(TRUE
);
768 // If they are pending events, we must process them.
771 ProcessPendingEvents();
778 // **** please implement me! ****
779 // Wake up the idle handler processor, even if it is in another thread...
782 // Send idle event to all top-level windows
783 bool wxApp::SendIdleEvents()
785 bool bNeedMore
= FALSE
;
786 wxWindowList::Node
* pNode
= wxTopLevelWindows
.GetFirst();
790 wxWindow
* pWin
= pNode
->GetData();
792 if (SendIdleEvents(pWin
))
794 pNode
= pNode
->GetNext();
800 // Send idle event to window and all subwindows
802 bool wxApp::SendIdleEvents(
806 bool bNeedMore
= FALSE
;
809 vEvent
.SetEventObject(pWin
);
810 pWin
->GetEventHandler()->ProcessEvent(vEvent
);
812 if (vEvent
.MoreRequested())
815 wxNode
* pNode
= pWin
->GetChildren().First();
819 wxWindow
* pWin
= (wxWindow
*) pNode
->Data();
821 if (SendIdleEvents(pWin
))
823 pNode
= pNode
->Next();
828 void wxApp::DeletePendingObjects()
830 wxNode
* pNode
= wxPendingDelete
.First();
834 wxObject
* pObj
= (wxObject
*)pNode
->Data();
838 if (wxPendingDelete
.Member(pObj
))
842 // Deleting one object may have deleted other pending
843 // objects, so start from beginning of list again.
845 pNode
= wxPendingDelete
.First();
849 void wxApp::OnEndSession(
850 wxCloseEvent
& WXUNUSED(rEvent
))
853 GetTopWindow()->Close(TRUE
);
857 // Default behaviour: close the application with prompts. The
858 // user can veto the close, and therefore the end session.
860 void wxApp::OnQueryEndSession(
866 if (!GetTopWindow()->Close(!rEvent
.CanVeto()))
873 wxLogError(_("Fatal error: exiting"));
878 // Yield to incoming messages
883 // We want to go back to the main message loop
884 // if we see a WM_QUIT. (?)
885 while (::WinPeekMsg(vHab
, &vMsg
, (HWND
)NULL
, 0, 0, PM_NOREMOVE
) && vMsg
.msg
!= WM_QUIT
)
887 if (!wxTheApp
->DoMessage())
890 // If they are pending events, we must process them.
892 wxTheApp
->ProcessPendingEvents();
897 wxIcon
wxApp::GetStdIcon(
903 case wxICON_INFORMATION
:
904 return wxIcon("wxICON_INFO");
906 case wxICON_QUESTION
:
907 return wxIcon("wxICON_QUESTION");
909 case wxICON_EXCLAMATION
:
910 return wxIcon("wxICON_WARNING");
913 wxFAIL_MSG(wxT("requested non existent standard icon"));
914 // still fall through
917 return wxIcon("wxICON_ERROR");
919 return wxIcon("wxICON_ERROR");
922 HINSTANCE
wxGetInstance()
927 void wxSetInstance(HINSTANCE hInst
)