]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/private.h
added wx/object.h include (bug 1398517)
[wxWidgets.git] / include / wx / msw / private.h
CommitLineData
2bda0e17 1/////////////////////////////////////////////////////////////////////////////
c0089c96 2// Name: wx/msw/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 29class WXDLLEXPORT wxFont;
d427503c 30class WXDLLEXPORT wxWindow;
c282a7a1 31class 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
48extern WXDLLEXPORT_DATA(HICON) wxSTD_FRAME_ICON;
49extern WXDLLEXPORT_DATA(HICON) wxSTD_MDIPARENTFRAME_ICON;
50extern WXDLLEXPORT_DATA(HICON) wxSTD_MDICHILDFRAME_ICON;
51extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_FRAME_ICON;
52extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_MDIPARENTFRAME_ICON;
53extern WXDLLEXPORT_DATA(HICON) wxDEFAULT_MDICHILDFRAME_ICON;
54extern WXDLLEXPORT_DATA(HFONT) wxSTATUS_LINE_FONT;
2bda0e17 55
b568d04f
VZ
56#endif // wxUSE_GUI
57
77ec05d4
VZ
58// ---------------------------------------------------------------------------
59// global data
60// ---------------------------------------------------------------------------
61
62extern 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
148extern 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
181class AutoHANDLE
182{
183public:
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
191protected:
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...)
198template <class T>
199struct 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
c0089c96
WS
213#include "wx/gdicmn.h"
214#include "wx/colour.h"
01dba85a 215
11c7d5b6
VZ
216// make conversion from wxColour and COLORREF a bit less painful
217inline COLORREF wxColourToRGB(const wxColour& c)
4ab861e5
VZ
218{
219 return RGB(c.Red(), c.Green(), c.Blue());
220}
221
222inline COLORREF wxColourToPalRGB(const wxColour& c)
11c7d5b6 223{
19193a2c 224 return PALETTERGB(c.Red(), c.Green(), c.Blue());
11c7d5b6
VZ
225}
226
d23c8ba2
VZ
227inline wxColour wxRGBToColour(COLORREF rgb)
228{
229 return wxColour(GetRValue(rgb), GetGValue(rgb), GetBValue(rgb));
230}
231
11c7d5b6
VZ
232inline 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!
245enum 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
254struct WXDLLEXPORT wxCOLORMAP
255{
256 COLORREF from, to;
257};
258
259// this function is implemented in src/msw/window.cpp
260extern wxCOLORMAP *wxGetStdColourMap();
261
9688700c 262// create a wxRect from Windows RECT
8704b366 263inline 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 269inline void wxCopyRECTToRect(const RECT& rc, wxRect& rect)
ed791986 270{
8704b366
VZ
271 rect = wxRectFromRECT(rc);
272}
273
274// and vice versa
275inline 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
287extern void HIMETRICToPixel(LONG *x, LONG *y);
288extern 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
292extern 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.
298extern HICON wxBitmapToHICON(const wxBitmap& bmp);
299
300// Same requirments as above apply and the bitmap must also have the correct
301// size.
302extern
303HCURSOR 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 315inline 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 323inline 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
333inline 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
345inline 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
363class ScreenHDC
364{
365public:
091225b4
VZ
366 ScreenHDC() { m_hdc = ::GetDC(NULL); }
367 ~ScreenHDC() { ::ReleaseDC(NULL, m_hdc); }
368
369 operator HDC() const { return m_hdc; }
370
371private:
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
378class WindowHDC
379{
380public:
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
386private:
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
395class MemoryHDC
396{
397public:
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
403private:
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
411class SelectInHDC
412{
413public:
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
422private:
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
430class AutoGDIObject
431{
432protected:
433 AutoGDIObject(HGDIOBJ gdiobj) : m_gdiobj(gdiobj) { }
434 ~AutoGDIObject() { if ( m_gdiobj ) ::DeleteObject(m_gdiobj); }
435
436 HGDIOBJ GetObject() const { return m_gdiobj; }
437
438private:
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
445class AutoHBRUSH : private AutoGDIObject
446{
447public:
448 AutoHBRUSH(COLORREF col)
449 : AutoGDIObject(::CreateSolidBrush(col)) { }
450
451 operator HBRUSH() const { return (HBRUSH)GetObject(); }
452};
453
454// a class for temporary pens
455class AutoHPEN : private AutoGDIObject
456{
457public:
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
465class AutoHBITMAP : private AutoGDIObject
466{
467public:
468 AutoHBITMAP(HBITMAP hbmp) : AutoGDIObject(hbmp) { }
469
470 operator HBITMAP() const { return (HBITMAP)GetObject(); }
471};
472
473class CompatibleBitmap : public AutoHBITMAP
978bb48f
VZ
474{
475public:
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
482class MonoBitmap : public AutoHBITMAP
483{
484public:
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
492class AutoHRGN : private AutoGDIObject
493{
494public:
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
501class HDCClipper
502{
503public:
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
516private:
517 HDC m_hdc;
518
519 DECLARE_NO_COPY_CLASS(HDCClipper)
520};
521
2be57a51
VZ
522// smart buffeer using GlobalAlloc/GlobalFree()
523class GlobalPtr
524{
525public:
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
543private:
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 552class GlobalPtrLock
51a2a728
VZ
553{
554public:
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
581private:
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
589class ClassRegistrar
590{
591public:
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
637private:
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
700extern "C"
701{
bb24c68f 702 WXDLLIMPEXP_BASE HINSTANCE wxGetInstance();
18600546
GRG
703}
704
bb24c68f 705WXDLLIMPEXP_BASE void wxSetInstance(HINSTANCE hInst);
a23fd0e1 706
25b0e7c8
VZ
707// return the full path of the given module
708inline 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
725inline 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
742enum 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 765WXDLLIMPEXP_BASE wxWinVersion wxGetWinVersion();
4c5da5e4 766
b568d04f
VZ
767#if wxUSE_GUI
768
bfbd6dc1
VZ
769// cursor stuff
770extern HCURSOR wxGetCurrentBusyCursor(); // from msw/utils.cpp
771extern const wxCursor *wxGetGlobalCursor(); // from msw/cursor.cpp
772
7a5e53ab 773WXDLLEXPORT void wxGetCharSize(WXHWND wnd, int *x, int *y, const wxFont& the_font);
11c7d5b6
VZ
774WXDLLEXPORT void wxFillLogFont(LOGFONT *logFont, const wxFont *font);
775WXDLLEXPORT wxFont wxCreateFontFromLogFont(const LOGFONT *logFont);
f6bcfd97 776WXDLLEXPORT wxFontEncoding wxGetFontEncFromCharSet(int charset);
a23fd0e1
VZ
777
778WXDLLEXPORT void wxSliderEvent(WXHWND control, WXWORD wParam, WXWORD pos);
779WXDLLEXPORT void wxScrollBarEvent(WXHWND hbar, WXWORD wParam, WXWORD pos);
780
781// Find maximum size of window/rectangle
ef359b43 782extern WXDLLEXPORT void wxFindMaxSize(WXHWND hwnd, RECT *rect);
a23fd0e1 783
1c4a764c 784// Safely get the window text (i.e. without using fixed size buffer)
ef359b43 785extern WXDLLEXPORT wxString wxGetWindowText(WXHWND hWnd);
1c4a764c 786
cc2b7472 787// get the window class name
ef359b43 788extern 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 792extern 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 796extern WXDLLEXPORT bool wxCheckWindowWndProc(WXHWND hWnd, WXFARPROC wndProc);
eb5e4d9a 797
c085e333 798// Does this window style specify any border?
184b5d99 799inline 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 811extern 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 818extern WXDLLEXPORT wxWindow *wxGetWindowFromHWND(WXHWND hwnd);
8614c467 819
6bad4c32 820// Get the size of an icon
ef359b43 821extern WXDLLEXPORT wxSize wxGetHiconSize(HICON hicon);
6bad4c32 822
086b3a5b
JS
823// Lines are drawn differently for WinCE and regular WIN32
824WXDLLEXPORT 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
827inline 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
840inline void *wxGetWindowProc(HWND hwnd)
841{
842 return (void *)::GetWindowLongPtr(hwnd, GWLP_WNDPROC);
843}
844
845inline void *wxGetWindowUserData(HWND hwnd)
846{
847 return (void *)::GetWindowLongPtr(hwnd, GWLP_USERDATA);
848}
849
850inline WNDPROC wxSetWindowProc(HWND hwnd, WNDPROC func)
851{
852 return (WNDPROC)::SetWindowLongPtr(hwnd, GWLP_WNDPROC, (LONG_PTR)func);
853}
854
855inline 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
869inline void *wxGetWindowProc(HWND hwnd)
870{
871 return (void *)::GetWindowLong(hwnd, GWL_WNDPROC);
872}
873
874inline void *wxGetWindowUserData(HWND hwnd)
875{
876 return (void *)::GetWindowLong(hwnd, GWL_USERDATA);
877}
878
879inline WNDPROC wxSetWindowProc(HWND hwnd, WNDPROC func)
880{
881 return (WNDPROC)::SetWindowLong(hwnd, GWL_WNDPROC, (LONG)func);
882}
883
884inline 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_