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 // ----------------------------------------------------------------------------
  16 // wxTopLevelWindowMSW
  17 // ----------------------------------------------------------------------------
  18
  19 class WXDLLEXPORT wxTopLevelWindowMSW : public wxTopLevelWindowBase
  20 {
  21 public:
  22     // constructors and such
  23     wxTopLevelWindowMSW() { Init(); }
  24
  25     wxTopLevelWindowMSW(wxWindow *parent,
  26                         wxWindowID id,
  27                         const wxString& title,
  28                         const wxPoint& pos = wxDefaultPosition,
  29                         const wxSize& size = wxDefaultSize,
  30                         long style = wxDEFAULT_FRAME_STYLE,
  31                         const wxString& name = wxFrameNameStr)
  32     {
  33         Init();
  34
  35         (void)Create(parent, id, title, pos, size, style, name);
  36     }
  37
  38     bool Create(wxWindow *parent,
  39                 wxWindowID id,
  40                 const wxString& title,
  41                 const wxPoint& pos = wxDefaultPosition,
  42                 const wxSize& size = wxDefaultSize,
  43                 long style = wxDEFAULT_FRAME_STYLE,
  44                 const wxString& name = wxFrameNameStr);
  45
  46     virtual ~wxTopLevelWindowMSW();
  47
  48     // implement base class pure virtuals
  49     virtual void SetTitle( const wxString& title);
  50     virtual wxString GetTitle() const;
  51     virtual void Maximize(bool maximize = true);
  52     virtual bool IsMaximized() const;
  53     virtual void Iconize(bool iconize = true);
  54     virtual bool IsIconized() const;
  55     virtual void SetIcon(const wxIcon& icon);
  56     virtual void SetIcons(const wxIconBundle& icons );
  57     virtual void Restore();
  58
  59 #ifndef __WXWINCE__
  60     virtual bool SetShape(const wxRegion& region);
  61 #endif // __WXWINCE__
  62     virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);
  63
  64     virtual bool Show(bool show = true);
  65
  66     virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL);
  67     virtual bool IsFullScreen() const { return m_fsIsShowing; }
  68
  69     // wxMSW only: EnableCloseButton(false) may be used to remove the "Close"
  70     // button from the title bar
  71     bool EnableCloseButton(bool enable = true);
  72
  73     // Set window transparency if the platform supports it
  74     virtual bool SetTransparent(wxByte alpha);
  75     virtual bool CanSetTransparent();
  76
  77
  78     // implementation from now on
  79     // --------------------------
  80
  81     // event handlers
  82     void OnActivate(wxActivateEvent& event);
  83
  84     // called by wxWindow whenever it gets focus
  85     void SetLastFocus(wxWindow *win) { m_winLastFocused = win; }
  86     wxWindow *GetLastFocus() const { return m_winLastFocused; }
  87
  88 #if defined(__SMARTPHONE__) && defined(__WXWINCE__)
  89     virtual void SetLeftMenu(int id = wxID_ANY, const wxString& label = wxEmptyString, wxMenu *subMenu = NULL);
  90     virtual void SetRightMenu(int id = wxID_ANY, const wxString& label = wxEmptyString, wxMenu *subMenu = NULL);
  91     bool HandleCommand(WXWORD id, WXWORD cmd, WXHWND control);
  92     virtual bool MSWShouldPreProcessMessage(WXMSG* pMsg);
  93 #endif // __SMARTPHONE__ && __WXWINCE__
  94
  95 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
  96     // Soft Input Panel (SIP) change notification
  97     virtual bool HandleSettingChange(WXWPARAM wParam, WXLPARAM lParam);
  98 #endif
  99
 100     // translate wxWidgets flags to Windows ones
 101     virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle) const;
 102
 103     // choose the right parent to use with CreateWindow()
 104     virtual WXHWND MSWGetParent() const;
 105
 106     // return true if the message was preprocessed and shouldn't be dispatched
 107     virtual bool MSWProcessMessage(WXMSG* pMsg);
 108
 109     // window proc for the frames
 110     WXLRESULT MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
 111
 112 protected:
 113     // common part of all ctors
 114     void Init();
 115
 116     // create a new frame, return false if it couldn't be created
 117     bool CreateFrame(const wxString& title,
 118                      const wxPoint& pos,
 119                      const wxSize& size);
 120
 121     // create a new dialog using the given dialog template from resources,
 122     // return false if it couldn't be created
 123     bool CreateDialog(const void *dlgTemplate,
 124                       const wxString& title,
 125                       const wxPoint& pos,
 126                       const wxSize& size);
 127
 128     // common part of Iconize(), Maximize() and Restore()
 129     void DoShowWindow(int nShowCmd);
 130
 131     // is the window 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     // Data to save/restore when calling ShowFullScreen
 139     long                  m_fsStyle; // Passed to ShowFullScreen
 140     wxRect                m_fsOldSize;
 141     long                  m_fsOldWindowStyle;
 142     bool                  m_fsIsMaximized;
 143     bool                  m_fsIsShowing;
 144
 145     // the last focused child: we restore focus to it on activation
 146     wxWindow             *m_winLastFocused;
 147
 148 #if defined(__SMARTPHONE__) && defined(__WXWINCE__)
 149     class ButtonMenu
 150     {
 151     public:
 152         ButtonMenu();
 153         ~ButtonMenu();
 154
 155         void SetButton(int id = wxID_ANY,
 156                        const wxString& label  = wxEmptyString,
 157                        wxMenu *subMenu = NULL);
 158
 159         bool IsAssigned() const {return m_assigned;}
 160         bool IsMenu() const {return m_menu!=NULL;}
 161
 162         int GetId() const {return m_id;}
 163         wxMenu* GetMenu() const {return m_menu;}
 164         wxString GetLabel() {return m_label;}
 165
 166         static wxMenu *DuplicateMenu(wxMenu *menu);
 167
 168     protected:
 169         int      m_id;
 170         wxString m_label;
 171         wxMenu  *m_menu;
 172         bool     m_assigned;
 173     };
 174
 175     ButtonMenu               m_LeftButton;
 176     ButtonMenu               m_RightButton;
 177     HWND                     m_MenuBarHWND;
 178
 179     void ReloadButton(ButtonMenu& button, UINT menuID);
 180     void ReloadAllButtons();
 181 #endif // __SMARTPHONE__ && __WXWINCE__
 182
 183 private:
 184
 185 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
 186     void* m_activateInfo;
 187 #endif
 188
 189     DECLARE_EVENT_TABLE()
 190     DECLARE_NO_COPY_CLASS(wxTopLevelWindowMSW)
 191 };
 192
 193 #endif // _WX_MSW_TOPLEVEL_H_