///////////////////////////////////////////////////////////////////////////// // Name: app.h // Purpose: wxApp class // Author: AUTHOR // Modified by: // Created: ??/??/98 // RCS-ID: $Id$ // Copyright: (c) AUTHOR // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// #ifndef _WX_APP_H_ #define _WX_APP_H_ #ifdef __GNUG__ #pragma interface "app.h" #endif #include "wx/defs.h" #include "wx/object.h" #include "wx/gdicmn.h" #include "wx/event.h" class WXDLLEXPORT wxFrame; class WXDLLEXPORT wxWindow; class WXDLLEXPORT wxApp ; class WXDLLEXPORT wxKeyEvent; class WXDLLEXPORT wxLog; #define wxPRINT_WINDOWS 1 #define wxPRINT_POSTSCRIPT 2 WXDLLEXPORT_DATA(extern wxApp*) wxTheApp; // 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() ; 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; } void SetVendorName(const wxString& vendorName) { m_vendorName = vendorName; } const wxString& GetVendorName() const { return m_vendorName; } 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); // Windows only, but for compatibility... inline void SetAuto3D(bool flag) { m_auto3D = flag; } inline bool GetAuto3D() const { return m_auto3D; } // Creates a log object virtual wxLog* CreateLogTarget(); public: // Will always be set to the appropriate, main-style values. int argc; char ** argv; protected: bool m_wantDebugOutput ; wxString m_className; wxString m_appName, m_vendorName; 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; public: // Implementation static bool Initialize(); static void CleanUp(); void DeletePendingObjects(); bool ProcessIdle(); public: static long sm_lastMessageTime; static wxWindow* s_captureWindow ; static int s_lastMouseDown ; // 0 = none , 1 = left , 2 = right static RgnHandle s_macCursorRgn ; EventRecord* m_macCurrentEvent ; int m_nCmdShow; protected: bool m_keepGoing ; // mac specifics public : static bool s_macDefaultEncodingIsPC ; static bool s_macSupportPCMenuShortcuts ; static long s_macAboutMenuItemId ; static wxString s_macHelpMenuTitleName ; static bool s_macHasAppearance ; static long s_macAppearanceVersion ; static bool s_macHasNavigation ; static bool s_macNavigationVersion ; static bool s_macHasWindowManager ; static long s_macWindowManagerVersion ; static bool s_macHasMenuManager ; static long s_macMenuManagerVersion ; static bool s_macHasDialogManager ; static long s_macDialogManagerVersion ; RgnHandle m_macCursorRgn ; RgnHandle m_macSleepRgn ; RgnHandle m_macHelpRgn ; virtual void MacSuspend( bool convertClipboard ) ; virtual void MacResume( bool convertClipboard ) ; virtual void MacConvertPrivateToPublicScrap() ; virtual void MacConvertPublicToPrivateScrap() ; // event main methods void MacDoOneEvent() ; void MacHandleOneEvent( EventRecord *ev ) ; EventRecord* MacGetCurrentEvent() { return m_macCurrentEvent ; } // primary events virtual void MacHandleMouseDownEvent( EventRecord *ev ) ; virtual void MacHandleMouseUpEvent( EventRecord *ev ) ; virtual void MacHandleActivateEvent( EventRecord *ev ) ; virtual void MacHandleUpdateEvent( EventRecord *ev ) ; virtual void MacHandleKeyDownEvent( EventRecord *ev ) ; virtual void MacHandleKeyUpEvent( EventRecord *ev ) ; virtual void MacHandleDiskEvent( EventRecord *ev ) ; virtual void MacHandleOSEvent( EventRecord *ev ) ; virtual void MacHandleHighLevelEvent( EventRecord *ev ) ; virtual void MacHandleMenuSelect( int menuid , int menuitem ) ; virtual OSErr MacHandleAEODoc(AppleEvent *event , AppleEvent *reply) ; virtual OSErr MacHandleAEPDoc(AppleEvent *event , AppleEvent *reply) ; virtual OSErr MacHandleAEOApp(AppleEvent *event , AppleEvent *reply) ; virtual OSErr MacHandleAEQuit(AppleEvent *event , AppleEvent *reply) ; DECLARE_EVENT_TABLE() }; // TODO: add platform-specific arguments int WXDLLEXPORT wxEntry( int argc, char *argv[] ); void wxMacConvertFromPCForControls( char * p ) ; void wxMacConvertToPC( const char *from , char *to , int len ) ; void wxMacConvertFromPC( const char *from , char *to , int len ) ; void wxMacConvertToPC( const char *from , char *to , int len ) ; void wxMacConvertFromPC( char * p ) ; void wxMacConvertFromPC( unsigned char *p ) ; wxString wxMacMakeMacStringFromPC( const char * p ) ; void wxMacConvertToPC( char * p ) ; void wxMacConvertToPC( unsigned char *p ) ; wxString wxMacMakePCStringFromMac( const char * p ) ; #endif // _WX_APP_H_