/////////////////////////////////////////////////////////////////////////////
-// Name: msw/main.cpp
+// Name: src/msw/main.cpp
// Purpose: WinMain/DllMain
// Author: Julian Smart
// Modified by:
// headers
// ----------------------------------------------------------------------------
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #pragma implementation
-#endif
-
// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#pragma hdrstop
#endif
-#include "wx/event.h"
-#include "wx/app.h"
+#ifndef WX_PRECOMP
+ #include "wx/event.h"
+ #include "wx/app.h"
+#endif //WX_PRECOMP
+
#include "wx/cmdline.h"
+#include "wx/scopeguard.h"
#include "wx/msw/private.h"
+#include "wx/msw/seh.h"
#if wxUSE_ON_FATAL_EXCEPTION
#include "wx/datetime.h"
#include "wx/msw/crashrpt.h"
-
- #ifdef __VISUALC__
- #include <eh.h>
- #endif // __VISUALC__
#endif // wxUSE_ON_FATAL_EXCEPTION
#ifdef __WXWINCE__
// there is no ExitProcess() under CE but exiting the main thread has the
// same effect
- #define ExitProcess ExitThread
-#endif
+ #ifndef ExitProcess
+ #define ExitProcess ExitThread
+ #endif
+#endif // __WXWINCE__
#ifdef __BORLANDC__
// BC++ has to be special: its run-time expects the DLL entry point to be
// named DllEntryPoint instead of the (more) standard DllMain
#define DllMain DllEntryPoint
-#endif
+#endif // __BORLANDC__
#if defined(__WXMICROWIN__)
#define HINSTANCE HANDLE
#endif
+// defined in common/init.cpp
+extern int wxEntryReal(int& argc, wxChar **argv);
+
// ============================================================================
// implementation: various entry points
// ============================================================================
+#if wxUSE_BASE
+
+#if wxUSE_ON_FATAL_EXCEPTION && defined(__VISUALC__) && !defined(__WXWINCE__)
+ // VC++ (at least from 4.0 up to version 7.1) is incredibly broken in that
+ // a "catch ( ... )" will *always* catch SEH exceptions in it even though
+ // it should have never been the case... to prevent such catches from
+ // stealing the exceptions from our wxGlobalSEHandler which is only called
+ // if the exception is not handled elsewhere, we have to also call it from
+ // a special SEH translator function which is called by VC CRT when a Win32
+ // exception occurs
+
+ // this warns that /EHa (async exceptions) should be used when using
+ // _set_se_translator but, in fact, this doesn't seem to change anything
+ // with VC++ up to 7.1 -- to be confirmed with VC++ 8
+ #if _MSC_VER <= 1310
+ #pragma warning(disable:4535)
+ #endif
+
+ // note that the SE translator must be called wxSETranslator!
+ #define DisableAutomaticSETranslator() _set_se_translator(wxSETranslator)
+#else // !__VISUALC__
+ #define DisableAutomaticSETranslator()
+#endif // __VISUALC__/!__VISUALC__
+
// ----------------------------------------------------------------------------
-// wrapper wxEntry catching all Win32 exceptions occuring in a wx program
+// wrapper wxEntry catching all Win32 exceptions occurring in a wx program
// ----------------------------------------------------------------------------
// wrap real wxEntry in a try-except block to be able to call
// flag telling us whether the application wants to handle exceptions at all
static bool gs_handleExceptions = false;
+static void wxFatalExit()
+{
+ // use the same exit code as abort()
+ ::ExitProcess(3);
+}
+
unsigned long wxGlobalSEHandler(EXCEPTION_POINTERS *pExcPtrs)
{
if ( gs_handleExceptions && wxTheApp )
wxGlobalSEInformation = pExcPtrs;
// give the user a chance to do something special about this
- __try
+ wxSEH_TRY
{
wxTheApp->OnFatalException();
}
- __except ( EXCEPTION_EXECUTE_HANDLER )
- {
- // nothing to do here, just ignore the exception inside the
- // exception handler
- ;
- }
+ wxSEH_IGNORE // ignore any exceptions inside the exception handler
wxGlobalSEInformation = NULL;
#ifdef __VISUALC__
-static void wxSETranslator(unsigned int WXUNUSED(code), EXCEPTION_POINTERS *ep)
+void wxSETranslator(unsigned int WXUNUSED(code), EXCEPTION_POINTERS *ep)
{
- wxGlobalSEHandler(ep);
+ switch ( wxGlobalSEHandler(ep) )
+ {
+ default:
+ wxFAIL_MSG( _T("unexpected wxGlobalSEHandler() return value") );
+ // fall through
+
+ case EXCEPTION_EXECUTE_HANDLER:
+ // if wxApp::OnFatalException() had been called we should exit the
+ // application -- but we shouldn't kill our host when we're a DLL
+#ifndef WXMAKINGDLL
+ wxFatalExit();
+#endif // not a DLL
+ break;
+
+ case EXCEPTION_CONTINUE_SEARCH:
+ // we're called for each "catch ( ... )" and if we (re)throw from
+ // here, the catch handler body is not executed, so the effect is
+ // as if had inhibited translation of SE to C++ ones because the
+ // handler will never see any structured exceptions
+ throw;
+ }
}
#endif // __VISUALC__
// assume this can only be called from the main thread
gs_handleExceptions = doit;
-#ifdef __VISUALC__
- // VC++ (at least from 4.0 up to version 7.1) is incredibly broken in that
- // a "catch ( ... )" will *always* catch SEH exceptions in it even though
- // it should have never been the case... to prevent such catches from
- // stealing the exceptions from our wxGlobalSEHandler which is only called
- // if the exception is not handled elsewhere, we have to also call it from
- // a special SEH translator function which is called by VC CRT when a Win32
- // exception occurs
-
- // this warns that /EHa (async exceptions) should be used when using
- // _set_se_translator but, in fact, this doesn't seem to change anything
- // with VC++ up to 7.1 -- to be confirmed with VC++ 8
- #if _MSC_VER <= 1310
- #pragma warning(disable:4535)
- #endif
-
- _set_se_translator(doit ? wxSETranslator : NULL);
-#endif
-
#if wxUSE_CRASHREPORT
if ( doit )
{
int wxEntry(int& argc, wxChar **argv)
{
- __try
- {
- extern int wxEntryReal(int& argc, wxChar **argv);
+ DisableAutomaticSETranslator();
+ wxSEH_TRY
+ {
return wxEntryReal(argc, argv);
}
- __except ( wxGlobalSEHandler(GetExceptionInformation()) )
- {
- ::ExitProcess(3); // the same exit code as abort()
+ wxSEH_HANDLE(-1)
+}
-#if !defined(_MSC_VER) || _MSC_VER < 1300
- // this code is unreachable but put it here to suppress warnings
- // from some compilers
- return -1;
+#else // !wxUSE_ON_FATAL_EXCEPTION
+
+#if defined(__VISUALC__) && !defined(__WXWINCE__)
+
+static void
+wxSETranslator(unsigned int WXUNUSED(code), EXCEPTION_POINTERS * WXUNUSED(ep))
+{
+ // see wxSETranslator() version for wxUSE_ON_FATAL_EXCEPTION above
+ throw;
+}
+
+#endif // __VISUALC__
+
+int wxEntry(int& argc, wxChar **argv)
+{
+ DisableAutomaticSETranslator();
+
+ return wxEntryReal(argc, argv);
+}
+
+#endif // wxUSE_ON_FATAL_EXCEPTION/!wxUSE_ON_FATAL_EXCEPTION
+
+#endif // wxUSE_BASE
+
+#if wxUSE_GUI && defined(__WXMSW__)
+
+#if wxUSE_UNICODE && !defined(__WXWINCE__)
+ #define NEED_UNICODE_CHECK
#endif
+
+#ifdef NEED_UNICODE_CHECK
+
+// check whether Unicode is available
+static bool wxIsUnicodeAvailable()
+{
+ static const wchar_t *ERROR_STRING = L"wxWidgets Fatal Error";
+
+ if ( wxGetOsVersion() != wxWINDOWS_NT )
+ {
+ // we need to be built with MSLU support
+#if !wxUSE_UNICODE_MSLU
+ // note that we can use MessageBoxW() as it's implemented even under
+ // Win9x - OTOH, we can't use wxGetTranslation() because the file APIs
+ // used by wxLocale are not
+ ::MessageBox
+ (
+ NULL,
+ L"This program uses Unicode and requires Windows NT/2000/XP.\n"
+ L"\n"
+ L"Program aborted.",
+ ERROR_STRING,
+ MB_ICONERROR | MB_OK
+ );
+
+ return false;
+#else // wxUSE_UNICODE_MSLU
+ // and the MSLU DLL must also be available
+ HMODULE hmod = ::LoadLibraryA("unicows.dll");
+ if ( !hmod )
+ {
+ ::MessageBox
+ (
+ NULL,
+ L"This program uses Unicode and requires unicows.dll to work "
+ L"under current operating system.\n"
+ L"\n"
+ L"Please install unicows.dll and relaunch the program.",
+ ERROR_STRING,
+ MB_ICONERROR | MB_OK
+ );
+ return false;
+ }
+
+ // this is not really necessary but be tidy
+ ::FreeLibrary(hmod);
+
+ // finally do the last check: has unicows.lib initialized correctly?
+ hmod = ::LoadLibraryW(L"unicows.dll");
+ if ( !hmod )
+ {
+ ::MessageBox
+ (
+ NULL,
+ L"This program uses Unicode but is not using unicows.dll\n"
+ L"correctly and so cannot work under current operating system.\n"
+ L"Please contact the program author for an updated version.\n"
+ L"\n"
+ L"Program aborted.",
+ ERROR_STRING,
+ MB_ICONERROR | MB_OK
+ );
+
+ return false;
+ }
+
+ ::FreeLibrary(hmod);
+#endif // !wxUSE_UNICODE_MSLU
}
-}
-#endif // wxUSE_ON_FATAL_EXCEPTION
+ return true;
+}
-#if wxUSE_GUI
+#endif // NEED_UNICODE_CHECK
// ----------------------------------------------------------------------------
// Windows-specific wxEntry
// ----------------------------------------------------------------------------
+// helper function used to clean up in wxEntry() just below
+//
+// notice that argv elements are supposed to be allocated using malloc() while
+// argv array itself is allocated with new
+static void wxFreeArgs(int argc, wxChar **argv)
+{
+ for ( int i = 0; i < argc; i++ )
+ {
+ free(argv[i]);
+ }
+
+ delete [] argv;
+}
+
WXDLLEXPORT int wxEntry(HINSTANCE hInstance,
HINSTANCE WXUNUSED(hPrevInstance),
wxCmdLineArgType WXUNUSED(pCmdLine),
int nCmdShow)
{
+ // the first thing to do is to check if we're trying to run an Unicode
+ // program under Win9x w/o MSLU emulation layer - if so, abort right now
+ // as it has no chance to work and has all chances to crash
+#ifdef NEED_UNICODE_CHECK
+ if ( !wxIsUnicodeAvailable() )
+ return -1;
+#endif // NEED_UNICODE_CHECK
+
+
// remember the parameters Windows gave us
wxSetInstance(hInstance);
wxApp::m_nCmdShow = nCmdShow;
// argv[] must be NULL-terminated
argv[argc] = NULL;
- return wxEntry(argc, argv);
-}
-
-// May wish not to have a DllMain or WinMain, e.g. if we're programming
-// a Netscape plugin or if we're writing a console application
-#if !defined(NOMAIN)
-
-extern "C"
-{
-
-// ----------------------------------------------------------------------------
-// WinMain
-// ----------------------------------------------------------------------------
+ wxON_BLOCK_EXIT2(wxFreeArgs, argc, argv);
-// Note that WinMain is also defined in dummy.obj, which is linked to
-// an application that is using the DLL version of wxWidgets.
-
-#if defined(_WINDLL)
-
-// DLL entry point
-
-BOOL WINAPI
-DllMain(HANDLE hModule, DWORD fdwReason, LPVOID WXUNUSED(lpReserved))
-{
- // Only call wxEntry if the application itself is part of the DLL.
- // If only the wxWidgets library is in the DLL, then the
- // initialisation will be called when the application implicitly
- // calls WinMain.
-#ifndef WXMAKINGDLL
- switch (fdwReason)
- {
- case DLL_PROCESS_ATTACH:
- return wxEntry(hModule);
-
- case DLL_PROCESS_DETACH:
- wxEntryCleanup();
- break;
- }
-#else
- (void)hModule;
- (void)fdwReason;
-#endif // !WXMAKINGDLL
-
- return TRUE;
+ return wxEntry(argc, argv);
}
-#endif // _WINDLL
-
-} // extern "C"
-
-#endif // !NOMAIN
-
-#endif // wxUSE_GUI
+#endif // wxUSE_GUI && __WXMSW__
// ----------------------------------------------------------------------------
// global HINSTANCE
}
#endif // wxUSE_BASE
-