[wxWidgets.git] / include / wx / mac / carbon / private.h

/////////////////////////////////////////////////////////////////////////////
// Name:        private.h
// Purpose:     Private declarations: as this header is only included by
//              wxWidgets itself, it may contain identifiers which don't start
//              with "wx".
// Author:      Stefan Csomor
// Modified by:
// Created:     1998-01-01
// RCS-ID:      $Id$
// Copyright:   (c) Stefan Csomor
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_PRIVATE_H_
#define _WX_PRIVATE_H_

#include "wx/defs.h"
#include "wx/app.h"

#ifdef __DARWIN__
#    include <Carbon/Carbon.h>
#else
#    include <Debugging.h>
#    include <Quickdraw.h>
#    include <Appearance.h>
#    include <Folders.h>
#    include <Controls.h>
#    include <ControlDefinitions.h>
#    include <LowMem.h>
#    include <Gestalt.h>
#endif

#if UNIVERSAL_INTERFACES_VERSION < 0x0340
    #error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
#endif

#ifndef MAC_OS_X_VERSION_10_3
    #define MAC_OS_X_VERSION_10_3 1030
#endif

#ifdef __WXMAC_CARBON__
#include "wx/mac/corefoundation/cfstring.h"
#endif

#if wxUSE_GUI

#include "wx/window.h"

class wxMacPortStateHelper 
{
    DECLARE_NO_COPY_CLASS(wxMacPortStateHelper)
        
public:
    wxMacPortStateHelper( GrafPtr newport) ; 
    wxMacPortStateHelper() ;
    ~wxMacPortStateHelper() ;

    void Setup( GrafPtr newport ) ;
    void Clear() ;
    bool IsCleared() { return m_clip == NULL ; }
    GrafPtr GetCurrentPort() { return m_currentPort ; }

private:
    GrafPtr          m_currentPort ;
    GrafPtr          m_oldPort ;
    RgnHandle          m_clip ;
    ThemeDrawingState m_drawingState ;
    short          m_textFont ;
    short          m_textSize ;
    short          m_textStyle ;
    short           m_textMode ;
} ;

class WXDLLEXPORT wxMacPortSaver
{
    DECLARE_NO_COPY_CLASS(wxMacPortSaver)
        
public:
    wxMacPortSaver( GrafPtr port ) 
    {
        ::GetPort( &m_port ) ;
        ::SetPort( port ) ;
    }
    ~wxMacPortSaver()
    {
        ::SetPort( m_port ) ;
    }
private :
    GrafPtr m_port ;
} ;

class WXDLLEXPORT wxMacPortSetter
{
    DECLARE_NO_COPY_CLASS(wxMacPortSetter)
        
public:
    wxMacPortSetter( const wxDC* dc ) ;
    ~wxMacPortSetter() ;
private:
    wxMacPortStateHelper m_ph ;
    const wxDC* m_dc ;
} ;

/*
 Clips to the visible region of a control within the current port
 */
 
class WXDLLEXPORT wxMacWindowClipper : public wxMacPortSaver
{
    DECLARE_NO_COPY_CLASS(wxMacWindowClipper)
        
public:
    wxMacWindowClipper( const wxWindow* win ) ;
    ~wxMacWindowClipper() ;
private:
    GrafPtr   m_newPort ;
    RgnHandle m_formerClip ;
    RgnHandle m_newClip ;
} ;

class WXDLLEXPORT wxMacWindowStateSaver : public wxMacWindowClipper
{
    DECLARE_NO_COPY_CLASS(wxMacWindowStateSaver)
        
public:
    wxMacWindowStateSaver( const wxWindow* win ) ;
    ~wxMacWindowStateSaver() ;
private:
    GrafPtr   m_newPort ;
    ThemeDrawingState m_themeDrawingState ;
} ;

/*
class wxMacDrawingHelper
{
    DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
        
public:
    wxMacDrawingHelper( wxWindowMac * theWindow , bool clientArea = false ) ;
    ~wxMacDrawingHelper() ;
    bool Ok() { return m_ok ; }
    void LocalToWindow( Rect *rect) { OffsetRect( rect , m_origin.h , m_origin.v ) ; }
    void LocalToWindow( Point *pt ) { AddPt( m_origin , pt ) ; }
    void LocalToWindow( RgnHandle rgn ) { OffsetRgn( rgn , m_origin.h , m_origin.v ) ; }
    const Point& GetOrigin() { return m_origin ; }
private:
    Point     m_origin ;
    GrafPtr   m_formerPort ;
    GrafPtr   m_currentPort ;
    PenState  m_savedPenState ;
    bool      m_ok ;
} ;
*/

// app.h
bool wxMacConvertEventToRecord( EventRef event , EventRecord *rec) ;

#endif // wxUSE_GUI

// filefn.h
WXDLLEXPORT wxString wxMacFSSpec2MacFilename( const FSSpec *spec ) ;
WXDLLEXPORT void wxMacFilename2FSSpec( const wxString &path , FSSpec *spec ) ;

// utils.h
WXDLLEXPORT wxString wxMacFindFolder(short vRefNum,
                                     OSType folderType,
                                     Boolean createFolder);

#if wxUSE_GUI

GWorldPtr         wxMacCreateGWorld( int width , int height , int depth ) ;
void                 wxMacDestroyGWorld( GWorldPtr gw ) ;
PicHandle         wxMacCreatePict( GWorldPtr gw , GWorldPtr mask = NULL ) ;
CIconHandle     wxMacCreateCIcon(GWorldPtr image , GWorldPtr mask , short dstDepth , short iconSize  ) ;
void                 wxMacSetColorTableEntry( CTabHandle newColors , int index , int red , int green ,  int blue ) ;
CTabHandle         wxMacCreateColorTable( int numColors ) ;
void wxMacCreateBitmapButton( ControlButtonContentInfo*info , const wxBitmap& bitmap , int forceType = 0 ) ;

#define MAC_WXCOLORREF(a) (*((RGBColor*)&(a)))
#define MAC_WXHBITMAP(a) (GWorldPtr(a))
#define MAC_WXHMETAFILE(a) (PicHandle(a))
#define MAC_WXHICON(a) (CIconHandle(a))
#define MAC_WXHCURSOR(a) (CursHandle(a))
#define MAC_WXHRGN(a) (RgnHandle(a))
#define MAC_WXHWND(a) (WindowPtr(a))
#define MAC_WXRECPTR(a) ((Rect*)a)
#define MAC_WXPOINTPTR(a) ((Point*)a)
#define MAC_WXHMENU(a) ((MenuHandle)a)

struct wxOpaqueWindowRef
{
    wxOpaqueWindowRef( WindowRef ref ) { m_data = ref ; }
    operator WindowRef() { return m_data ; } 
private :
    WindowRef m_data ;
} ;

wxWindow *              wxFindControlFromMacControl(ControlRef inControl ) ;
wxTopLevelWindowMac*    wxFindWinFromMacWindow( WindowRef inWindow ) ;
wxMenu*                 wxFindMenuFromMacMenu(MenuRef inMenuRef) ;

extern wxWindow* g_MacLastWindow ;
pascal OSStatus wxMacTopLevelMouseEventHandler( EventHandlerCallRef handler , EventRef event , void *data ) ;
Rect wxMacGetBoundsForControl( wxWindow* window , const wxPoint& pos , const wxSize &size , bool adjustForOrigin = true ) ;

template<typename T> EventParamType wxMacGetEventParamType() { wxFAIL_MSG( wxT("Unknown Param Type") ) ; return 0 ; }
template<> inline EventParamType wxMacGetEventParamType<RgnHandle>() { return typeQDRgnHandle ; }
template<> inline EventParamType wxMacGetEventParamType<ControlRef>() { return typeControlRef ; }
template<> inline EventParamType wxMacGetEventParamType<WindowRef>() { return typeWindowRef ; }
template<> inline EventParamType wxMacGetEventParamType<MenuRef>() { return typeMenuRef ; }
template<> inline EventParamType wxMacGetEventParamType<EventRef>() { return typeEventRef ; }
template<> inline EventParamType wxMacGetEventParamType<Point>() { return typeQDPoint ; }
template<> inline EventParamType wxMacGetEventParamType<Rect>() { return typeQDRectangle ; }
template<> inline EventParamType wxMacGetEventParamType<Boolean>() { return typeBoolean ; }
#if TARGET_API_MAC_OSX
template<> inline EventParamType wxMacGetEventParamType<HICommand>() { return typeHICommand ; }
template<> inline EventParamType wxMacGetEventParamType<HIPoint>() { return typeHIPoint ; }
template<> inline EventParamType wxMacGetEventParamType<HISize>() { return typeHISize ; }
template<> inline EventParamType wxMacGetEventParamType<HIRect>() { return typeHIRect ; }
template<> inline EventParamType wxMacGetEventParamType<void*>() { return typeVoidPtr ; }
#endif
template<> inline EventParamType wxMacGetEventParamType<Collection>() { return typeCollection ; }
template<> inline EventParamType wxMacGetEventParamType<CGContextRef>() { return typeCGContextRef ; }
/*
These are ambiguous
template<> EventParamType wxMacGetEventParamType<GrafPtr>() { return typeGrafPtr ; }
template<> EventParamType wxMacGetEventParamType<OSStatus>() { return typeOSStatus ; }
template<> EventParamType wxMacGetEventParamType<CFIndex>() { return typeCFIndex ; }
template<> EventParamType wxMacGetEventParamType<GWorldPtr>() { return typeGWorldPtr ; }
*/

class wxMacCarbonEvent
{
    
public :
    wxMacCarbonEvent( EventRef event , bool release = false ) 
    {
        m_eventRef = event ;
        m_release = release ;
    }
    wxMacCarbonEvent(UInt32 inClassID,UInt32 inKind,EventTime inWhen = 0 /*now*/,EventAttributes inAttributes=kEventAttributeNone) 
    {
        m_eventRef = NULL ;
        verify_noerr( MacCreateEvent( NULL , inClassID, inKind,inWhen,inAttributes,&m_eventRef) ) ;
        m_release = true ;
    }
    ~wxMacCarbonEvent()
    {
        if ( m_release )
            ReleaseEvent( m_eventRef ) ;
    }
    
    OSStatus GetParameter( EventParamName inName, EventParamType inDesiredType, UInt32 inBufferSize, void * outData) ;
    
    template <typename T> OSStatus GetParameter( EventParamName inName, EventParamType type , T *data )
    {
        return GetParameter( inName, type , sizeof( T ) , data ) ;
    }
    template <typename T> OSStatus GetParameter( EventParamName inName, T *data )
    {
        return GetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
    }
    
    template <typename T> T GetParameter( EventParamName inName )
    {
        T value ;
        verify_noerr( GetParameter<T>( inName, &value ) ) ;
        return value ;
    }
    template <typename T> T GetParameter( EventParamName inName, EventParamType inDesiredType )
    {
        T value ;
        verify_noerr( GetParameter<T>( inName, inDesiredType , &value ) ) ;
        return value ;
    }

    OSStatus SetParameter( EventParamName inName, EventParamType inType, UInt32 inSize, const void * inData) ;
    template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T *data )
    {
        return SetParameter( inName, inDesiredType , sizeof( T ) , data ) ;
    }
    template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T& data )
    {
        return SetParameter<T>( inName, inDesiredType , &data ) ;
    }
    template <typename T> OSStatus SetParameter( EventParamName inName, const T *data )
    {
        return SetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
    }
    template <typename T> OSStatus SetParameter( EventParamName inName, const T& data )
    {
        return SetParameter<T>( inName, wxMacGetEventParamType<T>() , &data ) ;
    }
    UInt32 GetClass()
    {
        return ::GetEventClass( m_eventRef ) ;
    }
    UInt32 GetKind()
    {
        return ::GetEventKind( m_eventRef ) ;
    }
    EventTime GetTime()
    {
        return ::GetEventTime( m_eventRef ) ;
    }
    UInt32 GetTicks()
    {
        return EventTimeToTicks( GetTime() ) ;
    }
    operator EventRef () { return m_eventRef; }   
protected :
    EventRef m_eventRef ;
    bool     m_release ;
} ;

class wxMacControl
{
public :
    wxMacControl()
    {
        m_controlRef = NULL ;
    }
    
    wxMacControl( ControlRef control ) 
    {
        m_controlRef = control ;
    }
    wxMacControl( WXWidget control )
    {
        m_controlRef = (ControlRef) control ;
    }
    virtual ~wxMacControl()
    {
    }
    
    virtual void Dispose() ;

    bool Ok() const { return GetControlRef() != NULL ; }
    
    virtual ControlRef * GetControlRefAddr() { return &m_controlRef; } 
    virtual ControlRef GetControlRef() const { return m_controlRef ; }  

    virtual void SetReference( SInt32 data ) ; 
    /*
    void operator= (ControlRef c) { m_controlRef = c ; }
    operator ControlRef () { return m_controlRef; }   
    operator ControlRef * () { return &m_controlRef; }   
    */
    // accessing data and values

    virtual OSStatus SetData( ControlPartCode inPartCode , ResType inTag , Size inSize , const void * inData ) ;
    virtual OSStatus GetData( ControlPartCode inPartCode , ResType inTag , Size inBufferSize , void * inOutBuffer , Size * outActualSize ) const ;
    virtual OSStatus GetDataSize( ControlPartCode inPartCode , ResType inTag , Size * outActualSize ) const ;
    virtual OSStatus SendEvent(  EventRef ref , OptionBits inOptions = 0 ) ;
    virtual OSStatus SendHICommand( HICommand &command , OptionBits inOptions = 0 ) ;

    virtual OSStatus SendHICommand( UInt32 commandID , OptionBits inOptions = 0 ) ;

    virtual SInt32 GetValue() const ;
    virtual SInt32 GetMaximum() const ;
    virtual SInt32 GetMinimum() const ;
    
    virtual void SetValue( SInt32 v ) ;
    virtual void SetMinimum( SInt32 v ) ;
    virtual void SetMaximum( SInt32 v ) ;

    virtual void SetValueAndRange( SInt32 value , SInt32 minimum , SInt32 maximum ) ;
    virtual void SetRange( SInt32 minimum , SInt32 maximum ) ;
    
    virtual OSStatus SetFocus( ControlFocusPart focusPart ) ;
    virtual bool HasFocus() const ;
    virtual bool NeedsFocusRect() const ;
    
    // templated helpers

    Size GetDataSize( ControlPartCode inPartCode , ResType inTag ) const
    {
        Size sz ;
        verify_noerr( GetDataSize( inPartCode , inTag , &sz ) ) ;
        return sz ;
    }
    template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T *data )
    {
        return SetData( inPartCode , inTag , sizeof( T ) , data ) ;
    }
    template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T& data )
    {
        return SetData( inPartCode , inTag , sizeof( T ) , &data ) ;
    }
    template <typename T> OSStatus GetData( ControlPartCode inPartCode , ResType inTag , T *data ) const
    {
        Size dummy ;
        return GetData( inPartCode , inTag , sizeof( T ) , data , &dummy ) ;
    }
    template <typename T> T GetData( ControlPartCode inPartCode , ResType inTag ) const
    {
        T value ;
        verify_noerr( GetData<T>( inPartCode , inTag , &value ) ) ;
        return value ;
    }
       
    // Flash the control for the specified amount of time
    virtual void Flash( ControlPartCode part , UInt32 ticks = 8 ) ;
    virtual void VisibilityChanged( bool shown ) ;
    virtual void SetFont( const wxFont & font , const wxColour& foreground , long windowStyle ) ;
    virtual void SetBackground( const wxBrush &brush ) ;
    virtual ControlPartCode HandleKey(  SInt16 keyCode,  SInt16 charCode, EventModifiers modifiers ) ;
    void SetActionProc( ControlActionUPP   actionProc ) ;
    void SetViewSize( SInt32 viewSize ) ;
    SInt32 GetViewSize() const ;
    
    virtual bool IsVisible() const ;
    virtual void SetVisibility( bool visible , bool redraw ) ;
    virtual bool IsEnabled() const ;
    virtual bool IsActive() const ;
    virtual void Enable( bool enable ) ;
    
    // invalidates this control and all children
    virtual void InvalidateWithChildren() ;
    virtual void SetDrawingEnabled( bool enable ) ;
    virtual bool GetNeedsDisplay() const ;
    virtual void SetNeedsDisplay( bool needsDisplay , RgnHandle where = NULL ) ;

    virtual void ScrollRect( const wxRect &rect , int dx , int dy ) ;

    virtual void GetRect( Rect *r ) ;
    virtual void SetRect( Rect *r ) ;
    virtual void GetRectInWindowCoords( Rect *r ) ;
    virtual void GetBestRect( Rect *r ) ;
    virtual void SetTitle( const wxString &title ) ;
    // converts from Toplevel-Content relative to local
    static void Convert( wxPoint *pt , wxMacControl *convert , wxMacControl *to ) ;
    
    virtual void GetFeatures( UInt32 *features ) ;
    virtual OSStatus GetRegion( ControlPartCode partCode , RgnHandle region ) ;
    virtual OSStatus SetZOrder( bool above , wxMacControl* other ) ;
    // to be moved into a databrowser subclass
    
    virtual OSStatus SetSelectionFlags( DataBrowserSelectionFlags ) ;
    virtual OSStatus AddListViewColumn( DataBrowserListViewColumnDesc *columnDesc,
        DataBrowserTableViewColumnIndex position ) ;
    virtual OSStatus AutoSizeListViewColumns() ;
    virtual OSStatus SetHasScrollBars( bool horiz , bool vert ) ;
    virtual OSStatus SetTableViewHiliteStyle( DataBrowserTableViewHiliteStyle hiliteStyle ) ;
    virtual OSStatus SetListViewHeaderBtnHeight(UInt16 height) ;
    virtual OSStatus SetCallbacks(const DataBrowserCallbacks *  callbacks) ;
    virtual OSStatus UpdateItems( DataBrowserItemID container, UInt32 numItems,
            const DataBrowserItemID* items,                
            DataBrowserPropertyID preSortProperty,
            DataBrowserPropertyID propertyID ) ;
    virtual OSStatus AddItems( DataBrowserItemID container, UInt32 numItems,
            const DataBrowserItemID* items,                
            DataBrowserPropertyID preSortProperty ) ;
    virtual OSStatus RemoveItems( DataBrowserItemID container, UInt32 numItems,
            const DataBrowserItemID* items,                
            DataBrowserPropertyID preSortProperty ) ;
    virtual OSStatus RevealItem( DataBrowserItemID item,
            DataBrowserPropertyID propertyID,
            DataBrowserRevealOptions options ) ;
    virtual OSStatus GetSelectionAnchor( DataBrowserItemID * first, DataBrowserItemID * last ) ;
    virtual bool IsItemSelected( DataBrowserItemID item ) ;
    virtual OSStatus SetSelectedItems(UInt32 numItems,
            const DataBrowserItemID * items,
            DataBrowserSetOption operation ) ;
            
    // to be moved into a tab control class
    
    virtual OSStatus SetTabEnabled( SInt16 tabNo , bool enable ) ;
protected :
    ControlRef  m_controlRef ;
    wxFont      m_font ;
    long        m_windowStyle ; 
} ;

#endif // wxUSE_GUI

//---------------------------------------------------------------------------
// wxMac string conversions
//---------------------------------------------------------------------------

void wxMacSetupConverters() ;
void wxMacCleanupConverters() ;

void wxMacStringToPascal( const wxString&from , StringPtr to ) ;
wxString wxMacMakeStringFromPascal( ConstStringPtr from ) ;

// toplevel.cpp

ControlRef wxMacFindControlUnderMouse( Point location , WindowRef window , ControlPartCode *outPart ) ;

// filefn.cpp

wxString wxMacFSRefToPath( const FSRef *fsRef , CFStringRef additionalPathComponent = NULL ) ;
OSStatus wxMacPathToFSRef( const wxString&path , FSRef *fsRef ) ;
wxString wxMacHFSUniStrToString( ConstHFSUniStr255Param uniname ) ;

#endif
    // _WX_PRIVATE_H_
Commit	Line	Data
8cf73271 SC	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: private.h
	3	// Purpose: Private declarations: as this header is only included by
77ffb593	4	// wxWidgets itself, it may contain identifiers which don't start
8cf73271 SC	5	// with "wx".
	6	// Author: Stefan Csomor
	7	// Modified by:
	8	// Created: 1998-01-01
	9	// RCS-ID: $Id$
	10	// Copyright: (c) Stefan Csomor
65571936	11	// Licence: wxWindows licence
8cf73271 SC	12	/////////////////////////////////////////////////////////////////////////////
	13
	14	#ifndef _WX_PRIVATE_H_
	15	#define _WX_PRIVATE_H_
	16
	17	#include "wx/defs.h"
	18	#include "wx/app.h"
	19
	20	#ifdef __DARWIN__
	21	# include <Carbon/Carbon.h>
	22	#else
4f305456	23	# include <Debugging.h>
8cf73271 SC	24	# include <Quickdraw.h>
	25	# include <Appearance.h>
	26	# include <Folders.h>
	27	# include <Controls.h>
	28	# include <ControlDefinitions.h>
	29	# include <LowMem.h>
	30	# include <Gestalt.h>
	31	#endif
	32
	33	#if UNIVERSAL_INTERFACES_VERSION < 0x0340
	34	#error "please update to Apple's lastest universal headers from http://developer.apple.com/sdk/"
	35	#endif
	36
c3a404b0 SC	37	#ifndef MAC_OS_X_VERSION_10_3
	38	#define MAC_OS_X_VERSION_10_3 1030
	39	#endif
	40
5185263f DE	41	#ifdef __WXMAC_CARBON__
	42	#include "wx/mac/corefoundation/cfstring.h"
	43	#endif
	44
8cf73271 SC	45	#if wxUSE_GUI
	46
	47	#include "wx/window.h"
	48
	49	class wxMacPortStateHelper
	50	{
	51	DECLARE_NO_COPY_CLASS(wxMacPortStateHelper)
	52
	53	public:
	54	wxMacPortStateHelper( GrafPtr newport) ;
	55	wxMacPortStateHelper() ;
	56	~wxMacPortStateHelper() ;
	57
	58	void Setup( GrafPtr newport ) ;
	59	void Clear() ;
	60	bool IsCleared() { return m_clip == NULL ; }
	61	GrafPtr GetCurrentPort() { return m_currentPort ; }
	62
	63	private:
	64	GrafPtr m_currentPort ;
	65	GrafPtr m_oldPort ;
	66	RgnHandle m_clip ;
	67	ThemeDrawingState m_drawingState ;
	68	short m_textFont ;
	69	short m_textSize ;
	70	short m_textStyle ;
	71	short m_textMode ;
	72	} ;
	73
4f305456 SC	74	class WXDLLEXPORT wxMacPortSaver
	75	{
	76	DECLARE_NO_COPY_CLASS(wxMacPortSaver)
	77
	78	public:
	79	wxMacPortSaver( GrafPtr port )
	80	{
	81	::GetPort( &m_port ) ;
	82	::SetPort( port ) ;
	83	}
	84	~wxMacPortSaver()
	85	{
	86	::SetPort( m_port ) ;
	87	}
	88	private :
	89	GrafPtr m_port ;
	90	} ;
	91
8cf73271 SC	92	class WXDLLEXPORT wxMacPortSetter
	93	{
	94	DECLARE_NO_COPY_CLASS(wxMacPortSetter)
	95
	96	public:
	97	wxMacPortSetter( const wxDC* dc ) ;
	98	~wxMacPortSetter() ;
	99	private:
	100	wxMacPortStateHelper m_ph ;
	101	const wxDC* m_dc ;
	102	} ;
	103
4f305456 SC	104	/*
	105	Clips to the visible region of a control within the current port
	106	*/
	107
	108	class WXDLLEXPORT wxMacWindowClipper : public wxMacPortSaver
8cf73271 SC	109	{
	110	DECLARE_NO_COPY_CLASS(wxMacWindowClipper)
	111
	112	public:
	113	wxMacWindowClipper( const wxWindow* win ) ;
	114	~wxMacWindowClipper() ;
	115	private:
01299d56	116	GrafPtr m_newPort ;
8cf73271 SC	117	RgnHandle m_formerClip ;
	118	RgnHandle m_newClip ;
	119	} ;
	120
01299d56 SC	121	class WXDLLEXPORT wxMacWindowStateSaver : public wxMacWindowClipper
	122	{
	123	DECLARE_NO_COPY_CLASS(wxMacWindowStateSaver)
	124
	125	public:
	126	wxMacWindowStateSaver( const wxWindow* win ) ;
	127	~wxMacWindowStateSaver() ;
	128	private:
	129	GrafPtr m_newPort ;
	130	ThemeDrawingState m_themeDrawingState ;
	131	} ;
	132
4f305456	133	/*
8cf73271 SC	134	class wxMacDrawingHelper
	135	{
	136	DECLARE_NO_COPY_CLASS(wxMacDrawingHelper)
	137
	138	public:
	139	wxMacDrawingHelper( wxWindowMac * theWindow , bool clientArea = false ) ;
	140	~wxMacDrawingHelper() ;
	141	bool Ok() { return m_ok ; }
	142	void LocalToWindow( Rect *rect) { OffsetRect( rect , m_origin.h , m_origin.v ) ; }
	143	void LocalToWindow( Point *pt ) { AddPt( m_origin , pt ) ; }
	144	void LocalToWindow( RgnHandle rgn ) { OffsetRgn( rgn , m_origin.h , m_origin.v ) ; }
	145	const Point& GetOrigin() { return m_origin ; }
	146	private:
	147	Point m_origin ;
	148	GrafPtr m_formerPort ;
	149	GrafPtr m_currentPort ;
	150	PenState m_savedPenState ;
	151	bool m_ok ;
	152	} ;
4f305456	153	*/
8cf73271 SC	154
	155	// app.h
	156	bool wxMacConvertEventToRecord( EventRef event , EventRecord *rec) ;
	157
	158	#endif // wxUSE_GUI
	159
	160	// filefn.h
	161	WXDLLEXPORT wxString wxMacFSSpec2MacFilename( const FSSpec *spec ) ;
a2b77260	162	WXDLLEXPORT void wxMacFilename2FSSpec( const wxString &path , FSSpec *spec ) ;
8cf73271 SC	163
	164	// utils.h
	165	WXDLLEXPORT wxString wxMacFindFolder(short vRefNum,
	166	OSType folderType,
	167	Boolean createFolder);
	168
	169	#if wxUSE_GUI
	170
	171	GWorldPtr wxMacCreateGWorld( int width , int height , int depth ) ;
	172	void wxMacDestroyGWorld( GWorldPtr gw ) ;
	173	PicHandle wxMacCreatePict( GWorldPtr gw , GWorldPtr mask = NULL ) ;
	174	CIconHandle wxMacCreateCIcon(GWorldPtr image , GWorldPtr mask , short dstDepth , short iconSize ) ;
	175	void wxMacSetColorTableEntry( CTabHandle newColors , int index , int red , int green , int blue ) ;
	176	CTabHandle wxMacCreateColorTable( int numColors ) ;
	177	void wxMacCreateBitmapButton( ControlButtonContentInfo*info , const wxBitmap& bitmap , int forceType = 0 ) ;
	178
	179	#define MAC_WXCOLORREF(a) (((RGBColor)&(a)))
	180	#define MAC_WXHBITMAP(a) (GWorldPtr(a))
	181	#define MAC_WXHMETAFILE(a) (PicHandle(a))
	182	#define MAC_WXHICON(a) (CIconHandle(a))
	183	#define MAC_WXHCURSOR(a) (CursHandle(a))
	184	#define MAC_WXHRGN(a) (RgnHandle(a))
	185	#define MAC_WXHWND(a) (WindowPtr(a))
	186	#define MAC_WXRECPTR(a) ((Rect*)a)
	187	#define MAC_WXPOINTPTR(a) ((Point*)a)
	188	#define MAC_WXHMENU(a) ((MenuHandle)a)
	189
4f305456 SC	190	struct wxOpaqueWindowRef
	191	{
	192	wxOpaqueWindowRef( WindowRef ref ) { m_data = ref ; }
	193	operator WindowRef() { return m_data ; }
	194	private :
	195	WindowRef m_data ;
	196	} ;
	197
41b53169 SC	198	wxWindow * wxFindControlFromMacControl(ControlRef inControl ) ;
	199	wxTopLevelWindowMac* wxFindWinFromMacWindow( WindowRef inWindow ) ;
	200	wxMenu* wxFindMenuFromMacMenu(MenuRef inMenuRef) ;
	201
4f305456 SC	202	extern wxWindow* g_MacLastWindow ;
4f305456 SC	203	pascal OSStatus wxMacTopLevelMouseEventHandler( EventHandlerCallRef handler , EventRef event , void *data ) ;
271cad4c	204	Rect wxMacGetBoundsForControl( wxWindow* window , const wxPoint& pos , const wxSize &size , bool adjustForOrigin = true ) ;
4f305456 SC	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	#if TARGET_API_MAC_OSX
6d4c54a7	216	template<> inline EventParamType wxMacGetEventParamType<HICommand>() { return typeHICommand ; }
4f305456 SC	217	template<> inline EventParamType wxMacGetEventParamType<HIPoint>() { return typeHIPoint ; }
	218	template<> inline EventParamType wxMacGetEventParamType<HISize>() { return typeHISize ; }
	219	template<> inline EventParamType wxMacGetEventParamType<HIRect>() { return typeHIRect ; }
	220	template<> inline EventParamType wxMacGetEventParamType<void*>() { return typeVoidPtr ; }
	221	#endif
	222	template<> inline EventParamType wxMacGetEventParamType<Collection>() { return typeCollection ; }
	223	template<> inline EventParamType wxMacGetEventParamType<CGContextRef>() { return typeCGContextRef ; }
	224	/*
	225	These are ambiguous
	226	template<> EventParamType wxMacGetEventParamType<GrafPtr>() { return typeGrafPtr ; }
	227	template<> EventParamType wxMacGetEventParamType<OSStatus>() { return typeOSStatus ; }
	228	template<> EventParamType wxMacGetEventParamType<CFIndex>() { return typeCFIndex ; }
	229	template<> EventParamType wxMacGetEventParamType<GWorldPtr>() { return typeGWorldPtr ; }
	230	*/
	231
	232	class wxMacCarbonEvent
	233	{
	234
	235	public :
6d4c54a7	236	wxMacCarbonEvent( EventRef event , bool release = false )
4f305456 SC	237	{
4f305456 SC	238	m_eventRef = event ;
6d4c54a7 SC	239	m_release = release ;
	240	}
	241	wxMacCarbonEvent(UInt32 inClassID,UInt32 inKind,EventTime inWhen = 0 /now/,EventAttributes inAttributes=kEventAttributeNone)
	242	{
	243	m_eventRef = NULL ;
	244	verify_noerr( MacCreateEvent( NULL , inClassID, inKind,inWhen,inAttributes,&m_eventRef) ) ;
	245	m_release = true ;
	246	}
	247	~wxMacCarbonEvent()
	248	{
	249	if ( m_release )
	250	ReleaseEvent( m_eventRef ) ;
4f305456 SC	251	}
	252
	253	OSStatus GetParameter( EventParamName inName, EventParamType inDesiredType, UInt32 inBufferSize, void * outData) ;
	254
	255	template <typename T> OSStatus GetParameter( EventParamName inName, EventParamType type , T *data )
	256	{
	257	return GetParameter( inName, type , sizeof( T ) , data ) ;
	258	}
	259	template <typename T> OSStatus GetParameter( EventParamName inName, T *data )
	260	{
	261	return GetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
	262	}
	263
	264	template <typename T> T GetParameter( EventParamName inName )
	265	{
	266	T value ;
	267	verify_noerr( GetParameter<T>( inName, &value ) ) ;
	268	return value ;
	269	}
	270	template <typename T> T GetParameter( EventParamName inName, EventParamType inDesiredType )
	271	{
	272	T value ;
	273	verify_noerr( GetParameter<T>( inName, inDesiredType , &value ) ) ;
	274	return value ;
	275	}
	276
6d4c54a7 SC	277	OSStatus SetParameter( EventParamName inName, EventParamType inType, UInt32 inSize, const void * inData) ;
6d4c54a7 SC	278	template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T *data )
4f305456	279	{
2aefa0ef SC	280	return SetParameter( inName, inDesiredType , sizeof( T ) , data ) ;
2aefa0ef SC	281	}
6d4c54a7	282	template <typename T> OSStatus SetParameter( EventParamName inName, EventParamType inDesiredType , const T& data )
2aefa0ef SC	283	{
2aefa0ef SC	284	return SetParameter<T>( inName, inDesiredType , &data ) ;
4f305456	285	}
6d4c54a7	286	template <typename T> OSStatus SetParameter( EventParamName inName, const T *data )
4f305456 SC	287	{
	288	return SetParameter<T>( inName, wxMacGetEventParamType<T>() , data ) ;
	289	}
6d4c54a7	290	template <typename T> OSStatus SetParameter( EventParamName inName, const T& data )
2aefa0ef SC	291	{
	292	return SetParameter<T>( inName, wxMacGetEventParamType<T>() , &data ) ;
	293	}
86d8b744 SC	294	UInt32 GetClass()
	295	{
	296	return ::GetEventClass( m_eventRef ) ;
	297	}
41b53169	298	UInt32 GetKind()
4f305456 SC	299	{
	300	return ::GetEventKind( m_eventRef ) ;
	301	}
	302	EventTime GetTime()
	303	{
	304	return ::GetEventTime( m_eventRef ) ;
	305	}
	306	UInt32 GetTicks()
	307	{
	308	return EventTimeToTicks( GetTime() ) ;
	309	}
6d4c54a7	310	operator EventRef () { return m_eventRef; }
4f305456 SC	311	protected :
4f305456 SC	312	EventRef m_eventRef ;
6d4c54a7	313	bool m_release ;
4f305456 SC	314	} ;
4f305456 SC	315
86d8b744 SC	316	class wxMacControl
	317	{
	318	public :
6d4c54a7 SC	319	wxMacControl()
	320	{
	321	m_controlRef = NULL ;
	322	}
	323
86d8b744 SC	324	wxMacControl( ControlRef control )
	325	{
	326	m_controlRef = control ;
	327	}
	328	wxMacControl( WXWidget control )
	329	{
	330	m_controlRef = (ControlRef) control ;
	331	}
0fc3bc3b SC	332	virtual ~wxMacControl()
	333	{
	334	}
6d4c54a7	335
5ca0d812 SC	336	virtual void Dispose() ;
	337
	338	bool Ok() const { return GetControlRef() != NULL ; }
	339
	340	virtual ControlRef * GetControlRefAddr() { return &m_controlRef; }
	341	virtual ControlRef GetControlRef() const { return m_controlRef ; }
	342
	343	virtual void SetReference( SInt32 data ) ;
	344	/*
2837271a SC	345	void operator= (ControlRef c) { m_controlRef = c ; }
	346	operator ControlRef () { return m_controlRef; }
	347	operator ControlRef * () { return &m_controlRef; }
5ca0d812	348	*/
2837271a SC	349	// accessing data and values
	350
	351	virtual OSStatus SetData( ControlPartCode inPartCode , ResType inTag , Size inSize , const void * inData ) ;
0fc3bc3b SC	352	virtual OSStatus GetData( ControlPartCode inPartCode , ResType inTag , Size inBufferSize , void * inOutBuffer , Size * outActualSize ) const ;
0fc3bc3b SC	353	virtual OSStatus GetDataSize( ControlPartCode inPartCode , ResType inTag , Size * outActualSize ) const ;
2837271a SC	354	virtual OSStatus SendEvent( EventRef ref , OptionBits inOptions = 0 ) ;
	355	virtual OSStatus SendHICommand( HICommand &command , OptionBits inOptions = 0 ) ;
	356
0fc3bc3b	357	virtual OSStatus SendHICommand( UInt32 commandID , OptionBits inOptions = 0 ) ;
2837271a	358
0fc3bc3b SC	359	virtual SInt32 GetValue() const ;
	360	virtual SInt32 GetMaximum() const ;
	361	virtual SInt32 GetMinimum() const ;
2837271a	362
0fc3bc3b SC	363	virtual void SetValue( SInt32 v ) ;
	364	virtual void SetMinimum( SInt32 v ) ;
	365	virtual void SetMaximum( SInt32 v ) ;
2837271a	366
0fc3bc3b SC	367	virtual void SetValueAndRange( SInt32 value , SInt32 minimum , SInt32 maximum ) ;
0fc3bc3b SC	368	virtual void SetRange( SInt32 minimum , SInt32 maximum ) ;
2837271a	369
5ca0d812 SC	370	virtual OSStatus SetFocus( ControlFocusPart focusPart ) ;
	371	virtual bool HasFocus() const ;
	372	virtual bool NeedsFocusRect() const ;
	373
2837271a SC	374	// templated helpers
2837271a SC	375
0fc3bc3b	376	Size GetDataSize( ControlPartCode inPartCode , ResType inTag ) const
86d8b744 SC	377	{
	378	Size sz ;
	379	verify_noerr( GetDataSize( inPartCode , inTag , &sz ) ) ;
	380	return sz ;
	381	}
6d4c54a7	382	template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T *data )
86d8b744 SC	383	{
	384	return SetData( inPartCode , inTag , sizeof( T ) , data ) ;
	385	}
6d4c54a7	386	template <typename T> OSStatus SetData( ControlPartCode inPartCode , ResType inTag , const T& data )
86d8b744 SC	387	{
	388	return SetData( inPartCode , inTag , sizeof( T ) , &data ) ;
	389	}
0fc3bc3b	390	template <typename T> OSStatus GetData( ControlPartCode inPartCode , ResType inTag , T *data ) const
86d8b744 SC	391	{
	392	Size dummy ;
	393	return GetData( inPartCode , inTag , sizeof( T ) , data , &dummy ) ;
	394	}
0fc3bc3b	395	template <typename T> T GetData( ControlPartCode inPartCode , ResType inTag ) const
86d8b744 SC	396	{
	397	T value ;
	398	verify_noerr( GetData<T>( inPartCode , inTag , &value ) ) ;
	399	return value ;
	400	}
2837271a	401
6d4c54a7	402	// Flash the control for the specified amount of time
0fc3bc3b SC	403	virtual void Flash( ControlPartCode part , UInt32 ticks = 8 ) ;
	404	virtual void VisibilityChanged( bool shown ) ;
	405	virtual void SetFont( const wxFont & font , const wxColour& foreground , long windowStyle ) ;
7ea087b7	406	virtual void SetBackground( const wxBrush &brush ) ;
5ca0d812 SC	407	virtual ControlPartCode HandleKey( SInt16 keyCode, SInt16 charCode, EventModifiers modifiers ) ;
	408	void SetActionProc( ControlActionUPP actionProc ) ;
	409	void SetViewSize( SInt32 viewSize ) ;
	410	SInt32 GetViewSize() const ;
	411
	412	virtual bool IsVisible() const ;
	413	virtual void SetVisibility( bool visible , bool redraw ) ;
	414	virtual bool IsEnabled() const ;
	415	virtual bool IsActive() const ;
	416	virtual void Enable( bool enable ) ;
	417
	418	// invalidates this control and all children
	419	virtual void InvalidateWithChildren() ;
	420	virtual void SetDrawingEnabled( bool enable ) ;
	421	virtual bool GetNeedsDisplay() const ;
	422	virtual void SetNeedsDisplay( bool needsDisplay , RgnHandle where = NULL ) ;
	423
	424	virtual void ScrollRect( const wxRect &rect , int dx , int dy ) ;
	425
	426	virtual void GetRect( Rect *r ) ;
	427	virtual void SetRect( Rect *r ) ;
	428	virtual void GetRectInWindowCoords( Rect *r ) ;
	429	virtual void GetBestRect( Rect *r ) ;
	430	virtual void SetTitle( const wxString &title ) ;
	431	// converts from Toplevel-Content relative to local
	432	static void Convert( wxPoint pt , wxMacControl convert , wxMacControl *to ) ;
	433
	434	virtual void GetFeatures( UInt32 *features ) ;
	435	virtual OSStatus GetRegion( ControlPartCode partCode , RgnHandle region ) ;
	436	virtual OSStatus SetZOrder( bool above , wxMacControl* other ) ;
	437	// to be moved into a databrowser subclass
	438
	439	virtual OSStatus SetSelectionFlags( DataBrowserSelectionFlags ) ;
	440	virtual OSStatus AddListViewColumn( DataBrowserListViewColumnDesc *columnDesc,
	441	DataBrowserTableViewColumnIndex position ) ;
	442	virtual OSStatus AutoSizeListViewColumns() ;
	443	virtual OSStatus SetHasScrollBars( bool horiz , bool vert ) ;
	444	virtual OSStatus SetTableViewHiliteStyle( DataBrowserTableViewHiliteStyle hiliteStyle ) ;
	445	virtual OSStatus SetListViewHeaderBtnHeight(UInt16 height) ;
	446	virtual OSStatus SetCallbacks(const DataBrowserCallbacks * callbacks) ;
	447	virtual OSStatus UpdateItems( DataBrowserItemID container, UInt32 numItems,
	448	const DataBrowserItemID* items,
	449	DataBrowserPropertyID preSortProperty,
	450	DataBrowserPropertyID propertyID ) ;
	451	virtual OSStatus AddItems( DataBrowserItemID container, UInt32 numItems,
	452	const DataBrowserItemID* items,
	453	DataBrowserPropertyID preSortProperty ) ;
	454	virtual OSStatus RemoveItems( DataBrowserItemID container, UInt32 numItems,
	455	const DataBrowserItemID* items,
	456	DataBrowserPropertyID preSortProperty ) ;
	457	virtual OSStatus RevealItem( DataBrowserItemID item,
	458	DataBrowserPropertyID propertyID,
	459	DataBrowserRevealOptions options ) ;
fe3dc505	460	virtual OSStatus GetSelectionAnchor( DataBrowserItemID * first, DataBrowserItemID * last ) ;
5ca0d812 SC	461	virtual bool IsItemSelected( DataBrowserItemID item ) ;
	462	virtual OSStatus SetSelectedItems(UInt32 numItems,
	463	const DataBrowserItemID * items,
	464	DataBrowserSetOption operation ) ;
	465
	466	// to be moved into a tab control class
	467
	468	virtual OSStatus SetTabEnabled( SInt16 tabNo , bool enable ) ;
86d8b744	469	protected :
0fc3bc3b SC	470	ControlRef m_controlRef ;
	471	wxFont m_font ;
	472	long m_windowStyle ;
86d8b744 SC	473	} ;
86d8b744 SC	474
8cf73271 SC	475	#endif // wxUSE_GUI
	476
	477	//---------------------------------------------------------------------------
	478	// wxMac string conversions
	479	//---------------------------------------------------------------------------
	480
	481	void wxMacSetupConverters() ;
	482	void wxMacCleanupConverters() ;
	483
	484	void wxMacStringToPascal( const wxString&from , StringPtr to ) ;
	485	wxString wxMacMakeStringFromPascal( ConstStringPtr from ) ;
	486
1a42f89c SC	487	// toplevel.cpp
	488
	489	ControlRef wxMacFindControlUnderMouse( Point location , WindowRef window , ControlPartCode *outPart ) ;
8cf73271	490
a2b77260 SC	491	// filefn.cpp
	492
	493	wxString wxMacFSRefToPath( const FSRef *fsRef , CFStringRef additionalPathComponent = NULL ) ;
	494	OSStatus wxMacPathToFSRef( const wxString&path , FSRef *fsRef ) ;
	495	wxString wxMacHFSUniStrToString( ConstHFSUniStr255Param uniname ) ;
aa0cc8a1	496
8cf73271 SC	497	#endif
8cf73271 SC	498	// _WX_PRIVATE_H_