]> git.saurik.com Git - wxWidgets.git/blame - include/wx/mac/carbon/private.h
wxParseWildcard added instead of methods hidden under wxUSE_FILEDLG and wxUSE_DIRDLG.
[wxWidgets.git] / include / wx / mac / carbon / private.h
CommitLineData
8cf73271
SC
1/////////////////////////////////////////////////////////////////////////////
2// Name: private.h
3// Purpose: Private declarations: as this header is only included by
77ffb593 4// wxWidgets itself, it may contain identifiers which don't start
8cf73271
SC
5// with "wx".
6// Author: Stefan Csomor
7// Modified by:
8// Created: 1998-01-01
9// RCS-ID: $Id$
10// Copyright: (c) Stefan Csomor
65571936 11// Licence: wxWindows licence
8cf73271
SC
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
4f305456 23# include <Debugging.h>
8cf73271
SC
24# include <Quickdraw.h>
25# include <Appearance.h>
26# include <Folders.h>
27# include <Controls.h>
28# include <ControlDefinitions.h>
29# include <LowMem.h>
30# include <Gestalt.h>
31#endif
32
33#if UNIVERSAL_INTERFACES_VERSION < 0x0340
34 #error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
35#endif
36
c3a404b0
SC
37#ifndef MAC_OS_X_VERSION_10_3
38 #define MAC_OS_X_VERSION_10_3 1030
39#endif
40
8cf73271
SC
41#if wxUSE_GUI
42
43#include "wx/window.h"
44
45class wxMacPortStateHelper
46{
47 DECLARE_NO_COPY_CLASS(wxMacPortStateHelper)
48
49public:
50 wxMacPortStateHelper( GrafPtr newport) ;
51 wxMacPortStateHelper() ;
52 ~wxMacPortStateHelper() ;
53
54 void Setup( GrafPtr newport ) ;
55 void Clear() ;
56 bool IsCleared() { return m_clip == NULL ; }
57 GrafPtr GetCurrentPort() { return m_currentPort ; }
58
59private:
60 GrafPtr m_currentPort ;
61 GrafPtr m_oldPort ;
62 RgnHandle m_clip ;
63 ThemeDrawingState m_drawingState ;
64 short m_textFont ;
65 short m_textSize ;
66 short m_textStyle ;
67 short m_textMode ;
68} ;
69
4f305456
SC
70class WXDLLEXPORT wxMacPortSaver
71{
72 DECLARE_NO_COPY_CLASS(wxMacPortSaver)
73
74public:
75 wxMacPortSaver( GrafPtr port )
76 {
77 ::GetPort( &m_port ) ;
78 ::SetPort( port ) ;
79 }
80 ~wxMacPortSaver()
81 {
82 ::SetPort( m_port ) ;
83 }
84private :
85 GrafPtr m_port ;
86} ;
87
8cf73271
SC
88class WXDLLEXPORT wxMacPortSetter
89{
90 DECLARE_NO_COPY_CLASS(wxMacPortSetter)
91
92public:
93 wxMacPortSetter( const wxDC* dc ) ;
94 ~wxMacPortSetter() ;
95private:
96 wxMacPortStateHelper m_ph ;
97 const wxDC* m_dc ;
98} ;
99
4f305456
SC
100/*
101 Clips to the visible region of a control within the current port
102 */
103
104class WXDLLEXPORT wxMacWindowClipper : public wxMacPortSaver
8cf73271
SC
105{
106 DECLARE_NO_COPY_CLASS(wxMacWindowClipper)
107
108public:
109 wxMacWindowClipper( const wxWindow* win ) ;
110 ~wxMacWindowClipper() ;
111private:
01299d56 112 GrafPtr m_newPort ;
8cf73271
SC
113 RgnHandle m_formerClip ;
114 RgnHandle m_newClip ;
115} ;
116
01299d56
SC
117class WXDLLEXPORT wxMacWindowStateSaver : public wxMacWindowClipper
118{
119 DECLARE_NO_COPY_CLASS(wxMacWindowStateSaver)
120
121public:
122 wxMacWindowStateSaver( const wxWindow* win ) ;
123 ~wxMacWindowStateSaver() ;
124private:
125 GrafPtr m_newPort ;
126 ThemeDrawingState m_themeDrawingState ;
127} ;
128
4f305456 129/*
8cf73271
SC
130class wxMacDrawingHelper
131{
132 DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
133
134public:
135 wxMacDrawingHelper( wxWindowMac * theWindow , bool clientArea = false ) ;
136 ~wxMacDrawingHelper() ;
137 bool Ok() { return m_ok ; }
138 void LocalToWindow( Rect *rect) { OffsetRect( rect , m_origin.h , m_origin.v ) ; }
139 void LocalToWindow( Point *pt ) { AddPt( m_origin , pt ) ; }
140 void LocalToWindow( RgnHandle rgn ) { OffsetRgn( rgn , m_origin.h , m_origin.v ) ; }
141 const Point& GetOrigin() { return m_origin ; }
142private:
143 Point m_origin ;
144 GrafPtr m_formerPort ;
145 GrafPtr m_currentPort ;
146 PenState m_savedPenState ;
147 bool m_ok ;
148} ;
4f305456 149*/
8cf73271
SC
150
151// app.h
152bool wxMacConvertEventToRecord( EventRef event , EventRecord *rec) ;
153
154#endif // wxUSE_GUI
155
156// filefn.h
157WXDLLEXPORT wxString wxMacFSSpec2MacFilename( const FSSpec *spec ) ;
158WXDLLEXPORT void wxMacFilename2FSSpec( const char *path , FSSpec *spec ) ;
159WXDLLEXPORT void wxMacFilename2FSSpec( const wxChar *path , FSSpec *spec ) ;
160# ifndef __DARWIN__
161// Mac file names are POSIX (Unix style) under Darwin, so these are not needed
162WXDLLEXPORT wxString wxMacFSSpec2UnixFilename( const FSSpec *spec ) ;
4f305456
SC
163WXDLLEXPORT void wxUnixFilename2FSSpec( const char *path , FSSpec *spec ) ;
164WXDLLEXPORT wxString wxMac2UnixFilename( const char *s) ;
165WXDLLEXPORT wxString wxUnix2MacFilename( const char *s);
8cf73271
SC
166# endif
167
168// utils.h
169WXDLLEXPORT wxString wxMacFindFolder(short vRefNum,
170 OSType folderType,
171 Boolean createFolder);
172
173#if wxUSE_GUI
174
175GWorldPtr wxMacCreateGWorld( int width , int height , int depth ) ;
176void wxMacDestroyGWorld( GWorldPtr gw ) ;
177PicHandle wxMacCreatePict( GWorldPtr gw , GWorldPtr mask = NULL ) ;
178CIconHandle wxMacCreateCIcon(GWorldPtr image , GWorldPtr mask , short dstDepth , short iconSize ) ;
179void wxMacSetColorTableEntry( CTabHandle newColors , int index , int red , int green , int blue ) ;
180CTabHandle wxMacCreateColorTable( int numColors ) ;
181void wxMacCreateBitmapButton( ControlButtonContentInfo*info , const wxBitmap& bitmap , int forceType = 0 ) ;
182
183#define MAC_WXCOLORREF(a) (*((RGBColor*)&(a)))
184#define MAC_WXHBITMAP(a) (GWorldPtr(a))
185#define MAC_WXHMETAFILE(a) (PicHandle(a))
186#define MAC_WXHICON(a) (CIconHandle(a))
187#define MAC_WXHCURSOR(a) (CursHandle(a))
188#define MAC_WXHRGN(a) (RgnHandle(a))
189#define MAC_WXHWND(a) (WindowPtr(a))
190#define MAC_WXRECPTR(a) ((Rect*)a)
191#define MAC_WXPOINTPTR(a) ((Point*)a)
192#define MAC_WXHMENU(a) ((MenuHandle)a)
193
4f305456
SC
194struct wxOpaqueWindowRef
195{
196 wxOpaqueWindowRef( WindowRef ref ) { m_data = ref ; }
197 operator WindowRef() { return m_data ; }
198private :
199 WindowRef m_data ;
200} ;
201
41b53169
SC
202wxWindow * wxFindControlFromMacControl(ControlRef inControl ) ;
203wxTopLevelWindowMac* wxFindWinFromMacWindow( WindowRef inWindow ) ;
204wxMenu* wxFindMenuFromMacMenu(MenuRef inMenuRef) ;
205
4f305456
SC
206extern wxWindow* g_MacLastWindow ;
207pascal OSStatus wxMacTopLevelMouseEventHandler( EventHandlerCallRef handler , EventRef event , void *data ) ;
271cad4c 208Rect wxMacGetBoundsForControl( wxWindow* window , const wxPoint& pos , const wxSize &size , bool adjustForOrigin = true ) ;
4f305456
SC
209
210template<typename T> EventParamType wxMacGetEventParamType() { wxFAIL_MSG( wxT("Unknown Param Type") ) ; return 0 ; }
211template<> inline EventParamType wxMacGetEventParamType<RgnHandle>() { return typeQDRgnHandle ; }
212template<> inline EventParamType wxMacGetEventParamType<ControlRef>() { return typeControlRef ; }
213template<> inline EventParamType wxMacGetEventParamType<WindowRef>() { return typeWindowRef ; }
214template<> inline EventParamType wxMacGetEventParamType<MenuRef>() { return typeMenuRef ; }
215template<> inline EventParamType wxMacGetEventParamType<EventRef>() { return typeEventRef ; }
216template<> inline EventParamType wxMacGetEventParamType<Point>() { return typeQDPoint ; }
217template<> inline EventParamType wxMacGetEventParamType<Rect>() { return typeQDRectangle ; }
218template<> inline EventParamType wxMacGetEventParamType<Boolean>() { return typeBoolean ; }
219#if TARGET_API_MAC_OSX
6d4c54a7 220template<> inline EventParamType wxMacGetEventParamType<HICommand>() { return typeHICommand ; }
4f305456
SC
221template<> inline EventParamType wxMacGetEventParamType<HIPoint>() { return typeHIPoint ; }
222template<> inline EventParamType wxMacGetEventParamType<HISize>() { return typeHISize ; }
223template<> inline EventParamType wxMacGetEventParamType<HIRect>() { return typeHIRect ; }
224template<> inline EventParamType wxMacGetEventParamType<void*>() { return typeVoidPtr ; }
225#endif
226template<> inline EventParamType wxMacGetEventParamType<Collection>() { return typeCollection ; }
227template<> inline EventParamType wxMacGetEventParamType<CGContextRef>() { return typeCGContextRef ; }
228/*
229These are ambiguous
230template<> EventParamType wxMacGetEventParamType<GrafPtr>() { return typeGrafPtr ; }
231template<> EventParamType wxMacGetEventParamType<OSStatus>() { return typeOSStatus ; }
232template<> EventParamType wxMacGetEventParamType<CFIndex>() { return typeCFIndex ; }
233template<> EventParamType wxMacGetEventParamType<GWorldPtr>() { return typeGWorldPtr ; }
234*/
235
236class wxMacCarbonEvent
237{
238
239public :
6d4c54a7 240 wxMacCarbonEvent( EventRef event , bool release = false )
4f305456
SC
241 {
242 m_eventRef = event ;
6d4c54a7
SC
243 m_release = release ;
244 }
245 wxMacCarbonEvent(UInt32 inClassID,UInt32 inKind,EventTime inWhen = 0 /*now*/,EventAttributes inAttributes=kEventAttributeNone)
246 {
247 m_eventRef = NULL ;
248 verify_noerr( MacCreateEvent( NULL , inClassID, inKind,inWhen,inAttributes,&m_eventRef) ) ;
249 m_release = true ;
250 }
251 ~wxMacCarbonEvent()
252 {
253 if ( m_release )
254 ReleaseEvent( m_eventRef ) ;
4f305456
SC
255 }
256
257 OSStatus GetParameter( EventParamName inName, EventParamType inDesiredType, UInt32 inBufferSize, void * outData) ;
258
259 template <typename T> OSStatus GetParameter( EventParamName inName, EventParamType type , T *data )
260 {
261 return GetParameter( inName, type , sizeof( T ) , data ) ;
262 }
263 template <typename T> OSStatus GetParameter( EventParamName inName, T *data )
264 {
265 return GetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
266 }
267
268 template <typename T> T GetParameter( EventParamName inName )
269 {
270 T value ;
271 verify_noerr( GetParameter<T>( inName, &value ) ) ;
272 return value ;
273 }
274 template <typename T> T GetParameter( EventParamName inName, EventParamType inDesiredType )
275 {
276 T value ;
277 verify_noerr( GetParameter<T>( inName, inDesiredType , &value ) ) ;
278 return value ;
279 }
280
6d4c54a7
SC
281 OSStatus SetParameter( EventParamName inName, EventParamType inType, UInt32 inSize, const void * inData) ;
282 template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T *data )
4f305456 283 {
2aefa0ef
SC
284 return SetParameter( inName, inDesiredType , sizeof( T ) , data ) ;
285 }
6d4c54a7 286 template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T& data )
2aefa0ef
SC
287 {
288 return SetParameter<T>( inName, inDesiredType , &data ) ;
4f305456 289 }
6d4c54a7 290 template <typename T> OSStatus SetParameter( EventParamName inName, const T *data )
4f305456
SC
291 {
292 return SetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
293 }
6d4c54a7 294 template <typename T> OSStatus SetParameter( EventParamName inName, const T& data )
2aefa0ef
SC
295 {
296 return SetParameter<T>( inName, wxMacGetEventParamType<T>() , &data ) ;
297 }
86d8b744
SC
298 UInt32 GetClass()
299 {
300 return ::GetEventClass( m_eventRef ) ;
301 }
41b53169 302 UInt32 GetKind()
4f305456
SC
303 {
304 return ::GetEventKind( m_eventRef ) ;
305 }
306 EventTime GetTime()
307 {
308 return ::GetEventTime( m_eventRef ) ;
309 }
310 UInt32 GetTicks()
311 {
312 return EventTimeToTicks( GetTime() ) ;
313 }
6d4c54a7 314 operator EventRef () { return m_eventRef; }
4f305456
SC
315protected :
316 EventRef m_eventRef ;
6d4c54a7 317 bool m_release ;
4f305456
SC
318} ;
319
86d8b744
SC
320class wxMacControl
321{
322public :
6d4c54a7
SC
323 wxMacControl()
324 {
325 m_controlRef = NULL ;
326 }
327
86d8b744
SC
328 wxMacControl( ControlRef control )
329 {
330 m_controlRef = control ;
331 }
332 wxMacControl( WXWidget control )
333 {
334 m_controlRef = (ControlRef) control ;
335 }
336
6d4c54a7
SC
337 bool Ok() const { return m_controlRef != NULL ; }
338
86d8b744
SC
339 OSStatus SetData( ControlPartCode inPartCode , ResType inTag , Size inSize , const void * inData ) ;
340 OSStatus GetData( ControlPartCode inPartCode , ResType inTag , Size inBufferSize , void * inOutBuffer , Size * outActualSize ) ;
341 OSStatus GetDataSize( ControlPartCode inPartCode , ResType inTag , Size * outActualSize ) ;
342 Size GetDataSize( ControlPartCode inPartCode , ResType inTag )
343 {
344 Size sz ;
345 verify_noerr( GetDataSize( inPartCode , inTag , &sz ) ) ;
346 return sz ;
347 }
6d4c54a7 348 template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T *data )
86d8b744
SC
349 {
350 return SetData( inPartCode , inTag , sizeof( T ) , data ) ;
351 }
6d4c54a7 352 template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T& data )
86d8b744
SC
353 {
354 return SetData( inPartCode , inTag , sizeof( T ) , &data ) ;
355 }
356 template <typename T> OSStatus GetData( ControlPartCode inPartCode , ResType inTag , T *data )
357 {
358 Size dummy ;
359 return GetData( inPartCode , inTag , sizeof( T ) , data , &dummy ) ;
360 }
361 template <typename T> T GetData( ControlPartCode inPartCode , ResType inTag )
362 {
363 T value ;
364 verify_noerr( GetData<T>( inPartCode , inTag , &value ) ) ;
365 return value ;
366 }
6d4c54a7
SC
367
368 OSStatus SendEvent( EventRef ref , OptionBits inOptions = 0 ) ;
369 OSStatus SendHICommand( HICommand &command , OptionBits inOptions = 0 ) ;
370 OSStatus SendHICommand( UInt32 commandID , OptionBits inOptions = 0 ) ;
371
372 // Flash the control for the specified amount of time
373 void Flash( ControlPartCode part , UInt32 ticks = 8 ) ;
374
375 SInt32 GetValue() { return ::GetControl32BitValue( m_controlRef ) ; }
376 SInt32 GetMaximum() { return ::GetControl32BitMaximum( m_controlRef ) ; }
377 SInt32 GetMinimum() { return ::GetControl32BitMinimum( m_controlRef ) ; }
378
379 void SetValue( SInt32 v ) { ::SetControl32BitValue( m_controlRef , v ) ; }
380 void SetMinimum( SInt32 v ) { ::SetControl32BitMinimum( m_controlRef , v ) ; }
381 void SetMaximum( SInt32 v ) { ::SetControl32BitMaximum( m_controlRef , v ) ; }
382
383 void SetValueAndRange( SInt32 value , SInt32 minimum , SInt32 maximum )
384 {
385 ::SetControl32BitMinimum( m_controlRef , minimum ) ;
386 ::SetControl32BitMaximum( m_controlRef , maximum ) ;
387 ::SetControl32BitValue( m_controlRef , value ) ;
388 }
389
390 void SetRange( SInt32 minimum , SInt32 maximum )
391 {
392 ::SetControl32BitMinimum( m_controlRef , minimum ) ;
393 ::SetControl32BitMaximum( m_controlRef , maximum ) ;
394 }
395
396 void operator= (ControlRef c) { m_controlRef = c ; }
86d8b744
SC
397 operator ControlRef () { return m_controlRef; }
398 operator ControlRef * () { return &m_controlRef; }
399protected :
400 ControlRef m_controlRef ;
401} ;
402
8cf73271
SC
403#endif // wxUSE_GUI
404
405//---------------------------------------------------------------------------
406// wxMac string conversions
407//---------------------------------------------------------------------------
408
409void wxMacSetupConverters() ;
410void wxMacCleanupConverters() ;
411
412void wxMacStringToPascal( const wxString&from , StringPtr to ) ;
413wxString wxMacMakeStringFromPascal( ConstStringPtr from ) ;
414
415void wxMacConvertNewlines13To10( char * data ) ;
416void wxMacConvertNewlines10To13( char * data ) ;
417void wxMacConvertNewlines13To10( wxString *data ) ;
418void wxMacConvertNewlines10To13( wxString *data ) ;
419
420#if wxUSE_UNICODE
421void wxMacConvertNewlines13To10( wxChar * data ) ;
422void wxMacConvertNewlines10To13( wxChar * data ) ;
423#endif
424
425#if TARGET_CARBON
426
427class wxMacCFStringHolder
428{
429public:
430 wxMacCFStringHolder()
431 {
432 m_cfs = NULL ;
433 m_release = false ;
434 }
435
436 wxMacCFStringHolder(const wxString &str , wxFontEncoding encoding )
437 {
438 m_cfs = NULL ;
439 m_release = false ;
440 Assign( str , encoding ) ;
441 }
442
443 wxMacCFStringHolder(CFStringRef ref , bool release = true )
444 {
445 m_cfs = ref ;
446 m_release = release ;
447 }
448
449 ~wxMacCFStringHolder()
450 {
451 Release() ;
452 }
453
454 CFStringRef Detach()
455 {
456 CFStringRef retval = m_cfs ;
457 m_release = false ;
458 m_cfs = NULL ;
459 return retval ;
460 }
461
462 void Release()
463 {
464 if ( m_release && m_cfs)
465 CFRelease( m_cfs ) ;
466 m_cfs = NULL ;
467 }
468
469 void Assign( const wxString &str , wxFontEncoding encoding ) ;
470
471 operator CFStringRef () { return m_cfs; }
472 wxString AsString( wxFontEncoding encoding = wxFONTENCODING_DEFAULT ) ;
473
474private:
475
476 CFStringRef m_cfs;
477 bool m_release ;
478} ;
479
480#endif
481
1a42f89c 482// utils.cpp
8cf73271
SC
483
484wxUint32 wxMacGetSystemEncFromFontEnc(wxFontEncoding encoding) ;
485wxFontEncoding wxMacGetFontEncFromSystemEnc(wxUint32 encoding) ;
6c85f776 486void wxMacWakeUp() ;
8cf73271 487
1a42f89c
SC
488// toplevel.cpp
489
490ControlRef wxMacFindControlUnderMouse( Point location , WindowRef window , ControlPartCode *outPart ) ;
8cf73271
SC
491
492#endif
493 // _WX_PRIVATE_H_