]> git.saurik.com Git - wxWidgets.git/blob - include/wx/mac/carbon/private.h
[ 1473731 ] 'wxColourBase and wxString <-> wxColour implementation'
[wxWidgets.git] / include / wx / mac / carbon / private.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/mac/carbon/private.h
3 // Purpose: Private declarations: as this header is only included by
4 // wxWidgets 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 <Debugging.h>
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 # include <FixMath.h>
32 # include <CoreServices.h>
33 #endif
34
35 #if UNIVERSAL_INTERFACES_VERSION < 0x0342
36 #error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
37 #endif
38
39 #ifndef MAC_OS_X_VERSION_10_3
40 #define MAC_OS_X_VERSION_10_3 1030
41 #endif
42
43 #ifndef MAC_OS_X_VERSION_10_4
44 #define MAC_OS_X_VERSION_10_4 1040
45 #endif
46
47 #ifdef __WXMAC_CARBON__
48 #include "wx/mac/corefoundation/cfstring.h"
49 #endif
50
51 #ifndef FixedToInt
52 // as macro in FixMath.h for 10.3
53 inline Fixed IntToFixed( int inInt )
54 {
55 return (((SInt32) inInt) << 16);
56 }
57
58 inline int FixedToInt( Fixed inFixed )
59 {
60 return (((SInt32) inFixed) >> 16);
61 }
62 #endif
63
64 #if wxUSE_GUI
65
66 #include "wx/dc.h"
67 #include "wx/window.h"
68 #include "wx/toplevel.h"
69
70 class wxMacPortStateHelper
71 {
72 DECLARE_NO_COPY_CLASS(wxMacPortStateHelper)
73
74 public:
75 wxMacPortStateHelper( GrafPtr newport);
76 wxMacPortStateHelper();
77 ~wxMacPortStateHelper();
78
79 void Setup( GrafPtr newport );
80 void Clear();
81 bool IsCleared() { return m_clip == NULL; }
82 GrafPtr GetCurrentPort() { return m_currentPort; }
83
84 private:
85 GrafPtr m_currentPort;
86 GrafPtr m_oldPort;
87 RgnHandle m_clip;
88 ThemeDrawingState m_drawingState;
89 short m_textFont;
90 short m_textSize;
91 short m_textStyle;
92 short m_textMode;
93 };
94
95 class WXDLLEXPORT wxMacPortSaver
96 {
97 DECLARE_NO_COPY_CLASS(wxMacPortSaver)
98
99 public:
100 wxMacPortSaver( GrafPtr port );
101 ~wxMacPortSaver();
102 private :
103 GrafPtr m_port;
104 };
105
106 class WXDLLEXPORT wxMacPortSetter
107 {
108 DECLARE_NO_COPY_CLASS(wxMacPortSetter)
109
110 public:
111 wxMacPortSetter( const wxDC* dc );
112 ~wxMacPortSetter();
113 private:
114 wxMacPortStateHelper m_ph;
115 const wxDC* m_dc;
116 };
117
118 /*
119 Clips to the visible region of a control within the current port
120 */
121
122 class WXDLLEXPORT wxMacWindowClipper : public wxMacPortSaver
123 {
124 DECLARE_NO_COPY_CLASS(wxMacWindowClipper)
125
126 public:
127 wxMacWindowClipper( const wxWindow* win );
128 ~wxMacWindowClipper();
129 private:
130 GrafPtr m_newPort;
131 RgnHandle m_formerClip;
132 RgnHandle m_newClip;
133 };
134
135 class WXDLLEXPORT wxMacWindowStateSaver : public wxMacWindowClipper
136 {
137 DECLARE_NO_COPY_CLASS(wxMacWindowStateSaver)
138
139 public:
140 wxMacWindowStateSaver( const wxWindow* win );
141 ~wxMacWindowStateSaver();
142 private:
143 GrafPtr m_newPort;
144 ThemeDrawingState m_themeDrawingState;
145 };
146
147 #if wxMAC_USE_CORE_GRAPHICS
148 class WXDLLEXPORT wxMacCGContextStateSaver
149 {
150 DECLARE_NO_COPY_CLASS(wxMacCGContextStateSaver)
151
152 public:
153 wxMacCGContextStateSaver( CGContextRef cg )
154 {
155 m_cg = cg;
156 CGContextSaveGState( cg );
157 }
158 ~wxMacCGContextStateSaver()
159 {
160 CGContextRestoreGState( m_cg );
161 }
162 private:
163 CGContextRef m_cg;
164 };
165
166 #endif
167 /*
168 class wxMacDrawingHelper
169 {
170 DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
171
172 public:
173 wxMacDrawingHelper( wxWindowMac * theWindow , bool clientArea = false );
174 ~wxMacDrawingHelper();
175 bool Ok() { return m_ok; }
176 void LocalToWindow( Rect *rect) { OffsetRect( rect , m_origin.h , m_origin.v ); }
177 void LocalToWindow( Point *pt ) { AddPt( m_origin , pt ); }
178 void LocalToWindow( RgnHandle rgn ) { OffsetRgn( rgn , m_origin.h , m_origin.v ); }
179 const Point& GetOrigin() { return m_origin; }
180 private:
181 Point m_origin;
182 GrafPtr m_formerPort;
183 GrafPtr m_currentPort;
184 PenState m_savedPenState;
185 bool m_ok;
186 };
187 */
188
189 // app.h
190 bool wxMacConvertEventToRecord( EventRef event , EventRecord *rec);
191
192 #endif // wxUSE_GUI
193
194 // filefn.h
195 WXDLLEXPORT wxString wxMacFSSpec2MacFilename( const FSSpec *spec );
196 WXDLLEXPORT void wxMacFilename2FSSpec( const wxString &path , FSSpec *spec );
197
198 // utils.h
199 WXDLLEXPORT wxString wxMacFindFolderNoSeparator(short vRefNum,
200 OSType folderType,
201 Boolean createFolder);
202 WXDLLEXPORT wxString wxMacFindFolder(short vRefNum,
203 OSType folderType,
204 Boolean createFolder);
205
206 template<typename T> EventParamType wxMacGetEventParamType() { wxFAIL_MSG( wxT("Unknown Param Type") ); return 0; }
207 template<> inline EventParamType wxMacGetEventParamType<RgnHandle>() { return typeQDRgnHandle; }
208 template<> inline EventParamType wxMacGetEventParamType<ControlRef>() { return typeControlRef; }
209 template<> inline EventParamType wxMacGetEventParamType<WindowRef>() { return typeWindowRef; }
210 template<> inline EventParamType wxMacGetEventParamType<MenuRef>() { return typeMenuRef; }
211 template<> inline EventParamType wxMacGetEventParamType<EventRef>() { return typeEventRef; }
212 template<> inline EventParamType wxMacGetEventParamType<Point>() { return typeQDPoint; }
213 template<> inline EventParamType wxMacGetEventParamType<Rect>() { return typeQDRectangle; }
214 template<> inline EventParamType wxMacGetEventParamType<Boolean>() { return typeBoolean; }
215 template<> inline EventParamType wxMacGetEventParamType<SInt16>() { return typeSInt16; }
216 template<> inline EventParamType wxMacGetEventParamType<SInt32>() { return typeSInt32; }
217 template<> inline EventParamType wxMacGetEventParamType<UInt32>() { return typeUInt32; }
218 template<> inline EventParamType wxMacGetEventParamType<RGBColor>() { return typeRGBColor; }
219 #if TARGET_API_MAC_OSX
220 template<> inline EventParamType wxMacGetEventParamType<HICommand>() { return typeHICommand; }
221 template<> inline EventParamType wxMacGetEventParamType<HIPoint>() { return typeHIPoint; }
222 template<> inline EventParamType wxMacGetEventParamType<HISize>() { return typeHISize; }
223 template<> inline EventParamType wxMacGetEventParamType<HIRect>() { return typeHIRect; }
224 template<> inline EventParamType wxMacGetEventParamType<void*>() { return typeVoidPtr; }
225 #endif
226 #if TARGET_API_MAC_OSX && ( MAC_OS_X_VERSION_MAX_ALLOWED > MAC_OS_X_VERSION_10_2 )
227 template<> inline EventParamType wxMacGetEventParamType<CFDictionaryRef>() { return typeCFDictionaryRef; }
228 #endif
229 template<> inline EventParamType wxMacGetEventParamType<Collection>() { return typeCollection; }
230 template<> inline EventParamType wxMacGetEventParamType<CGContextRef>() { return typeCGContextRef; }
231 /*
232 These are ambiguous
233 template<> EventParamType wxMacGetEventParamType<GrafPtr>() { return typeGrafPtr; }
234 template<> EventParamType wxMacGetEventParamType<OSStatus>() { return typeOSStatus; }
235 template<> EventParamType wxMacGetEventParamType<CFIndex>() { return typeCFIndex; }
236 template<> EventParamType wxMacGetEventParamType<GWorldPtr>() { return typeGWorldPtr; }
237 */
238
239 class wxMacCarbonEvent
240 {
241
242 public :
243 wxMacCarbonEvent()
244 {
245 m_eventRef = 0;
246 m_release = false;
247 }
248
249 wxMacCarbonEvent( EventRef event , bool release = false )
250 {
251 m_eventRef = event;
252 m_release = release;
253 }
254
255 wxMacCarbonEvent(UInt32 inClassID,UInt32 inKind,EventTime inWhen = 0 /*now*/,EventAttributes inAttributes=kEventAttributeNone)
256 {
257 m_eventRef = NULL;
258 verify_noerr( MacCreateEvent( NULL , inClassID, inKind,inWhen,inAttributes,&m_eventRef) );
259 m_release = true;
260 }
261
262 ~wxMacCarbonEvent()
263 {
264 if ( m_release )
265 ReleaseEvent( m_eventRef );
266 }
267
268 OSStatus Create(UInt32 inClassID,UInt32 inKind,EventTime inWhen = 0 /*now*/,EventAttributes inAttributes=kEventAttributeNone)
269 {
270 verify( (m_eventRef == NULL) || m_release );
271 if ( m_eventRef && m_release )
272 {
273 ReleaseEvent( m_eventRef );
274 m_release = false;
275 m_eventRef = NULL;
276 }
277 OSStatus err = MacCreateEvent( NULL , inClassID, inKind,inWhen,inAttributes,&m_eventRef);
278 if ( err == noErr )
279 m_release = true;
280 return err;
281 }
282
283 OSStatus GetParameter( EventParamName inName, EventParamType inDesiredType, UInt32 inBufferSize, void * outData);
284
285 template <typename T> OSStatus GetParameter( EventParamName inName, EventParamType type , T *data )
286 {
287 return GetParameter( inName, type , sizeof( T ) , data );
288 }
289 template <typename T> OSStatus GetParameter( EventParamName inName, T *data )
290 {
291 return GetParameter<T>( inName, wxMacGetEventParamType<T>() , data );
292 }
293
294 template <typename T> T GetParameter( EventParamName inName )
295 {
296 T value;
297 verify_noerr( GetParameter<T>( inName, &value ) );
298 return value;
299 }
300 template <typename T> T GetParameter( EventParamName inName, EventParamType inDesiredType )
301 {
302 T value;
303 verify_noerr( GetParameter<T>( inName, inDesiredType , &value ) );
304 return value;
305 }
306
307 OSStatus SetParameter( EventParamName inName, EventParamType inType, UInt32 inSize, const void * inData);
308 template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T *data )
309 {
310 return SetParameter( inName, inDesiredType , sizeof( T ) , data );
311 }
312 template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T& data )
313 {
314 return SetParameter<T>( inName, inDesiredType , &data );
315 }
316 template <typename T> OSStatus SetParameter( EventParamName inName, const T *data )
317 {
318 return SetParameter<T>( inName, wxMacGetEventParamType<T>() , data );
319 }
320 template <typename T> OSStatus SetParameter( EventParamName inName, const T& data )
321 {
322 return SetParameter<T>( inName, wxMacGetEventParamType<T>() , &data );
323 }
324 UInt32 GetClass()
325 {
326 return ::GetEventClass( m_eventRef );
327 }
328 UInt32 GetKind()
329 {
330 return ::GetEventKind( m_eventRef );
331 }
332 EventTime GetTime()
333 {
334 return ::GetEventTime( m_eventRef );
335 }
336 UInt32 GetTicks()
337 {
338 return EventTimeToTicks( GetTime() );
339 }
340 OSStatus SetCurrentTime( )
341 {
342 return ::SetEventTime( m_eventRef , GetCurrentEventTime() );
343 }
344 OSStatus SetTime( EventTime when )
345 {
346 return ::SetEventTime( m_eventRef , when );
347 }
348 operator EventRef () { return m_eventRef; }
349
350 bool IsValid() { return m_eventRef != 0; }
351 protected :
352 EventRef m_eventRef;
353 bool m_release;
354 };
355
356 //
357 // helper class for allocating and deallocating Universal Proc Ptrs
358 //
359
360 template <typename procType, typename uppType , uppType (*newUPP)(procType) , void (*disposeUPP)(uppType) > class wxMacUPP
361 {
362 public :
363 wxMacUPP( procType proc )
364 {
365 m_upp = NULL;
366 m_upp = (*newUPP)( NULL );
367 }
368 ~wxMacUPP()
369 {
370 if ( m_upp )
371 disposeUPP( m_upp );
372 }
373 operator uppType() { return m_upp; }
374 private :
375 uppType m_upp;
376 };
377
378 typedef wxMacUPP<NMProcPtr,NMUPP,NewNMUPP,DisposeNMUPP> wxMacNMUPP;
379
380 template <typename refType> class wxMacCFRefHolder
381 {
382 public :
383 wxMacCFRefHolder()
384 : m_ref(NULL) , m_release(false)
385 {
386 }
387
388 wxMacCFRefHolder( refType ref , bool release = true )
389 : m_ref(ref) , m_release(release)
390 {
391 }
392
393 ~wxMacCFRefHolder()
394 {
395 Release();
396 }
397
398 void Release()
399 {
400 if ( m_release && m_ref != NULL )
401 CFRelease( m_ref );
402 m_ref = NULL;
403 }
404
405 refType Detach()
406 {
407 refType val = m_ref;
408 m_release = false;
409 m_ref = NULL;
410 return val;
411 }
412
413 void Set( refType ref , bool release = true )
414 {
415 Release();
416 m_release = release;
417 m_ref = ref;
418 }
419
420 operator refType () const { return m_ref; }
421
422 private :
423 refType m_ref;
424 bool m_release;
425
426 DECLARE_NO_COPY_CLASS( wxMacCFRefHolder )
427 };
428
429 #if wxUSE_GUI
430
431 #include "wx/listbox.h"
432
433 /*
434 GWorldPtr wxMacCreateGWorld( int width , int height , int depth );
435 void wxMacDestroyGWorld( GWorldPtr gw );
436 PicHandle wxMacCreatePict( GWorldPtr gw , GWorldPtr mask = NULL );
437 CIconHandle wxMacCreateCIcon(GWorldPtr image , GWorldPtr mask , short dstDepth , short iconSize );
438 void wxMacSetColorTableEntry( CTabHandle newColors , int index , int red , int green , int blue );
439 CTabHandle wxMacCreateColorTable( int numColors );
440 */
441 void wxMacCreateBitmapButton( ControlButtonContentInfo*info , const wxBitmap& bitmap , int forceType = 0 );
442 void wxMacReleaseBitmapButton( ControlButtonContentInfo*info );
443
444 #define MAC_WXCOLORREF(a) (*((RGBColor*)&(a)))
445 #define MAC_WXHBITMAP(a) (GWorldPtr(a))
446 #define MAC_WXHMETAFILE(a) (PicHandle(a))
447 #define MAC_WXHICON(a) (IconRef(a))
448 #define MAC_WXHCURSOR(a) (CursHandle(a))
449 #define MAC_WXHRGN(a) (RgnHandle(a))
450 #define MAC_WXHWND(a) (WindowPtr(a))
451 #define MAC_WXRECPTR(a) ((Rect*)a)
452 #define MAC_WXPOINTPTR(a) ((Point*)a)
453 #define MAC_WXHMENU(a) ((MenuHandle)a)
454
455 struct wxOpaqueWindowRef
456 {
457 wxOpaqueWindowRef( WindowRef ref ) { m_data = ref; }
458 operator WindowRef() { return m_data; }
459 private :
460 WindowRef m_data;
461 };
462
463 void wxMacRectToNative( const wxRect *wx , Rect *n );
464 void wxMacNativeToRect( const Rect *n , wxRect* wx );
465 void wxMacPointToNative( const wxPoint* wx , Point *n );
466 void wxMacNativeToPoint( const Point *n , wxPoint* wx );
467
468 wxWindow * wxFindControlFromMacControl(ControlRef inControl );
469 wxTopLevelWindowMac* wxFindWinFromMacWindow( WindowRef inWindow );
470 wxMenu* wxFindMenuFromMacMenu(MenuRef inMenuRef);
471
472 int wxMacCommandToId( UInt32 macCommandId );
473 UInt32 wxIdToMacCommand( int wxId );
474 wxMenu* wxFindMenuFromMacCommand( const HICommand &macCommandId , wxMenuItem* &item );
475
476 extern wxWindow* g_MacLastWindow;
477 pascal OSStatus wxMacTopLevelMouseEventHandler( EventHandlerCallRef handler , EventRef event , void *data );
478 Rect wxMacGetBoundsForControl( wxWindow* window , const wxPoint& pos , const wxSize &size , bool adjustForOrigin = true );
479
480 ControlActionUPP GetwxMacLiveScrollbarActionProc();
481
482 class wxMacControl
483 {
484 public :
485 wxMacControl( wxWindow* peer , bool isRootControl = false );
486 wxMacControl( wxWindow* peer , ControlRef control );
487 wxMacControl( wxWindow* peer , WXWidget control );
488 virtual ~wxMacControl();
489
490 void Init();
491
492 virtual void Dispose();
493
494 bool Ok() const { return GetControlRef() != NULL; }
495
496 void SetReferenceInNativeControl();
497 static wxMacControl* GetReferenceFromNativeControl(ControlRef control);
498
499 virtual ControlRef * GetControlRefAddr() { return &m_controlRef; }
500 virtual ControlRef GetControlRef() const { return m_controlRef; }
501
502 virtual void SetReference( SInt32 data );
503 /*
504 void operator= (ControlRef c) { m_controlRef = c; }
505 operator ControlRef () { return m_controlRef; }
506 operator ControlRef * () { return &m_controlRef; }
507 */
508 // accessing data and values
509
510 virtual OSStatus SetData( ControlPartCode inPartCode , ResType inTag , Size inSize , const void * inData );
511 virtual OSStatus GetData( ControlPartCode inPartCode , ResType inTag , Size inBufferSize , void * inOutBuffer , Size * outActualSize ) const;
512 virtual OSStatus GetDataSize( ControlPartCode inPartCode , ResType inTag , Size * outActualSize ) const;
513 virtual OSStatus SendEvent( EventRef ref , OptionBits inOptions = 0 );
514 virtual OSStatus SendHICommand( HICommand &command , OptionBits inOptions = 0 );
515
516 virtual OSStatus SendHICommand( UInt32 commandID , OptionBits inOptions = 0 );
517
518 virtual SInt32 GetValue() const;
519 virtual SInt32 GetMaximum() const;
520 virtual SInt32 GetMinimum() const;
521
522 virtual void SetValue( SInt32 v );
523 virtual void SetMinimum( SInt32 v );
524 virtual void SetMaximum( SInt32 v );
525
526 virtual void SetValueAndRange( SInt32 value , SInt32 minimum , SInt32 maximum );
527 virtual void SetRange( SInt32 minimum , SInt32 maximum );
528
529 virtual OSStatus SetFocus( ControlFocusPart focusPart );
530 virtual bool HasFocus() const;
531 virtual bool NeedsFocusRect() const;
532 virtual void SetNeedsFocusRect( bool needs );
533
534 // templated helpers
535
536 Size GetDataSize( ControlPartCode inPartCode , ResType inTag ) const
537 {
538 Size sz;
539 verify_noerr( GetDataSize( inPartCode , inTag , &sz ) );
540 return sz;
541 }
542 template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T *data )
543 {
544 return SetData( inPartCode , inTag , sizeof( T ) , data );
545 }
546 template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T& data )
547 {
548 return SetData( inPartCode , inTag , sizeof( T ) , &data );
549 }
550 template <typename T> OSStatus SetData( ResType inTag , const T *data )
551 {
552 return SetData( kControlEntireControl , inTag , sizeof( T ) , data );
553 }
554 template <typename T> OSStatus SetData( ResType inTag , const T& data )
555 {
556 return SetData( kControlEntireControl , inTag , sizeof( T ) , &data );
557 }
558 template <typename T> OSStatus GetData( ControlPartCode inPartCode , ResType inTag , T *data ) const
559 {
560 Size dummy;
561 return GetData( inPartCode , inTag , sizeof( T ) , data , &dummy );
562 }
563 template <typename T> T GetData( ControlPartCode inPartCode , ResType inTag ) const
564 {
565 T value;
566 OSStatus err = GetData<T>( inPartCode , inTag , &value );
567
568 wxASSERT_MSG(err == noErr, wxString::Format(wxT("GetData Failed for Part [%i] and Tag [%i]"),
569 inPartCode, inTag));
570 return value;
571 }
572 template <typename T> OSStatus GetData( ResType inTag , T *data ) const
573 {
574 Size dummy;
575 return GetData( kControlEntireControl , inTag , sizeof( T ) , data , &dummy );
576 }
577 template <typename T> T GetData( ResType inTag ) const
578 {
579 return GetData<T>( kControlEntireControl , inTag );
580 }
581
582 // Flash the control for the specified amount of time
583 virtual void Flash( ControlPartCode part , UInt32 ticks = 8 );
584
585 virtual void VisibilityChanged( bool shown );
586 virtual void SuperChangedPosition();
587
588
589 virtual void SetFont( const wxFont & font , const wxColour& foreground , long windowStyle );
590 virtual void SetBackground( const wxBrush &brush );
591 virtual ControlPartCode HandleKey( SInt16 keyCode, SInt16 charCode, EventModifiers modifiers );
592 void SetActionProc( ControlActionUPP actionProc );
593 void SetViewSize( SInt32 viewSize );
594 SInt32 GetViewSize() const;
595
596 virtual bool IsVisible() const;
597 virtual void SetVisibility( bool visible , bool redraw );
598 virtual bool IsEnabled() const;
599 virtual bool IsActive() const;
600 virtual void Enable( bool enable );
601
602 // invalidates this control and all children
603 virtual void InvalidateWithChildren();
604 virtual void SetDrawingEnabled( bool enable );
605 #ifdef __WXMAC_OSX__
606 virtual bool GetNeedsDisplay() const;
607 #endif
608 // where is in native window relative coordinates
609 virtual void SetNeedsDisplay( RgnHandle where );
610 // where is in native window relative coordinates
611 virtual void SetNeedsDisplay( Rect* where = NULL );
612
613 // if rect = NULL, entire view
614 virtual void ScrollRect( wxRect *rect , int dx , int dy );
615
616 // in native parent window relative coordinates
617 virtual void GetRect( Rect *r );
618
619 // in native parent window relative coordinates
620 virtual void SetRect( Rect *r );
621
622 virtual void GetRectInWindowCoords( Rect *r );
623 virtual void GetBestRect( Rect *r );
624 virtual void SetLabel( const wxString &title );
625 // converts from Toplevel-Content relative to local
626 static void Convert( wxPoint *pt , wxMacControl *convert , wxMacControl *to );
627
628 virtual void GetFeatures( UInt32 *features );
629 virtual OSStatus GetRegion( ControlPartCode partCode , RgnHandle region );
630 virtual OSStatus SetZOrder( bool above , wxMacControl* other );
631
632 bool IsCompositing() { return m_isCompositing; }
633 bool IsRootControl() { return m_isRootControl; }
634
635 wxWindow* GetPeer() const
636 {
637 return m_peer;
638 }
639
640 // to be moved into a tab control class
641
642 virtual OSStatus SetTabEnabled( SInt16 tabNo , bool enable );
643 protected :
644 ControlRef m_controlRef;
645 wxFont m_font;
646 long m_windowStyle;
647 wxWindow* m_peer;
648 bool m_needsFocusRect;
649 bool m_isCompositing;
650 bool m_isRootControl;
651 };
652
653 // ============================================================================
654 // DataBrowser Wrapper
655 // ============================================================================
656 //
657 // basing on DataBrowserItemIDs
658 //
659
660 class wxMacDataBrowserControl : public wxMacControl
661 {
662 public :
663 wxMacDataBrowserControl( wxWindow* peer, const wxPoint& pos, const wxSize& size, long style);
664
665 OSStatus SetCallbacks( const DataBrowserCallbacks *callbacks );
666
667 OSStatus GetItemCount( DataBrowserItemID container,
668 Boolean recurse,
669 DataBrowserItemState state,
670 UInt32 *numItems) const;
671
672 OSStatus GetItems( DataBrowserItemID container,
673 Boolean recurse,
674 DataBrowserItemState state,
675 Handle items) const;
676
677
678 OSStatus AddColumn( DataBrowserListViewColumnDesc *columnDesc,
679 DataBrowserTableViewColumnIndex position );
680
681 OSStatus AutoSizeColumns();
682
683 OSStatus SetHasScrollBars( bool horiz, bool vert );
684 OSStatus SetHiliteStyle( DataBrowserTableViewHiliteStyle hiliteStyle );
685
686 OSStatus SetHeaderButtonHeight( UInt16 height );
687 OSStatus GetHeaderButtonHeight( UInt16 *height );
688
689 OSStatus UpdateItems( DataBrowserItemID container, UInt32 numItems,
690 const DataBrowserItemID *items,
691 DataBrowserPropertyID preSortProperty,
692 DataBrowserPropertyID propertyID ) const;
693
694 OSStatus AddItems( DataBrowserItemID container, UInt32 numItems,
695 const DataBrowserItemID *items,
696 DataBrowserPropertyID preSortProperty );
697 OSStatus RemoveItems( DataBrowserItemID container, UInt32 numItems,
698 const DataBrowserItemID *items,
699 DataBrowserPropertyID preSortProperty );
700 OSStatus RevealItem( DataBrowserItemID item,
701 DataBrowserPropertyID propertyID,
702 DataBrowserRevealOptions options ) const;
703
704 OSStatus SetSelectionFlags( DataBrowserSelectionFlags );
705 OSStatus GetSelectionAnchor( DataBrowserItemID *first, DataBrowserItemID *last ) const;
706 bool IsItemSelected( DataBrowserItemID item ) const;
707 OSStatus SetSelectedItems( UInt32 numItems,
708 const DataBrowserItemID *items,
709 DataBrowserSetOption operation );
710
711 OSStatus GetItemID( DataBrowserTableViewRowIndex row,
712 DataBrowserItemID * item ) const;
713 OSStatus GetItemRow( DataBrowserItemID item,
714 DataBrowserTableViewRowIndex * row ) const;
715
716 OSStatus SetDefaultRowHeight( UInt16 height );
717 OSStatus GetDefaultRowHeight( UInt16 * height ) const;
718
719 OSStatus SetRowHeight( DataBrowserItemID item , UInt16 height);
720 OSStatus GetRowHeight( DataBrowserItemID item , UInt16 *height) const;
721
722 OSStatus GetColumnWidth( DataBrowserPropertyID column , UInt16 *width ) const;
723 OSStatus SetColumnWidth( DataBrowserPropertyID column , UInt16 width );
724
725 OSStatus GetDefaultColumnWidth( UInt16 *width ) const;
726 OSStatus SetDefaultColumnWidth( UInt16 width );
727
728 OSStatus GetColumnCount( UInt32* numColumns) const;
729
730 OSStatus GetColumnPosition( DataBrowserPropertyID column, UInt32 *position) const;
731 OSStatus SetColumnPosition( DataBrowserPropertyID column, UInt32 position);
732
733 OSStatus GetScrollPosition( UInt32 *top , UInt32 *left ) const;
734 OSStatus SetScrollPosition( UInt32 top , UInt32 left );
735
736 OSStatus GetSortProperty( DataBrowserPropertyID *column ) const;
737 OSStatus SetSortProperty( DataBrowserPropertyID column );
738
739 OSStatus GetSortOrder( DataBrowserSortOrder *order ) const;
740 OSStatus SetSortOrder( DataBrowserSortOrder order );
741
742 OSStatus GetPropertyFlags( DataBrowserPropertyID property, DataBrowserPropertyFlags *flags ) const;
743 OSStatus SetPropertyFlags( DataBrowserPropertyID property, DataBrowserPropertyFlags flags );
744
745 OSStatus GetHeaderDesc( DataBrowserPropertyID property, DataBrowserListViewHeaderDesc *desc ) const;
746 OSStatus SetHeaderDesc( DataBrowserPropertyID property, DataBrowserListViewHeaderDesc *desc );
747
748 OSStatus SetDisclosureColumn( DataBrowserPropertyID property , Boolean expandableRows );
749 protected :
750
751 static pascal void DataBrowserItemNotificationProc(
752 ControlRef browser,
753 DataBrowserItemID itemID,
754 DataBrowserItemNotification message,
755 DataBrowserItemDataRef itemData );
756
757 virtual void ItemNotification(
758 DataBrowserItemID itemID,
759 DataBrowserItemNotification message,
760 DataBrowserItemDataRef itemData) = 0;
761
762 static pascal OSStatus DataBrowserGetSetItemDataProc(
763 ControlRef browser,
764 DataBrowserItemID itemID,
765 DataBrowserPropertyID property,
766 DataBrowserItemDataRef itemData,
767 Boolean changeValue );
768
769 virtual OSStatus GetSetItemData(
770 DataBrowserItemID itemID,
771 DataBrowserPropertyID property,
772 DataBrowserItemDataRef itemData,
773 Boolean changeValue ) = 0;
774
775 static pascal Boolean DataBrowserCompareProc(
776 ControlRef browser,
777 DataBrowserItemID itemOneID,
778 DataBrowserItemID itemTwoID,
779 DataBrowserPropertyID sortProperty);
780
781 virtual Boolean CompareItems(DataBrowserItemID itemOneID,
782 DataBrowserItemID itemTwoID,
783 DataBrowserPropertyID sortProperty) = 0;
784 };
785
786 // ============================================================================
787 // Higher-level Databrowser
788 // ============================================================================
789 //
790 // basing on data item objects
791 //
792
793 // forward decl
794
795 class wxMacDataItemBrowserControl;
796
797 // base class for databrowser items
798
799 class wxMacDataItem
800 {
801 public :
802 wxMacDataItem();
803 virtual ~wxMacDataItem();
804
805 virtual bool IsLessThan(wxMacDataItemBrowserControl *owner ,
806 const wxMacDataItem*,
807 DataBrowserPropertyID property) const;
808
809 // returns true if access was successful, otherwise false
810 virtual OSStatus GetSetData(wxMacDataItemBrowserControl *owner ,
811 DataBrowserPropertyID property,
812 DataBrowserItemDataRef itemData,
813 bool changeValue );
814
815 virtual void Notification(wxMacDataItemBrowserControl *owner ,
816 DataBrowserItemNotification message,
817 DataBrowserItemDataRef itemData ) const;
818 };
819
820 typedef wxMacDataItem* wxMacDataItemPtr;
821 const wxMacDataItemPtr wxMacDataBrowserRootContainer = NULL;
822
823 WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxMacDataItemPtr, wxArrayMacDataItemPtr, class WXDLLIMPEXP_CORE);
824
825 class wxMacDataItemBrowserControl : public wxMacDataBrowserControl
826 {
827 public :
828 wxMacDataItemBrowserControl( wxWindow* peer , const wxPoint& pos, const wxSize& size, long style);
829
830 unsigned int GetItemCount(const wxMacDataItem* container, bool recurse , DataBrowserItemState state) const;
831 void GetItems(const wxMacDataItem* container, bool recurse ,
832 DataBrowserItemState state, wxArrayMacDataItemPtr &items ) const;
833
834 unsigned int GetLineFromItem(const wxMacDataItem *item) const;
835 wxMacDataItem * GetItemFromLine(unsigned int n) const;
836
837 void UpdateItem(const wxMacDataItem *container, const wxMacDataItem *item,
838 DataBrowserPropertyID property) const;
839 void UpdateItems(const wxMacDataItem *container, wxArrayMacDataItemPtr &items,
840 DataBrowserPropertyID property) const;
841
842 void AddItem(wxMacDataItem *container, wxMacDataItem *item);
843 void AddItems(wxMacDataItem *container, wxArrayMacDataItemPtr &items );
844
845 void RemoveAllItems(wxMacDataItem *container);
846 void RemoveItem(wxMacDataItem *container, wxMacDataItem* item);
847 void RemoveItems(wxMacDataItem *container, wxArrayMacDataItemPtr &items);
848
849 void SetSelectedItem( wxMacDataItem* item , DataBrowserSetOption option);
850 void SetSelectedItems( wxArrayMacDataItemPtr &items , DataBrowserSetOption option);
851 void SetSelectedAllItems( DataBrowserSetOption option);
852 Boolean IsItemSelected( const wxMacDataItem* item) const;
853
854 void RevealItem( wxMacDataItem* item, DataBrowserRevealOptions options);
855
856 void GetSelectionAnchor( wxMacDataItemPtr* first , wxMacDataItemPtr* last) const;
857
858 // item aware methods, to be used in subclasses
859
860 virtual Boolean CompareItems(const wxMacDataItem* itemOneID,
861 const wxMacDataItem* itemTwoID,
862 DataBrowserPropertyID sortProperty);
863
864 virtual OSStatus GetSetItemData(wxMacDataItem* itemID,
865 DataBrowserPropertyID property,
866 DataBrowserItemDataRef itemData,
867 Boolean changeValue );
868
869 virtual void ItemNotification(
870 const wxMacDataItem* itemID,
871 DataBrowserItemNotification message,
872 DataBrowserItemDataRef itemData);
873
874 // ID aware base methods, should be 'final' ie not changed in subclasses
875
876 virtual Boolean CompareItems(DataBrowserItemID itemOneID,
877 DataBrowserItemID itemTwoID,
878 DataBrowserPropertyID sortProperty);
879
880 virtual OSStatus GetSetItemData(DataBrowserItemID itemID,
881 DataBrowserPropertyID property,
882 DataBrowserItemDataRef itemData,
883 Boolean changeValue );
884
885 virtual void ItemNotification(
886 DataBrowserItemID itemID,
887 DataBrowserItemNotification message,
888 DataBrowserItemDataRef itemData);
889
890 // as we are getting the same events for human and API selection we have to suppress
891 // events in the latter case, since this will be used from many subclasses we keep it here
892
893 bool IsSelectionSuppressed() const { return m_suppressSelection; }
894 bool SuppressSelection( bool suppress );
895
896 private :
897
898 bool m_suppressSelection;
899 };
900
901 class wxMacDataItemBrowserSelectionSuppressor
902 {
903 public :
904 wxMacDataItemBrowserSelectionSuppressor(wxMacDataItemBrowserControl *browser);
905 ~wxMacDataItemBrowserSelectionSuppressor();
906
907 private :
908
909 bool m_former;
910 wxMacDataItemBrowserControl* m_browser;
911 };
912
913 // ============================================================================
914 // platform listbox implementation
915 // ============================================================================
916 //
917 // exposed for reuse in wxCheckListBox
918
919 class wxMacListBoxItem : public wxMacDataItem
920 {
921 public :
922 wxMacListBoxItem();
923
924 virtual ~wxMacListBoxItem();
925
926 void SetLabel( const wxString& str);
927 const wxString& GetLabel() const;
928
929 virtual bool IsLessThan(wxMacDataItemBrowserControl *owner ,
930 const wxMacDataItem* rhs,
931 DataBrowserPropertyID sortProperty) const;
932
933 virtual OSStatus GetSetData( wxMacDataItemBrowserControl *owner ,
934 DataBrowserPropertyID property,
935 DataBrowserItemDataRef itemData,
936 bool changeValue );
937
938 virtual void Notification(wxMacDataItemBrowserControl *owner ,
939 DataBrowserItemNotification message,
940 DataBrowserItemDataRef itemData ) const;
941
942 void SetOrder( SInt32 order );
943 SInt32 GetOrder() const;
944
945 void SetData( void* data);
946 void* GetData() const;
947
948 private :
949 wxString m_label;
950 wxMacCFStringHolder m_cfLabel;
951 void * m_data;
952 SInt32 m_order;
953 };
954
955 class wxMacDataBrowserListControl : public wxMacDataItemBrowserControl , public wxMacListControl
956 {
957 public:
958 wxMacDataBrowserListControl( wxListBox *peer, const wxPoint& pos, const wxSize& size, long style );
959 ~wxMacDataBrowserListControl();
960
961 // create a list item (can be a subclass of wxMacListBoxItem)
962
963 virtual wxMacListBoxItem* CreateItem();
964
965 // add and remove
966
967 void MacDelete( unsigned int n );
968 void MacInsert( unsigned int n, const wxString& item );
969 void MacInsert( unsigned int n, const wxArrayString& items );
970 int MacAppend( const wxString& item );
971 void MacClear();
972
973 // selecting
974
975 void MacDeselectAll();
976 void MacSetSelection( unsigned int n, bool select );
977 int MacGetSelection() const;
978 int MacGetSelections( wxArrayInt& aSelections ) const;
979 bool MacIsSelected( unsigned int n ) const;
980
981 // display
982
983 void MacScrollTo( unsigned int n );
984
985 // accessing content
986
987 void MacSetString( unsigned int n, const wxString& item );
988 void MacSetClientData( unsigned int n, void * data);
989 wxString MacGetString( unsigned int n) const;
990 void * MacGetClientData( unsigned int) const;
991 unsigned int MacGetCount() const;
992
993 // client data
994
995 wxClientDataType GetClientDataType() const;
996 void SetClientDataType(wxClientDataType clientDataItemsType);
997
998 // pointing back
999
1000 wxListBox * GetPeer() const;
1001 private :
1002 bool m_stringSorted;
1003 wxClientDataType m_clientDataItemsType;
1004 };
1005
1006 // ============================================================================
1007 // graphics implementation
1008 // ============================================================================
1009
1010 #if wxMAC_USE_CORE_GRAPHICS
1011
1012 class WXDLLEXPORT wxMacCGPath : public wxGraphicPath
1013 {
1014 DECLARE_NO_COPY_CLASS(wxMacCGPath)
1015 public :
1016 wxMacCGPath();
1017 ~wxMacCGPath();
1018
1019 // Starts a new subpath at
1020 void MoveToPoint( wxCoord x1 , wxCoord y1 );
1021 void AddLineToPoint( wxCoord x1 , wxCoord y1 );
1022 void AddQuadCurveToPoint( wxCoord cx1, wxCoord cy1, wxCoord x1, wxCoord y1 );
1023 void AddRectangle( wxCoord x, wxCoord y, wxCoord w, wxCoord h );
1024 void AddCircle( wxCoord x, wxCoord y , wxCoord r );
1025
1026 // closes the current subpath
1027 void CloseSubpath();
1028
1029 CGPathRef GetPath() const;
1030 private :
1031 CGMutablePathRef m_path;
1032 };
1033
1034 class WXDLLEXPORT wxMacCGContext : public wxGraphicContext
1035 {
1036 DECLARE_NO_COPY_CLASS(wxMacCGContext)
1037
1038 public:
1039 wxMacCGContext( CGrafPtr port );
1040 wxMacCGContext( CGContextRef cgcontext );
1041 wxMacCGContext();
1042 ~wxMacCGContext();
1043
1044 virtual void Clip( const wxRegion &region );
1045 virtual void StrokePath( const wxGraphicPath *p );
1046 virtual void DrawPath( const wxGraphicPath *p , int fillStyle = wxWINDING_RULE );
1047 virtual void FillPath( const wxGraphicPath *p , const wxColor &fillColor , int fillStyle = wxWINDING_RULE );
1048
1049 virtual wxGraphicPath* CreatePath();
1050 virtual void SetPen( const wxPen &pen ) ;
1051 virtual void SetBrush( const wxBrush &brush );
1052 CGContextRef GetNativeContext();
1053 void SetNativeContext( CGContextRef cg );
1054 CGPathDrawingMode GetDrawingMode() const { return m_mode; }
1055 private:
1056 CGContextRef m_cgContext;
1057 CGrafPtr m_qdPort;
1058 CGPathDrawingMode m_mode;
1059 wxPen m_pen;
1060 wxBrush m_brush;
1061 };
1062
1063 #endif // wxMAC_USE_CORE_GRAPHICS
1064
1065 #ifdef __WXMAC_OSX__
1066
1067 CGColorSpaceRef wxMacGetGenericRGBColorSpace(void);
1068 void wxMacMemoryBufferReleaseProc(void *info, const void *data, size_t size);
1069
1070 #endif
1071
1072 class WXDLLEXPORT wxBitmapRefData: public wxGDIRefData
1073 {
1074 DECLARE_NO_COPY_CLASS(wxBitmapRefData)
1075
1076 friend class WXDLLEXPORT wxIcon;
1077 friend class WXDLLEXPORT wxCursor;
1078 public:
1079 wxBitmapRefData(int width , int height , int depth);
1080 wxBitmapRefData();
1081 ~wxBitmapRefData();
1082
1083 void Free();
1084 bool Ok() const { return m_ok; }
1085 void SetOk( bool isOk) { m_ok = isOk; }
1086
1087 void SetWidth( int width ) { m_width = width; }
1088 void SetHeight( int height ) { m_height = height; }
1089 void SetDepth( int depth ) { m_depth = depth; }
1090
1091 int GetWidth() const { return m_width; }
1092 int GetHeight() const { return m_height; }
1093 int GetDepth() const { return m_depth; }
1094
1095 void *GetRawAccess() const;
1096 void *BeginRawAccess();
1097 void EndRawAccess();
1098
1099 bool HasAlpha() const { return m_hasAlpha; }
1100 void UseAlpha( bool useAlpha );
1101
1102 public:
1103 #if wxUSE_PALETTE
1104 wxPalette m_bitmapPalette;
1105 #endif // wxUSE_PALETTE
1106
1107 wxMask * m_bitmapMask; // Optional mask
1108 #ifdef __WXMAC_OSX__
1109 CGImageRef CGImageCreate() const;
1110 #endif
1111
1112 // returns true if the bitmap has a size that
1113 // can be natively transferred into a true icon
1114 // if no is returned GetIconRef will still produce
1115 // an icon but it will be generated via a PICT and
1116 // rescaled to 16 x 16
1117 bool HasNativeSize();
1118
1119 // caller should increase ref count if needed longer
1120 // than the bitmap exists
1121 IconRef GetIconRef();
1122
1123 // returns a Pict from the bitmap content
1124 PicHandle GetPictHandle();
1125 GWorldPtr GetHBITMAP(GWorldPtr * mask = NULL ) const;
1126 void UpdateAlphaMask() const;
1127
1128 private :
1129 bool Create(int width , int height , int depth);
1130 void Init();
1131
1132 int m_width;
1133 int m_height;
1134 int m_bytesPerRow;
1135 int m_depth;
1136 bool m_hasAlpha;
1137 wxMemoryBuffer m_memBuf;
1138 int m_rawAccessCount;
1139 bool m_ok;
1140 #ifdef __WXMAC_OSX__
1141 mutable CGImageRef m_cgImageRef;
1142 #endif
1143 IconRef m_iconRef;
1144 PicHandle m_pictHandle;
1145 GWorldPtr m_hBitmap;
1146 GWorldPtr m_hMaskBitmap;
1147 wxMemoryBuffer m_maskMemBuf;
1148 int m_maskBytesPerRow;
1149 };
1150
1151 class WXDLLEXPORT wxIconRefData : public wxGDIRefData
1152 {
1153 public:
1154 wxIconRefData();
1155 wxIconRefData( WXHICON );
1156 virtual ~wxIconRefData() { Free(); }
1157
1158 void Init();
1159 virtual void Free();
1160
1161 void SetWidth( int width ) { m_width = width; }
1162 void SetHeight( int height ) { m_height = height; }
1163
1164 int GetWidth() const { return m_width; }
1165 int GetHeight() const { return m_height; }
1166
1167 WXHICON GetHICON() const { return (WXHICON) m_iconRef; }
1168 private :
1169 IconRef m_iconRef;
1170 int m_width;
1171 int m_height;
1172 };
1173
1174 // toplevel.cpp
1175
1176 ControlRef wxMacFindControlUnderMouse( wxTopLevelWindowMac* toplevelWindow, const Point& location , WindowRef window , ControlPartCode *outPart );
1177
1178 #ifdef WORDS_BIGENDIAN
1179 inline Rect* wxMacGetPictureBounds( PicHandle pict , Rect* rect )
1180 {
1181 *rect = (**pict).picFrame;
1182 return rect;
1183 }
1184 #else
1185 inline Rect* wxMacGetPictureBounds( PicHandle pict , Rect* rect )
1186 {
1187 return QDGetPictureBounds( pict , rect );
1188 }
1189 #endif
1190
1191 #endif // wxUSE_GUI
1192
1193 #define wxMAC_DEFINE_PROC_GETTER( UPP , x ) \
1194 UPP Get##x() \
1195 { \
1196 static UPP sHandler = NULL; \
1197 if ( sHandler == NULL ) \
1198 sHandler = New##UPP( x ); \
1199 return sHandler; \
1200 }
1201
1202 //---------------------------------------------------------------------------
1203 // wxMac string conversions
1204 //---------------------------------------------------------------------------
1205
1206 void wxMacSetupConverters();
1207 void wxMacCleanupConverters();
1208
1209 void wxMacStringToPascal( const wxString&from , StringPtr to );
1210 wxString wxMacMakeStringFromPascal( ConstStringPtr from );
1211
1212 // filefn.cpp
1213
1214 wxString wxMacFSRefToPath( const FSRef *fsRef , CFStringRef additionalPathComponent = NULL );
1215 OSStatus wxMacPathToFSRef( const wxString&path , FSRef *fsRef );
1216 wxString wxMacHFSUniStrToString( ConstHFSUniStr255Param uniname );
1217
1218 #endif
1219 // _WX_PRIVATE_H_