include/wx/mac/app.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        app.h
   3 // Purpose:     wxApp class
   4 // Author:      AUTHOR
   5 // Modified by:
   6 // Created:     ??/??/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) AUTHOR
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_APP_H_
  13 #define _WX_APP_H_
  14
  15 #ifdef __GNUG__
  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   wxApp();
  47   virtual ~wxApp() {}
  48
  49   virtual int MainLoop();
  50   virtual void ExitMainLoop();
  51   virtual bool Initialized();
  52   virtual bool Pending() ;
  53   virtual void Dispatch() ;
  54   virtual bool Yield(bool onlyIfNeeded = FALSE);
  55
  56   virtual void SetPrintMode(int mode) { m_printMode = mode; }
  57   virtual int GetPrintMode() const { return m_printMode; }
  58
  59   // implementation only
  60   void OnIdle(wxIdleEvent& event);
  61   void OnEndSession(wxCloseEvent& event);
  62   void OnQueryEndSession(wxCloseEvent& event);
  63
  64   // Send idle event to all top-level windows.
  65   // Returns TRUE if more idle time is requested.
  66   bool SendIdleEvents();
  67
  68   // Send idle event to window and all subwindows
  69   // Returns TRUE if more idle time is requested.
  70   bool SendIdleEvents(wxWindowMac* win);
  71
  72   // Windows only, but for compatibility...
  73   inline void SetAuto3D(bool flag) { m_auto3D = flag; }
  74   inline bool GetAuto3D() const { return m_auto3D; }
  75
  76 protected:
  77   bool                  m_showOnInit;
  78   int                   m_printMode; // wxPRINT_WINDOWS, wxPRINT_POSTSCRIPT
  79   bool                  m_auto3D ;   // Always use 3D controls, except
  80                                  // where overriden
  81 public:
  82
  83   // Implementation
  84   static bool Initialize();
  85   static void CleanUp();
  86
  87   void DeletePendingObjects();
  88   bool ProcessIdle();
  89   bool IsExiting() { return !m_keepGoing ; }
  90
  91 public:
  92   static long           sm_lastMessageTime;
  93   static wxWindow*                      s_captureWindow ;
  94   static int                                            s_lastMouseDown ; // 0 = none , 1 = left , 2 = right
  95   static WXHRGN                 s_macCursorRgn ;
  96   WXEVENTREF                                    m_macCurrentEvent ;
  97
  98   int                   m_nCmdShow;
  99
 100 protected:
 101   bool                  m_keepGoing ;
 102
 103 // mac specifics
 104
 105 public :
 106         static bool                                             s_macDefaultEncodingIsPC ;
 107         static bool                                             s_macSupportPCMenuShortcuts ;
 108         static long                                             s_macAboutMenuItemId ;
 109         static wxString                         s_macHelpMenuTitleName ;
 110
 111   static bool                                           s_macHasAppearance ;
 112   static long                                           s_macAppearanceVersion ;
 113   static bool                                           s_macHasNavigation ;
 114   static bool                                           s_macNavigationVersion ;
 115   static bool                                           s_macHasWindowManager ;
 116   static long                                           s_macWindowManagerVersion ;
 117   static bool                                           s_macHasMenuManager ;
 118   static long                                           s_macMenuManagerVersion ;
 119   static bool                                           s_macHasDialogManager ;
 120   static long                                           s_macDialogManagerVersion ;
 121
 122         WXHRGN                                                  m_macCursorRgn ;
 123         WXHRGN                                                  m_macSleepRgn ;
 124         WXHRGN                                                  m_macHelpRgn ;
 125
 126   virtual void          MacSuspend( bool convertClipboard ) ;
 127   virtual void          MacResume( bool convertClipboard ) ;
 128
 129         virtual void                                    MacConvertPrivateToPublicScrap() ;
 130         virtual void                                    MacConvertPublicToPrivateScrap() ;
 131
 132         // event main methods
 133
 134         void                                                                    MacDoOneEvent() ;
 135         void                                                                    MacHandleOneEvent( WXEVENTREF ev ) ;
 136         WXEVENTREF                                      MacGetCurrentEvent() { return m_macCurrentEvent ; }
 137         // primary events
 138
 139   virtual void          MacHandleMouseDownEvent( WXEVENTREF ev ) ;
 140   virtual void          MacHandleMouseUpEvent( WXEVENTREF ev ) ;
 141         virtual void          MacHandleActivateEvent( WXEVENTREF ev ) ;
 142   virtual void          MacHandleUpdateEvent( WXEVENTREF ev ) ;
 143   virtual void          MacHandleKeyDownEvent( WXEVENTREF ev ) ;
 144   virtual void          MacHandleKeyUpEvent( WXEVENTREF ev ) ;
 145   virtual void          MacHandleDiskEvent( WXEVENTREF ev ) ;
 146   virtual void          MacHandleOSEvent( WXEVENTREF ev ) ;
 147   virtual void                                  MacHandleHighLevelEvent( WXEVENTREF ev ) ;
 148         virtual void                                    MacHandleMenuSelect( int menuid , int menuitem ) ;
 149
 150         virtual short                                   MacHandleAEODoc(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 151         virtual short                                   MacHandleAEPDoc(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 152         virtual short                                   MacHandleAEOApp(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 153         virtual short                                   MacHandleAEQuit(const WXAPPLEEVENTREF event , WXAPPLEEVENTREF reply) ;
 154
 155 DECLARE_EVENT_TABLE()
 156 };
 157
 158 class WXDLLEXPORT wxStAppResource
 159 {
 160 public :
 161     wxStAppResource() ;
 162     ~wxStAppResource() ;
 163 private :
 164     short m_currentRefNum ;
 165 } ;
 166
 167 // TODO: add platform-specific arguments
 168 int WXDLLEXPORT wxEntry( int argc, char *argv[] , bool enterLoop = TRUE);
 169
 170 void wxMacConvertFromPCForControls( char * p ) ;
 171
 172 void wxMacConvertToPC( const char *from , char *to , int len ) ;
 173 void wxMacConvertFromPC( const char *from , char *to , int len ) ;
 174 void wxMacConvertToPC( const char *from , char *to , int len ) ;
 175 void wxMacConvertFromPC( char * p ) ;
 176 void wxMacConvertFromPC( unsigned char *p ) ;
 177 wxString wxMacMakeMacStringFromPC( const char * p ) ;
 178 void wxMacConvertToPC( char * p ) ;
 179 void wxMacConvertToPC( unsigned char *p ) ;
 180 wxString wxMacMakePCStringFromMac( const char * p ) ;
 181
 182 // converts this string into a pascal with optional pc 2 mac encoding
 183 void wxMacStringToPascal( const char * from , unsigned char* to , bool pc2macEncoding ) ;
 184
 185 // converts this string into a pascal with pc 2 mac encoding if s_macDefaultEncodingIsPC
 186 inline void wxMacStringToPascal( const char * from , unsigned char*  to )
 187   { wxMacStringToPascal( from , to , wxApp::s_macDefaultEncodingIsPC ) ; }
 188
 189 // converts this string into a pascal with optional mac 2 pc encoding
 190 wxString wxMacMakeStringFromPascal( unsigned char*  from , bool mac2pcEncoding ) ;
 191
 192 // converts this pascal string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 193 inline wxString wxMacMakeStringFromPascal( unsigned char*  from  )
 194   { return wxMacMakeStringFromPascal( from , wxApp::s_macDefaultEncodingIsPC ) ; }
 195
 196 // converts this c string into a wxString with optional mac 2 pc encoding
 197 wxString wxMacMakeStringFromMacString( const char* from , bool mac2pcEncoding ) ;
 198
 199 // converts this c string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 200 inline wxString wxMacMakeStringFromMacString( const char* from  )
 201   { return wxMacMakeStringFromMacString( from , wxApp::s_macDefaultEncodingIsPC ) ; }
 202
 203 #endif
 204     // _WX_APP_H_
 205