///////////////////////////////////////////////////////////////////////////// // Name: app.h // Purpose: wxApp class // Author: Julian Smart // Modified by: // Created: 01/02/97 // RCS-ID: $Id$ // Copyright: (c) Julian Smart and Markus Holzem // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// #ifndef __APPH__ #define __APPH__ #ifdef __GNUG__ #pragma interface "app.h" #endif #include "wx/defs.h" #include "wx/object.h" class WXDLLEXPORT wxFrame; class WXDLLEXPORT wxWindow; class WXDLLEXPORT wxApp ; class WXDLLEXPORT wxKeyEvent; class WXDLLEXPORT wxLog; #if USE_WXCONFIG class WXDLLEXPORT wxConfig; #endif //USE_WXCONFIG #define wxPRINT_WINDOWS 1 #define wxPRINT_POSTSCRIPT 2 WXDLLEXPORT_DATA(extern wxApp*) wxTheApp; void WXDLLEXPORT wxCleanUp(); void WXDLLEXPORT wxCommonCleanUp(); // Call this from the platform's wxCleanUp() void WXDLLEXPORT wxCommonInit(); // Call this from the platform's initialization // Force an exit from main loop void WXDLLEXPORT wxExit(); // Yield to other apps/messages bool WXDLLEXPORT wxYield(); // Represents the application. Derive OnInit and declare // a new App object to start application class WXDLLEXPORT wxApp: public wxEvtHandler { DECLARE_DYNAMIC_CLASS(wxApp) wxApp(); inline ~wxApp() {} static void SetInitializerFunction(wxAppInitializerFunction fn) { m_appInitFn = fn; } static wxAppInitializerFunction GetInitializerFunction() { return m_appInitFn; } virtual int MainLoop(); void ExitMainLoop(); bool Initialized(); virtual bool Pending() ; virtual void Dispatch() ; virtual void OnIdle(wxIdleEvent& event); // Generic virtual bool OnInit() { return FALSE; }; // No specific tasks to do here. virtual bool OnInitGui() { return TRUE; } // Called to set off the main loop virtual int OnRun() { return MainLoop(); }; virtual int OnExit() { return 0; }; inline void SetPrintMode(int mode) { m_printMode = mode; } inline int GetPrintMode() const { return m_printMode; } inline void SetExitOnFrameDelete(bool flag) { m_exitOnFrameDelete = flag; } inline bool GetExitOnFrameDelete() const { return m_exitOnFrameDelete; } inline wxString GetAppName() const { if (m_appName != "") return m_appName; else return m_className; } inline void SetAppName(const wxString& name) { m_appName = name; }; inline wxString GetClassName() const { return m_className; } inline void SetClassName(const wxString& name) { m_className = name; } wxWindow *GetTopWindow() const ; inline void SetTopWindow(wxWindow *win) { m_topWindow = win; } inline void SetWantDebugOutput(bool flag) { m_wantDebugOutput = flag; } inline bool GetWantDebugOutput() { return m_wantDebugOutput; } // Send idle event to all top-level windows. // Returns TRUE if more idle time is requested. bool SendIdleEvents(); // Send idle event to window and all subwindows // Returns TRUE if more idle time is requested. bool SendIdleEvents(wxWindow* win); inline void SetAuto3D(bool flag) { m_auto3D = flag; } inline bool GetAuto3D() const { return m_auto3D; } // Creates a log object virtual wxLog* CreateLogTarget(); #if USE_WXCONFIG // override this function to create a global wxConfig object of different // than default type (right now the default implementation returns NULL) virtual wxConfig* CreateConfig() { return NULL; } #endif //USE_WXCONFIG public: // void (*work_proc)(wxApp*app); // work procedure; int argc; char ** argv; protected: bool m_wantDebugOutput ; wxString m_className; wxString m_appName; wxWindow * m_topWindow; bool m_exitOnFrameDelete; bool m_showOnInit; int m_printMode; // wxPRINT_WINDOWS, wxPRINT_POSTSCRIPT bool m_auto3D ; // Always use 3D controls, except // where overriden static wxAppInitializerFunction m_appInitFn; /* Windows-specific wxApp definitions */ public: // Implementation static bool Initialize(WXHINSTANCE instance); static void CommonInit(); static bool RegisterWindowClasses(); static void CleanUp(); static void CommonCleanUp(); virtual bool DoMessage(); virtual bool ProcessMessage(WXMSG* pMsg); void DeletePendingObjects(); bool ProcessIdle(); int GetComCtl32Version() const; public: static long sm_lastMessageTime; int m_nCmdShow; protected: bool m_keepGoing ; // bool m_resourceCollection; // bool m_pendingCleanup; // TRUE if we need to check the GDI object lists for cleanup DECLARE_EVENT_TABLE() }; #if !defined(_WINDLL) || (defined(_WINDLL) && defined(WXMAKINGDLL)) int WXDLLEXPORT wxEntry(WXHINSTANCE hInstance, WXHINSTANCE hPrevInstance, char *lpszCmdLine, int nCmdShow, bool enterLoop = TRUE); #else int WXDLLEXPORT wxEntry(WXHINSTANCE hInstance); #endif #endif // __APPH__