include/wx/msw/private.h

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