include/wx/gtk/toplevel.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/gtk/toplevel.h
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Id:          $Id$
   6 // Copyright:   (c) 1998 Robert Roebling, Julian Smart
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifndef _WX_GTK_TOPLEVEL_H_
  11 #define _WX_GTK_TOPLEVEL_H_
  12
  13 //-----------------------------------------------------------------------------
  14 // wxTopLevelWindowGTK
  15 //-----------------------------------------------------------------------------
  16
  17 class WXDLLIMPEXP_CORE wxTopLevelWindowGTK : public wxTopLevelWindowBase
  18 {
  19 public:
  20     // construction
  21     wxTopLevelWindowGTK() { Init(); }
  22     wxTopLevelWindowGTK(wxWindow *parent,
  23                         wxWindowID id,
  24                         const wxString& title,
  25                         const wxPoint& pos = wxDefaultPosition,
  26                         const wxSize& size = wxDefaultSize,
  27                         long style = wxDEFAULT_FRAME_STYLE,
  28                         const wxString& name = wxFrameNameStr)
  29     {
  30         Init();
  31
  32         Create(parent, id, title, pos, size, style, name);
  33     }
  34
  35     bool Create(wxWindow *parent,
  36                 wxWindowID id,
  37                 const wxString& title,
  38                 const wxPoint& pos = wxDefaultPosition,
  39                 const wxSize& size = wxDefaultSize,
  40                 long style = wxDEFAULT_FRAME_STYLE,
  41                 const wxString& name = wxFrameNameStr);
  42
  43     virtual ~wxTopLevelWindowGTK();
  44
  45     // implement base class pure virtuals
  46     virtual void Maximize(bool maximize = true);
  47     virtual bool IsMaximized() const;
  48     virtual void Iconize(bool iconize = true);
  49     virtual bool IsIconized() const;
  50     virtual void SetIcons(const wxIconBundle& icons);
  51     virtual void Restore();
  52
  53     virtual bool EnableCloseButton(bool enable = true);
  54
  55     virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL);
  56     virtual bool IsFullScreen() const { return m_fsIsShowing; };
  57
  58     virtual bool SetShape(const wxRegion& region);
  59
  60     virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);
  61
  62     virtual void SetWindowStyleFlag( long style );
  63
  64     virtual bool Show(bool show = true);
  65
  66     virtual void Raise();
  67
  68     virtual bool IsActive();
  69
  70     virtual void SetTitle( const wxString &title );
  71     virtual wxString GetTitle() const { return m_title; }
  72
  73     virtual bool SetTransparent(wxByte alpha);
  74     virtual bool CanSetTransparent();
  75
  76     // Experimental, to allow help windows to be
  77     // viewable from within modal dialogs
  78     virtual void AddGrab();
  79     virtual void RemoveGrab();
  80     virtual bool IsGrabbed() const { return m_grabbed; }
  81
  82     // implementation from now on
  83     // --------------------------
  84
  85     // GTK callbacks
  86     virtual void GtkOnSize();
  87     virtual void OnInternalIdle();
  88
  89     // do *not* call this to iconize the frame, this is a private function!
  90     void SetIconizeState(bool iconic);
  91
  92     int           m_miniEdge,
  93                   m_miniTitle;
  94     GtkWidget    *m_mainWidget;
  95
  96     bool          m_fsIsShowing;         /* full screen */
  97     long          m_fsSaveGdkFunc, m_fsSaveGdkDecor;
  98     long          m_fsSaveFlag;
  99     wxRect        m_fsSaveFrame;
 100
 101     // m_windowStyle translated to GDK's terms
 102     long          m_gdkFunc,
 103                   m_gdkDecor;
 104
 105     bool m_sizeSet;
 106
 107     // private gtk_timeout_add result for mimicing wxUSER_ATTENTION_INFO and
 108     // wxUSER_ATTENTION_ERROR difference, -2 for no hint, -1 for ERROR hint, rest for GtkTimeout handle.
 109     int m_urgency_hint;
 110
 111     // give hints to the Window Manager for how the size
 112     // of the TLW can be changed by dragging
 113     virtual void DoSetSizeHints( int minW, int minH,
 114                                  int maxW = wxDefaultCoord, int maxH = wxDefaultCoord,
 115                                  int incW = wxDefaultCoord, int incH = wxDefaultCoord );
 116
 117     // return the full size of the window without WM decorations
 118     void GTKDoGetSize(int *width, int *height) const;
 119
 120     void GtkUpdateSize() { m_sizeSet = false; }
 121
 122 protected:
 123     // common part of all ctors
 124     void Init();
 125
 126     // move the window to the specified location and resize it
 127     virtual void DoMoveWindow(int x, int y, int width, int height);
 128
 129     // take into account WM decorations here
 130     virtual void DoGetSize(int *width, int *height) const;
 131     virtual void DoSetSize(int x, int y,
 132                            int width, int height,
 133                            int sizeFlags = wxSIZE_AUTO);
 134
 135     // override these methods to take into account tool/menu/statusbars
 136     virtual void DoGetClientSize(int *width, int *height) const;
 137
 138     // this method takes the size of the window not taking account of
 139     // decorations
 140     void GTKDoSetSize(int width, int height);
 141
 142
 143     // string shown in the title bar
 144     wxString m_title;
 145
 146     // is the frame currently iconized?
 147     bool m_isIconized;
 148
 149     // is the frame currently grabbed explicitly by the application?
 150     bool m_grabbed;
 151 };
 152
 153 #endif // _WX_GTK_TOPLEVEL_H_