]>
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 | ||
bfc6fde4 | 369 | // Window procedure |
c140b7e7 | 370 | virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); |
bfc6fde4 VZ |
371 | |
372 | // Calls an appropriate default window procedure | |
c140b7e7 | 373 | virtual WXLRESULT MSWDefWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); |
a37d422a VZ |
374 | |
375 | // message processing helpers | |
376 | ||
27d2dbbc | 377 | // return false if the message shouldn't be translated/preprocessed but |
a37d422a VZ |
378 | // dispatched normally |
379 | virtual bool MSWShouldPreProcessMessage(WXMSG* pMsg); | |
380 | ||
27d2dbbc | 381 | // return true if the message was preprocessed and shouldn't be dispatched |
bfc6fde4 | 382 | virtual bool MSWProcessMessage(WXMSG* pMsg); |
a37d422a | 383 | |
27d2dbbc | 384 | // return true if the message was translated and shouldn't be dispatched |
bfc6fde4 | 385 | virtual bool MSWTranslateMessage(WXMSG* pMsg); |
a37d422a VZ |
386 | |
387 | // called when the window is about to be destroyed | |
bfc6fde4 VZ |
388 | virtual void MSWDestroyWindow(); |
389 | ||
01c500af | 390 | |
0a81f130 VZ |
391 | // Functions dealing with painting the window background. The derived |
392 | // classes should normally only need to reimplement MSWGetBgBrush() if they | |
393 | // need to use a non-solid brush for erasing their background. This | |
394 | // function is called by MSWGetBgBrushForChild() which only exists for the | |
395 | // weird wxToolBar case and MSWGetBgBrushForChild() itself is used by | |
396 | // MSWGetBgBrush() to actually find the right brush to use. | |
397 | ||
398 | // The brush returned from here must remain valid at least until the next | |
399 | // event loop iteration. Returning 0, as is done by default, indicates | |
400 | // there is no custom background brush. | |
401 | virtual WXHBRUSH MSWGetCustomBgBrush() { return 0; } | |
402 | ||
c5bd3c62 VZ |
403 | // this function should return the brush to paint the children controls |
404 | // background or 0 if this window doesn't impose any particular background | |
405 | // on its children | |
406 | // | |
b8797d96 VZ |
407 | // the hDC parameter is the DC background will be drawn on, it can be used |
408 | // to call SetBrushOrgEx() on it if the returned brush is a bitmap one | |
409 | // | |
ebfee179 VZ |
410 | // child parameter is never NULL, it can be this window itself or one of |
411 | // its (grand)children | |
b8797d96 | 412 | // |
c3732409 VZ |
413 | // the base class version returns a solid brush if we have a non default |
414 | // background colour or 0 otherwise | |
b8797d96 | 415 | virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC hDC, wxWindowMSW *child); |
c5bd3c62 | 416 | |
c3732409 | 417 | // return the background brush to use for painting the given window by |
ebfee179 VZ |
418 | // querying the parent windows via MSWGetBgBrushForChild() recursively |
419 | WXHBRUSH MSWGetBgBrush(WXHDC hDC); | |
c3732409 | 420 | |
a5b1be33 JS |
421 | enum MSWThemeColour |
422 | { | |
423 | ThemeColourText = 0, | |
424 | ThemeColourBackground, | |
425 | ThemeColourBorder | |
426 | }; | |
427 | ||
428 | // returns a specific theme colour, or if that is not possible then | |
429 | // wxSystemSettings::GetColour(fallback) | |
430 | wxColour MSWGetThemeColour(const wchar_t *themeName, | |
431 | int themePart, | |
432 | int themeState, | |
433 | MSWThemeColour themeColour, | |
108694fe | 434 | wxSystemColour fallback) const; |
a5b1be33 | 435 | |
c3732409 VZ |
436 | // gives the parent the possibility to draw its children background, e.g. |
437 | // this is used by wxNotebook to do it using DrawThemeBackground() | |
07c19327 | 438 | // |
c3732409 VZ |
439 | // return true if background was drawn, false otherwise |
440 | virtual bool MSWPrintChild(WXHDC WXUNUSED(hDC), wxWindow * WXUNUSED(child)) | |
441 | { | |
442 | return false; | |
443 | } | |
07c19327 | 444 | |
ce0e1aac JS |
445 | // some controls (e.g. wxListBox) need to set the return value themselves |
446 | // | |
447 | // return true to let parent handle it if we don't, false otherwise | |
448 | virtual bool MSWShouldPropagatePrintChild() | |
449 | { | |
450 | return true; | |
451 | } | |
452 | ||
d9317033 VZ |
453 | // This should be overridden to return true for the controls which have |
454 | // themed background that should through their children. Currently only | |
455 | // wxNotebook uses this. | |
456 | virtual bool MSWHasInheritableBackground() const { return false; } | |
457 | ||
bec9bf3e VZ |
458 | #if !defined(__WXWINCE__) && !defined(__WXUNIVERSAL__) |
459 | #define wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
460 | #endif | |
461 | ||
462 | #ifdef wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
463 | // allows the child to hook into its parent WM_ERASEBKGND processing: call | |
464 | // MSWSetEraseBgHook() with a non-NULL window to make parent call | |
465 | // MSWEraseBgHook() on this window (don't forget to reset it to NULL | |
466 | // afterwards) | |
467 | // | |
468 | // this hack is used by wxToolBar, see comments there | |
469 | void MSWSetEraseBgHook(wxWindow *child); | |
470 | ||
471 | // return true if WM_ERASEBKGND is currently hooked | |
472 | bool MSWHasEraseBgHook() const; | |
473 | ||
474 | // called when the window on which MSWSetEraseBgHook() had been called | |
475 | // receives WM_ERASEBKGND | |
476 | virtual bool MSWEraseBgHook(WXHDC WXUNUSED(hDC)) { return false; } | |
477 | #endif // wxHAS_MSW_BACKGROUND_ERASE_HOOK | |
478 | ||
376d7d97 VZ |
479 | // common part of Show/HideWithEffect() |
480 | bool MSWShowWithEffect(bool show, | |
481 | wxShowEffect effect, | |
eed04c99 | 482 | unsigned timeout); |
07c19327 | 483 | |
bfc6fde4 VZ |
484 | // Responds to colour changes: passes event on to children. |
485 | void OnSysColourChanged(wxSysColourChangedEvent& event); | |
486 | ||
a23fd0e1 VZ |
487 | // initialize various fields of wxMouseEvent (common part of MSWOnMouseXXX) |
488 | void InitMouseEvent(wxMouseEvent& event, int x, int y, WXUINT flags); | |
bfc6fde4 | 489 | |
1e6feb95 VZ |
490 | // check if mouse is in the window |
491 | bool IsMouseInWindow() const; | |
2e992e06 VZ |
492 | |
493 | // check if a native double-buffering applies for this window | |
494 | virtual bool IsDoubleBuffered() const; | |
03647350 | 495 | |
f60ca3e2 | 496 | void SetDoubleBuffered(bool on); |
03647350 | 497 | |
51e4e266 VZ |
498 | // synthesize a wxEVT_LEAVE_WINDOW event and set m_mouseInWindow to false |
499 | void GenerateMouseLeave(); | |
500 | ||
e39af974 JS |
501 | // virtual function for implementing internal idle |
502 | // behaviour | |
c3732409 | 503 | virtual void OnInternalIdle(); |
e39af974 | 504 | |
2bda0e17 | 505 | protected: |
3c75d8ba PC |
506 | // this allows you to implement standard control borders without |
507 | // repeating the code in different classes that are not derived from | |
508 | // wxControl | |
509 | virtual wxBorder GetDefaultBorderForControl() const; | |
510 | ||
511 | // choose the default border for this window | |
512 | virtual wxBorder GetDefaultBorder() const; | |
6f02a879 | 513 | |
dc797d8e JS |
514 | // Translate wxBORDER_THEME (and other border styles if necessary to the value |
515 | // that makes most sense for this Windows environment | |
516 | virtual wxBorder TranslateBorder(wxBorder border) const; | |
517 | ||
6f02a879 VZ |
518 | #if wxUSE_MENUS_NATIVE |
519 | virtual bool DoPopupMenu( wxMenu *menu, int x, int y ); | |
520 | #endif // wxUSE_MENUS_NATIVE | |
521 | ||
d7c24517 VZ |
522 | // the window handle |
523 | WXHWND m_hWnd; | |
524 | ||
cc2b7472 | 525 | // the old window proc (we subclass all windows) |
bfc6fde4 | 526 | WXFARPROC m_oldWndProc; |
2bda0e17 | 527 | |
cc2b7472 | 528 | // additional (MSW specific) flags |
cc2b7472 | 529 | bool m_mouseInWindow:1; |
68304caf | 530 | bool m_lastKeydownProcessed:1; |
bfc6fde4 | 531 | |
cc2b7472 | 532 | // the size of one page for scrolling |
bfc6fde4 VZ |
533 | int m_xThumbSize; |
534 | int m_yThumbSize; | |
2bda0e17 | 535 | |
cc2b7472 | 536 | // implement the base class pure virtuals |
6de70470 VZ |
537 | virtual void DoGetTextExtent(const wxString& string, |
538 | int *x, int *y, | |
539 | int *descent = NULL, | |
540 | int *externalLeading = NULL, | |
541 | const wxFont *font = NULL) const; | |
dabc0cd5 VZ |
542 | virtual void DoClientToScreen( int *x, int *y ) const; |
543 | virtual void DoScreenToClient( int *x, int *y ) const; | |
cc2b7472 VZ |
544 | virtual void DoGetPosition( int *x, int *y ) const; |
545 | virtual void DoGetSize( int *width, int *height ) const; | |
546 | virtual void DoGetClientSize( int *width, int *height ) const; | |
547 | virtual void DoSetSize(int x, int y, | |
548 | int width, int height, | |
549 | int sizeFlags = wxSIZE_AUTO); | |
bfc6fde4 | 550 | virtual void DoSetClientSize(int width, int height); |
2bda0e17 | 551 | |
743b4266 VZ |
552 | virtual wxSize DoGetBorderSize() const; |
553 | ||
94633ad9 VZ |
554 | virtual void DoCaptureMouse(); |
555 | virtual void DoReleaseMouse(); | |
68304caf | 556 | |
3c75d8ba PC |
557 | virtual void DoEnable(bool enable); |
558 | ||
17808a75 VZ |
559 | virtual void DoFreeze(); |
560 | virtual void DoThaw(); | |
561 | ||
7d86a2d4 VZ |
562 | // this simply moves/resizes the given HWND which is supposed to be our |
563 | // sibling (this is useful for controls which are composite at MSW level | |
564 | // and for which DoMoveWindow() is not enough) | |
86e30911 VZ |
565 | // |
566 | // returns true if the window move was deferred, false if it was moved | |
567 | // immediately (no error return) | |
568 | bool DoMoveSibling(WXHWND hwnd, int x, int y, int width, int height); | |
7d86a2d4 | 569 | |
b782f2e0 VZ |
570 | // move the window to the specified location and resize it: this is called |
571 | // from both DoSetSize() and DoSetClientSize() and would usually just call | |
572 | // ::MoveWindow() except for composite controls which will want to arrange | |
573 | // themselves inside the given rectangle | |
574 | virtual void DoMoveWindow(int x, int y, int width, int height); | |
575 | ||
cc2b7472 VZ |
576 | #if wxUSE_TOOLTIPS |
577 | virtual void DoSetToolTip( wxToolTip *tip ); | |
bd9cd534 VZ |
578 | |
579 | // process TTN_NEEDTEXT message properly (i.e. fixing the bugs in | |
580 | // comctl32.dll in our code -- see the function body for more info) | |
581 | bool HandleTooltipNotify(WXUINT code, | |
582 | WXLPARAM lParam, | |
583 | const wxString& ttip); | |
cc2b7472 VZ |
584 | #endif // wxUSE_TOOLTIPS |
585 | ||
b6885972 VZ |
586 | // This is used by CreateKeyEvent() and also for wxEVT_CHAR[_HOOK] event |
587 | // creation. Notice that this method doesn't initialize wxKeyEvent | |
588 | // m_keyCode and m_uniChar fields. | |
589 | void InitAnyKeyEvent(wxKeyEvent& event, | |
590 | WXWPARAM wParam, | |
591 | WXLPARAM lParam) const; | |
592 | ||
593 | // Helper functions used by HandleKeyXXX() methods and some derived | |
594 | // classes, wParam and lParam have the same meaning as in WM_KEY{DOWN,UP}. | |
595 | // | |
596 | // NB: evType here must be wxEVT_KEY_{DOWN,UP} as wParam here contains the | |
597 | // virtual key code, not character! | |
598 | wxKeyEvent CreateKeyEvent(wxEventType evType, | |
599 | WXWPARAM wParam, | |
600 | WXLPARAM lParam = 0) const; | |
b09bda68 | 601 | |
1afe4f9b VZ |
602 | // Another helper for creating wxKeyEvent for wxEVT_CHAR and related types. |
603 | // | |
604 | // The wParam and lParam here must come from WM_CHAR event parameters, i.e. | |
605 | // wParam must be a character and not a virtual code. | |
606 | wxKeyEvent CreateCharEvent(wxEventType evType, | |
607 | WXWPARAM wParam, | |
608 | WXLPARAM lParam) const; | |
609 | ||
3b72cd91 VZ |
610 | |
611 | // default OnEraseBackground() implementation, return true if we did erase | |
c3732409 VZ |
612 | // the background, false otherwise (i.e. the system should erase it) |
613 | bool DoEraseBackground(WXHDC hDC); | |
3b72cd91 | 614 | |
1ca78aa1 | 615 | // generate WM_CHANGEUISTATE if it's needed for the OS we're running under |
3ef092d6 | 616 | // |
1ca78aa1 JS |
617 | // action should be one of the UIS_XXX constants |
618 | // state should be one or more of the UISF_XXX constants | |
619 | // if action == UIS_INITIALIZE then it doesn't seem to matter what we use | |
620 | // for state as the system will decide for us what needs to be set | |
621 | void MSWUpdateUIState(int action, int state = 0); | |
d7e0024b | 622 | |
fa5f4858 VZ |
623 | // translate wxWidgets coords into Windows ones suitable to be passed to |
624 | // ::CreateWindow(), called from MSWCreate() | |
625 | virtual void MSWGetCreateWindowCoords(const wxPoint& pos, | |
626 | const wxSize& size, | |
627 | int& x, int& y, | |
628 | int& w, int& h) const; | |
629 | ||
0826c4d3 VS |
630 | bool MSWEnableHWND(WXHWND hWnd, bool enable); |
631 | ||
fd3f686c VZ |
632 | private: |
633 | // common part of all ctors | |
634 | void Init(); | |
635 | ||
a23fd0e1 VZ |
636 | // the (non-virtual) handlers for the events |
637 | bool HandleMove(int x, int y); | |
5706de1c | 638 | bool HandleMoving(wxRect& rect); |
a23fd0e1 | 639 | bool HandleJoystickEvent(WXUINT msg, int x, int y, WXUINT flags); |
a23fd0e1 | 640 | bool HandleNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result); |
a23fd0e1 | 641 | |
6bd9b9f2 VZ |
642 | #if wxUSE_DEFERRED_SIZING |
643 | protected: | |
644 | // this function is called after the window was resized to its new size | |
645 | virtual void MSWEndDeferWindowPos() | |
646 | { | |
647 | m_pendingPosition = wxDefaultPosition; | |
648 | m_pendingSize = wxDefaultSize; | |
649 | } | |
d7cbabe0 | 650 | |
220f77b0 | 651 | // current defer window position operation handle (may be NULL) |
3b72cd91 | 652 | WXHANDLE m_hDWP; |
220f77b0 | 653 | |
67644c1d RD |
654 | // When deferred positioning is done these hold the pending changes, and |
655 | // are used for the default values if another size/pos changes is done on | |
656 | // this window before the group of deferred changes is completed. | |
657 | wxPoint m_pendingPosition; | |
658 | wxSize m_pendingSize; | |
6bd9b9f2 | 659 | #endif // wxUSE_DEFERRED_SIZING |
220f77b0 | 660 | |
5637cc35 | 661 | private: |
7d4f65e3 JS |
662 | #ifdef __POCKETPC__ |
663 | bool m_contextMenuEnabled; | |
664 | #endif | |
665 | ||
e8e4fa12 | 666 | DECLARE_DYNAMIC_CLASS(wxWindowMSW) |
c0c133e1 | 667 | wxDECLARE_NO_COPY_CLASS(wxWindowMSW); |
fd3f686c | 668 | DECLARE_EVENT_TABLE() |
2bda0e17 KB |
669 | }; |
670 | ||
b225f659 VZ |
671 | // window creation helper class: before creating a new HWND, instantiate an |
672 | // object of this class on stack - this allows to process the messages sent to | |
673 | // the window even before CreateWindow() returns | |
674 | class wxWindowCreationHook | |
675 | { | |
676 | public: | |
677 | wxWindowCreationHook(wxWindowMSW *winBeingCreated); | |
678 | ~wxWindowCreationHook(); | |
679 | }; | |
680 | ||
faa49bfd | 681 | #endif // _WX_WINDOW_H_ |