1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/osx/core/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
9 // RCS-ID: $Id: private.h 53819 2008-05-29 14:11:45Z SC $
10 // Copyright: (c) Stefan Csomor
11 // Licence: wxWindows licence
12 /////////////////////////////////////////////////////////////////////////////
14 #ifndef _WX_PRIVATE_CORE_H_
15 #define _WX_PRIVATE_CORE_H_
19 #include <CoreFoundation/CoreFoundation.h>
21 #include "wx/osx/core/cfstring.h"
22 #include "wx/osx/core/cfdataref.h"
24 // Define helper macros allowing to insert small snippets of code to be
25 // compiled for high enough OS X version only: this shouldn't be abused for
26 // anything big but it's handy for e.g. specifying OS X 10.6-only protocols in
27 // the Objective C classes declarations when they're not supported under the
29 #if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_6
30 #define wxOSX_10_6_AND_LATER(x) x
32 #define wxOSX_10_6_AND_LATER(x)
35 #if wxOSX_USE_COCOA_OR_CARBON
37 WXDLLIMPEXP_BASE
long UMAGetSystemVersion() ;
39 void WXDLLIMPEXP_CORE
wxMacStringToPascal( const wxString
&from
, unsigned char * to
);
40 wxString WXDLLIMPEXP_CORE
wxMacMakeStringFromPascal( const unsigned char * from
);
47 #include <CoreGraphics/CoreGraphics.h>
49 #include <ApplicationServices/ApplicationServices.h>
52 #include "wx/bitmap.h"
53 #include "wx/window.h"
55 class WXDLLIMPEXP_CORE wxMacCGContextStateSaver
57 wxDECLARE_NO_COPY_CLASS(wxMacCGContextStateSaver
);
60 wxMacCGContextStateSaver( CGContextRef cg
)
63 CGContextSaveGState( cg
);
65 ~wxMacCGContextStateSaver()
67 CGContextRestoreGState( m_cg
);
73 class WXDLLIMPEXP_CORE wxDeferredObjectDeleter
: public wxObject
76 wxDeferredObjectDeleter( wxObject
* obj
) : m_obj(obj
)
79 virtual ~wxDeferredObjectDeleter()
89 WXDLLIMPEXP_CORE CGImageRef
wxMacCreateCGImageFromBitmap( const wxBitmap
& bitmap
);
91 WXDLLIMPEXP_CORE CGDataProviderRef
wxMacCGDataProviderCreateWithCFData( CFDataRef data
);
92 WXDLLIMPEXP_CORE CGDataConsumerRef
wxMacCGDataConsumerCreateWithCFData( CFMutableDataRef data
);
93 WXDLLIMPEXP_CORE CGDataProviderRef
wxMacCGDataProviderCreateWithMemoryBuffer( const wxMemoryBuffer
& buf
);
95 CGColorSpaceRef WXDLLIMPEXP_CORE
wxMacGetGenericRGBColorSpace(void);
99 extern wxWindow
* g_MacLastWindow
;
100 class wxNonOwnedWindow
;
102 // temporary typedef so that no additional casts are necessary within carbon code at the moment
109 WXDLLIMPEXP_CORE wxWindowMac
* wxFindWindowFromWXWidget(WXWidget inControl
);
112 typedef wxMacControl wxWidgetImplType
;
114 typedef wxWidgetImpl wxWidgetImplType
;
118 class wxMenuItemImpl
: public wxObject
121 wxMenuItemImpl( wxMenuItem
* peer
) : m_peer(peer
)
125 virtual ~wxMenuItemImpl() ;
126 virtual void SetBitmap( const wxBitmap
& bitmap
) = 0;
127 virtual void Enable( bool enable
) = 0;
128 virtual void Check( bool check
) = 0;
129 virtual void SetLabel( const wxString
& text
, wxAcceleratorEntry
*entry
) = 0;
130 virtual void Hide( bool hide
= true ) = 0;
132 virtual void * GetHMenuItem() = 0;
134 wxMenuItem
* GetWXPeer() { return m_peer
; }
136 static wxMenuItemImpl
* Create( wxMenuItem
* peer
, wxMenu
*pParentMenu
,
138 const wxString
& text
,
139 wxAcceleratorEntry
*entry
,
140 const wxString
& strHelp
,
147 DECLARE_ABSTRACT_CLASS(wxMenuItemImpl
)
150 class wxMenuImpl
: public wxObject
153 wxMenuImpl( wxMenu
* peer
) : m_peer(peer
)
157 virtual ~wxMenuImpl() ;
158 virtual void InsertOrAppend(wxMenuItem
*pItem
, size_t pos
) = 0;
159 virtual void Remove( wxMenuItem
*pItem
) = 0;
161 virtual void MakeRoot() = 0;
163 virtual void SetTitle( const wxString
& text
) = 0;
165 virtual WXHMENU
GetHMenu() = 0;
167 wxMenu
* GetWXPeer() { return m_peer
; }
169 virtual void PopUp( wxWindow
*win
, int x
, int y
) = 0;
171 static wxMenuImpl
* Create( wxMenu
* peer
, const wxString
& title
);
172 static wxMenuImpl
* CreateRootMenu( wxMenu
* peer
);
176 DECLARE_ABSTRACT_CLASS(wxMenuItemImpl
)
181 class WXDLLIMPEXP_CORE wxWidgetImpl
: public wxObject
184 wxWidgetImpl( wxWindowMac
* peer
, bool isRootControl
= false );
186 virtual ~wxWidgetImpl();
190 bool IsRootControl() const { return m_isRootControl
; }
192 wxWindowMac
* GetWXPeer() const { return m_wxPeer
; }
194 bool IsOk() const { return GetWXWidget() != NULL
; }
196 // not only the control itself, but also all its parents must be visible
197 // in order for this function to return true
198 virtual bool IsVisible() const = 0;
199 // set the visibility of this widget (maybe latent)
200 virtual void SetVisibility( bool visible
) = 0;
202 virtual bool ShowWithEffect(bool WXUNUSED(show
),
203 wxShowEffect
WXUNUSED(effect
),
204 unsigned WXUNUSED(timeout
))
209 virtual void Raise() = 0;
211 virtual void Lower() = 0;
213 virtual void ScrollRect( const wxRect
*rect
, int dx
, int dy
) = 0;
215 virtual WXWidget
GetWXWidget() const = 0;
217 virtual void SetBackgroundColour( const wxColour
& col
) = 0;
219 // all coordinates in native parent widget relative coordinates
220 virtual void GetContentArea( int &left
, int &top
, int &width
, int &height
) const = 0;
221 virtual void Move(int x
, int y
, int width
, int height
) = 0;
222 virtual void GetPosition( int &x
, int &y
) const = 0;
223 virtual void GetSize( int &width
, int &height
) const = 0;
224 virtual void SetControlSize( wxWindowVariant variant
) = 0;
226 // native view coordinates are topleft to bottom right (flipped regarding CoreGraphics origin)
227 virtual bool IsFlipped() const { return true; }
229 virtual void SetNeedsDisplay( const wxRect
* where
= NULL
) = 0;
230 virtual bool GetNeedsDisplay() const = 0;
232 virtual bool NeedsFocusRect() const;
233 virtual void SetNeedsFocusRect( bool needs
);
235 virtual bool NeedsFrame() const;
236 virtual void SetNeedsFrame( bool needs
);
238 virtual bool CanFocus() const = 0;
239 // return true if successful
240 virtual bool SetFocus() = 0;
241 virtual bool HasFocus() const = 0;
243 virtual void RemoveFromParent() = 0;
244 virtual void Embed( wxWidgetImpl
*parent
) = 0;
246 virtual void SetDefaultButton( bool isDefault
) = 0;
247 virtual void PerformClick() = 0;
248 virtual void SetLabel( const wxString
& title
, wxFontEncoding encoding
) = 0;
250 virtual void SetCursor( const wxCursor
& cursor
) = 0;
251 virtual void CaptureMouse() = 0;
252 virtual void ReleaseMouse() = 0;
254 virtual wxInt32
GetValue() const = 0;
255 virtual void SetValue( wxInt32 v
) = 0;
256 virtual wxBitmap
GetBitmap() const = 0;
257 virtual void SetBitmap( const wxBitmap
& bitmap
) = 0;
258 virtual void SetBitmapPosition( wxDirection dir
) = 0;
259 virtual void SetupTabs( const wxNotebook
¬ebook
) =0;
260 virtual void GetBestRect( wxRect
*r
) const = 0;
261 virtual bool IsEnabled() const = 0;
262 virtual void Enable( bool enable
) = 0;
263 virtual void SetMinimum( wxInt32 v
) = 0;
264 virtual void SetMaximum( wxInt32 v
) = 0;
265 virtual wxInt32
GetMinimum() const = 0;
266 virtual wxInt32
GetMaximum() const = 0;
267 virtual void PulseGauge() = 0;
268 virtual void SetScrollThumb( wxInt32 value
, wxInt32 thumbSize
) = 0;
270 virtual void SetFont( const wxFont
& font
, const wxColour
& foreground
, long windowStyle
, bool ignoreBlack
= true ) = 0;
272 // is the clicked event sent AFTER the state already changed, so no additional
273 // state changing logic is required from the outside
274 virtual bool ButtonClickDidStateChange() = 0;
276 virtual void InstallEventHandler( WXWidget control
= NULL
) = 0;
278 // static methods for associating native controls and their implementations
281 FindFromWXWidget(WXWidget control
);
283 static void RemoveAssociations( wxWidgetImpl
* impl
);
285 static void Associate( WXWidget control
, wxWidgetImpl
*impl
);
287 static WXWidget
FindFocus();
289 // static creation methods, must be implemented by all toolkits
291 static wxWidgetImplType
* CreateUserPane( wxWindowMac
* wxpeer
,
298 static wxWidgetImplType
* CreateContentView( wxNonOwnedWindow
* now
) ;
300 static wxWidgetImplType
* CreateButton( wxWindowMac
* wxpeer
,
303 const wxString
& label
,
309 static wxWidgetImplType
* CreateDisclosureTriangle( wxWindowMac
* wxpeer
,
312 const wxString
& label
,
318 static wxWidgetImplType
* CreateStaticLine( wxWindowMac
* wxpeer
,
326 static wxWidgetImplType
* CreateGroupBox( wxWindowMac
* wxpeer
,
329 const wxString
& label
,
335 static wxWidgetImplType
* CreateStaticText( wxWindowMac
* wxpeer
,
338 const wxString
& label
,
344 static wxWidgetImplType
* CreateTextControl( wxTextCtrl
* wxpeer
,
347 const wxString
& content
,
353 static wxWidgetImplType
* CreateSearchControl( wxTextCtrl
* wxpeer
,
356 const wxString
& content
,
362 static wxWidgetImplType
* CreateCheckBox( wxWindowMac
* wxpeer
,
365 const wxString
& label
,
371 static wxWidgetImplType
* CreateRadioButton( wxWindowMac
* wxpeer
,
374 const wxString
& label
,
380 static wxWidgetImplType
* CreateToggleButton( wxWindowMac
* wxpeer
,
383 const wxString
& label
,
389 static wxWidgetImplType
* CreateBitmapToggleButton( wxWindowMac
* wxpeer
,
392 const wxBitmap
& bitmap
,
398 static wxWidgetImplType
* CreateBitmapButton( wxWindowMac
* wxpeer
,
401 const wxBitmap
& bitmap
,
407 static wxWidgetImplType
* CreateTabView( wxWindowMac
* wxpeer
,
415 static wxWidgetImplType
* CreateGauge( wxWindowMac
* wxpeer
,
426 static wxWidgetImplType
* CreateSlider( wxWindowMac
* wxpeer
,
437 static wxWidgetImplType
* CreateSpinButton( wxWindowMac
* wxpeer
,
448 static wxWidgetImplType
* CreateScrollBar( wxWindowMac
* wxpeer
,
456 static wxWidgetImplType
* CreateChoice( wxWindowMac
* wxpeer
,
465 static wxWidgetImplType
* CreateListBox( wxWindowMac
* wxpeer
,
473 // converts from Toplevel-Content relative to local
474 static void Convert( wxPoint
*pt
, wxWidgetImpl
*from
, wxWidgetImpl
*to
);
476 bool m_isRootControl
;
477 wxWindowMac
* m_wxPeer
;
478 bool m_needsFocusRect
;
481 DECLARE_ABSTRACT_CLASS(wxWidgetImpl
)
485 // the interface to be implemented eg by a listbox
488 class WXDLLIMPEXP_CORE wxListWidgetColumn
491 virtual ~wxListWidgetColumn() {}
494 class WXDLLIMPEXP_CORE wxListWidgetCellValue
497 wxListWidgetCellValue() {}
498 virtual ~wxListWidgetCellValue() {}
500 virtual void Set( CFStringRef value
) = 0;
501 virtual void Set( const wxString
& value
) = 0;
502 virtual void Set( int value
) = 0;
503 virtual void Check( bool check
);
505 virtual bool IsChecked() const;
506 virtual int GetIntValue() const = 0;
507 virtual wxString
GetStringValue() const = 0;
510 class WXDLLIMPEXP_CORE wxListWidgetImpl
513 wxListWidgetImpl() {}
514 virtual ~wxListWidgetImpl() { }
516 virtual wxListWidgetColumn
* InsertTextColumn( unsigned pos
, const wxString
& title
, bool editable
= false,
517 wxAlignment just
= wxALIGN_LEFT
, int defaultWidth
= -1) = 0 ;
518 virtual wxListWidgetColumn
* InsertCheckColumn( unsigned pos
, const wxString
& title
, bool editable
= false,
519 wxAlignment just
= wxALIGN_LEFT
, int defaultWidth
= -1) = 0 ;
523 // TODO will be replaced
524 virtual void ListDelete( unsigned int n
) = 0;
525 virtual void ListInsert( unsigned int n
) = 0;
526 virtual void ListClear() = 0;
530 virtual void ListDeselectAll() = 0;
531 virtual void ListSetSelection( unsigned int n
, bool select
, bool multi
) = 0;
532 virtual int ListGetSelection() const = 0;
533 virtual int ListGetSelections( wxArrayInt
& aSelections
) const = 0;
534 virtual bool ListIsSelected( unsigned int n
) const = 0;
538 virtual void ListScrollTo( unsigned int n
) = 0;
539 virtual void UpdateLine( unsigned int n
, wxListWidgetColumn
* col
= NULL
) = 0;
540 virtual void UpdateLineToEnd( unsigned int n
) = 0;
544 virtual unsigned int ListGetCount() const = 0;
548 // interface to be implemented by a textcontrol
551 class WXDLLIMPEXP_FWD_CORE wxTextAttr
;
553 // common interface for all implementations
554 class WXDLLIMPEXP_CORE wxTextWidgetImpl
558 wxTextWidgetImpl() {}
560 virtual ~wxTextWidgetImpl() {}
562 virtual bool CanFocus() const { return true; }
564 virtual wxString
GetStringValue() const = 0 ;
565 virtual void SetStringValue( const wxString
&val
) = 0 ;
566 virtual void SetSelection( long from
, long to
) = 0 ;
567 virtual void GetSelection( long* from
, long* to
) const = 0 ;
568 virtual void WriteText( const wxString
& str
) = 0 ;
570 virtual bool GetStyle( long position
, wxTextAttr
& style
);
571 virtual void SetStyle( long start
, long end
, const wxTextAttr
& style
) ;
572 virtual void Copy() ;
574 virtual void Paste() ;
575 virtual bool CanPaste() const ;
576 virtual void SetEditable( bool editable
) ;
577 virtual long GetLastPosition() const ;
578 virtual void Replace( long from
, long to
, const wxString
&str
) ;
579 virtual void Remove( long from
, long to
) ;
582 virtual bool HasOwnContextMenu() const
585 virtual bool SetupCursor( const wxPoint
& WXUNUSED(pt
) )
588 virtual void Clear() ;
589 virtual bool CanUndo() const;
590 virtual void Undo() ;
591 virtual bool CanRedo() const;
592 virtual void Redo() ;
593 virtual int GetNumberOfLines() const ;
594 virtual long XYToPosition(long x
, long y
) const;
595 virtual bool PositionToXY(long pos
, long *x
, long *y
) const ;
596 virtual void ShowPosition(long WXUNUSED(pos
)) ;
597 virtual int GetLineLength(long lineNo
) const ;
598 virtual wxString
GetLineText(long lineNo
) const ;
599 virtual void CheckSpelling(bool WXUNUSED(check
)) { }
601 virtual wxSize
GetBestSize() const { return wxDefaultSize
; }
605 // common interface for buttons
612 virtual ~wxButtonImpl(){}
614 virtual void SetPressedBitmap( const wxBitmap
& bitmap
) = 0;
618 // common interface for search controls
621 class wxSearchWidgetImpl
624 wxSearchWidgetImpl(){}
625 virtual ~wxSearchWidgetImpl(){}
627 // search field options
628 virtual void ShowSearchButton( bool show
) = 0;
629 virtual bool IsSearchButtonVisible() const = 0;
631 virtual void ShowCancelButton( bool show
) = 0;
632 virtual bool IsCancelButtonVisible() const = 0;
634 virtual void SetSearchMenu( wxMenu
* menu
) = 0;
636 virtual void SetDescriptiveText(const wxString
& text
) = 0;
640 // toplevel window implementation class
643 class wxNonOwnedWindowImpl
: public wxObject
646 wxNonOwnedWindowImpl( wxNonOwnedWindow
* nonownedwnd
) : m_wxPeer(nonownedwnd
)
649 wxNonOwnedWindowImpl()
652 virtual ~wxNonOwnedWindowImpl()
656 virtual void WillBeDestroyed()
660 virtual void Create( wxWindow
* parent
, const wxPoint
& pos
, const wxSize
& size
,
661 long style
, long extraStyle
, const wxString
& name
) = 0;
664 virtual WXWindow
GetWXWindow() const = 0;
674 virtual bool Show(bool WXUNUSED(show
))
679 virtual bool ShowWithEffect(bool show
, wxShowEffect
WXUNUSED(effect
), unsigned WXUNUSED(timeout
))
684 virtual void Update()
688 virtual bool SetTransparent(wxByte
WXUNUSED(alpha
))
693 virtual bool SetBackgroundColour(const wxColour
& WXUNUSED(col
) )
698 virtual void SetExtraStyle( long WXUNUSED(exStyle
) )
702 virtual void SetWindowStyleFlag( long WXUNUSED(style
) )
706 virtual bool SetBackgroundStyle(wxBackgroundStyle
WXUNUSED(style
))
711 bool CanSetTransparent()
716 virtual void GetContentArea( int &left
, int &top
, int &width
, int &height
) const = 0;
717 virtual void MoveWindow(int x
, int y
, int width
, int height
) = 0;
718 virtual void GetPosition( int &x
, int &y
) const = 0;
719 virtual void GetSize( int &width
, int &height
) const = 0;
721 virtual bool SetShape(const wxRegion
& WXUNUSED(region
))
726 virtual void SetTitle( const wxString
& title
, wxFontEncoding encoding
) = 0;
728 virtual bool IsMaximized() const = 0;
730 virtual bool IsIconized() const= 0;
732 virtual void Iconize( bool iconize
)= 0;
734 virtual void Maximize(bool maximize
) = 0;
736 virtual bool IsFullScreen() const= 0;
738 virtual void ShowWithoutActivating() { Show(true); }
740 virtual bool ShowFullScreen(bool show
, long style
)= 0;
742 virtual void RequestUserAttention(int flags
) = 0;
744 virtual void ScreenToWindow( int *x
, int *y
) = 0;
746 virtual void WindowToScreen( int *x
, int *y
) = 0;
748 virtual bool IsActive() = 0;
750 wxNonOwnedWindow
* GetWXPeer() { return m_wxPeer
; }
752 // static creation methods, must be implemented by all toolkits
754 static wxNonOwnedWindowImpl
* CreateNonOwnedWindow( wxNonOwnedWindow
* wxpeer
, wxWindow
* parent
, const wxPoint
& pos
, const wxSize
& size
,
755 long style
, long extraStyle
, const wxString
& name
) ;
757 virtual void SetModified(bool WXUNUSED(modified
)) { }
758 virtual bool IsModified() const { return false; }
761 wxNonOwnedWindow
* m_wxPeer
;
762 DECLARE_ABSTRACT_CLASS(wxNonOwnedWindowImpl
)
767 //---------------------------------------------------------------------------
768 // cocoa bridging utilities
769 //---------------------------------------------------------------------------
771 bool wxMacInitCocoa();
773 class WXDLLIMPEXP_CORE wxMacAutoreleasePool
776 wxMacAutoreleasePool();
777 ~wxMacAutoreleasePool();
784 void wxMacCocoaRelease( void* obj
);
785 void wxMacCocoaAutorelease( void* obj
);
786 void* wxMacCocoaRetain( void* obj
);
790 // _WX_PRIVATE_CORE_H_