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