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
6 // Author: Stefan Csomor
10 // Copyright: (c) Stefan Csomor
11 // Licence: wxWindows licence
12 /////////////////////////////////////////////////////////////////////////////
14 #ifndef _WX_PRIVATE_H_
15 #define _WX_PRIVATE_H_
21 # include <Carbon/Carbon.h>
23 # include <Debugging.h>
24 # include <Quickdraw.h>
25 # include <Appearance.h>
27 # include <Controls.h>
28 # include <ControlDefinitions.h>
32 # include <CoreServices.h>
35 #if UNIVERSAL_INTERFACES_VERSION < 0x0342
36 #error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
39 #ifndef MAC_OS_X_VERSION_10_3
40 #define MAC_OS_X_VERSION_10_3 1030
43 #ifndef MAC_OS_X_VERSION_10_4
44 #define MAC_OS_X_VERSION_10_4 1040
47 #ifdef __WXMAC_CARBON__
48 #include "wx/mac/corefoundation/cfstring.h"
52 // as macro in FixMath.h for 10.3
53 inline Fixed
IntToFixed( int inInt
)
55 return (((SInt32
) inInt
) << 16);
58 inline int FixedToInt( Fixed inFixed
)
60 return (((SInt32
) inFixed
) >> 16);
67 #include "wx/window.h"
68 #include "wx/toplevel.h"
70 class wxMacPortStateHelper
72 DECLARE_NO_COPY_CLASS(wxMacPortStateHelper
)
75 wxMacPortStateHelper( GrafPtr newport
);
76 wxMacPortStateHelper();
77 ~wxMacPortStateHelper();
79 void Setup( GrafPtr newport
);
81 bool IsCleared() { return m_clip
== NULL
; }
82 GrafPtr
GetCurrentPort() { return m_currentPort
; }
85 GrafPtr m_currentPort
;
88 ThemeDrawingState m_drawingState
;
95 class WXDLLEXPORT wxMacPortSaver
97 DECLARE_NO_COPY_CLASS(wxMacPortSaver
)
100 wxMacPortSaver( GrafPtr port
);
106 class WXDLLEXPORT wxMacPortSetter
108 DECLARE_NO_COPY_CLASS(wxMacPortSetter
)
111 wxMacPortSetter( const wxDC
* dc
);
114 wxMacPortStateHelper m_ph
;
119 Clips to the visible region of a control within the current port
122 class WXDLLEXPORT wxMacWindowClipper
: public wxMacPortSaver
124 DECLARE_NO_COPY_CLASS(wxMacWindowClipper
)
127 wxMacWindowClipper( const wxWindow
* win
);
128 ~wxMacWindowClipper();
131 RgnHandle m_formerClip
;
135 class WXDLLEXPORT wxMacWindowStateSaver
: public wxMacWindowClipper
137 DECLARE_NO_COPY_CLASS(wxMacWindowStateSaver
)
140 wxMacWindowStateSaver( const wxWindow
* win
);
141 ~wxMacWindowStateSaver();
144 ThemeDrawingState m_themeDrawingState
;
147 #if wxMAC_USE_CORE_GRAPHICS
148 class WXDLLEXPORT wxMacCGContextStateSaver
150 DECLARE_NO_COPY_CLASS(wxMacCGContextStateSaver
)
153 wxMacCGContextStateSaver( CGContextRef cg
)
156 CGContextSaveGState( cg
);
158 ~wxMacCGContextStateSaver()
160 CGContextRestoreGState( m_cg
);
168 class wxMacDrawingHelper
170 DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
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; }
182 GrafPtr m_formerPort;
183 GrafPtr m_currentPort;
184 PenState m_savedPenState;
190 bool wxMacConvertEventToRecord( EventRef event
, EventRecord
*rec
);
195 WXDLLEXPORT wxString
wxMacFSSpec2MacFilename( const FSSpec
*spec
);
196 WXDLLEXPORT
void wxMacFilename2FSSpec( const wxString
&path
, FSSpec
*spec
);
199 WXDLLEXPORT wxString
wxMacFindFolderNoSeparator(short vRefNum
,
201 Boolean createFolder
);
202 WXDLLEXPORT wxString
wxMacFindFolder(short vRefNum
,
204 Boolean createFolder
);
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
; }
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
; }
229 template<> inline EventParamType wxMacGetEventParamType
<Collection
>() { return typeCollection
; }
230 template<> inline EventParamType wxMacGetEventParamType
<CGContextRef
>() { return typeCGContextRef
; }
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; }
239 class wxMacCarbonEvent
249 wxMacCarbonEvent( EventRef event
, bool release
= false )
255 wxMacCarbonEvent(UInt32 inClassID
,UInt32 inKind
,EventTime inWhen
= 0 /*now*/,EventAttributes inAttributes
=kEventAttributeNone
)
258 verify_noerr( MacCreateEvent( NULL
, inClassID
, inKind
,inWhen
,inAttributes
,&m_eventRef
) );
265 ReleaseEvent( m_eventRef
);
268 OSStatus
Create(UInt32 inClassID
,UInt32 inKind
,EventTime inWhen
= 0 /*now*/,EventAttributes inAttributes
=kEventAttributeNone
)
270 verify( (m_eventRef
== NULL
) || m_release
);
271 if ( m_eventRef
&& m_release
)
273 ReleaseEvent( m_eventRef
);
277 OSStatus err
= MacCreateEvent( NULL
, inClassID
, inKind
,inWhen
,inAttributes
,&m_eventRef
);
283 OSStatus
GetParameter( EventParamName inName
, EventParamType inDesiredType
, UInt32 inBufferSize
, void * outData
);
285 template <typename T
> OSStatus
GetParameter( EventParamName inName
, EventParamType type
, T
*data
)
287 return GetParameter( inName
, type
, sizeof( T
) , data
);
289 template <typename T
> OSStatus
GetParameter( EventParamName inName
, T
*data
)
291 return GetParameter
<T
>( inName
, wxMacGetEventParamType
<T
>() , data
);
294 template <typename T
> T
GetParameter( EventParamName inName
)
297 verify_noerr( GetParameter
<T
>( inName
, &value
) );
300 template <typename T
> T
GetParameter( EventParamName inName
, EventParamType inDesiredType
)
303 verify_noerr( GetParameter
<T
>( inName
, inDesiredType
, &value
) );
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
)
310 return SetParameter( inName
, inDesiredType
, sizeof( T
) , data
);
312 template <typename T
> OSStatus
SetParameter( EventParamName inName
, EventParamType inDesiredType
, const T
& data
)
314 return SetParameter
<T
>( inName
, inDesiredType
, &data
);
316 template <typename T
> OSStatus
SetParameter( EventParamName inName
, const T
*data
)
318 return SetParameter
<T
>( inName
, wxMacGetEventParamType
<T
>() , data
);
320 template <typename T
> OSStatus
SetParameter( EventParamName inName
, const T
& data
)
322 return SetParameter
<T
>( inName
, wxMacGetEventParamType
<T
>() , &data
);
326 return ::GetEventClass( m_eventRef
);
330 return ::GetEventKind( m_eventRef
);
334 return ::GetEventTime( m_eventRef
);
338 return EventTimeToTicks( GetTime() );
340 OSStatus
SetCurrentTime( )
342 return ::SetEventTime( m_eventRef
, GetCurrentEventTime() );
344 OSStatus
SetTime( EventTime when
)
346 return ::SetEventTime( m_eventRef
, when
);
348 operator EventRef () { return m_eventRef
; }
350 bool IsValid() { return m_eventRef
!= 0; }
357 // helper class for allocating and deallocating Universal Proc Ptrs
360 template <typename procType
, typename uppType
, uppType (*newUPP
)(procType
) , void (*disposeUPP
)(uppType
) > class wxMacUPP
363 wxMacUPP( procType proc
)
366 m_upp
= (*newUPP
)( NULL
);
373 operator uppType() { return m_upp
; }
378 typedef wxMacUPP
<NMProcPtr
,NMUPP
,NewNMUPP
,DisposeNMUPP
> wxMacNMUPP
;
380 template <typename refType
> class wxMacCFRefHolder
384 : m_ref(NULL
) , m_release(false)
388 wxMacCFRefHolder( refType ref
, bool release
= true )
389 : m_ref(ref
) , m_release(release
)
400 if ( m_release
&& m_ref
!= NULL
)
413 void Set( refType ref
, bool release
= true )
420 operator refType () const { return m_ref
; }
426 DECLARE_NO_COPY_CLASS( wxMacCFRefHolder
)
431 #include "wx/listbox.h"
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 );
441 void wxMacCreateBitmapButton( ControlButtonContentInfo
*info
, const wxBitmap
& bitmap
, int forceType
= 0 );
442 void wxMacReleaseBitmapButton( ControlButtonContentInfo
*info
);
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)
455 struct wxOpaqueWindowRef
457 wxOpaqueWindowRef( WindowRef ref
) { m_data
= ref
; }
458 operator WindowRef() { return m_data
; }
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
);
468 wxWindow
* wxFindControlFromMacControl(ControlRef inControl
);
469 wxTopLevelWindowMac
* wxFindWinFromMacWindow( WindowRef inWindow
);
470 wxMenu
* wxFindMenuFromMacMenu(MenuRef inMenuRef
);
472 int wxMacCommandToId( UInt32 macCommandId
);
473 UInt32
wxIdToMacCommand( int wxId
);
474 wxMenu
* wxFindMenuFromMacCommand( const HICommand
&macCommandId
, wxMenuItem
* &item
);
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 );
480 ControlActionUPP
GetwxMacLiveScrollbarActionProc();
485 wxMacControl( wxWindow
* peer
, bool isRootControl
= false );
486 wxMacControl( wxWindow
* peer
, ControlRef control
);
487 wxMacControl( wxWindow
* peer
, WXWidget control
);
488 virtual ~wxMacControl();
492 virtual void Dispose();
494 bool Ok() const { return GetControlRef() != NULL
; }
496 void SetReferenceInNativeControl();
497 static wxMacControl
* GetReferenceFromNativeControl(ControlRef control
);
499 virtual ControlRef
* GetControlRefAddr() { return &m_controlRef
; }
500 virtual ControlRef
GetControlRef() const { return m_controlRef
; }
502 virtual void SetReference( SInt32 data
);
504 void operator= (ControlRef c) { m_controlRef = c; }
505 operator ControlRef () { return m_controlRef; }
506 operator ControlRef * () { return &m_controlRef; }
508 // accessing data and values
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 );
516 virtual OSStatus
SendHICommand( UInt32 commandID
, OptionBits inOptions
= 0 );
518 virtual SInt32
GetValue() const;
519 virtual SInt32
GetMaximum() const;
520 virtual SInt32
GetMinimum() const;
522 virtual void SetValue( SInt32 v
);
523 virtual void SetMinimum( SInt32 v
);
524 virtual void SetMaximum( SInt32 v
);
526 virtual void SetValueAndRange( SInt32 value
, SInt32 minimum
, SInt32 maximum
);
527 virtual void SetRange( SInt32 minimum
, SInt32 maximum
);
529 virtual OSStatus
SetFocus( ControlFocusPart focusPart
);
530 virtual bool HasFocus() const;
531 virtual bool NeedsFocusRect() const;
532 virtual void SetNeedsFocusRect( bool needs
);
536 Size
GetDataSize( ControlPartCode inPartCode
, ResType inTag
) const
539 verify_noerr( GetDataSize( inPartCode
, inTag
, &sz
) );
542 template <typename T
> OSStatus
SetData( ControlPartCode inPartCode
, ResType inTag
, const T
*data
)
544 return SetData( inPartCode
, inTag
, sizeof( T
) , data
);
546 template <typename T
> OSStatus
SetData( ControlPartCode inPartCode
, ResType inTag
, const T
& data
)
548 return SetData( inPartCode
, inTag
, sizeof( T
) , &data
);
550 template <typename T
> OSStatus
SetData( ResType inTag
, const T
*data
)
552 return SetData( kControlEntireControl
, inTag
, sizeof( T
) , data
);
554 template <typename T
> OSStatus
SetData( ResType inTag
, const T
& data
)
556 return SetData( kControlEntireControl
, inTag
, sizeof( T
) , &data
);
558 template <typename T
> OSStatus
GetData( ControlPartCode inPartCode
, ResType inTag
, T
*data
) const
561 return GetData( inPartCode
, inTag
, sizeof( T
) , data
, &dummy
);
563 template <typename T
> T
GetData( ControlPartCode inPartCode
, ResType inTag
) const
566 OSStatus err
= GetData
<T
>( inPartCode
, inTag
, &value
);
568 wxASSERT_MSG( err
== noErr
,
569 wxString::Format(wxT("GetData Failed for Part [%i] and Tag [%i]"),
570 inPartCode
, (int)inTag
) );
573 template <typename T
> OSStatus
GetData( ResType inTag
, T
*data
) const
576 return GetData( kControlEntireControl
, inTag
, sizeof( T
) , data
, &dummy
);
578 template <typename T
> T
GetData( ResType inTag
) const
580 return GetData
<T
>( kControlEntireControl
, inTag
);
583 // Flash the control for the specified amount of time
584 virtual void Flash( ControlPartCode part
, UInt32 ticks
= 8 );
586 virtual void VisibilityChanged( bool shown
);
587 virtual void SuperChangedPosition();
590 virtual void SetFont( const wxFont
& font
, const wxColour
& foreground
, long windowStyle
);
591 virtual void SetBackground( const wxBrush
&brush
);
592 virtual ControlPartCode
HandleKey( SInt16 keyCode
, SInt16 charCode
, EventModifiers modifiers
);
593 void SetActionProc( ControlActionUPP actionProc
);
594 void SetViewSize( SInt32 viewSize
);
595 SInt32
GetViewSize() const;
597 virtual bool IsVisible() const;
598 virtual void SetVisibility( bool visible
, bool redraw
);
599 virtual bool IsEnabled() const;
600 virtual bool IsActive() const;
601 virtual void Enable( bool enable
);
603 // invalidates this control and all children
604 virtual void InvalidateWithChildren();
605 virtual void SetDrawingEnabled( bool enable
);
607 virtual bool GetNeedsDisplay() const;
609 // where is in native window relative coordinates
610 virtual void SetNeedsDisplay( RgnHandle where
);
611 // where is in native window relative coordinates
612 virtual void SetNeedsDisplay( Rect
* where
= NULL
);
614 // if rect = NULL, entire view
615 virtual void ScrollRect( wxRect
*rect
, int dx
, int dy
);
617 // in native parent window relative coordinates
618 virtual void GetRect( Rect
*r
);
620 // in native parent window relative coordinates
621 virtual void SetRect( Rect
*r
);
623 virtual void GetRectInWindowCoords( Rect
*r
);
624 virtual void GetBestRect( Rect
*r
);
625 virtual void SetLabel( const wxString
&title
);
626 // converts from Toplevel-Content relative to local
627 static void Convert( wxPoint
*pt
, wxMacControl
*convert
, wxMacControl
*to
);
629 virtual void GetFeatures( UInt32
*features
);
630 virtual OSStatus
GetRegion( ControlPartCode partCode
, RgnHandle region
);
631 virtual OSStatus
SetZOrder( bool above
, wxMacControl
* other
);
633 bool IsCompositing() { return m_isCompositing
; }
634 bool IsRootControl() { return m_isRootControl
; }
636 wxWindow
* GetPeer() const
641 // to be moved into a tab control class
643 virtual OSStatus
SetTabEnabled( SInt16 tabNo
, bool enable
);
645 ControlRef m_controlRef
;
649 bool m_needsFocusRect
;
650 bool m_isCompositing
;
651 bool m_isRootControl
;
654 // ============================================================================
655 // DataBrowser Wrapper
656 // ============================================================================
658 // basing on DataBrowserItemIDs
661 class wxMacDataBrowserControl
: public wxMacControl
664 wxMacDataBrowserControl( wxWindow
* peer
, const wxPoint
& pos
, const wxSize
& size
, long style
);
666 OSStatus
SetCallbacks( const DataBrowserCallbacks
*callbacks
);
668 OSStatus
GetItemCount( DataBrowserItemID container
,
670 DataBrowserItemState state
,
671 UInt32
*numItems
) const;
673 OSStatus
GetItems( DataBrowserItemID container
,
675 DataBrowserItemState state
,
679 OSStatus
AddColumn( DataBrowserListViewColumnDesc
*columnDesc
,
680 DataBrowserTableViewColumnIndex position
);
682 OSStatus
AutoSizeColumns();
684 OSStatus
SetHasScrollBars( bool horiz
, bool vert
);
685 OSStatus
SetHiliteStyle( DataBrowserTableViewHiliteStyle hiliteStyle
);
687 OSStatus
SetHeaderButtonHeight( UInt16 height
);
688 OSStatus
GetHeaderButtonHeight( UInt16
*height
);
690 OSStatus
UpdateItems( DataBrowserItemID container
, UInt32 numItems
,
691 const DataBrowserItemID
*items
,
692 DataBrowserPropertyID preSortProperty
,
693 DataBrowserPropertyID propertyID
) const;
695 OSStatus
AddItems( DataBrowserItemID container
, UInt32 numItems
,
696 const DataBrowserItemID
*items
,
697 DataBrowserPropertyID preSortProperty
);
698 OSStatus
RemoveItems( DataBrowserItemID container
, UInt32 numItems
,
699 const DataBrowserItemID
*items
,
700 DataBrowserPropertyID preSortProperty
);
701 OSStatus
RevealItem( DataBrowserItemID item
,
702 DataBrowserPropertyID propertyID
,
703 DataBrowserRevealOptions options
) const;
705 OSStatus
SetSelectionFlags( DataBrowserSelectionFlags
);
706 OSStatus
GetSelectionAnchor( DataBrowserItemID
*first
, DataBrowserItemID
*last
) const;
707 bool IsItemSelected( DataBrowserItemID item
) const;
708 OSStatus
SetSelectedItems( UInt32 numItems
,
709 const DataBrowserItemID
*items
,
710 DataBrowserSetOption operation
);
712 OSStatus
GetItemID( DataBrowserTableViewRowIndex row
,
713 DataBrowserItemID
* item
) const;
714 OSStatus
GetItemRow( DataBrowserItemID item
,
715 DataBrowserTableViewRowIndex
* row
) const;
717 OSStatus
SetDefaultRowHeight( UInt16 height
);
718 OSStatus
GetDefaultRowHeight( UInt16
* height
) const;
720 OSStatus
SetRowHeight( DataBrowserItemID item
, UInt16 height
);
721 OSStatus
GetRowHeight( DataBrowserItemID item
, UInt16
*height
) const;
723 OSStatus
GetColumnWidth( DataBrowserPropertyID column
, UInt16
*width
) const;
724 OSStatus
SetColumnWidth( DataBrowserPropertyID column
, UInt16 width
);
726 OSStatus
GetDefaultColumnWidth( UInt16
*width
) const;
727 OSStatus
SetDefaultColumnWidth( UInt16 width
);
729 OSStatus
GetColumnCount( UInt32
* numColumns
) const;
731 OSStatus
GetColumnPosition( DataBrowserPropertyID column
, UInt32
*position
) const;
732 OSStatus
SetColumnPosition( DataBrowserPropertyID column
, UInt32 position
);
734 OSStatus
GetScrollPosition( UInt32
*top
, UInt32
*left
) const;
735 OSStatus
SetScrollPosition( UInt32 top
, UInt32 left
);
737 OSStatus
GetSortProperty( DataBrowserPropertyID
*column
) const;
738 OSStatus
SetSortProperty( DataBrowserPropertyID column
);
740 OSStatus
GetSortOrder( DataBrowserSortOrder
*order
) const;
741 OSStatus
SetSortOrder( DataBrowserSortOrder order
);
743 OSStatus
GetPropertyFlags( DataBrowserPropertyID property
, DataBrowserPropertyFlags
*flags
) const;
744 OSStatus
SetPropertyFlags( DataBrowserPropertyID property
, DataBrowserPropertyFlags flags
);
746 OSStatus
GetHeaderDesc( DataBrowserPropertyID property
, DataBrowserListViewHeaderDesc
*desc
) const;
747 OSStatus
SetHeaderDesc( DataBrowserPropertyID property
, DataBrowserListViewHeaderDesc
*desc
);
749 OSStatus
SetDisclosureColumn( DataBrowserPropertyID property
, Boolean expandableRows
);
752 static pascal void DataBrowserItemNotificationProc(
754 DataBrowserItemID itemID
,
755 DataBrowserItemNotification message
,
756 DataBrowserItemDataRef itemData
);
758 virtual void ItemNotification(
759 DataBrowserItemID itemID
,
760 DataBrowserItemNotification message
,
761 DataBrowserItemDataRef itemData
) = 0;
763 static pascal OSStatus
DataBrowserGetSetItemDataProc(
765 DataBrowserItemID itemID
,
766 DataBrowserPropertyID property
,
767 DataBrowserItemDataRef itemData
,
768 Boolean changeValue
);
770 virtual OSStatus
GetSetItemData(
771 DataBrowserItemID itemID
,
772 DataBrowserPropertyID property
,
773 DataBrowserItemDataRef itemData
,
774 Boolean changeValue
) = 0;
776 static pascal Boolean
DataBrowserCompareProc(
778 DataBrowserItemID itemOneID
,
779 DataBrowserItemID itemTwoID
,
780 DataBrowserPropertyID sortProperty
);
782 virtual Boolean
CompareItems(DataBrowserItemID itemOneID
,
783 DataBrowserItemID itemTwoID
,
784 DataBrowserPropertyID sortProperty
) = 0;
787 // ============================================================================
788 // Higher-level Databrowser
789 // ============================================================================
791 // basing on data item objects
796 class wxMacDataItemBrowserControl
;
798 // base class for databrowser items
804 virtual ~wxMacDataItem();
806 virtual bool IsLessThan(wxMacDataItemBrowserControl
*owner
,
807 const wxMacDataItem
*,
808 DataBrowserPropertyID property
) const;
810 // returns true if access was successful, otherwise false
811 virtual OSStatus
GetSetData(wxMacDataItemBrowserControl
*owner
,
812 DataBrowserPropertyID property
,
813 DataBrowserItemDataRef itemData
,
816 virtual void Notification(wxMacDataItemBrowserControl
*owner
,
817 DataBrowserItemNotification message
,
818 DataBrowserItemDataRef itemData
) const;
821 typedef wxMacDataItem
* wxMacDataItemPtr
;
822 const wxMacDataItemPtr wxMacDataBrowserRootContainer
= NULL
;
824 WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxMacDataItemPtr
, wxArrayMacDataItemPtr
, class WXDLLIMPEXP_CORE
);
826 class wxMacDataItemBrowserControl
: public wxMacDataBrowserControl
829 wxMacDataItemBrowserControl( wxWindow
* peer
, const wxPoint
& pos
, const wxSize
& size
, long style
);
831 unsigned int GetItemCount(const wxMacDataItem
* container
, bool recurse
, DataBrowserItemState state
) const;
832 void GetItems(const wxMacDataItem
* container
, bool recurse
,
833 DataBrowserItemState state
, wxArrayMacDataItemPtr
&items
) const;
835 unsigned int GetLineFromItem(const wxMacDataItem
*item
) const;
836 wxMacDataItem
* GetItemFromLine(unsigned int n
) const;
838 void UpdateItem(const wxMacDataItem
*container
, const wxMacDataItem
*item
,
839 DataBrowserPropertyID property
) const;
840 void UpdateItems(const wxMacDataItem
*container
, wxArrayMacDataItemPtr
&items
,
841 DataBrowserPropertyID property
) const;
843 void AddItem(wxMacDataItem
*container
, wxMacDataItem
*item
);
844 void AddItems(wxMacDataItem
*container
, wxArrayMacDataItemPtr
&items
);
846 void RemoveAllItems(wxMacDataItem
*container
);
847 void RemoveItem(wxMacDataItem
*container
, wxMacDataItem
* item
);
848 void RemoveItems(wxMacDataItem
*container
, wxArrayMacDataItemPtr
&items
);
850 void SetSelectedItem( wxMacDataItem
* item
, DataBrowserSetOption option
);
851 void SetSelectedItems( wxArrayMacDataItemPtr
&items
, DataBrowserSetOption option
);
852 void SetSelectedAllItems( DataBrowserSetOption option
);
853 Boolean
IsItemSelected( const wxMacDataItem
* item
) const;
855 void RevealItem( wxMacDataItem
* item
, DataBrowserRevealOptions options
);
857 void GetSelectionAnchor( wxMacDataItemPtr
* first
, wxMacDataItemPtr
* last
) const;
859 // item aware methods, to be used in subclasses
861 virtual Boolean
CompareItems(const wxMacDataItem
* itemOneID
,
862 const wxMacDataItem
* itemTwoID
,
863 DataBrowserPropertyID sortProperty
);
865 virtual OSStatus
GetSetItemData(wxMacDataItem
* itemID
,
866 DataBrowserPropertyID property
,
867 DataBrowserItemDataRef itemData
,
868 Boolean changeValue
);
870 virtual void ItemNotification(
871 const wxMacDataItem
* itemID
,
872 DataBrowserItemNotification message
,
873 DataBrowserItemDataRef itemData
);
875 // as we are getting the same events for human and API selection we have to suppress
876 // events in the latter case, since this will be used from many subclasses we keep it here
878 bool IsSelectionSuppressed() const { return m_suppressSelection
; }
879 bool SuppressSelection( bool suppress
);
882 // ID aware base methods, should be 'final' ie not changed in subclasses
884 virtual Boolean
CompareItems(DataBrowserItemID itemOneID
,
885 DataBrowserItemID itemTwoID
,
886 DataBrowserPropertyID sortProperty
);
888 virtual OSStatus
GetSetItemData(DataBrowserItemID itemID
,
889 DataBrowserPropertyID property
,
890 DataBrowserItemDataRef itemData
,
891 Boolean changeValue
);
893 virtual void ItemNotification(
894 DataBrowserItemID itemID
,
895 DataBrowserItemNotification message
,
896 DataBrowserItemDataRef itemData
);
900 bool m_suppressSelection
;
903 class wxMacDataItemBrowserSelectionSuppressor
906 wxMacDataItemBrowserSelectionSuppressor(wxMacDataItemBrowserControl
*browser
);
907 ~wxMacDataItemBrowserSelectionSuppressor();
912 wxMacDataItemBrowserControl
* m_browser
;
915 // ============================================================================
916 // platform listbox implementation
917 // ============================================================================
919 // exposed for reuse in wxCheckListBox
921 class wxMacListBoxItem
: public wxMacDataItem
926 virtual ~wxMacListBoxItem();
928 void SetLabel( const wxString
& str
);
929 const wxString
& GetLabel() const;
931 virtual bool IsLessThan(wxMacDataItemBrowserControl
*owner
,
932 const wxMacDataItem
* rhs
,
933 DataBrowserPropertyID sortProperty
) const;
935 virtual OSStatus
GetSetData( wxMacDataItemBrowserControl
*owner
,
936 DataBrowserPropertyID property
,
937 DataBrowserItemDataRef itemData
,
940 virtual void Notification(wxMacDataItemBrowserControl
*owner
,
941 DataBrowserItemNotification message
,
942 DataBrowserItemDataRef itemData
) const;
944 void SetOrder( SInt32 order
);
945 SInt32
GetOrder() const;
947 void SetData( void* data
);
948 void* GetData() const;
952 wxMacCFStringHolder m_cfLabel
;
957 class wxMacDataBrowserListControl
: public wxMacDataItemBrowserControl
, public wxMacListControl
960 wxMacDataBrowserListControl( wxListBox
*peer
, const wxPoint
& pos
, const wxSize
& size
, long style
);
961 ~wxMacDataBrowserListControl();
963 // create a list item (can be a subclass of wxMacListBoxItem)
965 virtual wxMacListBoxItem
* CreateItem();
969 void MacDelete( unsigned int n
);
970 void MacInsert( unsigned int n
, const wxString
& item
);
971 void MacInsert( unsigned int n
, const wxArrayString
& items
);
972 int MacAppend( const wxString
& item
);
977 void MacDeselectAll();
978 void MacSetSelection( unsigned int n
, bool select
);
979 int MacGetSelection() const;
980 int MacGetSelections( wxArrayInt
& aSelections
) const;
981 bool MacIsSelected( unsigned int n
) const;
985 void MacScrollTo( unsigned int n
);
989 void MacSetString( unsigned int n
, const wxString
& item
);
990 void MacSetClientData( unsigned int n
, void * data
);
991 wxString
MacGetString( unsigned int n
) const;
992 void * MacGetClientData( unsigned int) const;
993 unsigned int MacGetCount() const;
997 wxClientDataType
GetClientDataType() const;
998 void SetClientDataType(wxClientDataType clientDataItemsType
);
1002 wxListBox
* GetPeer() const;
1004 bool m_stringSorted
;
1005 wxClientDataType m_clientDataItemsType
;
1008 // ============================================================================
1009 // graphics implementation
1010 // ============================================================================
1012 #if wxMAC_USE_CORE_GRAPHICS
1014 class WXDLLEXPORT wxMacCGPath
: public wxGraphicPath
1016 DECLARE_NO_COPY_CLASS(wxMacCGPath
)
1021 // Starts a new subpath at
1022 void MoveToPoint( wxCoord x1
, wxCoord y1
);
1023 void AddLineToPoint( wxCoord x1
, wxCoord y1
);
1024 void AddQuadCurveToPoint( wxCoord cx1
, wxCoord cy1
, wxCoord x1
, wxCoord y1
);
1025 void AddRectangle( wxCoord x
, wxCoord y
, wxCoord w
, wxCoord h
);
1026 void AddCircle( wxCoord x
, wxCoord y
, wxCoord r
);
1028 // closes the current subpath
1029 void CloseSubpath();
1031 CGPathRef
GetPath() const;
1033 CGMutablePathRef m_path
;
1036 class WXDLLEXPORT wxMacCGContext
: public wxGraphicContext
1038 DECLARE_NO_COPY_CLASS(wxMacCGContext
)
1041 wxMacCGContext( CGrafPtr port
);
1042 wxMacCGContext( CGContextRef cgcontext
);
1046 virtual void Clip( const wxRegion
®ion
);
1047 virtual void StrokePath( const wxGraphicPath
*p
);
1048 virtual void DrawPath( const wxGraphicPath
*p
, int fillStyle
= wxWINDING_RULE
);
1049 virtual void FillPath( const wxGraphicPath
*p
, const wxColor
&fillColor
, int fillStyle
= wxWINDING_RULE
);
1051 virtual wxGraphicPath
* CreatePath();
1052 virtual void SetPen( const wxPen
&pen
) ;
1053 virtual void SetBrush( const wxBrush
&brush
);
1054 CGContextRef
GetNativeContext();
1055 void SetNativeContext( CGContextRef cg
);
1056 CGPathDrawingMode
GetDrawingMode() const { return m_mode
; }
1058 CGContextRef m_cgContext
;
1060 CGPathDrawingMode m_mode
;
1065 #endif // wxMAC_USE_CORE_GRAPHICS
1067 #ifdef __WXMAC_OSX__
1069 CGColorSpaceRef
wxMacGetGenericRGBColorSpace(void);
1070 void wxMacMemoryBufferReleaseProc(void *info
, const void *data
, size_t size
);
1074 class WXDLLEXPORT wxBitmapRefData
: public wxGDIRefData
1076 DECLARE_NO_COPY_CLASS(wxBitmapRefData
)
1078 friend class WXDLLEXPORT wxIcon
;
1079 friend class WXDLLEXPORT wxCursor
;
1081 wxBitmapRefData(int width
, int height
, int depth
);
1086 bool Ok() const { return m_ok
; }
1087 void SetOk( bool isOk
) { m_ok
= isOk
; }
1089 void SetWidth( int width
) { m_width
= width
; }
1090 void SetHeight( int height
) { m_height
= height
; }
1091 void SetDepth( int depth
) { m_depth
= depth
; }
1093 int GetWidth() const { return m_width
; }
1094 int GetHeight() const { return m_height
; }
1095 int GetDepth() const { return m_depth
; }
1097 void *GetRawAccess() const;
1098 void *BeginRawAccess();
1099 void EndRawAccess();
1101 bool HasAlpha() const { return m_hasAlpha
; }
1102 void UseAlpha( bool useAlpha
);
1106 wxPalette m_bitmapPalette
;
1107 #endif // wxUSE_PALETTE
1109 wxMask
* m_bitmapMask
; // Optional mask
1110 #ifdef __WXMAC_OSX__
1111 CGImageRef
CGImageCreate() const;
1114 // returns true if the bitmap has a size that
1115 // can be natively transferred into a true icon
1116 // if no is returned GetIconRef will still produce
1117 // an icon but it will be generated via a PICT and
1118 // rescaled to 16 x 16
1119 bool HasNativeSize();
1121 // caller should increase ref count if needed longer
1122 // than the bitmap exists
1123 IconRef
GetIconRef();
1125 // returns a Pict from the bitmap content
1126 PicHandle
GetPictHandle();
1127 GWorldPtr
GetHBITMAP(GWorldPtr
* mask
= NULL
) const;
1128 void UpdateAlphaMask() const;
1131 bool Create(int width
, int height
, int depth
);
1139 wxMemoryBuffer m_memBuf
;
1140 int m_rawAccessCount
;
1142 #ifdef __WXMAC_OSX__
1143 mutable CGImageRef m_cgImageRef
;
1146 PicHandle m_pictHandle
;
1147 GWorldPtr m_hBitmap
;
1148 GWorldPtr m_hMaskBitmap
;
1149 wxMemoryBuffer m_maskMemBuf
;
1150 int m_maskBytesPerRow
;
1153 class WXDLLEXPORT wxIconRefData
: public wxGDIRefData
1157 wxIconRefData( WXHICON
);
1158 virtual ~wxIconRefData() { Free(); }
1161 virtual void Free();
1163 void SetWidth( int width
) { m_width
= width
; }
1164 void SetHeight( int height
) { m_height
= height
; }
1166 int GetWidth() const { return m_width
; }
1167 int GetHeight() const { return m_height
; }
1169 WXHICON
GetHICON() const { return (WXHICON
) m_iconRef
; }
1178 ControlRef
wxMacFindControlUnderMouse( wxTopLevelWindowMac
* toplevelWindow
, const Point
& location
, WindowRef window
, ControlPartCode
*outPart
);
1180 #ifdef WORDS_BIGENDIAN
1181 inline Rect
* wxMacGetPictureBounds( PicHandle pict
, Rect
* rect
)
1183 *rect
= (**pict
).picFrame
;
1187 inline Rect
* wxMacGetPictureBounds( PicHandle pict
, Rect
* rect
)
1189 return QDGetPictureBounds( pict
, rect
);
1195 #define wxMAC_DEFINE_PROC_GETTER( UPP , x ) \
1198 static UPP sHandler = NULL; \
1199 if ( sHandler == NULL ) \
1200 sHandler = New##UPP( x ); \
1204 //---------------------------------------------------------------------------
1205 // wxMac string conversions
1206 //---------------------------------------------------------------------------
1208 void wxMacSetupConverters();
1209 void wxMacCleanupConverters();
1211 void wxMacStringToPascal( const wxString
&from
, StringPtr to
);
1212 wxString
wxMacMakeStringFromPascal( ConstStringPtr from
);
1216 wxString
wxMacFSRefToPath( const FSRef
*fsRef
, CFStringRef additionalPathComponent
= NULL
);
1217 OSStatus
wxMacPathToFSRef( const wxString
&path
, FSRef
*fsRef
);
1218 wxString
wxMacHFSUniStrToString( ConstHFSUniStr255Param uniname
);