include/wx/mac/private.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        private.h
   3 // Purpose:     Private declarations: as this header is only included by
   4 //              wxWindows itself, it may contain identifiers which don't start
   5 //              with "wx".
   6 // Author:      Stefan Csomor
   7 // Modified by:
   8 // Created:     1998-01-01
   9 // RCS-ID:      $Id$
  10 // Copyright:   (c) Stefan Csomor
  11 // Licence:     wxWindows licence
  12 /////////////////////////////////////////////////////////////////////////////
  13
  14 #ifndef _WX_PRIVATE_H_
  15 #define _WX_PRIVATE_H_
  16
  17 #include "wx/defs.h"
  18 #include "wx/app.h"
  19
  20 #ifdef __DARWIN__
  21 #    include <Carbon/Carbon.h>
  22 #else
  23 #    include <Quickdraw.h>
  24 #    include <Appearance.h>
  25 #    include <Folders.h>
  26 #    include <Controls.h>
  27 #    include <ControlDefinitions.h>
  28 #    include <LowMem.h>
  29 #    include <Gestalt.h>
  30 #endif
  31
  32 #if UNIVERSAL_INTERFACES_VERSION < 0x0340
  33     #error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
  34 #endif
  35
  36 #if wxUSE_GUI
  37
  38 #include "wx/window.h"
  39
  40 class wxMacPortStateHelper
  41 {
  42     DECLARE_NO_COPY_CLASS(wxMacPortStateHelper)
  43
  44 public:
  45     wxMacPortStateHelper( GrafPtr newport) ;
  46     wxMacPortStateHelper() ;
  47     ~wxMacPortStateHelper() ;
  48
  49     void Setup( GrafPtr newport ) ;
  50     void Clear() ;
  51     bool IsCleared() { return m_clip == NULL ; }
  52     GrafPtr GetCurrentPort() { return m_currentPort ; }
  53
  54 private:
  55     GrafPtr          m_currentPort ;
  56     GrafPtr          m_oldPort ;
  57     RgnHandle          m_clip ;
  58     ThemeDrawingState m_drawingState ;
  59     short          m_textFont ;
  60     short          m_textSize ;
  61     short          m_textStyle ;
  62     short           m_textMode ;
  63 } ;
  64
  65 class WXDLLEXPORT wxMacPortSetter
  66 {
  67     DECLARE_NO_COPY_CLASS(wxMacPortSetter)
  68
  69 public:
  70     wxMacPortSetter( const wxDC* dc ) ;
  71     ~wxMacPortSetter() ;
  72 private:
  73     wxMacPortStateHelper m_ph ;
  74     const wxDC* m_dc ;
  75 } ;
  76
  77 class WXDLLEXPORT wxMacWindowClipper
  78 {
  79     DECLARE_NO_COPY_CLASS(wxMacWindowClipper)
  80
  81 public:
  82     wxMacWindowClipper( const wxWindow* win ) ;
  83     ~wxMacWindowClipper() ;
  84 private:
  85     RgnHandle m_formerClip ;
  86     RgnHandle m_newClip ;
  87 } ;
  88
  89 class wxMacDrawingHelper
  90 {
  91     DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
  92
  93 public:
  94     wxMacDrawingHelper( wxWindowMac * theWindow , bool clientArea = false ) ;
  95     ~wxMacDrawingHelper() ;
  96     bool Ok() { return m_ok ; }
  97     void LocalToWindow( Rect *rect) { OffsetRect( rect , m_origin.h , m_origin.v ) ; }
  98     void LocalToWindow( Point *pt ) { AddPt( m_origin , pt ) ; }
  99     void LocalToWindow( RgnHandle rgn ) { OffsetRgn( rgn , m_origin.h , m_origin.v ) ; }
 100     const Point& GetOrigin() { return m_origin ; }
 101 private:
 102     Point     m_origin ;
 103     GrafPtr   m_formerPort ;
 104     GrafPtr   m_currentPort ;
 105     PenState  m_savedPenState ;
 106     bool      m_ok ;
 107 } ;
 108
 109 // app.h
 110 bool wxMacConvertEventToRecord( EventRef event , EventRecord *rec) ;
 111
 112 #endif // wxUSE_GUI
 113
 114 // filefn.h
 115 WXDLLEXPORT wxString wxMacFSSpec2MacFilename( const FSSpec *spec ) ;
 116 WXDLLEXPORT void wxMacFilename2FSSpec( const char *path , FSSpec *spec ) ;
 117 WXDLLEXPORT void wxMacFilename2FSSpec( const wxChar *path , FSSpec *spec ) ;
 118 #  ifndef __DARWIN__
 119 // Mac file names are POSIX (Unix style) under Darwin, so these are not needed
 120 WXDLLEXPORT wxString wxMacFSSpec2UnixFilename( const FSSpec *spec ) ;
 121 WXDLLEXPORT void wxUnixFilename2FSSpec( const char *path , FSSpec *spec ) ;
 122 WXDLLEXPORT wxString wxMac2UnixFilename( const char *s) ;
 123 WXDLLEXPORT wxString wxUnix2MacFilename( const char *s);
 124 #  endif
 125
 126 // utils.h
 127 WXDLLEXPORT wxString wxMacFindFolder(short vRefNum,
 128                                      OSType folderType,
 129                                      Boolean createFolder);
 130
 131 #if wxUSE_GUI
 132
 133 GWorldPtr         wxMacCreateGWorld( int width , int height , int depth ) ;
 134 void                 wxMacDestroyGWorld( GWorldPtr gw ) ;
 135 PicHandle         wxMacCreatePict( GWorldPtr gw , GWorldPtr mask = NULL ) ;
 136 CIconHandle     wxMacCreateCIcon(GWorldPtr image , GWorldPtr mask , short dstDepth , short iconSize  ) ;
 137 void                 wxMacSetColorTableEntry( CTabHandle newColors , int index , int red , int green ,  int blue ) ;
 138 CTabHandle         wxMacCreateColorTable( int numColors ) ;
 139 void wxMacCreateBitmapButton( ControlButtonContentInfo*info , const wxBitmap& bitmap , int forceType = 0 ) ;
 140
 141 #define MAC_WXCOLORREF(a) (*((RGBColor*)&(a)))
 142 #define MAC_WXHBITMAP(a) (GWorldPtr(a))
 143 #define MAC_WXHMETAFILE(a) (PicHandle(a))
 144 #define MAC_WXHICON(a) (CIconHandle(a))
 145 #define MAC_WXHCURSOR(a) (CursHandle(a))
 146 #define MAC_WXHRGN(a) (RgnHandle(a))
 147 #define MAC_WXHWND(a) (WindowPtr(a))
 148 #define MAC_WXRECPTR(a) ((Rect*)a)
 149 #define MAC_WXPOINTPTR(a) ((Point*)a)
 150 #define MAC_WXHMENU(a) ((MenuHandle)a)
 151
 152 #endif // wxUSE_GUI
 153
 154 //---------------------------------------------------------------------------
 155 // wxMac string conversions
 156 //---------------------------------------------------------------------------
 157
 158 void wxMacSetupConverters() ;
 159 void wxMacCleanupConverters() ;
 160
 161 void wxMacStringToPascal( const wxString&from , StringPtr to ) ;
 162 wxString wxMacMakeStringFromPascal( ConstStringPtr from ) ;
 163
 164 wxCharBuffer wxMacStringToCString( const wxString &from ) ;
 165 wxWCharBuffer wxMacStringToWString( const wxString &from ) ;
 166 wxString wxMacMakeStringFromCString( const char * from , int len ) ;
 167 wxString wxMacMakeStringFromCString( const char * from ) ;
 168
 169 #if TARGET_CARBON
 170
 171 class wxMacCFStringHolder
 172 {
 173 public:
 174         wxMacCFStringHolder()
 175         {
 176         m_cfs = NULL ;
 177         m_release = false ;
 178         }
 179
 180     wxMacCFStringHolder(const wxString &str)
 181     {
 182         m_cfs = NULL ;
 183         m_release = false ;
 184         Assign( str ) ;
 185     }
 186
 187     wxMacCFStringHolder(CFStringRef ref , bool release = true )
 188     {
 189         m_cfs = ref ;
 190         m_release = release ;
 191     }
 192
 193     ~wxMacCFStringHolder()
 194     {
 195         Release() ;
 196     }
 197
 198     wxMacCFStringHolder& operator=(const wxString& str)
 199     {
 200         Release() ;
 201                 Assign( str ) ;
 202         return *this;
 203     }
 204
 205     CFStringRef Detach()
 206     {
 207         CFStringRef retval = m_cfs ;
 208         m_release = false ;
 209         m_cfs = NULL ;
 210         return retval ;
 211     }
 212
 213     void Release()
 214     {
 215         if ( m_release && m_cfs)
 216                 CFRelease( m_cfs ) ;
 217         m_cfs = NULL ;
 218     }
 219
 220     operator CFStringRef () { return m_cfs; }
 221     wxString AsString() ;
 222
 223 private:
 224         void Assign( const wxString &str ) ;
 225
 226     CFStringRef m_cfs;
 227     bool m_release ;
 228 } ;
 229
 230 //  CFStringRef wxMacStringToCFString( const wxString &str ) ;
 231 //  wxString wxMacMakeStringFromCFString( CFStringRef cf ) ;
 232 #endif
 233
 234 #if 0
 235
 236 void wxMacConvertToPC( const char *from , char *to , int len ) ;
 237 void wxMacConvertFromPC( const char *from , char *to , int len ) ;
 238 void wxMacConvertToPC( const char *from , char *to , int len ) ;
 239
 240 wxString wxMacMakeMacStringFromPC( const wxChar * p ) ;
 241
 242 wxString wxMacMakePCStringFromMac( const wxChar * p ) ;
 243
 244
 245 // converts this c string into a wxString with optional mac 2 pc encoding
 246 wxString wxMacMakeStringFromMacString( const wxChar* from , bool mac2pcEncoding ) ;
 247
 248 // converts this c string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 249 inline wxString wxMacMakeStringFromMacString( const wxChar* from  )
 250   { return wxMacMakeStringFromMacString( from , wxApp::s_macDefaultEncodingIsPC ) ; }
 251
 252 #if wxUSE_UNICODE
 253
 254 wxString wxMacMakeMacStringFromPC( const char * p ) ;
 255
 256 wxString wxMacMakePCStringFromMac( const char * p ) ;
 257
 258 // converts this c string into a wxString with optional mac 2 pc encoding
 259 wxString wxMacMakeStringFromMacString( const char* from , bool mac2pcEncoding ) ;
 260
 261 // converts this c string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 262 inline wxString wxMacMakeStringFromMacString( const char* from  )
 263   { return wxMacMakeStringFromMacString( from , wxApp::s_macDefaultEncodingIsPC ) ; }
 264
 265 #endif
 266
 267 // converts this c string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 268 inline wxString wxMacMakeStringFromMacString( const wxString& from  )
 269   { return wxApp::s_macDefaultEncodingIsPC ?
 270       wxMacMakeStringFromMacString( from.c_str() , true ) : from ; }
 271
 272 //
 273 // Pascal Strings
 274 //
 275
 276 // converts this string into a pascal with optional pc 2 mac encoding
 277 void wxMacStringToPascal( const wxChar * from , StringPtr to , bool pc2macEncoding ) ;
 278
 279 // converts this string into a pascal with pc 2 mac encoding if s_macDefaultEncodingIsPC
 280 inline void wxMacStringToPascal( const wxChar * from , StringPtr to )
 281   { wxMacStringToPascal( from , to , wxApp::s_macDefaultEncodingIsPC ) ; }
 282
 283 // converts this string into a pascal with optional mac 2 pc encoding
 284 wxString wxMacMakeStringFromPascal( ConstStringPtr from , bool mac2pcEncoding ) ;
 285
 286 // converts this pascal string into a wxString with pc 2 mac encoding if s_macDefaultEncodingIsPC
 287 inline wxString wxMacMakeStringFromPascal( ConstStringPtr from  )
 288   { return wxMacMakeStringFromPascal( from , wxApp::s_macDefaultEncodingIsPC ) ; }
 289
 290 //
 291 // CFStringRefs (Carbon only)
 292 //
 293
 294 #if TARGET_CARBON
 295 // converts this string into a carbon foundation string with optional pc 2 mac encoding
 296 CFStringRef wxMacStringToCFString( const wxString &str , bool pc2macEncoding ) ;
 297
 298 // converts this string into a carbon foundation string with optional pc 2 mac encoding
 299 inline CFStringRef wxMacStringToCFString( const wxString &str )
 300   { return wxMacStringToCFString( str , wxApp::s_macDefaultEncodingIsPC ) ; }
 301
 302 #endif //TARGET_CARBON
 303
 304 #endif // 0
 305
 306 #endif
 307     // _WX_PRIVATE_H_