include/wx/osx/cocoa/private.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/osx/cocoa/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: private.h 53819 2008-05-29 14:11:45Z SC $
  10 // Copyright:   (c) Stefan Csomor
  11 // Licence:     wxWindows licence
  12 /////////////////////////////////////////////////////////////////////////////
  13
  14 #ifndef _WX_PRIVATE_COCOA_H_
  15 #define _WX_PRIVATE_COCOA_H_
  16
  17 #include "wx/osx/core/private.h"
  18
  19 #include "wx/defs.h"
  20
  21 #include <ApplicationServices/ApplicationServices.h>
  22
  23 #if wxOSX_USE_ATSU_TEXT
  24     // we need theming and atsu
  25     #include <Carbon/Carbon.h>
  26 #else
  27     // we only need theming, if we find a better include replace the following
  28     #include <Carbon/Carbon.h>
  29 #endif
  30
  31 #ifdef __OBJC__
  32     #import <Cocoa/Cocoa.h>
  33 #endif
  34
  35 //
  36 // shared between Cocoa and Carbon
  37 //
  38
  39 // bring in theming types without pulling in the headers
  40
  41 #if wxUSE_GUI
  42 typedef SInt16 ThemeBrush;
  43 CGColorRef WXDLLIMPEXP_CORE wxMacCreateCGColorFromHITheme( ThemeBrush brush ) ;
  44 OSStatus WXDLLIMPEXP_CORE wxMacDrawCGImage(
  45                                CGContextRef    inContext,
  46                                const CGRect *  inBounds,
  47                                CGImageRef      inImage) ;
  48 WX_NSImage WXDLLIMPEXP_CORE wxOSXCreateNSImageFromCGImage( CGImageRef image );
  49 CGImageRef WXDLLIMPEXP_CORE wxOSXCreateCGImageFromNSImage( WX_NSImage nsimage );
  50 #endif
  51
  52 long UMAGetSystemVersion() ;
  53 WXDLLIMPEXP_BASE void wxMacStringToPascal( const wxString&from , StringPtr to );
  54 WXDLLIMPEXP_BASE wxString wxMacFSRefToPath( const FSRef *fsRef , CFStringRef additionalPathComponent = NULL );
  55 WXDLLIMPEXP_BASE OSStatus wxMacPathToFSRef( const wxString&path , FSRef *fsRef );
  56 WXDLLIMPEXP_BASE wxString wxMacHFSUniStrToString( ConstHFSUniStr255Param uniname );
  57
  58 //
  59 //
  60 //
  61
  62 #if wxUSE_GUI
  63
  64 class WXDLLIMPEXP_CORE wxWidgetCocoaImpl : public wxWidgetImpl
  65 {
  66 public :
  67     wxWidgetCocoaImpl( wxWindowMac* peer , WXWidget w, bool isRootControl = false ) ;
  68     wxWidgetCocoaImpl() ;
  69     ~wxWidgetCocoaImpl();
  70
  71     void Init();
  72
  73     virtual bool        IsVisible() const ;
  74     virtual void        SetVisibility(bool);
  75
  76     // we provide a static function which can be reused from
  77     // wxNonOwnedWindowCocoaImpl too
  78     static bool ShowViewOrWindowWithEffect(wxWindow *win,
  79                                            bool show,
  80                                            wxShowEffect effect,
  81                                            unsigned timeout);
  82
  83     virtual bool ShowWithEffect(bool show,
  84                                 wxShowEffect effect,
  85                                 unsigned timeout);
  86
  87     virtual void        Raise();
  88
  89     virtual void        Lower();
  90
  91     virtual void        ScrollRect( const wxRect *rect, int dx, int dy );
  92
  93     virtual WXWidget    GetWXWidget() const { return m_osxView; }
  94
  95     virtual void        SetBackgroundColour(const wxColour&);
  96
  97     virtual void        GetContentArea( int &left , int &top , int &width , int &height ) const;
  98     virtual void        Move(int x, int y, int width, int height);
  99     virtual void        GetPosition( int &x, int &y ) const;
 100     virtual void        GetSize( int &width, int &height ) const;
 101     virtual void        SetControlSize( wxWindowVariant variant );
 102
 103     virtual void        SetNeedsDisplay( const wxRect* where = NULL );
 104     virtual bool        GetNeedsDisplay() const;
 105
 106     virtual bool        CanFocus() const;
 107     // return true if successful
 108     virtual bool        SetFocus();
 109     virtual bool        HasFocus() const;
 110
 111     void                RemoveFromParent();
 112     void                Embed( wxWidgetImpl *parent );
 113
 114     void                SetDefaultButton( bool isDefault );
 115     void                PerformClick();
 116     virtual void        SetLabel(const wxString& title, wxFontEncoding encoding);
 117
 118     void                SetCursor( const wxCursor & cursor );
 119     void                CaptureMouse();
 120     void                ReleaseMouse();
 121
 122     wxInt32             GetValue() const;
 123     void                SetValue( wxInt32 v );
 124     wxBitmap            GetBitmap() const;
 125     void                SetBitmap( const wxBitmap& bitmap );
 126     void                SetBitmapPosition( wxDirection dir );
 127     void                SetupTabs( const wxNotebook &notebook );
 128     void                GetBestRect( wxRect *r ) const;
 129     bool                IsEnabled() const;
 130     void                Enable( bool enable );
 131     bool                ButtonClickDidStateChange() { return true ;}
 132     void                SetMinimum( wxInt32 v );
 133     void                SetMaximum( wxInt32 v );
 134     wxInt32             GetMinimum() const;
 135     wxInt32             GetMaximum() const;
 136     void                PulseGauge();
 137     void                SetScrollThumb( wxInt32 value, wxInt32 thumbSize );
 138
 139     void                SetFont( const wxFont & font , const wxColour& foreground , long windowStyle, bool ignoreBlack = true );
 140
 141     void                InstallEventHandler( WXWidget control = NULL );
 142
 143     virtual bool        DoHandleMouseEvent(NSEvent *event);
 144     virtual bool        DoHandleKeyEvent(NSEvent *event);
 145     virtual bool        DoHandleCharEvent(NSEvent *event, NSString *text);
 146     virtual void        DoNotifyFocusEvent(bool receivedFocus, wxWidgetImpl* otherWindow);
 147
 148     virtual void        SetupKeyEvent(wxKeyEvent &wxevent, NSEvent * nsEvent, NSString* charString = NULL);
 149     virtual void        SetupMouseEvent(wxMouseEvent &wxevent, NSEvent * nsEvent);
 150
 151
 152     void                SetFlipped(bool flipped);
 153     virtual bool        IsFlipped() const { return m_isFlipped; }
 154
 155     // cocoa thunk connected calls
 156
 157     virtual unsigned int        draggingEntered(void* sender, WXWidget slf, void* _cmd);
 158     virtual void                draggingExited(void* sender, WXWidget slf, void* _cmd);
 159     virtual unsigned int        draggingUpdated(void* sender, WXWidget slf, void* _cmd);
 160     virtual bool                performDragOperation(void* sender, WXWidget slf, void* _cmd);
 161     virtual void                mouseEvent(WX_NSEvent event, WXWidget slf, void* _cmd);
 162     virtual void                keyEvent(WX_NSEvent event, WXWidget slf, void* _cmd);
 163     virtual void                insertText(NSString* text, WXWidget slf, void* _cmd);
 164     virtual bool                performKeyEquivalent(WX_NSEvent event, WXWidget slf, void* _cmd);
 165     virtual bool                acceptsFirstResponder(WXWidget slf, void* _cmd);
 166     virtual bool                becomeFirstResponder(WXWidget slf, void* _cmd);
 167     virtual bool                resignFirstResponder(WXWidget slf, void* _cmd);
 168     virtual void                resetCursorRects(WXWidget slf, void* _cmd);
 169     virtual bool                isFlipped(WXWidget slf, void* _cmd);
 170     virtual void                drawRect(void* rect, WXWidget slf, void* _cmd);
 171
 172     virtual void                controlAction(WXWidget slf, void* _cmd, void* sender);
 173     virtual void                controlDoubleAction(WXWidget slf, void* _cmd, void *sender);
 174
 175 protected:
 176     WXWidget m_osxView;
 177     NSEvent* m_lastKeyDownEvent;
 178     bool m_isFlipped;
 179     // if it the control has an editor, that editor will already send some
 180     // events, don't resend them
 181     bool m_hasEditor;
 182
 183     DECLARE_DYNAMIC_CLASS_NO_COPY(wxWidgetCocoaImpl)
 184 };
 185
 186 DECLARE_WXCOCOA_OBJC_CLASS( wxNSWindow );
 187
 188 class wxNonOwnedWindowCocoaImpl : public wxNonOwnedWindowImpl
 189 {
 190 public :
 191     wxNonOwnedWindowCocoaImpl( wxNonOwnedWindow* nonownedwnd) ;
 192     wxNonOwnedWindowCocoaImpl();
 193
 194     virtual ~wxNonOwnedWindowCocoaImpl();
 195
 196     virtual void Destroy() ;
 197     void Create( wxWindow* parent, const wxPoint& pos, const wxSize& size,
 198     long style, long extraStyle, const wxString& name ) ;
 199
 200     WXWindow GetWXWindow() const;
 201     void Raise();
 202     void Lower();
 203     bool Show(bool show);
 204
 205     virtual bool ShowWithEffect(bool show,
 206                                 wxShowEffect effect,
 207                                 unsigned timeout);
 208
 209     void Update();
 210     bool SetTransparent(wxByte alpha);
 211     bool SetBackgroundColour(const wxColour& col );
 212     void SetExtraStyle( long exStyle );
 213     void SetWindowStyleFlag( long style );
 214     bool SetBackgroundStyle(wxBackgroundStyle style);
 215     bool CanSetTransparent();
 216
 217     void MoveWindow(int x, int y, int width, int height);
 218     void GetPosition( int &x, int &y ) const;
 219     void GetSize( int &width, int &height ) const;
 220
 221     void GetContentArea( int &left , int &top , int &width , int &height ) const;
 222     bool SetShape(const wxRegion& region);
 223
 224     virtual void SetTitle( const wxString& title, wxFontEncoding encoding ) ;
 225
 226     virtual bool IsMaximized() const;
 227
 228     virtual bool IsIconized() const;
 229
 230     virtual void Iconize( bool iconize );
 231
 232     virtual void Maximize(bool maximize);
 233
 234     virtual bool IsFullScreen() const;
 235
 236     virtual bool ShowFullScreen(bool show, long style);
 237
 238     virtual void ShowWithoutActivating();
 239
 240     virtual void RequestUserAttention(int flags);
 241
 242     virtual void ScreenToWindow( int *x, int *y );
 243
 244     virtual void WindowToScreen( int *x, int *y );
 245
 246     virtual bool IsActive();
 247
 248     virtual void SetModified(bool modified);
 249     virtual bool IsModified() const;
 250
 251     wxNonOwnedWindow*   GetWXPeer() { return m_wxPeer; }
 252 protected :
 253     WX_wxNSWindow         m_macWindow;
 254     void *              m_macFullScreenData ;
 255     DECLARE_DYNAMIC_CLASS_NO_COPY(wxNonOwnedWindowCocoaImpl)
 256 };
 257
 258 #ifdef __OBJC__
 259
 260     WXDLLIMPEXP_CORE NSRect wxToNSRect( NSView* parent, const wxRect& r );
 261     WXDLLIMPEXP_CORE wxRect wxFromNSRect( NSView* parent, const NSRect& rect );
 262     WXDLLIMPEXP_CORE NSPoint wxToNSPoint( NSView* parent, const wxPoint& p );
 263     WXDLLIMPEXP_CORE wxPoint wxFromNSPoint( NSView* parent, const NSPoint& p );
 264
 265     NSRect WXDLLIMPEXP_CORE wxOSXGetFrameForControl( wxWindowMac* window , const wxPoint& pos , const wxSize &size ,
 266         bool adjustForOrigin = true );
 267
 268     // used for many wxControls
 269
 270     @interface wxNSButton : NSButton
 271     {
 272         NSTrackingRectTag rectTag;
 273     }
 274
 275     @end
 276
 277     @interface wxNSBox : NSBox
 278     {
 279     }
 280
 281     @end
 282
 283     @interface wxNSTextFieldEditor : NSTextView
 284     {
 285         NSEvent* lastKeyDownEvent;
 286     }
 287
 288     @end
 289
 290     @interface wxNSTextField : NSTextField
 291     {
 292         wxNSTextFieldEditor* fieldEditor;
 293     }
 294
 295     - (wxNSTextFieldEditor*) fieldEditor;
 296     - (void) setFieldEditor:(wxNSTextFieldEditor*) fieldEditor;
 297
 298     @end
 299
 300     @interface wxNSSecureTextField : NSSecureTextField
 301     {
 302     }
 303
 304     @end
 305
 306
 307     @interface wxNSTextView : NSTextView wxOSX_10_6_AND_LATER(<NSTextViewDelegate>)
 308     {
 309     }
 310
 311     - (void)textDidChange:(NSNotification *)aNotification;
 312
 313     @end
 314
 315     @interface wxNSMenu : NSMenu
 316     {
 317        wxMenuImpl* impl;
 318     }
 319
 320     - (void) setImplementation:(wxMenuImpl*) item;
 321     - (wxMenuImpl*) implementation;
 322
 323     @end
 324
 325     @interface wxNSMenuItem : NSMenuItem
 326     {
 327        wxMenuItemImpl* impl;
 328     }
 329
 330     - (void) setImplementation:(wxMenuItemImpl*) item;
 331     - (wxMenuItemImpl*) implementation;
 332
 333     - (void)clickedAction:(id)sender;
 334     - (BOOL)validateMenuItem:(NSMenuItem *)menuItem;
 335
 336     @end
 337
 338     void WXDLLIMPEXP_CORE wxOSXCocoaClassAddWXMethods(Class c);
 339
 340     /*
 341     We need this for ShowModal, as the sheet just disables the parent window and
 342     returns control to the app, whereas we don't want to return from ShowModal
 343     until the sheet has been dismissed.
 344     */
 345     @interface ModalDialogDelegate : NSObject
 346     {
 347         BOOL sheetFinished;
 348         int resultCode;
 349     }
 350
 351     - (BOOL)finished;
 352     - (int)code;
 353     - (void)waitForSheetToFinish;
 354     - (void)sheetDidEnd:(NSWindow *)sheet returnCode:(int)returnCode contextInfo:(void *)contextInfo;
 355     @end
 356
 357
 358 #endif // __OBJC__
 359
 360 // NSCursor
 361
 362 WX_NSCursor wxMacCocoaCreateStockCursor( int cursor_type );
 363 WX_NSCursor  wxMacCocoaCreateCursorFromCGImage( CGImageRef cgImageRef, float hotSpotX, float hotSpotY );
 364 void  wxMacCocoaSetCursor( WX_NSCursor cursor );
 365 void  wxMacCocoaHideCursor();
 366 void  wxMacCocoaShowCursor();
 367
 368 typedef struct tagClassicCursor
 369 {
 370     wxUint16 bits[16];
 371     wxUint16 mask[16];
 372     wxInt16 hotspot[2];
 373 }ClassicCursor;
 374
 375 const short kwxCursorBullseye = 0;
 376 const short kwxCursorBlank = 1;
 377 const short kwxCursorPencil = 2;
 378 const short kwxCursorMagnifier = 3;
 379 const short kwxCursorNoEntry = 4;
 380 const short kwxCursorPaintBrush = 5;
 381 const short kwxCursorPointRight = 6;
 382 const short kwxCursorPointLeft = 7;
 383 const short kwxCursorQuestionArrow = 8;
 384 const short kwxCursorRightArrow = 9;
 385 const short kwxCursorSizeNS = 10;
 386 const short kwxCursorSize = 11;
 387 const short kwxCursorSizeNESW = 12;
 388 const short kwxCursorSizeNWSE = 13;
 389 const short kwxCursorRoller = 14;
 390 const short kwxCursorLast = kwxCursorRoller;
 391
 392 // exposing our fallback cursor map
 393
 394 extern ClassicCursor gMacCursors[];
 395
 396 #endif
 397
 398 #endif
 399     // _WX_PRIVATE_COCOA_H_
 400