]>
Commit | Line | Data |
---|---|---|
2bda0e17 KB |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: private.h | |
a23fd0e1 | 3 | // Purpose: Private declarations: as this header is only included by |
77ffb593 | 4 | // wxWidgets itself, it may contain identifiers which don't start |
a23fd0e1 | 5 | // with "wx". |
2bda0e17 KB |
6 | // Author: Julian Smart |
7 | // Modified by: | |
8 | // Created: 01/02/97 | |
9 | // RCS-ID: $Id$ | |
bbcdf8bc | 10 | // Copyright: (c) Julian Smart |
65571936 | 11 | // Licence: wxWindows licence |
2bda0e17 KB |
12 | ///////////////////////////////////////////////////////////////////////////// |
13 | ||
bbcdf8bc JS |
14 | #ifndef _WX_PRIVATE_H_ |
15 | #define _WX_PRIVATE_H_ | |
2bda0e17 | 16 | |
9ed0d735 | 17 | #include "wx/msw/wrapwin.h" |
2bda0e17 | 18 | |
04ef50df | 19 | #ifdef __WXMICROWIN__ |
b225f659 VZ |
20 | // Extra prototypes and symbols not defined by MicroWindows |
21 | #include "wx/msw/microwin.h" | |
04ef50df JS |
22 | #endif |
23 | ||
3d5231db VS |
24 | // Include fixes for MSLU: |
25 | #include "wx/msw/mslu.h" | |
26 | ||
3a922bb4 RL |
27 | #include "wx/log.h" |
28 | ||
a23fd0e1 | 29 | class WXDLLEXPORT wxFont; |
d427503c | 30 | class WXDLLEXPORT wxWindow; |
c282a7a1 | 31 | class WXDLLEXPORT wxWindowBase; |
2bda0e17 | 32 | |
42e69d6b VZ |
33 | // --------------------------------------------------------------------------- |
34 | // private constants | |
35 | // --------------------------------------------------------------------------- | |
36 | ||
77d8d6cd VZ |
37 | // 260 was taken from windef.h |
38 | #ifndef MAX_PATH | |
39 | #define MAX_PATH 260 | |
40 | #endif | |
41 | ||
a23fd0e1 VZ |
42 | // --------------------------------------------------------------------------- |
43 | // standard icons from the resources | |
44 | // --------------------------------------------------------------------------- | |
2bda0e17 | 45 | |
b568d04f VZ |
46 | #if wxUSE_GUI |
47 | ||
ef359b43 WS |
48 | extern WXDLLEXPORT_DATA(HICON) wxSTD_FRAME_ICON; |
49 | extern WXDLLEXPORT_DATA(HICON) wxSTD_MDIPARENTFRAME_ICON; | |
50 | extern WXDLLEXPORT_DATA(HICON) wxSTD_MDICHILDFRAME_ICON; | |
51 | extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_FRAME_ICON; | |
52 | extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_MDIPARENTFRAME_ICON; | |
53 | extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_MDICHILDFRAME_ICON; | |
54 | extern WXDLLEXPORT_DATA(HFONT) wxSTATUS_LINE_FONT; | |
2bda0e17 | 55 | |
b568d04f VZ |
56 | #endif // wxUSE_GUI |
57 | ||
77ec05d4 VZ |
58 | // --------------------------------------------------------------------------- |
59 | // global data | |
60 | // --------------------------------------------------------------------------- | |
61 | ||
62 | extern WXDLLIMPEXP_DATA_BASE(HINSTANCE) wxhInstance; | |
63 | ||
a23fd0e1 | 64 | // --------------------------------------------------------------------------- |
11c7d5b6 | 65 | // define things missing from some compilers' headers |
a23fd0e1 | 66 | // --------------------------------------------------------------------------- |
c455ab93 | 67 | |
7f0586ef | 68 | #if defined(__WXWINCE__) || (defined(__GNUWIN32__) && !wxUSE_NORLANDER_HEADERS) |
01dba85a | 69 | #ifndef ZeroMemory |
11c7d5b6 | 70 | inline void ZeroMemory(void *buf, size_t len) { memset(buf, 0, len); } |
01dba85a | 71 | #endif |
11c7d5b6 VZ |
72 | #endif // old mingw32 |
73 | ||
74 | // this defines a CASTWNDPROC macro which casts a pointer to the type of a | |
75 | // window proc | |
7f0586ef | 76 | #if defined(STRICT) || defined(__GNUC__) |
ebb0781f | 77 | typedef WNDPROC WndProcCast; |
c3b177ae | 78 | #else |
ebb0781f VZ |
79 | typedef FARPROC WndProcCast; |
80 | #endif | |
81 | ||
552a0ebd | 82 | |
ebb0781f | 83 | #define CASTWNDPROC (WndProcCast) |
2bda0e17 | 84 | |
dd54f5d3 | 85 | |
50165591 | 86 | |
a23fd0e1 VZ |
87 | // --------------------------------------------------------------------------- |
88 | // some stuff for old Windows versions (FIXME: what does it do here??) | |
89 | // --------------------------------------------------------------------------- | |
90 | ||
c085e333 | 91 | #if !defined(APIENTRY) // NT defines APIENTRY, 3.x not |
a23fd0e1 | 92 | #define APIENTRY FAR PASCAL |
2bda0e17 | 93 | #endif |
c085e333 | 94 | |
2bda0e17 | 95 | #ifdef __WIN32__ |
a23fd0e1 | 96 | #define _EXPORT |
2bda0e17 | 97 | #else |
a23fd0e1 VZ |
98 | #define _EXPORT _export |
99 | #endif | |
100 | ||
101 | #ifndef __WIN32__ | |
102 | typedef signed short int SHORT; | |
2bda0e17 | 103 | #endif |
c085e333 VZ |
104 | |
105 | #if !defined(__WIN32__) // 3.x uses FARPROC for dialogs | |
27a9bd48 | 106 | #ifndef STRICT |
a23fd0e1 | 107 | #define DLGPROC FARPROC |
2bda0e17 | 108 | #endif |
27a9bd48 | 109 | #endif |
2bda0e17 | 110 | |
2bda0e17 KB |
111 | /* |
112 | * Decide what window classes we're going to use | |
113 | * for this combination of CTl3D/FAFA settings | |
114 | */ | |
c085e333 | 115 | |
223d09f6 | 116 | #define STATIC_CLASS wxT("STATIC") |
2bda0e17 | 117 | #define STATIC_FLAGS (SS_LEFT|WS_CHILD|WS_VISIBLE) |
223d09f6 | 118 | #define CHECK_CLASS wxT("BUTTON") |
2bda0e17 | 119 | #define CHECK_FLAGS (BS_AUTOCHECKBOX|WS_TABSTOP|WS_CHILD) |
078cf5cb | 120 | #define CHECK_IS_FAFA FALSE |
223d09f6 | 121 | #define RADIO_CLASS wxT("BUTTON") |
2bda0e17 KB |
122 | #define RADIO_FLAGS (BS_AUTORADIOBUTTON|WS_CHILD|WS_VISIBLE) |
123 | #define RADIO_SIZE 20 | |
078cf5cb | 124 | #define RADIO_IS_FAFA FALSE |
2bda0e17 | 125 | #define PURE_WINDOWS |
223d09f6 | 126 | #define GROUP_CLASS wxT("BUTTON") |
2bda0e17 KB |
127 | #define GROUP_FLAGS (BS_GROUPBOX|WS_CHILD|WS_VISIBLE) |
128 | ||
129 | /* | |
130 | #define BITCHECK_FLAGS (FB_BITMAP|FC_BUTTONDRAW|FC_DEFAULT|WS_VISIBLE) | |
131 | #define BITRADIO_FLAGS (FC_BUTTONDRAW|FB_BITMAP|FC_RADIO|WS_CHILD|WS_VISIBLE) | |
132 | */ | |
133 | ||
a23fd0e1 VZ |
134 | // --------------------------------------------------------------------------- |
135 | // misc macros | |
136 | // --------------------------------------------------------------------------- | |
137 | ||
2bda0e17 | 138 | #define MEANING_CHARACTER '0' |
5d368213 | 139 | #define DEFAULT_ITEM_WIDTH 100 |
2bda0e17 | 140 | #define DEFAULT_ITEM_HEIGHT 80 |
1c4a764c VZ |
141 | |
142 | // Scale font to get edit control height | |
f6bcfd97 BP |
143 | //#define EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy) (3*(cy)/2) |
144 | #define EDIT_HEIGHT_FROM_CHAR_HEIGHT(cy) (cy+8) | |
2bda0e17 KB |
145 | |
146 | // Generic subclass proc, for panel item moving/sizing and intercept | |
147 | // EDIT control VK_RETURN messages | |
148 | extern LONG APIENTRY _EXPORT | |
149 | wxSubclassedGenericControlProc(WXHWND hWnd, WXUINT message, WXWPARAM wParam, WXLPARAM lParam); | |
150 | ||
11c7d5b6 VZ |
151 | // --------------------------------------------------------------------------- |
152 | // useful macros and functions | |
153 | // --------------------------------------------------------------------------- | |
154 | ||
155 | // a wrapper macro for ZeroMemory() | |
04ef50df | 156 | #if defined(__WIN32__) && !defined(__WXMICROWIN__) |
11c7d5b6 | 157 | #define wxZeroMemory(obj) ::ZeroMemory(&obj, sizeof(obj)) |
0e528b99 JS |
158 | #else |
159 | #define wxZeroMemory(obj) memset((void*) & obj, 0, sizeof(obj)) | |
160 | #endif | |
11c7d5b6 | 161 | |
18a1516c MW |
162 | // This one is a macro so that it can be tested with #ifdef, it will be |
163 | // undefined if it cannot be implemented for a given compiler. | |
164 | // Vc++, bcc, dmc, ow, mingw, codewarrior (and rsxnt) have _get_osfhandle. | |
165 | // Cygwin has get_osfhandle. Others are currently unknown, e.g. Salford, | |
166 | // Intel, Visual Age. | |
167 | #if defined(__WXWINCE__) | |
168 | #define wxGetOSFHandle(fd) ((HANDLE)fd) | |
169 | #elif defined(__CYGWIN__) | |
170 | #define wxGetOSFHandle(fd) ((HANDLE)get_osfhandle(fd)) | |
171 | #elif defined(__VISUALC__) \ | |
172 | || defined(__BORLANDC__) \ | |
18a1516c | 173 | || defined(__DMC__) \ |
74fe6751 | 174 | || defined(__WATCOMC__) \ |
8df9a8a0 | 175 | || defined(__MINGW32__) \ |
18a1516c MW |
176 | || (defined(__MWERKS__) && defined(__MSL__)) |
177 | #define wxGetOSFHandle(fd) ((HANDLE)_get_osfhandle(fd)) | |
178 | #endif | |
179 | ||
0cdd4e19 VZ |
180 | // close the handle in the class dtor |
181 | class AutoHANDLE | |
182 | { | |
183 | public: | |
184 | wxEXPLICIT AutoHANDLE(HANDLE handle) : m_handle(handle) { } | |
185 | ||
186 | bool IsOk() const { return m_handle != INVALID_HANDLE_VALUE; } | |
187 | operator HANDLE() const { return m_handle; } | |
188 | ||
189 | ~AutoHANDLE() { if ( IsOk() ) ::CloseHandle(m_handle); } | |
190 | ||
191 | protected: | |
192 | HANDLE m_handle; | |
193 | }; | |
194 | ||
d1e4a818 VZ |
195 | // a template to make initializing Windows styructs less painful: it zeroes all |
196 | // the struct fields and also sets cbSize member to the correct value (and so | |
197 | // can be only used with structures which have this member...) | |
198 | template <class T> | |
199 | struct WinStruct : public T | |
200 | { | |
201 | WinStruct() | |
202 | { | |
203 | ::ZeroMemory(this, sizeof(T)); | |
204 | ||
205 | // explicit qualification is required here for this to be valid C++ | |
206 | this->cbSize = sizeof(T); | |
207 | } | |
208 | }; | |
209 | ||
210 | ||
f6bcfd97 BP |
211 | #if wxUSE_GUI |
212 | ||
01dba85a | 213 | #include <wx/gdicmn.h> |
ed39ff57 | 214 | #include <wx/colour.h> |
01dba85a | 215 | |
11c7d5b6 VZ |
216 | // make conversion from wxColour and COLORREF a bit less painful |
217 | inline COLORREF wxColourToRGB(const wxColour& c) | |
4ab861e5 VZ |
218 | { |
219 | return RGB(c.Red(), c.Green(), c.Blue()); | |
220 | } | |
221 | ||
222 | inline COLORREF wxColourToPalRGB(const wxColour& c) | |
11c7d5b6 | 223 | { |
19193a2c | 224 | return PALETTERGB(c.Red(), c.Green(), c.Blue()); |
11c7d5b6 VZ |
225 | } |
226 | ||
d23c8ba2 VZ |
227 | inline wxColour wxRGBToColour(COLORREF rgb) |
228 | { | |
229 | return wxColour(GetRValue(rgb), GetGValue(rgb), GetBValue(rgb)); | |
230 | } | |
231 | ||
11c7d5b6 VZ |
232 | inline void wxRGBToColour(wxColour& c, COLORREF rgb) |
233 | { | |
234 | c.Set(GetRValue(rgb), GetGValue(rgb), GetBValue(rgb)); | |
235 | } | |
236 | ||
90c1530a VZ |
237 | // get the standard colour map for some standard colours - see comment in this |
238 | // function to understand why is it needed and when should it be used | |
239 | // | |
240 | // it returns a wxCOLORMAP (can't use COLORMAP itself here as comctl32.dll | |
241 | // might be not included/available) array of size wxSTD_COLOUR_MAX | |
242 | // | |
243 | // NB: if you change these colours, update wxBITMAP_STD_COLOURS in the | |
244 | // resources as well: it must have the same number of pixels! | |
245 | enum wxSTD_COLOUR | |
246 | { | |
247 | wxSTD_COL_BTNTEXT, | |
248 | wxSTD_COL_BTNSHADOW, | |
249 | wxSTD_COL_BTNFACE, | |
250 | wxSTD_COL_BTNHIGHLIGHT, | |
57e075e9 | 251 | wxSTD_COL_MAX |
90c1530a VZ |
252 | }; |
253 | ||
254 | struct WXDLLEXPORT wxCOLORMAP | |
255 | { | |
256 | COLORREF from, to; | |
257 | }; | |
258 | ||
259 | // this function is implemented in src/msw/window.cpp | |
260 | extern wxCOLORMAP *wxGetStdColourMap(); | |
261 | ||
9688700c | 262 | // create a wxRect from Windows RECT |
8704b366 | 263 | inline wxRect wxRectFromRECT(const RECT& rc) |
9688700c | 264 | { |
8704b366 | 265 | return wxRect(rc.left, rc.top, rc.right - rc.left, rc.bottom - rc.top); |
9688700c VZ |
266 | } |
267 | ||
ed791986 | 268 | // copy Windows RECT to our wxRect |
8704b366 | 269 | inline void wxCopyRECTToRect(const RECT& rc, wxRect& rect) |
ed791986 | 270 | { |
8704b366 VZ |
271 | rect = wxRectFromRECT(rc); |
272 | } | |
273 | ||
274 | // and vice versa | |
275 | inline void wxCopyRectToRECT(const wxRect& rect, RECT& rc) | |
276 | { | |
277 | // note that we don't use wxRect::GetRight() as it is one of compared to | |
278 | // wxRectFromRECT() above | |
279 | rc.top = rect.y; | |
280 | rc.left = rect.x; | |
281 | rc.right = rect.x + rect.width; | |
282 | rc.bottom = rect.y + rect.height; | |
ed791986 VZ |
283 | } |
284 | ||
d9317fd4 VZ |
285 | // translations between HIMETRIC units (which OLE likes) and pixels (which are |
286 | // liked by all the others) - implemented in msw/utilsexc.cpp | |
287 | extern void HIMETRICToPixel(LONG *x, LONG *y); | |
288 | extern void PixelToHIMETRIC(LONG *x, LONG *y); | |
289 | ||
77ffb593 | 290 | // Windows convention of the mask is opposed to the wxWidgets one, so we need |
4b7f2165 VZ |
291 | // to invert the mask each time we pass one/get one to/from Windows |
292 | extern HBITMAP wxInvertMask(HBITMAP hbmpMask, int w = 0, int h = 0); | |
293 | ||
211b54b1 VZ |
294 | // Creates an icon or cursor depending from a bitmap |
295 | // | |
296 | // The bitmap must be valid and it should have a mask. If it doesn't, a default | |
297 | // mask is created using light grey as the transparent colour. | |
298 | extern HICON wxBitmapToHICON(const wxBitmap& bmp); | |
299 | ||
300 | // Same requirments as above apply and the bitmap must also have the correct | |
301 | // size. | |
302 | extern | |
303 | HCURSOR wxBitmapToHCURSOR(const wxBitmap& bmp, int hotSpotX, int hotSpotY); | |
304 | ||
8614c467 VZ |
305 | // get (x, y) from DWORD - notice that HI/LOWORD can *not* be used because they |
306 | // will fail on system with multiple monitors where the coords may be negative | |
307 | // | |
308 | // these macros are standard now (Win98) but some older headers don't have them | |
309 | #ifndef GET_X_LPARAM | |
310 | #define GET_X_LPARAM(lp) ((int)(short)LOWORD(lp)) | |
311 | #define GET_Y_LPARAM(lp) ((int)(short)HIWORD(lp)) | |
312 | #endif // GET_X_LPARAM | |
313 | ||
a95e38c0 | 314 | // get the current state of SHIFT/CTRL keys |
1f80a703 | 315 | inline bool wxIsShiftDown() |
a95e38c0 | 316 | { |
1fdf858b JS |
317 | // return (::GetKeyState(VK_SHIFT) & 0x100) != 0; |
318 | // Returns different negative values on WinME and WinNT, | |
319 | // so simply test for negative value. | |
320 | return ::GetKeyState(VK_SHIFT) < 0; | |
a95e38c0 VZ |
321 | } |
322 | ||
1f80a703 | 323 | inline bool wxIsCtrlDown() |
a95e38c0 | 324 | { |
1fdf858b JS |
325 | // return (::GetKeyState(VK_CONTROL) & 0x100) != 0; |
326 | // Returns different negative values on WinME and WinNT, | |
327 | // so simply test for negative value. | |
328 | return ::GetKeyState(VK_CONTROL) < 0; | |
a95e38c0 VZ |
329 | } |
330 | ||
82c9f85c VZ |
331 | // wrapper around GetWindowRect() and GetClientRect() APIs doing error checking |
332 | // for Win32 | |
333 | inline RECT wxGetWindowRect(HWND hwnd) | |
334 | { | |
335 | RECT rect; | |
3a5bcc4d | 336 | |
82c9f85c VZ |
337 | if ( !::GetWindowRect(hwnd, &rect) ) |
338 | { | |
339 | wxLogLastError(_T("GetWindowRect")); | |
340 | } | |
82c9f85c VZ |
341 | |
342 | return rect; | |
343 | } | |
344 | ||
345 | inline RECT wxGetClientRect(HWND hwnd) | |
346 | { | |
347 | RECT rect; | |
3a5bcc4d | 348 | |
82c9f85c VZ |
349 | if ( !::GetClientRect(hwnd, &rect) ) |
350 | { | |
351 | wxLogLastError(_T("GetClientRect")); | |
352 | } | |
82c9f85c VZ |
353 | |
354 | return rect; | |
355 | } | |
356 | ||
6d167489 VZ |
357 | // --------------------------------------------------------------------------- |
358 | // small helper classes | |
359 | // --------------------------------------------------------------------------- | |
360 | ||
361 | // create an instance of this class and use it as the HDC for screen, will | |
362 | // automatically release the DC going out of scope | |
363 | class ScreenHDC | |
364 | { | |
365 | public: | |
091225b4 VZ |
366 | ScreenHDC() { m_hdc = ::GetDC(NULL); } |
367 | ~ScreenHDC() { ::ReleaseDC(NULL, m_hdc); } | |
368 | ||
369 | operator HDC() const { return m_hdc; } | |
370 | ||
371 | private: | |
372 | HDC m_hdc; | |
22f3361e VZ |
373 | |
374 | DECLARE_NO_COPY_CLASS(ScreenHDC) | |
091225b4 VZ |
375 | }; |
376 | ||
2ff56383 VZ |
377 | // the same as ScreenHDC but for window DCs |
378 | class WindowHDC | |
379 | { | |
380 | public: | |
381 | WindowHDC(HWND hwnd) { m_hdc = ::GetDC(m_hwnd = hwnd); } | |
382 | ~WindowHDC() { ::ReleaseDC(m_hwnd, m_hdc); } | |
383 | ||
384 | operator HDC() const { return m_hdc; } | |
385 | ||
386 | private: | |
387 | HWND m_hwnd; | |
388 | HDC m_hdc; | |
389 | ||
390 | DECLARE_NO_COPY_CLASS(WindowHDC) | |
391 | }; | |
392 | ||
697b08a8 VZ |
393 | // the same as ScreenHDC but for memory DCs: creates the HDC compatible with |
394 | // the given one (screen by default) in ctor and destroys it in dtor | |
091225b4 VZ |
395 | class MemoryHDC |
396 | { | |
397 | public: | |
9cf743aa | 398 | MemoryHDC(HDC hdc = 0) { m_hdc = ::CreateCompatibleDC(hdc); } |
697b08a8 | 399 | ~MemoryHDC() { ::DeleteDC(m_hdc); } |
091225b4 VZ |
400 | |
401 | operator HDC() const { return m_hdc; } | |
6d167489 VZ |
402 | |
403 | private: | |
404 | HDC m_hdc; | |
22f3361e VZ |
405 | |
406 | DECLARE_NO_COPY_CLASS(MemoryHDC) | |
6d167489 VZ |
407 | }; |
408 | ||
091225b4 VZ |
409 | // a class which selects a GDI object into a DC in its ctor and deselects in |
410 | // dtor | |
411 | class SelectInHDC | |
412 | { | |
413 | public: | |
414 | SelectInHDC(HDC hdc, HGDIOBJ hgdiobj) : m_hdc(hdc) | |
415 | { m_hgdiobj = ::SelectObject(hdc, hgdiobj); } | |
416 | ||
417 | ~SelectInHDC() { ::SelectObject(m_hdc, m_hgdiobj); } | |
418 | ||
419 | // return true if the object was successfully selected | |
420 | operator bool() const { return m_hgdiobj != 0; } | |
421 | ||
422 | private: | |
423 | HDC m_hdc; | |
424 | HGDIOBJ m_hgdiobj; | |
22f3361e | 425 | |
51a2a728 VZ |
426 | DECLARE_NO_COPY_CLASS(SelectInHDC) |
427 | }; | |
428 | ||
a27cbf44 VZ |
429 | // a class which cleans up any GDI object |
430 | class AutoGDIObject | |
431 | { | |
432 | protected: | |
433 | AutoGDIObject(HGDIOBJ gdiobj) : m_gdiobj(gdiobj) { } | |
434 | ~AutoGDIObject() { if ( m_gdiobj ) ::DeleteObject(m_gdiobj); } | |
435 | ||
436 | HGDIOBJ GetObject() const { return m_gdiobj; } | |
437 | ||
438 | private: | |
439 | HGDIOBJ m_gdiobj; | |
440 | }; | |
441 | ||
cf831d8e VZ |
442 | // TODO: all this asks for using a AutoHandler<T, CreateFunc> template... |
443 | ||
444 | // a class for temporary pens | |
445 | class AutoHBRUSH : private AutoGDIObject | |
446 | { | |
447 | public: | |
448 | AutoHBRUSH(COLORREF col) | |
449 | : AutoGDIObject(::CreateSolidBrush(col)) { } | |
450 | ||
451 | operator HBRUSH() const { return (HBRUSH)GetObject(); } | |
452 | }; | |
453 | ||
454 | // a class for temporary pens | |
455 | class AutoHPEN : private AutoGDIObject | |
456 | { | |
457 | public: | |
458 | AutoHPEN(COLORREF col) | |
459 | : AutoGDIObject(::CreatePen(PS_SOLID, 0, col)) { } | |
460 | ||
461 | operator HPEN() const { return (HPEN)GetObject(); } | |
462 | }; | |
463 | ||
464 | // classes for temporary bitmaps | |
465 | class AutoHBITMAP : private AutoGDIObject | |
466 | { | |
467 | public: | |
468 | AutoHBITMAP(HBITMAP hbmp) : AutoGDIObject(hbmp) { } | |
469 | ||
470 | operator HBITMAP() const { return (HBITMAP)GetObject(); } | |
471 | }; | |
472 | ||
473 | class CompatibleBitmap : public AutoHBITMAP | |
978bb48f VZ |
474 | { |
475 | public: | |
476 | CompatibleBitmap(HDC hdc, int w, int h) | |
cf831d8e | 477 | : AutoHBITMAP(::CreateCompatibleBitmap(hdc, w, h)) |
978bb48f | 478 | { |
978bb48f | 479 | } |
cf831d8e | 480 | }; |
978bb48f | 481 | |
cf831d8e VZ |
482 | class MonoBitmap : public AutoHBITMAP |
483 | { | |
484 | public: | |
485 | MonoBitmap(int w, int h) | |
486 | : AutoHBITMAP(::CreateBitmap(w, h, 1, 1, 0)) | |
487 | { | |
488 | } | |
a27cbf44 | 489 | }; |
978bb48f | 490 | |
a27cbf44 VZ |
491 | // class automatically destroys the region object |
492 | class AutoHRGN : private AutoGDIObject | |
493 | { | |
494 | public: | |
495 | AutoHRGN(HRGN hrgn) : AutoGDIObject(hrgn) { } | |
978bb48f | 496 | |
a27cbf44 | 497 | operator HRGN() const { return (HRGN)GetObject(); } |
978bb48f VZ |
498 | }; |
499 | ||
a1372ae2 VZ |
500 | // class sets the specified clipping region during its life time |
501 | class HDCClipper | |
502 | { | |
503 | public: | |
504 | HDCClipper(HDC hdc, HRGN hrgn) | |
505 | : m_hdc(hdc) | |
506 | { | |
507 | if ( !::SelectClipRgn(hdc, hrgn) ) | |
508 | wxLogLastError(_T("SelectClipRgn")); | |
509 | } | |
510 | ||
511 | ~HDCClipper() | |
512 | { | |
513 | ::SelectClipRgn(m_hdc, NULL); | |
514 | } | |
515 | ||
516 | private: | |
517 | HDC m_hdc; | |
518 | ||
519 | DECLARE_NO_COPY_CLASS(HDCClipper) | |
520 | }; | |
521 | ||
2be57a51 VZ |
522 | // smart buffeer using GlobalAlloc/GlobalFree() |
523 | class GlobalPtr | |
524 | { | |
525 | public: | |
526 | // allocates a block of given size | |
527 | GlobalPtr(size_t size, unsigned flags = GMEM_MOVEABLE) | |
528 | { | |
529 | m_hGlobal = ::GlobalAlloc(flags, size); | |
530 | if ( !m_hGlobal ) | |
531 | wxLogLastError(_T("GlobalAlloc")); | |
532 | } | |
533 | ||
534 | ~GlobalPtr() | |
535 | { | |
536 | if ( m_hGlobal && ::GlobalFree(m_hGlobal) ) | |
537 | wxLogLastError(_T("GlobalFree")); | |
538 | } | |
539 | ||
540 | // implicit conversion | |
541 | operator HGLOBAL() const { return m_hGlobal; } | |
542 | ||
543 | private: | |
544 | HGLOBAL m_hGlobal; | |
545 | ||
546 | DECLARE_NO_COPY_CLASS(GlobalPtr) | |
547 | }; | |
548 | ||
51a2a728 VZ |
549 | // when working with global pointers (which is unfortunately still necessary |
550 | // sometimes, e.g. for clipboard) it is important to unlock them exactly as | |
551 | // many times as we lock them which just asks for using a "smart lock" class | |
0645e2b9 | 552 | class GlobalPtrLock |
51a2a728 VZ |
553 | { |
554 | public: | |
0645e2b9 | 555 | GlobalPtrLock(HGLOBAL hGlobal) : m_hGlobal(hGlobal) |
51a2a728 | 556 | { |
2aaf17c2 | 557 | m_ptr = GlobalLock(hGlobal); |
51a2a728 VZ |
558 | if ( !m_ptr ) |
559 | { | |
560 | wxLogLastError(_T("GlobalLock")); | |
561 | } | |
562 | } | |
563 | ||
0645e2b9 | 564 | ~GlobalPtrLock() |
51a2a728 | 565 | { |
2aaf17c2 | 566 | if ( !GlobalUnlock(m_hGlobal) ) |
51a2a728 VZ |
567 | { |
568 | #ifdef __WXDEBUG__ | |
569 | // this might happen simply because the block became unlocked | |
570 | DWORD dwLastError = ::GetLastError(); | |
571 | if ( dwLastError != NO_ERROR ) | |
572 | { | |
573 | wxLogApiError(_T("GlobalUnlock"), dwLastError); | |
574 | } | |
575 | #endif // __WXDEBUG__ | |
576 | } | |
577 | } | |
578 | ||
579 | operator void *() const { return m_ptr; } | |
580 | ||
581 | private: | |
582 | HGLOBAL m_hGlobal; | |
583 | void *m_ptr; | |
584 | ||
0645e2b9 | 585 | DECLARE_NO_COPY_CLASS(GlobalPtrLock) |
091225b4 VZ |
586 | }; |
587 | ||
77ec05d4 VZ |
588 | // register the class when it is first needed and unregister it in dtor |
589 | class ClassRegistrar | |
590 | { | |
591 | public: | |
592 | // ctor doesn't register the class, call Initialize() for this | |
593 | ClassRegistrar() { m_registered = -1; } | |
594 | ||
595 | // return true if the class is already registered | |
596 | bool IsInitialized() const { return m_registered != -1; } | |
597 | ||
598 | // return true if the class had been already registered | |
599 | bool IsRegistered() const { return m_registered == 1; } | |
600 | ||
601 | // try to register the class if not done yet, return true on success | |
602 | bool Register(const WNDCLASS& wc) | |
603 | { | |
604 | // we should only be called if we hadn't been initialized yet | |
605 | wxASSERT_MSG( m_registered == -1, | |
606 | _T("calling ClassRegistrar::Register() twice?") ); | |
607 | ||
608 | m_registered = ::RegisterClass(&wc) ? 1 : 0; | |
609 | if ( !IsRegistered() ) | |
610 | { | |
611 | wxLogLastError(_T("RegisterClassEx()")); | |
612 | } | |
613 | else | |
614 | { | |
615 | m_clsname = wc.lpszClassName; | |
616 | } | |
617 | ||
618 | return m_registered == 1; | |
619 | } | |
620 | ||
621 | // get the name of the registered class (returns empty string if not | |
622 | // registered) | |
623 | const wxString& GetName() const { return m_clsname; } | |
624 | ||
625 | // unregister the class if it had been registered | |
626 | ~ClassRegistrar() | |
627 | { | |
628 | if ( IsRegistered() ) | |
629 | { | |
630 | if ( !::UnregisterClass(m_clsname, wxhInstance) ) | |
631 | { | |
632 | wxLogLastError(_T("UnregisterClass")); | |
633 | } | |
634 | } | |
635 | } | |
636 | ||
637 | private: | |
638 | // initial value is -1 which means that we hadn't tried registering the | |
639 | // class yet, it becomes true or false (1 or 0) when Initialize() is called | |
640 | int m_registered; | |
641 | ||
642 | // the name of the class, only non empty if it had been registered | |
643 | wxString m_clsname; | |
644 | }; | |
645 | ||
a23fd0e1 | 646 | // --------------------------------------------------------------------------- |
42e69d6b | 647 | // macros to make casting between WXFOO and FOO a bit easier: the GetFoo() |
c50f1fb9 VZ |
648 | // returns Foo cast to the Windows type for oruselves, while GetFooOf() takes |
649 | // an argument which should be a pointer or reference to the object of the | |
650 | // corresponding class (this depends on the macro) | |
a23fd0e1 VZ |
651 | // --------------------------------------------------------------------------- |
652 | ||
653 | #define GetHwnd() ((HWND)GetHWND()) | |
c50f1fb9 VZ |
654 | #define GetHwndOf(win) ((HWND)((win)->GetHWND())) |
655 | // old name | |
656 | #define GetWinHwnd GetHwndOf | |
a23fd0e1 VZ |
657 | |
658 | #define GetHdc() ((HDC)GetHDC()) | |
c50f1fb9 | 659 | #define GetHdcOf(dc) ((HDC)(dc).GetHDC()) |
a23fd0e1 | 660 | |
11c7d5b6 VZ |
661 | #define GetHbitmap() ((HBITMAP)GetHBITMAP()) |
662 | #define GetHbitmapOf(bmp) ((HBITMAP)(bmp).GetHBITMAP()) | |
663 | ||
42e69d6b | 664 | #define GetHicon() ((HICON)GetHICON()) |
c50f1fb9 | 665 | #define GetHiconOf(icon) ((HICON)(icon).GetHICON()) |
42e69d6b | 666 | |
a23fd0e1 | 667 | #define GetHaccel() ((HACCEL)GetHACCEL()) |
c50f1fb9 VZ |
668 | #define GetHaccelOf(table) ((HACCEL)((table).GetHACCEL())) |
669 | ||
a27cbf44 VZ |
670 | #define GetHbrush() ((HBRUSH)GetResourceHandle()) |
671 | #define GetHbrushOf(brush) ((HBRUSH)(brush).GetResourceHandle()) | |
ee50eab8 | 672 | |
c50f1fb9 VZ |
673 | #define GetHmenu() ((HMENU)GetHMenu()) |
674 | #define GetHmenuOf(menu) ((HMENU)menu->GetHMenu()) | |
a23fd0e1 | 675 | |
bfbd6dc1 VZ |
676 | #define GetHcursor() ((HCURSOR)GetHCURSOR()) |
677 | #define GetHcursorOf(cursor) ((HCURSOR)(cursor).GetHCURSOR()) | |
678 | ||
f6bcfd97 BP |
679 | #define GetHfont() ((HFONT)GetHFONT()) |
680 | #define GetHfontOf(font) ((HFONT)(font).GetHFONT()) | |
681 | ||
f6840be6 VZ |
682 | #define GetHimagelist() ((HIMAGELIST)GetHIMAGELIST()) |
683 | #define GetHimagelistOf(imgl) ((HIMAGELIST)imgl->GetHIMAGELIST()) | |
684 | ||
1816a070 | 685 | #define GetHpalette() ((HPALETTE)GetHPALETTE()) |
b95edd47 | 686 | #define GetHpaletteOf(pal) ((HPALETTE)(pal).GetHPALETTE()) |
1816a070 | 687 | |
75776373 VZ |
688 | #define GetHpen() ((HPEN)GetResourceHandle()) |
689 | #define GetHpenOf(pen) ((HPEN)(pen).GetResourceHandle()) | |
690 | ||
1e6feb95 VZ |
691 | #define GetHrgn() ((HRGN)GetHRGN()) |
692 | #define GetHrgnOf(rgn) ((HRGN)(rgn).GetHRGN()) | |
693 | ||
f6bcfd97 BP |
694 | #endif // wxUSE_GUI |
695 | ||
a23fd0e1 VZ |
696 | // --------------------------------------------------------------------------- |
697 | // global functions | |
698 | // --------------------------------------------------------------------------- | |
699 | ||
18600546 GRG |
700 | extern "C" |
701 | { | |
bb24c68f | 702 | WXDLLIMPEXP_BASE HINSTANCE wxGetInstance(); |
18600546 GRG |
703 | } |
704 | ||
bb24c68f | 705 | WXDLLIMPEXP_BASE void wxSetInstance(HINSTANCE hInst); |
a23fd0e1 | 706 | |
25b0e7c8 VZ |
707 | // return the full path of the given module |
708 | inline wxString wxGetFullModuleName(HMODULE hmod) | |
77d8d6cd VZ |
709 | { |
710 | wxString fullname; | |
711 | if ( !::GetModuleFileName | |
712 | ( | |
25b0e7c8 | 713 | hmod, |
77d8d6cd VZ |
714 | wxStringBuffer(fullname, MAX_PATH), |
715 | MAX_PATH | |
716 | ) ) | |
717 | { | |
718 | wxLogLastError(_T("GetModuleFileName")); | |
719 | } | |
720 | ||
721 | return fullname; | |
722 | } | |
723 | ||
25b0e7c8 VZ |
724 | // return the full path of the program file |
725 | inline wxString wxGetFullModuleName() | |
726 | { | |
727 | return wxGetFullModuleName((HMODULE)wxGetInstance()); | |
728 | } | |
729 | ||
4c5da5e4 VZ |
730 | // return the run-time version of the OS in a format similar to |
731 | // WINVER/_WIN32_WINNT compile-time macros: | |
732 | // | |
733 | // 0x0300 Windows NT 3.51 | |
734 | // 0x0400 Windows 95, NT4 | |
735 | // 0x0410 Windows 98 | |
736 | // 0x0500 Windows ME, 2000 | |
737 | // 0x0501 Windows XP | |
738 | // 0x0502 Windows 2003 | |
739 | // 0x0600 Longhorn | |
740 | // | |
741 | // for the other Windows versions 0 is currently returned | |
742 | enum wxWinVersion | |
743 | { | |
744 | wxWinVersion_Unknown = 0, | |
745 | ||
746 | wxWinVersion_3 = 0x0300, | |
747 | wxWinVersion_NT3 = wxWinVersion_3, | |
748 | ||
749 | wxWinVersion_4 = 0x0400, | |
750 | wxWinVersion_95 = wxWinVersion_4, | |
751 | wxWinVersion_NT4 = wxWinVersion_4, | |
752 | wxWinVersion_98 = 0x0410, | |
753 | ||
754 | wxWinVersion_5 = 0x0500, | |
755 | wxWinVersion_ME = wxWinVersion_5, | |
756 | wxWinVersion_NT5 = wxWinVersion_5, | |
757 | wxWinVersion_2000 = wxWinVersion_5, | |
758 | wxWinVersion_XP = 0x0501, | |
759 | wxWinVersion_2003 = 0x0502, | |
760 | ||
761 | wxWinVersion_6 = 0x0600, | |
762 | wxWinVersion_NT6 = 0x0600 | |
763 | }; | |
764 | ||
be2572a3 | 765 | WXDLLIMPEXP_BASE wxWinVersion wxGetWinVersion(); |
4c5da5e4 | 766 | |
b568d04f VZ |
767 | #if wxUSE_GUI |
768 | ||
bfbd6dc1 VZ |
769 | // cursor stuff |
770 | extern HCURSOR wxGetCurrentBusyCursor(); // from msw/utils.cpp | |
771 | extern const wxCursor *wxGetGlobalCursor(); // from msw/cursor.cpp | |
772 | ||
7a5e53ab | 773 | WXDLLEXPORT void wxGetCharSize(WXHWND wnd, int *x, int *y, const wxFont& the_font); |
11c7d5b6 VZ |
774 | WXDLLEXPORT void wxFillLogFont(LOGFONT *logFont, const wxFont *font); |
775 | WXDLLEXPORT wxFont wxCreateFontFromLogFont(const LOGFONT *logFont); | |
f6bcfd97 | 776 | WXDLLEXPORT wxFontEncoding wxGetFontEncFromCharSet(int charset); |
a23fd0e1 VZ |
777 | |
778 | WXDLLEXPORT void wxSliderEvent(WXHWND control, WXWORD wParam, WXWORD pos); | |
779 | WXDLLEXPORT void wxScrollBarEvent(WXHWND hbar, WXWORD wParam, WXWORD pos); | |
780 | ||
781 | // Find maximum size of window/rectangle | |
ef359b43 | 782 | extern WXDLLEXPORT void wxFindMaxSize(WXHWND hwnd, RECT *rect); |
a23fd0e1 | 783 | |
1c4a764c | 784 | // Safely get the window text (i.e. without using fixed size buffer) |
ef359b43 | 785 | extern WXDLLEXPORT wxString wxGetWindowText(WXHWND hWnd); |
1c4a764c | 786 | |
cc2b7472 | 787 | // get the window class name |
ef359b43 | 788 | extern WXDLLEXPORT wxString wxGetWindowClass(WXHWND hWnd); |
cc2b7472 | 789 | |
42e69d6b VZ |
790 | // get the window id (should be unsigned, hence this is not wxWindowID which |
791 | // is, for mainly historical reasons, signed) | |
ef359b43 | 792 | extern WXDLLEXPORT WXWORD wxGetWindowId(WXHWND hWnd); |
cc2b7472 | 793 | |
ae304744 VZ |
794 | // check if hWnd's WNDPROC is wndProc. Return true if yes, false if they are |
795 | // different | |
ef359b43 | 796 | extern WXDLLEXPORT bool wxCheckWindowWndProc(WXHWND hWnd, WXFARPROC wndProc); |
eb5e4d9a | 797 | |
c085e333 | 798 | // Does this window style specify any border? |
184b5d99 | 799 | inline bool wxStyleHasBorder(long style) |
c085e333 | 800 | { |
82c9f85c VZ |
801 | return (style & (wxSIMPLE_BORDER | wxRAISED_BORDER | |
802 | wxSUNKEN_BORDER | wxDOUBLE_BORDER)) != 0; | |
c085e333 VZ |
803 | } |
804 | ||
ae304744 VZ |
805 | // ---------------------------------------------------------------------------- |
806 | // functions mapping HWND to wxWindow | |
807 | // ---------------------------------------------------------------------------- | |
808 | ||
809 | // this function simply checks whether the given hWnd corresponds to a wxWindow | |
810 | // and returns either that window if it does or NULL otherwise | |
ef359b43 | 811 | extern WXDLLEXPORT wxWindow* wxFindWinFromHandle(WXHWND hWnd); |
ae304744 VZ |
812 | |
813 | // find the window for HWND which is part of some wxWindow, i.e. unlike | |
814 | // wxFindWinFromHandle() above it will also work for "sub controls" of a | |
815 | // wxWindow. | |
8614c467 | 816 | // |
ae304744 | 817 | // returns the wxWindow corresponding to the given HWND or NULL. |
ef359b43 | 818 | extern WXDLLEXPORT wxWindow *wxGetWindowFromHWND(WXHWND hwnd); |
8614c467 | 819 | |
6bad4c32 | 820 | // Get the size of an icon |
ef359b43 | 821 | extern WXDLLEXPORT wxSize wxGetHiconSize(HICON hicon); |
6bad4c32 | 822 | |
086b3a5b JS |
823 | // Lines are drawn differently for WinCE and regular WIN32 |
824 | WXDLLEXPORT void wxDrawLine(HDC hdc, int x1, int y1, int x2, int y2); | |
825 | ||
c3732409 VZ |
826 | // fill the client rect of the given window on the provided dc using this brush |
827 | inline void wxFillRect(HWND hwnd, HDC hdc, HBRUSH hbr) | |
828 | { | |
829 | RECT rc; | |
830 | ::GetClientRect(hwnd, &rc); | |
831 | ::FillRect(hdc, &rc, hbr); | |
832 | } | |
833 | ||
5171ea0e VZ |
834 | // ---------------------------------------------------------------------------- |
835 | // 32/64 bit helpers | |
836 | // ---------------------------------------------------------------------------- | |
837 | ||
838 | #ifdef __WIN64__ | |
839 | ||
840 | inline void *wxGetWindowProc(HWND hwnd) | |
841 | { | |
842 | return (void *)::GetWindowLongPtr(hwnd, GWLP_WNDPROC); | |
843 | } | |
844 | ||
845 | inline void *wxGetWindowUserData(HWND hwnd) | |
846 | { | |
847 | return (void *)::GetWindowLongPtr(hwnd, GWLP_USERDATA); | |
848 | } | |
849 | ||
850 | inline WNDPROC wxSetWindowProc(HWND hwnd, WNDPROC func) | |
851 | { | |
852 | return (WNDPROC)::SetWindowLongPtr(hwnd, GWLP_WNDPROC, (LONG_PTR)func); | |
853 | } | |
854 | ||
855 | inline void *wxSetWindowUserData(HWND hwnd, void *data) | |
856 | { | |
857 | return (void *)::SetWindowLongPtr(hwnd, GWLP_USERDATA, (LONG_PTR)data); | |
858 | } | |
859 | ||
860 | #else // __WIN32__ | |
861 | ||
b41f29c3 VZ |
862 | #ifdef __VISUALC__ |
863 | // strangely enough, VC++ 7.1 gives warnings about 32 -> 64 bit conversions | |
864 | // in the functions below, even in spite of the explicit casts | |
865 | #pragma warning(disable:4311) | |
866 | #pragma warning(disable:4312) | |
867 | #endif | |
868 | ||
5171ea0e VZ |
869 | inline void *wxGetWindowProc(HWND hwnd) |
870 | { | |
871 | return (void *)::GetWindowLong(hwnd, GWL_WNDPROC); | |
872 | } | |
873 | ||
874 | inline void *wxGetWindowUserData(HWND hwnd) | |
875 | { | |
876 | return (void *)::GetWindowLong(hwnd, GWL_USERDATA); | |
877 | } | |
878 | ||
879 | inline WNDPROC wxSetWindowProc(HWND hwnd, WNDPROC func) | |
880 | { | |
881 | return (WNDPROC)::SetWindowLong(hwnd, GWL_WNDPROC, (LONG)func); | |
882 | } | |
883 | ||
884 | inline void *wxSetWindowUserData(HWND hwnd, void *data) | |
885 | { | |
886 | return (void *)::SetWindowLong(hwnd, GWL_USERDATA, (LONG)data); | |
887 | } | |
888 | ||
b41f29c3 VZ |
889 | #ifdef __VISUALC__ |
890 | #pragma warning(default:4311) | |
891 | #pragma warning(default:4312) | |
892 | #endif | |
893 | ||
5171ea0e VZ |
894 | #endif // __WIN64__/__WIN32__ |
895 | ||
b568d04f VZ |
896 | #endif // wxUSE_GUI |
897 | ||
a27cbf44 | 898 | #endif // _WX_PRIVATE_H_ |