include/wx/mac/carbon/toplevel.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/mac/carbon/toplevel.h
   3 // Purpose:     wxTopLevelWindowMac is the Mac implementation of wxTLW
   4 // Author:      Stefan Csomor
   5 // Modified by:
   6 // Created:     20.09.01
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2001 Stefan Csomor
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_MSW_TOPLEVEL_H_
  13 #define _WX_MSW_TOPLEVEL_H_
  14
  15 #if wxUSE_SYSTEM_OPTIONS
  16     #define wxMAC_WINDOW_PLAIN_TRANSITION _T("mac.window-plain-transition")
  17 #endif
  18
  19 // ----------------------------------------------------------------------------
  20 // wxTopLevelWindowMac
  21 // ----------------------------------------------------------------------------
  22
  23 class WXDLLEXPORT wxTopLevelWindowMac : public wxTopLevelWindowBase
  24 {
  25 public:
  26     // constructors and such
  27     wxTopLevelWindowMac() { Init(); }
  28
  29     wxTopLevelWindowMac(wxWindow *parent,
  30                         wxWindowID id,
  31                         const wxString& title,
  32                         const wxPoint& pos = wxDefaultPosition,
  33                         const wxSize& size = wxDefaultSize,
  34                         long style = wxDEFAULT_FRAME_STYLE,
  35                         const wxString& name = wxFrameNameStr)
  36     {
  37         Init();
  38
  39         (void)Create(parent, id, title, pos, size, style, name);
  40     }
  41
  42     bool Create(wxWindow *parent,
  43                 wxWindowID id,
  44                 const wxString& title,
  45                 const wxPoint& pos = wxDefaultPosition,
  46                 const wxSize& size = wxDefaultSize,
  47                 long style = wxDEFAULT_FRAME_STYLE,
  48                 const wxString& name = wxFrameNameStr);
  49
  50     virtual ~wxTopLevelWindowMac();
  51
  52     virtual wxPoint GetClientAreaOrigin() const;
  53
  54     // Attracts the users attention to this window if the application is
  55     // inactive (should be called when a background event occurs)
  56     virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);
  57
  58     // implement base class pure virtuals
  59     virtual void Maximize(bool maximize = true);
  60     virtual bool IsMaximized() const;
  61     virtual void Iconize(bool iconize = true);
  62     virtual bool IsIconized() const;
  63     virtual void Restore();
  64
  65     virtual bool SetShape(const wxRegion& region);
  66
  67     virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL) ;
  68     virtual bool IsFullScreen() const ;
  69
  70     virtual bool SetTransparent(wxByte alpha);
  71     virtual bool CanSetTransparent();
  72
  73     virtual bool SetBackgroundStyle(wxBackgroundStyle style);
  74
  75     // implementation from now on
  76     // --------------------------
  77
  78     static void MacDelayedDeactivation(long timestamp);
  79     virtual void MacCreateRealWindow( const wxString& title,
  80                                       const wxPoint& pos,
  81                                       const wxSize& size,
  82                                       long style,
  83                                       const wxString& name ) ;
  84     virtual void ClearBackground() ;
  85
  86     WXWindow MacGetWindowRef() { return m_macWindow ; }
  87     virtual void MacActivate( long timestamp , bool inIsActivating ) ;
  88     virtual void MacPerformUpdates() ;
  89
  90     virtual void SetTitle( const wxString& title);
  91     virtual wxString GetTitle() const;
  92
  93     virtual void Raise();
  94     virtual void Lower();
  95     virtual bool Show( bool show = true );
  96
  97     virtual bool ShowWithEffect(wxShowEffect effect,
  98                                 unsigned timeout = 0,
  99                                 wxDirection dir = wxBOTTOM);
 100
 101     virtual bool HideWithEffect(wxShowEffect effect,
 102                                 unsigned timeout = 0,
 103                                 wxDirection dir = wxBOTTOM);
 104
 105     virtual void SetExtraStyle(long exStyle) ;
 106
 107     virtual bool SetBackgroundColour( const wxColour &colour );
 108
 109     virtual void MacInstallTopLevelWindowEventHandler() ;
 110
 111     bool MacGetMetalAppearance() const ;
 112     bool MacGetUnifiedAppearance() const ;
 113
 114     void MacChangeWindowAttributes( wxUint32 attributesToSet , wxUint32 attributesToClear ) ;
 115     wxUint32 MacGetWindowAttributes() const ;
 116
 117     WXEVENTHANDLERREF    MacGetEventHandler() { return m_macEventHandler ; }
 118
 119     virtual void        MacGetContentAreaInset( int &left , int &top , int &right , int &bottom ) ;
 120
 121 protected:
 122     // common part of all ctors
 123     void Init();
 124
 125     virtual void DoGetPosition( int *x, int *y ) const;
 126     virtual void DoGetSize( int *width, int *height ) const;
 127     virtual void DoMoveWindow(int x, int y, int width, int height);
 128     virtual void DoGetClientSize(int *width, int *height) const;
 129     virtual void DoCentre(int dir);
 130
 131     // is the frame currently iconized?
 132     bool m_iconized;
 133
 134     // should the frame be maximized when it will be shown? set by Maximize()
 135     // when it is called while the frame is hidden
 136     bool m_maximizeOnShow;
 137
 138     WXWindow m_macWindow ;
 139
 140     wxWindowMac* m_macFocus ;
 141     void *m_macFullScreenData ;
 142
 143     static wxTopLevelWindowMac *s_macDeactivateWindow;
 144 private :
 145     // KH: We cannot let this be called directly since the metal appearance is now managed by an
 146     // extra style. Calling this function directly can result in blank white window backgrounds.
 147     // This is because the ExtraStyle flags get out of sync with the metal appearance and the metal
 148     // logic & checks cease to work as expected. To set the metal appearance, use SetExtraStyle.
 149     void MacSetMetalAppearance( bool on ) ;
 150     void MacSetUnifiedAppearance( bool on ) ;
 151     // binary compatible workaround TODO REPLACE
 152     void DoMacCreateRealWindow( wxWindow *parent, const wxString& title,
 153                                       const wxPoint& pos,
 154                                       const wxSize& size,
 155                                       long style,
 156                                       const wxString& name );
 157
 158     WXEVENTHANDLERREF    m_macEventHandler ;
 159
 160     DECLARE_EVENT_TABLE()
 161 };
 162
 163 // list of all frames and modeless dialogs
 164 extern WXDLLEXPORT_DATA(wxWindowList) wxModelessWindows;
 165
 166 #endif // _WX_MSW_TOPLEVEL_H_