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