include/wx/mac/app.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        app.h
   3 // Purpose:     wxApp class
   4 // Author:      Stefan Csomor
   5 // Modified by:
   6 // Created:     1998-01-01
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Stefan Csomor
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_APP_H_
  13 #define _WX_APP_H_
  14
  15 #if defined(__GNUG__) && !defined(__APPLE__)
  16 #pragma interface "app.h"
  17 #endif
  18
  19 #include "wx/defs.h"
  20 #include "wx/object.h"
  21 #include "wx/gdicmn.h"
  22 #include "wx/event.h"
  23
  24 class WXDLLEXPORT wxFrame;
  25 class WXDLLEXPORT wxWindowMac;
  26 class WXDLLEXPORT wxApp ;
  27 class WXDLLEXPORT wxKeyEvent;
  28 class WXDLLEXPORT wxLog;
  29
  30 #define wxPRINT_WINDOWS         1
  31 #define wxPRINT_POSTSCRIPT      2
  32
  33 WXDLLEXPORT_DATA(extern wxApp*) wxTheApp;
  34
  35 // Force an exit from main loop
  36 void WXDLLEXPORT wxExit();
  37
  38 // Yield to other apps/messages
  39 bool WXDLLEXPORT wxYield();
  40
  41 // Represents the application. Derive OnInit and declare
  42 // a new App object to start application
  43 class WXDLLEXPORT wxApp: public wxAppBase
  44 {
  45     DECLARE_DYNAMIC_CLASS(wxApp)
  46
  47     wxApp();
  48     virtual ~wxApp() {}
  49
  50     virtual int MainLoop();
  51     virtual void ExitMainLoop();
  52     virtual bool Initialized();
  53     virtual bool Pending() ;
  54     virtual void Dispatch() ;
  55
  56     virtual void Exit();
  57
  58     virtual bool Yield(bool onlyIfNeeded = FALSE);
  59     virtual bool ProcessIdle();
  60     virtual void WakeUpIdle();
  61
  62     virtual void SetPrintMode(int mode) { m_printMode = mode; }
  63     virtual int GetPrintMode() const { return m_printMode; }
  64
  65 #if wxUSE_GUI
  66     // setting up all MacOS Specific Event-Handlers etc
  67     virtual bool OnInitGui();
  68 #endif // wxUSE_GUI
  69     // implementation only
  70     void OnIdle(wxIdleEvent& event);
  71     void OnEndSession(wxCloseEvent& event);
  72     void OnQueryEndSession(wxCloseEvent& event);
  73
  74     // Send idle event to all top-level windows.
  75     // Returns TRUE if more idle time is requested.
  76     bool SendIdleEvents();
  77
  78     // Send idle event to window and all subwindows
  79     // Returns TRUE if more idle time is requested.
  80     bool SendIdleEvents(wxWindowMac* win);
  81
  82     // Windows only, but for compatibility...
  83     inline void SetAuto3D(bool flag) { m_auto3D = flag; }
  84     inline bool GetAuto3D() const { return m_auto3D; }
  85
  86 protected:
  87     bool                  m_showOnInit;
  88     int                   m_printMode; // wxPRINT_WINDOWS, wxPRINT_POSTSCRIPT
  89     bool                  m_auto3D ;   // Always use 3D controls, except
  90                                        // where overriden
  91 public:
  92
  93     // Implementation
  94     static bool Initialize();
  95     static void CleanUp();
  96
  97     void DeletePendingObjects();
  98     bool IsExiting() { return !m_keepGoing ; }
  99 #if TARGET_CARBON
 100     WXEVENTHANDLERREF    MacGetEventHandler() { return m_macEventHandler ; }
 101     WXEVENTHANDLERREF    MacGetCurrentEventHandlerCallRef() { return m_macCurrentEventHandlerCallRef ; }
 102 #endif
 103
 104 public:
 105     static long           sm_lastMessageTime;
 106     static wxWindow*      s_captureWindow ;
 107     static int            s_lastMouseDown ; // 0 = none , 1 = left , 2 = right
 108     static WXHRGN         s_macCursorRgn ;
 109     static long           s_lastModifiers ;
 110
 111     int                   m_nCmdShow;
 112
 113 private:
 114     bool                  m_keepGoing ;
 115
 116     // mac specifics
 117 #if TARGET_CARBON
 118     WXEVENTHANDLERREF      m_macEventHandler ;
 119     WXEVENTHANDLERCALLREF      m_macCurrentEventHandlerCallRef ;
 120 #endif
 121     WXEVENTREF            m_macCurrentEvent ;
 122
 123 public:
 124     static bool           s_macDefaultEncodingIsPC ;
 125     static bool           s_macSupportPCMenuShortcuts ;
 126     static long           s_macAboutMenuItemId ;
 127     static long           s_macPreferencesMenuItemId ;
 128     static long           s_macExitMenuItemId ;
 129     static wxString       s_macHelpMenuTitleName ;
 130
 131     static bool           s_macHasAppearance ;
 132     static long           s_macAppearanceVersion ;
 133     static bool           s_macHasNavigation ;
 134     static bool           s_macNavigationVersion ;
 135     static bool           s_macHasWindowManager ;
 136     static long           s_macWindowManagerVersion ;
 137     static bool           s_macHasMenuManager ;
 138     static long           s_macMenuManagerVersion ;
 139     static bool           s_macHasDialogManager ;
 140     static long           s_macDialogManagerVersion ;
 141
 142     WXHRGN                m_macCursorRgn ;
 143     WXHRGN                m_macSleepRgn ;
 144     WXHRGN                m_macHelpRgn ;
 145
 146     virtual void          MacSuspend( bool convertClipboard ) ;
 147     virtual void          MacResume( bool convertClipboard ) ;
 148     virtual void          MacConvertPrivateToPublicScrap() ;
 149     virtual void          MacConvertPublicToPrivateScrap() ;
 150
 151     void                  MacDoOneEvent() ;
 152     WXEVENTREF            MacGetCurrentEvent() { return m_macCurrentEvent ; }
 153     void                  MacHandleOneEvent( WXEVENTREF ev ) ;
 154 #if !TARGET_CARBON
 155     virtual void          MacHandleMenuSelect( int menuid , int menuitem ) ;
 156     virtual void          MacHandleMouseUpEvent( WXEVENTREF ev ) ;
 157     virtual void          MacHandleOSEvent( WXEVENTREF ev ) ;
 158     virtual void          MacHandleDiskEvent( WXEVENTREF ev ) ;
 159     virtual void          MacHandleActivateEvent( WXEVENTREF ev ) ;
 160     virtual void          MacHandleUpdateEvent( WXEVENTREF ev ) ;
 161     virtual void          MacHandleMouseDownEvent( WXEVENTREF ev ) ;
 162
 163     void                  MacHandleModifierEvents( WXEVENTREF ev ) ;
 164
 165     virtual void          MacHandleKeyDownEvent( WXEVENTREF ev ) ;
 166     virtual void          MacHandleKeyUpEvent( WXEVENTREF ev ) ;
 167     virtual void          MacHandleHighLevelEvent( WXEVENTREF ev ) ;
 168
 169 #endif
 170
 171     void                  MacHandleMenuCommand( wxUint32 command ) ;
 172     bool                    MacSendKeyDownEvent( wxWindow* focus , long keyval , long modifiers , long when , short wherex , short wherey ) ;
 173     bool                    MacSendKeyUpEvent( wxWindow* focus , long keyval , long modifiers , long when , short wherex , short wherey ) ;
 174
 175     virtual short         MacHandleAEODoc(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 176     virtual short         MacHandleAEPDoc(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 177     virtual short         MacHandleAEOApp(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 178     virtual short         MacHandleAEQuit(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 179
 180     // in response of an open-document apple event
 181     virtual void         MacOpenFile(const wxString &fileName) ;
 182     // in response of a print-document apple event
 183     virtual void         MacPrintFile(const wxString &fileName) ;
 184     // in response of a open-application apple event
 185     virtual void         MacNewFile() ;
 186
 187     DECLARE_EVENT_TABLE()
 188 };
 189
 190 class WXDLLEXPORT wxStAppResource
 191 {
 192 public:
 193     wxStAppResource() ;
 194     ~wxStAppResource() ;
 195
 196     // opaque pointer for CFragInitBlock
 197     static void OpenSharedLibraryResource(const void *) ;
 198     static void CloseSharedLibraryResource() ;
 199
 200 private:
 201     short       m_currentRefNum ;
 202 } ;
 203
 204 #endif
 205     // _WX_APP_H_
 206