]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/toplevel.h
enum wxWebViewBackend has been removed.
[wxWidgets.git] / include / wx / msw / toplevel.h
CommitLineData
82c9f85c
VZ
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)
65571936 9// Licence: wxWindows licence
82c9f85c
VZ
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_MSW_TOPLEVEL_H_
13#define _WX_MSW_TOPLEVEL_H_
14
82c9f85c
VZ
15// ----------------------------------------------------------------------------
16// wxTopLevelWindowMSW
17// ----------------------------------------------------------------------------
18
53a2db12 19class WXDLLIMPEXP_CORE wxTopLevelWindowMSW : public wxTopLevelWindowBase
82c9f85c
VZ
20{
21public:
22 // constructors and such
6463b9f5 23 wxTopLevelWindowMSW() { Init(); }
82c9f85c
VZ
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,
6463b9f5
JS
31 const wxString& name = wxFrameNameStr)
32 {
33 Init();
34
35 (void)Create(parent, id, title, pos, size, style, name);
36 }
82c9f85c
VZ
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
faa49bfd
WS
49 virtual void SetTitle( const wxString& title);
50 virtual wxString GetTitle() const;
bfbb0b4c 51 virtual void Maximize(bool maximize = true);
82c9f85c 52 virtual bool IsMaximized() const;
bfbb0b4c 53 virtual void Iconize(bool iconize = true);
82c9f85c 54 virtual bool IsIconized() const;
f618020a 55 virtual void SetIcons(const wxIconBundle& icons );
82c9f85c 56 virtual void Restore();
d43eb2a0 57
978af864 58 virtual void SetLayoutDirection(wxLayoutDirection dir);
82c9f85c 59
dc92adaf 60 virtual void RequestUserAttention(int flags = wxUSER_ATTENTION_INFO);
1542ea39 61
bfbb0b4c 62 virtual bool Show(bool show = true);
7cee4f76 63 virtual void Raise();
82c9f85c 64
dbc7ceb9 65 virtual void ShowWithoutActivating();
41e929e5
VS
66 virtual bool ShowFullScreen(bool show, long style = wxFULLSCREEN_ALL);
67 virtual bool IsFullScreen() const { return m_fsIsShowing; }
9b9cab37 68
bfbb0b4c 69 // wxMSW only: EnableCloseButton(false) may be used to remove the "Close"
a91cf80c 70 // button from the title bar
5b5210ba 71 virtual bool EnableCloseButton(bool enable = true);
a91cf80c 72
50f3c41d 73 // Set window transparency if the platform supports it
07880314
RD
74 virtual bool SetTransparent(wxByte alpha);
75 virtual bool CanSetTransparent();
50f3c41d 76
d43eb2a0 77
ddae5262
VZ
78 // MSW-specific methods
79 // --------------------
80
81 // Return the menu representing the "system" menu of the window. You can
82 // call wxMenu::AppendWhatever() methods on it but removing items from it
83 // is in general not a good idea.
84 //
85 // The pointer returned by this method belongs to the window and will be
86 // deleted when the window itself is, do not delete it yourself. May return
87 // NULL if getting the system menu failed.
88 wxMenu *MSWGetSystemMenu() const;
89
90
82c9f85c
VZ
91 // implementation from now on
92 // --------------------------
93
085ad686
VZ
94 // event handlers
95 void OnActivate(wxActivateEvent& event);
96
97 // called by wxWindow whenever it gets focus
98 void SetLastFocus(wxWindow *win) { m_winLastFocused = win; }
99 wxWindow *GetLastFocus() const { return m_winLastFocused; }
100
9b141468
WS
101#if defined(__SMARTPHONE__) && defined(__WXWINCE__)
102 virtual void SetLeftMenu(int id = wxID_ANY, const wxString& label = wxEmptyString, wxMenu *subMenu = NULL);
103 virtual void SetRightMenu(int id = wxID_ANY, const wxString& label = wxEmptyString, wxMenu *subMenu = NULL);
fb8a56b7 104 bool HandleCommand(WXWORD id, WXWORD cmd, WXHWND control);
96dcd41a 105 virtual bool MSWShouldPreProcessMessage(WXMSG* pMsg);
9b141468 106#endif // __SMARTPHONE__ && __WXWINCE__
fb8a56b7 107
b7e5ba8f
JG
108#if defined(__SMARTPHONE__) || defined(__POCKETPC__)
109 // Soft Input Panel (SIP) change notification
1272e71b 110 virtual bool HandleSettingChange(WXWPARAM wParam, WXLPARAM lParam);
b7e5ba8f
JG
111#endif
112
6f02a879
VZ
113 // translate wxWidgets flags to Windows ones
114 virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle) const;
115
116 // choose the right parent to use with CreateWindow()
117 virtual WXHWND MSWGetParent() const;
118
119 // window proc for the frames
120 WXLRESULT MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
121
a047aff2
JS
122 // returns true if the platform should explicitly apply a theme border
123 virtual bool CanApplyThemeBorder() const { return false; }
124
82c9f85c
VZ
125protected:
126 // common part of all ctors
127 void Init();
128
bfbb0b4c 129 // create a new frame, return false if it couldn't be created
b225f659
VZ
130 bool CreateFrame(const wxString& title,
131 const wxPoint& pos,
132 const wxSize& size);
133
134 // create a new dialog using the given dialog template from resources,
bfbb0b4c 135 // return false if it couldn't be created
6e8515a3 136 bool CreateDialog(const void *dlgTemplate,
b225f659
VZ
137 const wxString& title,
138 const wxPoint& pos,
139 const wxSize& size);
140
82c9f85c
VZ
141 // common part of Iconize(), Maximize() and Restore()
142 void DoShowWindow(int nShowCmd);
143
d43eb2a0
VZ
144 // override those to return the normal window coordinates even when the
145 // window is minimized
c5dc89a1 146#ifndef __WXWINCE__
d43eb2a0
VZ
147 virtual void DoGetPosition(int *x, int *y) const;
148 virtual void DoGetSize(int *width, int *height) const;
c5dc89a1 149#endif // __WXWINCE__
d43eb2a0 150
17808a75
VZ
151 // Top level windows have different freeze semantics on Windows
152 virtual void DoFreeze();
153 virtual void DoThaw();
154
b9e66233
VZ
155 // helper of SetIcons(): calls gets the icon with the size specified by the
156 // given system metrics (SM_C{X|Y}[SM]ICON) from the bundle and sets it
13f0cfee
VS
157 // using WM_SETICON with the specified wParam (ICOM_SMALL or ICON_BIG);
158 // returns true if the icon was set
159 bool DoSelectAndSetIcon(const wxIconBundle& icons, int smX, int smY, int i);
b9e66233 160
fa5f4858
VZ
161 // override wxWindow virtual method to use CW_USEDEFAULT if necessary
162 virtual void MSWGetCreateWindowCoords(const wxPoint& pos,
163 const wxSize& size,
164 int& x, int& y,
165 int& w, int& h) const;
166
d43eb2a0 167
7e25f59e 168 // is the window currently iconized?
82c9f85c
VZ
169 bool m_iconized;
170
171 // should the frame be maximized when it will be shown? set by Maximize()
172 // when it is called while the frame is hidden
173 bool m_maximizeOnShow;
41e929e5
VS
174
175 // Data to save/restore when calling ShowFullScreen
176 long m_fsStyle; // Passed to ShowFullScreen
177 wxRect m_fsOldSize;
178 long m_fsOldWindowStyle;
179 bool m_fsIsMaximized;
180 bool m_fsIsShowing;
9dfef5ac 181
0c6dff03
VZ
182 // Save the current focus to m_winLastFocused if we're not iconized (the
183 // focus is always NULL when we're iconized).
184 void DoSaveLastFocus();
185
186 // Restore focus to m_winLastFocused if possible and needed.
187 void DoRestoreLastFocus();
188
189 // The last focused child: we remember it when we're deactivated and
190 // restore focus to it when we're activated (this is done here) or restored
191 // from iconic state (done by wxFrame).
085ad686
VZ
192 wxWindow *m_winLastFocused;
193
9b141468 194#if defined(__SMARTPHONE__) && defined(__WXWINCE__)
fb8a56b7
WS
195 class ButtonMenu
196 {
197 public:
198 ButtonMenu();
199 ~ButtonMenu();
200
bfbb0b4c
WS
201 void SetButton(int id = wxID_ANY,
202 const wxString& label = wxEmptyString,
fb8a56b7
WS
203 wxMenu *subMenu = NULL);
204
205 bool IsAssigned() const {return m_assigned;}
206 bool IsMenu() const {return m_menu!=NULL;}
207
208 int GetId() const {return m_id;}
209 wxMenu* GetMenu() const {return m_menu;}
210 wxString GetLabel() {return m_label;}
211
212 static wxMenu *DuplicateMenu(wxMenu *menu);
213
214 protected:
215 int m_id;
216 wxString m_label;
217 wxMenu *m_menu;
218 bool m_assigned;
219 };
220
221 ButtonMenu m_LeftButton;
222 ButtonMenu m_RightButton;
223 HWND m_MenuBarHWND;
224
225 void ReloadButton(ButtonMenu& button, UINT menuID);
226 void ReloadAllButtons();
9b141468 227#endif // __SMARTPHONE__ && __WXWINCE__
fb8a56b7 228
08b97268
WS
229private:
230
231#if defined(__SMARTPHONE__) || defined(__POCKETPC__)
232 void* m_activateInfo;
233#endif
234
ddae5262
VZ
235 // The system menu: initially NULL but can be set (once) by
236 // MSWGetSystemMenu(). Owned by this window.
237 wxMenu *m_menuSystem;
238
085ad686 239 DECLARE_EVENT_TABLE()
c0c133e1 240 wxDECLARE_NO_COPY_CLASS(wxTopLevelWindowMSW);
82c9f85c
VZ
241};
242
82c9f85c 243#endif // _WX_MSW_TOPLEVEL_H_