include/wx/msw/toplevel.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/msw/toplevel.h
   3 // Purpose:     wxTopLevelWindowMSW is the MSW implementation of wxTLW
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     20.09.01
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2001 SciTech Software, Inc. (www.scitechsoft.com)
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_MSW_TOPLEVEL_H_
  13 #define _WX_MSW_TOPLEVEL_H_
  14
  15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  16     #pragma interface "toplevel.h"
  17 #endif
  18
  19 // ----------------------------------------------------------------------------
  20 // wxTopLevelWindowMSW
  21 // ----------------------------------------------------------------------------
  22
  23 class WXDLLEXPORT wxTopLevelWindowMSW : public wxTopLevelWindowBase
  24 {
  25 public:
  26     // constructors and such
  27     wxTopLevelWindowMSW() { Init(); }
  28
  29     wxTopLevelWindowMSW(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 ~wxTopLevelWindowMSW();
  51
  52     // implement base class pure virtuals
  53     virtual void Maximize(bool maximize = TRUE);
  54     virtual bool IsMaximized() const;
  55     virtual void Iconize(bool iconize = TRUE);
  56     virtual bool IsIconized() const;
  57     virtual void SetIcon(const wxIcon& icon);
  58     virtual void SetIcons(const wxIconBundle& icons );
  59     virtual void Restore();
  60
  61 #ifndef __WXWINCE__
  62     virtual bool SetShape(const wxRegion& region);
  63 #endif // __WXWINCE__
  64
  65     virtual bool Show(bool show = TRUE);
  66
  67     virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL);
  68     virtual bool IsFullScreen() const { return m_fsIsShowing; }
  69
  70     // wxMSW only: EnableCloseButton(FALSE) may be used to remove the "Close"
  71     // button from the title bar
  72     bool EnableCloseButton(bool enable = TRUE);
  73
  74     // implementation from now on
  75     // --------------------------
  76
  77     // event handlers
  78     void OnActivate(wxActivateEvent& event);
  79
  80     // called by wxWindow whenever it gets focus
  81     void SetLastFocus(wxWindow *win) { m_winLastFocused = win; }
  82     wxWindow *GetLastFocus() const { return m_winLastFocused; }
  83
  84 protected:
  85     // common part of all ctors
  86     void Init();
  87
  88     // create a new frame, return FALSE if it couldn't be created
  89     bool CreateFrame(const wxString& title,
  90                      const wxPoint& pos,
  91                      const wxSize& size);
  92
  93     // create a new dialog using the given dialog template from resources,
  94     // return FALSE if it couldn't be created
  95     bool CreateDialog(const void *dlgTemplate,
  96                       const wxString& title,
  97                       const wxPoint& pos,
  98                       const wxSize& size);
  99
 100     // common part of Iconize(), Maximize() and Restore()
 101     void DoShowWindow(int nShowCmd);
 102
 103     // translate wxWindows flags to Windows ones
 104     virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle) const;
 105
 106     // choose the right parent to use with CreateWindow()
 107     virtual WXHWND MSWGetParent() const;
 108
 109     // is the window currently iconized?
 110     bool m_iconized;
 111
 112     // should the frame be maximized when it will be shown? set by Maximize()
 113     // when it is called while the frame is hidden
 114     bool m_maximizeOnShow;
 115
 116     // Data to save/restore when calling ShowFullScreen
 117     long                  m_fsStyle; // Passed to ShowFullScreen
 118     wxRect                m_fsOldSize;
 119     long                  m_fsOldWindowStyle;
 120     bool                  m_fsIsMaximized;
 121     bool                  m_fsIsShowing;
 122
 123     // the last focused child: we restore focus to it on activation
 124     wxWindow             *m_winLastFocused;
 125
 126     DECLARE_EVENT_TABLE()
 127     DECLARE_NO_COPY_CLASS(wxTopLevelWindowMSW)
 128 };
 129
 130 // list of all frames and modeless dialogs
 131 extern WXDLLEXPORT_DATA(wxWindowList) wxModelessWindows;
 132
 133 #endif // _WX_MSW_TOPLEVEL_H_
 134