]>
Commit | Line | Data |
---|---|---|
2bda0e17 | 1 | ///////////////////////////////////////////////////////////////////////////// |
1e6feb95 | 2 | // Name: wx/msw/window.h |
faa49bfd | 3 | // Purpose: wxWindowMSW class |
2bda0e17 | 4 | // Author: Julian Smart |
1e6feb95 VZ |
5 | // Modified by: Vadim Zeitlin on 13.05.99: complete refont of message handling, |
6 | // elimination of Default(), ... | |
2bda0e17 KB |
7 | // Created: 01/02/97 |
8 | // RCS-ID: $Id$ | |
371a5b4e | 9 | // Copyright: (c) Julian Smart |
65571936 | 10 | // Licence: wxWindows licence |
2bda0e17 KB |
11 | ///////////////////////////////////////////////////////////////////////////// |
12 | ||
bbcdf8bc JS |
13 | #ifndef _WX_WINDOW_H_ |
14 | #define _WX_WINDOW_H_ | |
2bda0e17 | 15 | |
cf7715db | 16 | #include "wx/settings.h" // solely for wxSystemColour |
a5b1be33 | 17 | |
6bd9b9f2 VZ |
18 | // if this is set to 1, we use deferred window sizing to reduce flicker when |
19 | // resizing complicated window hierarchies, but this can in theory result in | |
20 | // different behaviour than the old code so we keep the possibility to use it | |
21 | // by setting this to 0 (in the future this should be removed completely) | |
22 | #ifdef __WXWINCE__ | |
23 | #define wxUSE_DEFERRED_SIZING 0 | |
24 | #else | |
25 | #define wxUSE_DEFERRED_SIZING 1 | |
26 | #endif | |
1e6d9499 | 27 | |
cc2b7472 VZ |
28 | // --------------------------------------------------------------------------- |
29 | // wxWindow declaration for MSW | |
30 | // --------------------------------------------------------------------------- | |
b782f2e0 | 31 | |
53a2db12 | 32 | class WXDLLIMPEXP_CORE wxWindowMSW : public wxWindowBase |
1e6d9499 | 33 | { |
8e44f3ca JS |
34 | friend class wxSpinCtrl; |
35 | friend class wxSlider; | |
36 | friend class wxRadioBox; | |
fa61fec5 MW |
37 | #if defined __VISUALC__ && __VISUALC__ <= 1200 |
38 | friend class wxWindowMSW; | |
39 | #endif | |
2bda0e17 | 40 | public: |
6463b9f5 | 41 | wxWindowMSW() { Init(); } |
1e6feb95 VZ |
42 | |
43 | wxWindowMSW(wxWindow *parent, | |
44 | wxWindowID id, | |
45 | const wxPoint& pos = wxDefaultPosition, | |
46 | const wxSize& size = wxDefaultSize, | |
47 | long style = 0, | |
6463b9f5 JS |
48 | const wxString& name = wxPanelNameStr) |
49 | { | |
50 | Init(); | |
51 | Create(parent, id, pos, size, style, name); | |
52 | } | |
2bda0e17 | 53 | |
1e6feb95 | 54 | virtual ~wxWindowMSW(); |
2bda0e17 | 55 | |
cc2b7472 VZ |
56 | bool Create(wxWindow *parent, |
57 | wxWindowID id, | |
58 | const wxPoint& pos = wxDefaultPosition, | |
59 | const wxSize& size = wxDefaultSize, | |
60 | long style = 0, | |
61 | const wxString& name = wxPanelNameStr); | |
bfc6fde4 | 62 | |
cc2b7472 | 63 | // implement base class pure virtuals |
faa49bfd WS |
64 | virtual void SetLabel(const wxString& label); |
65 | virtual wxString GetLabel() const; | |
42e69d6b | 66 | |
bfc6fde4 | 67 | virtual void Raise(); |
bfc6fde4 VZ |
68 | virtual void Lower(); |
69 | ||
376d7d97 VZ |
70 | virtual bool Show(bool show = true); |
71 | virtual bool ShowWithEffect(wxShowEffect effect, | |
eed04c99 | 72 | unsigned timeout = 0) |
376d7d97 | 73 | { |
eed04c99 | 74 | return MSWShowWithEffect(true, effect, timeout); |
376d7d97 VZ |
75 | } |
76 | virtual bool HideWithEffect(wxShowEffect effect, | |
eed04c99 | 77 | unsigned timeout = 0) |
376d7d97 | 78 | { |
eed04c99 | 79 | return MSWShowWithEffect(false, effect, timeout); |
376d7d97 | 80 | } |
bfc6fde4 | 81 | |
cc2b7472 | 82 | virtual void SetFocus(); |
ddf9d04f | 83 | virtual void SetFocusFromKbd(); |
bfc6fde4 | 84 | |
1e6feb95 | 85 | virtual bool Reparent(wxWindowBase *newParent); |
bfc6fde4 | 86 | |
cc2b7472 | 87 | virtual void WarpPointer(int x, int y); |
bfc6fde4 | 88 | |
27d2dbbc | 89 | virtual void Refresh( bool eraseBackground = true, |
cc2b7472 | 90 | const wxRect *rect = (const wxRect *) NULL ); |
1e6feb95 | 91 | virtual void Update(); |
bfc6fde4 | 92 | |
7bd6bf45 VZ |
93 | virtual void SetWindowStyleFlag(long style); |
94 | virtual void SetExtraStyle(long exStyle); | |
cc2b7472 VZ |
95 | virtual bool SetCursor( const wxCursor &cursor ); |
96 | virtual bool SetFont( const wxFont &font ); | |
bfc6fde4 | 97 | |
bfc6fde4 VZ |
98 | virtual int GetCharHeight() const; |
99 | virtual int GetCharWidth() const; | |
cc2b7472 | 100 | |
cc2b7472 | 101 | virtual void SetScrollbar( int orient, int pos, int thumbVisible, |
27d2dbbc WS |
102 | int range, bool refresh = true ); |
103 | virtual void SetScrollPos( int orient, int pos, bool refresh = true ); | |
cc2b7472 VZ |
104 | virtual int GetScrollPos( int orient ) const; |
105 | virtual int GetScrollThumb( int orient ) const; | |
106 | virtual int GetScrollRange( int orient ) const; | |
107 | virtual void ScrollWindow( int dx, int dy, | |
d3b9f782 | 108 | const wxRect* rect = NULL ); |
2bda0e17 | 109 | |
9cd6d737 VZ |
110 | virtual bool ScrollLines(int lines); |
111 | virtual bool ScrollPages(int pages); | |
b9b3393e | 112 | |
978af864 VZ |
113 | virtual void SetLayoutDirection(wxLayoutDirection dir); |
114 | virtual wxLayoutDirection GetLayoutDirection() const; | |
115 | virtual wxCoord AdjustForLayoutDirection(wxCoord x, | |
116 | wxCoord width, | |
117 | wxCoord widthTotal) const; | |
118 | ||
47d67540 | 119 | #if wxUSE_DRAG_AND_DROP |
cc2b7472 VZ |
120 | virtual void SetDropTarget( wxDropTarget *dropTarget ); |
121 | #endif // wxUSE_DRAG_AND_DROP | |
9f3362c4 | 122 | |
bfc6fde4 VZ |
123 | // Accept files for dragging |
124 | virtual void DragAcceptFiles(bool accept); | |
2bda0e17 | 125 | |
1e6feb95 | 126 | #ifndef __WXUNIVERSAL__ |
cc2b7472 VZ |
127 | // Native resource loading (implemented in src/msw/nativdlg.cpp) |
128 | // FIXME: should they really be all virtual? | |
bfc6fde4 VZ |
129 | virtual bool LoadNativeDialog(wxWindow* parent, wxWindowID& id); |
130 | virtual bool LoadNativeDialog(wxWindow* parent, const wxString& name); | |
42e69d6b VZ |
131 | wxWindow* GetWindowChild1(wxWindowID id); |
132 | wxWindow* GetWindowChild(wxWindowID id); | |
1e6feb95 | 133 | #endif // __WXUNIVERSAL__ |
2bda0e17 | 134 | |
540b6b09 | 135 | #if wxUSE_HOTKEY |
5048c832 | 136 | // install and deinstall a system wide hotkey |
540b6b09 | 137 | virtual bool RegisterHotKey(int hotkeyId, int modifiers, int keycode); |
5048c832 | 138 | virtual bool UnregisterHotKey(int hotkeyId); |
540b6b09 | 139 | #endif // wxUSE_HOTKEY |
5048c832 | 140 | |
7d4f65e3 JS |
141 | #ifdef __POCKETPC__ |
142 | bool IsContextMenuEnabled() const { return m_contextMenuEnabled; } | |
143 | void EnableContextMenu(bool enable = true) { m_contextMenuEnabled = enable; } | |
144 | #endif | |
145 | ||
ed4780ea VZ |
146 | // window handle stuff |
147 | // ------------------- | |
2bda0e17 | 148 | |
d7c24517 VZ |
149 | WXHWND GetHWND() const { return m_hWnd; } |
150 | void SetHWND(WXHWND hWnd) { m_hWnd = hWnd; } | |
151 | virtual WXWidget GetHandle() const { return GetHWND(); } | |
2bda0e17 | 152 | |
ed4780ea VZ |
153 | void AssociateHandle(WXWidget handle); |
154 | void DissociateHandle(); | |
155 | ||
f7040b5f VZ |
156 | // does this window have deferred position and/or size? |
157 | bool IsSizeDeferred() const; | |
158 | ||
5acec112 VZ |
159 | // these functions allow to register a global handler for the given Windows |
160 | // message: it will be called from MSWWindowProc() of any window which gets | |
161 | // this event if it's not processed before (i.e. unlike a hook procedure it | |
162 | // does not override the normal processing) | |
163 | // | |
164 | // notice that if you want to process a message for a given window only you | |
165 | // should override its MSWWindowProc() instead | |
166 | ||
167 | // type of the handler: it is called with the message parameters (except | |
168 | // that the window object is passed instead of window handle) and should | |
169 | // return true if it handled the message or false if it should be passed to | |
170 | // DefWindowProc() | |
2035ad11 | 171 | typedef bool (*MSWMessageHandler)(wxWindowMSW *win, |
5acec112 VZ |
172 | WXUINT nMsg, |
173 | WXWPARAM wParam, | |
174 | WXLPARAM lParam); | |
175 | ||
176 | // install a handler, shouldn't be called more than one for the same message | |
177 | static bool MSWRegisterMessageHandler(int msg, MSWMessageHandler handler); | |
178 | ||
179 | // unregister a previously registered handler | |
180 | static void MSWUnregisterMessageHandler(int msg, MSWMessageHandler handler); | |
181 | ||
ed4780ea VZ |
182 | |
183 | // implementation from now on | |
184 | // ========================== | |
185 | ||
cc2b7472 VZ |
186 | // event handlers |
187 | // -------------- | |
00c4e897 | 188 | |
63da7df7 | 189 | void OnPaint(wxPaintEvent& event); |
79099b80 | 190 | #ifdef __WXWINCE__ |
8681b094 | 191 | void OnInitDialog(wxInitDialogEvent& event); |
79099b80 | 192 | #endif |
2bda0e17 | 193 | |
2bda0e17 | 194 | public: |
bfc6fde4 VZ |
195 | // Windows subclassing |
196 | void SubclassWin(WXHWND hWnd); | |
197 | void UnsubclassWin(); | |
bfc6fde4 | 198 | |
a23fd0e1 VZ |
199 | WXFARPROC MSWGetOldWndProc() const { return m_oldWndProc; } |
200 | void MSWSetOldWndProc(WXFARPROC proc) { m_oldWndProc = proc; } | |
bfc6fde4 | 201 | |
27d2dbbc | 202 | // return true if the window is of a standard (i.e. not wxWidgets') class |
5a403e3f VZ |
203 | // |
204 | // to understand why does it work, look at SubclassWin() code and comments | |
205 | bool IsOfStandardClass() const { return m_oldWndProc != NULL; } | |
206 | ||
197dd9af | 207 | wxWindow *FindItem(long id) const; |
27d2dbbc | 208 | wxWindow *FindItemByHWND(WXHWND hWnd, bool controlOnly = false) const; |
bfc6fde4 | 209 | |
27d2dbbc | 210 | // MSW only: true if this control is part of the main control |
47b378bd | 211 | virtual bool ContainsHWND(WXHWND WXUNUSED(hWnd)) const { return false; } |
bfc6fde4 | 212 | |
c009bf3e VZ |
213 | #if wxUSE_TOOLTIPS |
214 | // MSW only: true if this window or any of its children have a tooltip | |
215 | virtual bool HasToolTips() const { return GetToolTip() != NULL; } | |
216 | #endif // wxUSE_TOOLTIPS | |
217 | ||
77ffb593 | 218 | // translate wxWidgets style flags for this control into the Windows style |
b2d5a7ee VZ |
219 | // and optional extended style for the corresponding native control |
220 | // | |
221 | // this is the function that should be overridden in the derived classes, | |
222 | // but you will mostly use MSWGetCreateWindowFlags() below | |
fe3d9123 | 223 | virtual WXDWORD MSWGetStyle(long flags, WXDWORD *exstyle = NULL) const ; |
b2d5a7ee | 224 | |
77ffb593 | 225 | // get the MSW window flags corresponding to wxWidgets ones |
b2d5a7ee VZ |
226 | // |
227 | // the functions returns the flags (WS_XXX) directly and puts the ext | |
228 | // (WS_EX_XXX) flags into the provided pointer if not NULL | |
229 | WXDWORD MSWGetCreateWindowFlags(WXDWORD *exflags = NULL) const | |
230 | { return MSWGetStyle(GetWindowStyle(), exflags); } | |
231 | ||
7bd6bf45 VZ |
232 | // update the real underlying window style flags to correspond to the |
233 | // current wxWindow object style (safe to call even if window isn't fully | |
234 | // created yet) | |
235 | void MSWUpdateStyle(long flagsOld, long exflagsOld); | |
236 | ||
9dfef5ac VZ |
237 | // get the HWND to be used as parent of this window with CreateWindow() |
238 | virtual WXHWND MSWGetParent() const; | |
239 | ||
d9698bd4 VZ |
240 | // get the Win32 window class name used by all wxWindow objects by default |
241 | static const wxChar *MSWGetRegisteredClassName(); | |
242 | ||
b225f659 VZ |
243 | // creates the window of specified Windows class with given style, extended |
244 | // style, title and geometry (default values | |
245 | // | |
27d2dbbc | 246 | // returns true if the window has been created, false if creation failed |
b225f659 VZ |
247 | bool MSWCreate(const wxChar *wclass, |
248 | const wxChar *title = NULL, | |
249 | const wxPoint& pos = wxDefaultPosition, | |
250 | const wxSize& size = wxDefaultSize, | |
251 | WXDWORD style = 0, | |
a23fd0e1 | 252 | WXDWORD exendedStyle = 0); |
b225f659 | 253 | |
42e69d6b | 254 | virtual bool MSWCommand(WXUINT param, WXWORD id); |
bfc6fde4 | 255 | |
1e6feb95 | 256 | #ifndef __WXUNIVERSAL__ |
bfc6fde4 VZ |
257 | // Create an appropriate wxWindow from a HWND |
258 | virtual wxWindow* CreateWindowFromHWND(wxWindow* parent, WXHWND hWnd); | |
259 | ||
260 | // Make sure the window style reflects the HWND style (roughly) | |
261 | virtual void AdoptAttributesFromHWND(); | |
1e6feb95 | 262 | #endif // __WXUNIVERSAL__ |
bfc6fde4 VZ |
263 | |
264 | // Setup background and foreground colours correctly | |
265 | virtual void SetupColours(); | |
266 | ||
42e69d6b VZ |
267 | // ------------------------------------------------------------------------ |
268 | // helpers for message handlers: these perform the same function as the | |
269 | // message crackers from <windowsx.h> - they unpack WPARAM and LPARAM into | |
270 | // the correct parameters | |
271 | // ------------------------------------------------------------------------ | |
272 | ||
273 | void UnpackCommand(WXWPARAM wParam, WXLPARAM lParam, | |
274 | WXWORD *id, WXHWND *hwnd, WXWORD *cmd); | |
275 | void UnpackActivate(WXWPARAM wParam, WXLPARAM lParam, | |
276 | WXWORD *state, WXWORD *minimized, WXHWND *hwnd); | |
277 | void UnpackScroll(WXWPARAM wParam, WXLPARAM lParam, | |
278 | WXWORD *code, WXWORD *pos, WXHWND *hwnd); | |
279 | void UnpackCtlColor(WXWPARAM wParam, WXLPARAM lParam, | |
01c500af | 280 | WXHDC *hdc, WXHWND *hwnd); |
42e69d6b VZ |
281 | void UnpackMenuSelect(WXWPARAM wParam, WXLPARAM lParam, |
282 | WXWORD *item, WXWORD *flags, WXHMENU *hmenu); | |
283 | ||
a23fd0e1 | 284 | // ------------------------------------------------------------------------ |
3cfcd50b | 285 | // internal handlers for MSW messages: all handlers return a boolean value: |
27d2dbbc | 286 | // true means that the handler processed the event and false that it didn't |
a23fd0e1 | 287 | // ------------------------------------------------------------------------ |
bfc6fde4 | 288 | |
42e69d6b VZ |
289 | // there are several cases where we have virtual functions for Windows |
290 | // message processing: this is because these messages often require to be | |
291 | // processed in a different manner in the derived classes. For all other | |
292 | // messages, however, we do *not* have corresponding MSWOnXXX() function | |
293 | // and if the derived class wants to process them, it should override | |
294 | // MSWWindowProc() directly. | |
a23fd0e1 | 295 | |
42e69d6b | 296 | // scroll event (both horizontal and vertical) |
a23fd0e1 VZ |
297 | virtual bool MSWOnScroll(int orientation, WXWORD nSBCode, |
298 | WXWORD pos, WXHWND control); | |
299 | ||
42e69d6b | 300 | // child control notifications |
a23fd0e1 | 301 | virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result); |
a23fd0e1 | 302 | |
42e69d6b VZ |
303 | // owner-drawn controls need to process these messages |
304 | virtual bool MSWOnDrawItem(int id, WXDRAWITEMSTRUCT *item); | |
305 | virtual bool MSWOnMeasureItem(int id, WXMEASUREITEMSTRUCT *item); | |
306 | ||
307 | // the rest are not virtual | |
308 | bool HandleCreate(WXLPCREATESTRUCT cs, bool *mayCreate); | |
309 | bool HandleInitDialog(WXHWND hWndFocus); | |
310 | bool HandleDestroy(); | |
311 | ||
312 | bool HandlePaint(); | |
1a784dfc VZ |
313 | bool HandlePrintClient(WXHDC hDC); |
314 | bool HandleEraseBkgnd(WXHDC hDC); | |
42e69d6b VZ |
315 | |
316 | bool HandleMinimize(); | |
317 | bool HandleMaximize(); | |
318 | bool HandleSize(int x, int y, WXUINT flag); | |
5706de1c | 319 | bool HandleSizing(wxRect& rect); |
42e69d6b | 320 | bool HandleGetMinMaxInfo(void *mmInfo); |
aa767a45 JS |
321 | bool HandleEnterSizeMove(); |
322 | bool HandleExitSizeMove(); | |
42e69d6b VZ |
323 | |
324 | bool HandleShow(bool show, int status); | |
325 | bool HandleActivate(int flag, bool minimized, WXHWND activate); | |
326 | ||
327 | bool HandleCommand(WXWORD id, WXWORD cmd, WXHWND control); | |
42e69d6b | 328 | |
48fa6bd3 | 329 | bool HandleCtlColor(WXHBRUSH *hBrush, WXHDC hdc, WXHWND hWnd); |
a23fd0e1 | 330 | |
42e69d6b VZ |
331 | bool HandlePaletteChanged(WXHWND hWndPalChange); |
332 | bool HandleQueryNewPalette(); | |
333 | bool HandleSysColorChange(); | |
574c939e | 334 | bool HandleDisplayChange(); |
a5e84126 | 335 | bool HandleCaptureChanged(WXHWND gainedCapture); |
1272e71b | 336 | virtual bool HandleSettingChange(WXWPARAM wParam, WXLPARAM lParam); |
a23fd0e1 | 337 | |
42e69d6b VZ |
338 | bool HandleQueryEndSession(long logOff, bool *mayEnd); |
339 | bool HandleEndSession(bool endSession, long logOff); | |
a23fd0e1 | 340 | |
42e69d6b VZ |
341 | bool HandleSetFocus(WXHWND wnd); |
342 | bool HandleKillFocus(WXHWND wnd); | |
bfc6fde4 | 343 | |
42e69d6b | 344 | bool HandleDropFiles(WXWPARAM wParam); |
bfc6fde4 | 345 | |
42e69d6b VZ |
346 | bool HandleMouseEvent(WXUINT msg, int x, int y, WXUINT flags); |
347 | bool HandleMouseMove(int x, int y, WXUINT flags); | |
d2c52078 | 348 | bool HandleMouseWheel(WXWPARAM wParam, WXLPARAM lParam); |
bfc6fde4 | 349 | |
b6885972 | 350 | bool HandleChar(WXWPARAM wParam, WXLPARAM lParam); |
33ac7e6f KB |
351 | bool HandleKeyDown(WXWPARAM wParam, WXLPARAM lParam); |
352 | bool HandleKeyUp(WXWPARAM wParam, WXLPARAM lParam); | |
5048c832 JS |
353 | #if wxUSE_ACCEL |
354 | bool HandleHotKey(WXWPARAM wParam, WXLPARAM lParam); | |
355 | #endif | |
b74cce40 VZ |
356 | #ifdef __WIN32__ |
357 | int HandleMenuChar(int chAccel, WXLPARAM lParam); | |
358 | #endif | |
78c91815 VZ |
359 | // Create and process a clipboard event specified by type. |
360 | bool HandleClipboardEvent( WXUINT nMsg ); | |
bfc6fde4 | 361 | |
42e69d6b VZ |
362 | bool HandleQueryDragIcon(WXHICON *hIcon); |
363 | ||
364 | bool HandleSetCursor(WXHWND hWnd, short nHitTest, int mouseMsg); | |
bfc6fde4 | 365 | |
355debca VZ |
366 | bool HandlePower(WXWPARAM wParam, WXLPARAM lParam, bool *vetoed); |
367 | ||
368 | ||
2e1cee23 VZ |
369 | // The main body of common window proc for all wxWindow objects. It tries |
370 | // to handle the given message and returns true if it was handled (the | |
371 | // appropriate return value is then put in result, which must be non-NULL) | |
372 | // or false if it wasn't. | |
373 | // | |
374 | // This function should be overridden in any new code instead of | |
375 | // MSWWindowProc() even if currently most of the code overrides | |
376 | // MSWWindowProc() as it had been written before this function was added. | |
377 | virtual bool MSWHandleMessage(WXLRESULT *result, | |
378 | WXUINT message, | |
379 | WXWPARAM wParam, | |
380 | WXLPARAM lParam); | |
381 | ||
382 | // Common Window procedure for all wxWindow objects: forwards to | |
383 | // MSWHandleMessage() and MSWDefWindowProc() if the message wasn't handled. | |
c140b7e7 | 384 | virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); |
bfc6fde4 VZ |
385 | |
386 | // Calls an appropriate default window procedure | |
c140b7e7 | 387 | virtual WXLRESULT MSWDefWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); |
a37d422a VZ |
388 | |
389 | // message processing helpers | |
390 | ||
27d2dbbc | 391 | // return false if the message shouldn't be translated/preprocessed but |
a37d422a VZ |
392 | // dispatched normally |
393 | virtual bool MSWShouldPreProcessMessage(WXMSG* pMsg); | |
394 | ||
27d2dbbc | 395 | // return true if the message was preprocessed and shouldn't be dispatched |
bfc6fde4 | 396 | virtual bool MSWProcessMessage(WXMSG* pMsg); |
a37d422a | 397 | |
27d2dbbc | 398 | // return true if the message was translated and shouldn't be dispatched |
bfc6fde4 | 399 | virtual bool MSWTranslateMessage(WXMSG* pMsg); |
a37d422a VZ |
400 | |
401 | // called when the window is about to be destroyed | |
bfc6fde4 VZ |
402 | virtual void MSWDestroyWindow(); |
403 | ||
01c500af | 404 | |
0a81f130 VZ |
405 | // Functions dealing with painting the window background. The derived |
406 | // classes should normally only need to reimplement MSWGetBgBrush() if they | |
407 | // need to use a non-solid brush for erasing their background. This | |
408 | // function is called by MSWGetBgBrushForChild() which only exists for the | |
409 | // weird wxToolBar case and MSWGetBgBrushForChild() itself is used by | |
410 | // MSWGetBgBrush() to actually find the right brush to use. | |
411 | ||
412 | // The brush returned from here must remain valid at least until the next | |
413 | // event loop iteration. Returning 0, as is done by default, indicates | |
414 | // there is no custom background brush. | |
415 | virtual WXHBRUSH MSWGetCustomBgBrush() { return 0; } | |
416 | ||
c5bd3c62 VZ |
417 | // this function should return the brush to paint the children controls |
418 | // background or 0 if this window doesn't impose any particular background | |
419 | // on its children | |
420 | // | |
b8797d96 VZ |
421 | // the hDC parameter is the DC background will be drawn on, it can be used |
422 | // to call SetBrushOrgEx() on it if the returned brush is a bitmap one | |
423 | // | |
ebfee179 VZ |
424 | // child parameter is never NULL, it can be this window itself or one of |
425 | // its (grand)children | |
b8797d96 | 426 | // |
c3732409 VZ |
427 | // the base class version returns a solid brush if we have a non default |
428 | // background colour or 0 otherwise | |
b8797d96 | 429 | virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC hDC, wxWindowMSW *child); |
c5bd3c62 | 430 | |
c3732409 | 431 | // return the background brush to use for painting the given window by |
ebfee179 VZ |
432 | // querying the parent windows via MSWGetBgBrushForChild() recursively |
433 | WXHBRUSH MSWGetBgBrush(WXHDC hDC); | |
c3732409 | 434 | |
a5b1be33 JS |
435 | enum MSWThemeColour |
436 | { | |
437 | ThemeColourText = 0, | |
438 | ThemeColourBackground, | |
439 | ThemeColourBorder | |
440 | }; | |
441 | ||
442 | // returns a specific theme colour, or if that is not possible then | |
443 | // wxSystemSettings::GetColour(fallback) | |
444 | wxColour MSWGetThemeColour(const wchar_t *themeName, | |
445 | int themePart, | |
446 | int themeState, | |
447 | MSWThemeColour themeColour, | |
108694fe | 448 | wxSystemColour fallback) const; |
a5b1be33 | 449 | |
c3732409 VZ |
450 | // gives the parent the possibility to draw its children background, e.g. |
451 | // this is used by wxNotebook to do it using DrawThemeBackground() | |
07c19327 | 452 | // |
c3732409 VZ |
453 | // return true if background was drawn, false otherwise |
454 | virtual bool MSWPrintChild(WXHDC WXUNUSED(hDC), wxWindow * WXUNUSED(child)) | |
455 | { | |
456 | return false; | |
457 | } | |
07c19327 | 458 | |
ce0e1aac JS |
459 | // some controls (e.g. wxListBox) need to set the return value themselves |
460 | // | |
461 | // return true to let parent handle it if we don't, false otherwise | |
462 | virtual bool MSWShouldPropagatePrintChild() | |
463 | { | |
464 | return true; | |
465 | } | |
466 | ||
d9317033 VZ |
467 | // This should be overridden to return true for the controls which have |
468 | // themed background that should through their children. Currently only | |
469 | // wxNotebook uses this. | |
470 | virtual bool MSWHasInheritableBackground() const { return false; } | |
471 | ||
bec9bf3e VZ |
472 | #if !defined(__WXWINCE__) && !defined(__WXUNIVERSAL__) |
473 | #define wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
474 | #endif | |
475 | ||
476 | #ifdef wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
477 | // allows the child to hook into its parent WM_ERASEBKGND processing: call | |
478 | // MSWSetEraseBgHook() with a non-NULL window to make parent call | |
479 | // MSWEraseBgHook() on this window (don't forget to reset it to NULL | |
480 | // afterwards) | |
481 | // | |
482 | // this hack is used by wxToolBar, see comments there | |
483 | void MSWSetEraseBgHook(wxWindow *child); | |
484 | ||
485 | // return true if WM_ERASEBKGND is currently hooked | |
486 | bool MSWHasEraseBgHook() const; | |
487 | ||
488 | // called when the window on which MSWSetEraseBgHook() had been called | |
489 | // receives WM_ERASEBKGND | |
490 | virtual bool MSWEraseBgHook(WXHDC WXUNUSED(hDC)) { return false; } | |
491 | #endif // wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
492 | ||
376d7d97 VZ |
493 | // common part of Show/HideWithEffect() |
494 | bool MSWShowWithEffect(bool show, | |
495 | wxShowEffect effect, | |
eed04c99 | 496 | unsigned timeout); |
07c19327 | 497 | |
bfc6fde4 VZ |
498 | // Responds to colour changes: passes event on to children. |
499 | void OnSysColourChanged(wxSysColourChangedEvent& event); | |
500 | ||
a23fd0e1 VZ |
501 | // initialize various fields of wxMouseEvent (common part of MSWOnMouseXXX) |
502 | void InitMouseEvent(wxMouseEvent& event, int x, int y, WXUINT flags); | |
bfc6fde4 | 503 | |
1e6feb95 VZ |
504 | // check if mouse is in the window |
505 | bool IsMouseInWindow() const; | |
2e992e06 VZ |
506 | |
507 | // check if a native double-buffering applies for this window | |
508 | virtual bool IsDoubleBuffered() const; | |
03647350 | 509 | |
f60ca3e2 | 510 | void SetDoubleBuffered(bool on); |
03647350 | 511 | |
51e4e266 VZ |
512 | // synthesize a wxEVT_LEAVE_WINDOW event and set m_mouseInWindow to false |
513 | void GenerateMouseLeave(); | |
514 | ||
e39af974 JS |
515 | // virtual function for implementing internal idle |
516 | // behaviour | |
c3732409 | 517 | virtual void OnInternalIdle(); |
e39af974 | 518 | |
2bda0e17 | 519 | protected: |
3c75d8ba PC |
520 | // this allows you to implement standard control borders without |
521 | // repeating the code in different classes that are not derived from | |
522 | // wxControl | |
523 | virtual wxBorder GetDefaultBorderForControl() const; | |
524 | ||
525 | // choose the default border for this window | |
526 | virtual wxBorder GetDefaultBorder() const; | |
6f02a879 | 527 | |
dc797d8e JS |
528 | // Translate wxBORDER_THEME (and other border styles if necessary to the value |
529 | // that makes most sense for this Windows environment | |
530 | virtual wxBorder TranslateBorder(wxBorder border) const; | |
531 | ||
6f02a879 VZ |
532 | #if wxUSE_MENUS_NATIVE |
533 | virtual bool DoPopupMenu( wxMenu *menu, int x, int y ); | |
534 | #endif // wxUSE_MENUS_NATIVE | |
535 | ||
d7c24517 VZ |
536 | // the window handle |
537 | WXHWND m_hWnd; | |
538 | ||
cc2b7472 | 539 | // the old window proc (we subclass all windows) |
bfc6fde4 | 540 | WXFARPROC m_oldWndProc; |
2bda0e17 | 541 | |
cc2b7472 | 542 | // additional (MSW specific) flags |
cc2b7472 | 543 | bool m_mouseInWindow:1; |
68304caf | 544 | bool m_lastKeydownProcessed:1; |
bfc6fde4 | 545 | |
cc2b7472 | 546 | // the size of one page for scrolling |
bfc6fde4 VZ |
547 | int m_xThumbSize; |
548 | int m_yThumbSize; | |
2bda0e17 | 549 | |
cc2b7472 | 550 | // implement the base class pure virtuals |
6de70470 VZ |
551 | virtual void DoGetTextExtent(const wxString& string, |
552 | int *x, int *y, | |
553 | int *descent = NULL, | |
554 | int *externalLeading = NULL, | |
555 | const wxFont *font = NULL) const; | |
dabc0cd5 VZ |
556 | virtual void DoClientToScreen( int *x, int *y ) const; |
557 | virtual void DoScreenToClient( int *x, int *y ) const; | |
cc2b7472 VZ |
558 | virtual void DoGetPosition( int *x, int *y ) const; |
559 | virtual void DoGetSize( int *width, int *height ) const; | |
560 | virtual void DoGetClientSize( int *width, int *height ) const; | |
561 | virtual void DoSetSize(int x, int y, | |
562 | int width, int height, | |
563 | int sizeFlags = wxSIZE_AUTO); | |
bfc6fde4 | 564 | virtual void DoSetClientSize(int width, int height); |
2bda0e17 | 565 | |
743b4266 VZ |
566 | virtual wxSize DoGetBorderSize() const; |
567 | ||
94633ad9 VZ |
568 | virtual void DoCaptureMouse(); |
569 | virtual void DoReleaseMouse(); | |
68304caf | 570 | |
3c75d8ba PC |
571 | virtual void DoEnable(bool enable); |
572 | ||
17808a75 VZ |
573 | virtual void DoFreeze(); |
574 | virtual void DoThaw(); | |
575 | ||
7d86a2d4 VZ |
576 | // this simply moves/resizes the given HWND which is supposed to be our |
577 | // sibling (this is useful for controls which are composite at MSW level | |
578 | // and for which DoMoveWindow() is not enough) | |
86e30911 VZ |
579 | // |
580 | // returns true if the window move was deferred, false if it was moved | |
581 | // immediately (no error return) | |
582 | bool DoMoveSibling(WXHWND hwnd, int x, int y, int width, int height); | |
7d86a2d4 | 583 | |
b782f2e0 VZ |
584 | // move the window to the specified location and resize it: this is called |
585 | // from both DoSetSize() and DoSetClientSize() and would usually just call | |
586 | // ::MoveWindow() except for composite controls which will want to arrange | |
587 | // themselves inside the given rectangle | |
588 | virtual void DoMoveWindow(int x, int y, int width, int height); | |
589 | ||
cc2b7472 VZ |
590 | #if wxUSE_TOOLTIPS |
591 | virtual void DoSetToolTip( wxToolTip *tip ); | |
bd9cd534 VZ |
592 | |
593 | // process TTN_NEEDTEXT message properly (i.e. fixing the bugs in | |
594 | // comctl32.dll in our code -- see the function body for more info) | |
595 | bool HandleTooltipNotify(WXUINT code, | |
596 | WXLPARAM lParam, | |
597 | const wxString& ttip); | |
cc2b7472 VZ |
598 | #endif // wxUSE_TOOLTIPS |
599 | ||
b6885972 VZ |
600 | // This is used by CreateKeyEvent() and also for wxEVT_CHAR[_HOOK] event |
601 | // creation. Notice that this method doesn't initialize wxKeyEvent | |
602 | // m_keyCode and m_uniChar fields. | |
603 | void InitAnyKeyEvent(wxKeyEvent& event, | |
604 | WXWPARAM wParam, | |
605 | WXLPARAM lParam) const; | |
606 | ||
607 | // Helper functions used by HandleKeyXXX() methods and some derived | |
608 | // classes, wParam and lParam have the same meaning as in WM_KEY{DOWN,UP}. | |
609 | // | |
610 | // NB: evType here must be wxEVT_KEY_{DOWN,UP} as wParam here contains the | |
611 | // virtual key code, not character! | |
612 | wxKeyEvent CreateKeyEvent(wxEventType evType, | |
613 | WXWPARAM wParam, | |
614 | WXLPARAM lParam = 0) const; | |
b09bda68 | 615 | |
1afe4f9b VZ |
616 | // Another helper for creating wxKeyEvent for wxEVT_CHAR and related types. |
617 | // | |
618 | // The wParam and lParam here must come from WM_CHAR event parameters, i.e. | |
619 | // wParam must be a character and not a virtual code. | |
620 | wxKeyEvent CreateCharEvent(wxEventType evType, | |
621 | WXWPARAM wParam, | |
622 | WXLPARAM lParam) const; | |
623 | ||
3b72cd91 VZ |
624 | |
625 | // default OnEraseBackground() implementation, return true if we did erase | |
c3732409 VZ |
626 | // the background, false otherwise (i.e. the system should erase it) |
627 | bool DoEraseBackground(WXHDC hDC); | |
3b72cd91 | 628 | |
1ca78aa1 | 629 | // generate WM_CHANGEUISTATE if it's needed for the OS we're running under |
3ef092d6 | 630 | // |
1ca78aa1 JS |
631 | // action should be one of the UIS_XXX constants |
632 | // state should be one or more of the UISF_XXX constants | |
633 | // if action == UIS_INITIALIZE then it doesn't seem to matter what we use | |
634 | // for state as the system will decide for us what needs to be set | |
635 | void MSWUpdateUIState(int action, int state = 0); | |
d7e0024b | 636 | |
fa5f4858 VZ |
637 | // translate wxWidgets coords into Windows ones suitable to be passed to |
638 | // ::CreateWindow(), called from MSWCreate() | |
639 | virtual void MSWGetCreateWindowCoords(const wxPoint& pos, | |
640 | const wxSize& size, | |
641 | int& x, int& y, | |
642 | int& w, int& h) const; | |
643 | ||
0826c4d3 VS |
644 | bool MSWEnableHWND(WXHWND hWnd, bool enable); |
645 | ||
fd3f686c VZ |
646 | private: |
647 | // common part of all ctors | |
648 | void Init(); | |
649 | ||
a23fd0e1 VZ |
650 | // the (non-virtual) handlers for the events |
651 | bool HandleMove(int x, int y); | |
5706de1c | 652 | bool HandleMoving(wxRect& rect); |
a23fd0e1 | 653 | bool HandleJoystickEvent(WXUINT msg, int x, int y, WXUINT flags); |
a23fd0e1 | 654 | bool HandleNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result); |
a23fd0e1 | 655 | |
6bd9b9f2 VZ |
656 | #if wxUSE_DEFERRED_SIZING |
657 | protected: | |
658 | // this function is called after the window was resized to its new size | |
659 | virtual void MSWEndDeferWindowPos() | |
660 | { | |
661 | m_pendingPosition = wxDefaultPosition; | |
662 | m_pendingSize = wxDefaultSize; | |
663 | } | |
d7cbabe0 | 664 | |
220f77b0 | 665 | // current defer window position operation handle (may be NULL) |
3b72cd91 | 666 | WXHANDLE m_hDWP; |
220f77b0 | 667 | |
67644c1d RD |
668 | // When deferred positioning is done these hold the pending changes, and |
669 | // are used for the default values if another size/pos changes is done on | |
670 | // this window before the group of deferred changes is completed. | |
671 | wxPoint m_pendingPosition; | |
672 | wxSize m_pendingSize; | |
6bd9b9f2 | 673 | #endif // wxUSE_DEFERRED_SIZING |
220f77b0 | 674 | |
5637cc35 | 675 | private: |
7d4f65e3 JS |
676 | #ifdef __POCKETPC__ |
677 | bool m_contextMenuEnabled; | |
678 | #endif | |
679 | ||
e8e4fa12 | 680 | DECLARE_DYNAMIC_CLASS(wxWindowMSW) |
c0c133e1 | 681 | wxDECLARE_NO_COPY_CLASS(wxWindowMSW); |
fd3f686c | 682 | DECLARE_EVENT_TABLE() |
2bda0e17 KB |
683 | }; |
684 | ||
b225f659 VZ |
685 | // window creation helper class: before creating a new HWND, instantiate an |
686 | // object of this class on stack - this allows to process the messages sent to | |
687 | // the window even before CreateWindow() returns | |
688 | class wxWindowCreationHook | |
689 | { | |
690 | public: | |
691 | wxWindowCreationHook(wxWindowMSW *winBeingCreated); | |
692 | ~wxWindowCreationHook(); | |
693 | }; | |
694 | ||
faa49bfd | 695 | #endif // _WX_WINDOW_H_ |