include/wx/defs.h

   1 /**
   2 *  Name:        defs.h
   3 *  Purpose:     Declarations/definitions common to all wx source files
   4 *  Author:      Julian Smart and others
   5 *  Modified by: Ryan Norton (Converted to C)
   6 *  Created:     01/02/97
   7 *  RCS-ID:      $Id$
   8 *  Copyright:   (c) Julian Smart
   9 *  Licence:     wxWindows licence
  10 */
  11
  12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
  13
  14 #ifndef _WX_DEFS_H_
  15 #define _WX_DEFS_H_
  16
  17 /*  ---------------------------------------------------------------------------- */
  18 /*  compiler and OS identification */
  19 /*  ---------------------------------------------------------------------------- */
  20
  21 #include "wx/platform.h"
  22
  23 #ifdef __cplusplus
  24 /*  Make sure the environment is set correctly */
  25 #   if defined(__WXMSW__) && defined(__X__)
  26 #       error "Target can't be both X and Windows"
  27 #   elif defined(__WXMSW__) && defined(__PALMOS__)
  28 #       error "Target can't be both PalmOS and Windows"
  29 #   elif !defined(__WXMOTIF__) && \
  30          !defined(__WXMSW__)   && \
  31          !defined(__WXPALMOS__)&& \
  32          !defined(__WXGTK__)   && \
  33          !defined(__WXPM__)    && \
  34          !defined(__WXMAC__)   && \
  35          !defined(__WXCOCOA__) && \
  36          !defined(__X__)       && \
  37          !defined(__WXMGL__)   && \
  38          !defined(__WXX11__)   && \
  39           wxUSE_GUI
  40 #       ifdef __UNIX__
  41 #           error "No Target! You should use wx-config program for compilation flags!"
  42 #       else /*  !Unix */
  43 #           error "No Target! You should use supplied makefiles for compilation!"
  44 #       endif /*  Unix/!Unix */
  45 #   endif
  46 #endif /*__cplusplus*/
  47
  48 #ifndef __WXWINDOWS__
  49     #define __WXWINDOWS__ 1
  50 #endif
  51
  52 #ifndef wxUSE_BASE
  53     /*  by default consider that this is a monolithic build */
  54     #define wxUSE_BASE 1
  55 #endif
  56
  57 #if !wxUSE_GUI && !defined(__WXBASE__)
  58     #define __WXBASE__
  59 #endif
  60
  61 /*  include the feature test macros */
  62 #include "wx/features.h"
  63
  64 /*  suppress some Visual C++ warnings */
  65 #ifdef __VISUALC__
  66     /*  the only "real" warning here is 4244 but there are just too many of them */
  67     /*  in our code... one day someone should go and fix them but until then... */
  68 #   pragma warning(disable:4201)    /*  nonstandard extension used: nameless struct/union */
  69 #   pragma warning(disable:4244)    /*  conversion from double to float */
  70 #   pragma warning(disable:4710)    /*  function not inlined */
  71 #   pragma warning(disable:4097)    /*  typedef used as class */
  72 #   pragma warning(disable:4511)    /*  copy ctor couldn't be generated */
  73 #   pragma warning(disable:4512)    /*  operator=() couldn't be generated */
  74 #ifndef WIN32
  75 #   pragma warning(disable:4135)    /*  conversion between different integral types */
  76 #   pragma warning(disable:4769)    /*  assignment of near pointer to long integer */
  77 /*  This one is really annoying, since it occurs for each cast to (HANDLE)... */
  78 #   pragma warning(disable:4305)    /*  truncation of long to near ptr */
  79 #endif
  80 #endif /*  __VISUALC__ */
  81
  82 /*  suppress some Salford C++ warnings */
  83 #ifdef __SALFORDC__
  84 #   pragma suppress 353             /*  Possible nested comments */
  85 #   pragma suppress 593             /*  Define not used */
  86 #   pragma suppress 61              /*  enum has no name (doesn't suppress!) */
  87 #   pragma suppress 106             /*  unnamed, unused parameter */
  88 #   pragma suppress 571             /*  Virtual function hiding */
  89 #endif /*  __SALFORDC__ */
  90
  91 /*  suppress some Borland C++ warnings */
  92 #ifdef __BORLANDC__
  93 #   pragma warn -inl                /*  Functions containing reserved words and certain constructs are not expanded inline */
  94 #endif /*  __BORLANDC__ */
  95
  96 /*  ---------------------------------------------------------------------------- */
  97 /*  wxWidgets version and compatibility defines */
  98 /*  ---------------------------------------------------------------------------- */
  99
 100 #include "wx/version.h"
 101
 102 /*  ============================================================================ */
 103 /*  non portable C++ features */
 104 /*  ============================================================================ */
 105
 106 /*  ---------------------------------------------------------------------------- */
 107 /*  compiler defects workarounds */
 108 /*  ---------------------------------------------------------------------------- */
 109
 110 /*
 111    Digital Unix C++ compiler only defines this symbol for .cxx and .hxx files,
 112    so define it ourselves (newer versions do it for all files, though, and
 113    don't allow it to be redefined)
 114  */
 115 #if defined(__DECCXX) && !defined(__VMS) && !defined(__cplusplus)
 116 #define __cplusplus
 117 #endif /* __DECCXX */
 118
 119 /*  Resolves linking problems under HP-UX when compiling with gcc/g++ */
 120 #if defined(__HPUX__) && defined(__GNUG__)
 121 #define va_list __gnuc_va_list
 122 #endif /*  HP-UX */
 123
 124 /*  ---------------------------------------------------------------------------- */
 125 /*  check for native bool type and TRUE/FALSE constants */
 126 /*  ---------------------------------------------------------------------------- */
 127
 128 /*  Add more tests here for Windows compilers that already define bool */
 129 /*  (under Unix, configure tests for this) */
 130 #ifndef HAVE_BOOL
 131     #if defined( __MWERKS__ )
 132         #if (__MWERKS__ >= 0x1000) && __option(bool)
 133             #define HAVE_BOOL
 134         #endif
 135     #elif defined(__APPLE__) && defined(__APPLE_CC__)
 136         /*  Apple bundled gcc supports bool */
 137         #define HAVE_BOOL
 138     #elif defined(__VISUALC__) && (__VISUALC__ == 1020)
 139         /*  in VC++ 4.2 the bool keyword is reserved (hence can't be typedefed) */
 140         /*  but not implemented, so we must #define it */
 141         #define bool unsigned int
 142     #elif defined(__VISUALC__) && (__VISUALC__ == 1010)
 143         /*  For VisualC++ 4.1, we need to define */
 144         /*  bool as something between 4.0 & 5.0... */
 145         typedef unsigned int wxbool;
 146         #define bool wxbool
 147         #define HAVE_BOOL
 148     #elif defined(__VISUALC__) && (__VISUALC__ > 1020)
 149         /*  VC++ supports bool since 4.2 */
 150         #define HAVE_BOOL
 151     #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x500)
 152         /*  Borland 5.0+ supports bool */
 153         #define HAVE_BOOL
 154     #elif defined(__WATCOMC__) && (__WATCOMC__ >= 1100)
 155         /*  Watcom 11+ supports bool */
 156         #define HAVE_BOOL
 157     #elif defined(__DIGITALMARS__)
 158         /*  DigitalMars supports bool */
 159         #define HAVE_BOOL
 160     #elif defined(__GNUWIN32__) || defined(__MINGW32__) || defined(__CYGWIN__)
 161         /*  Cygwin supports bool */
 162         #define HAVE_BOOL
 163     #elif defined(__VISAGECPP__)
 164         #if __IBMCPP__ < 400
 165             typedef unsigned long bool;
 166             #define true ((bool)1)
 167             #define false ((bool)0)
 168         #endif
 169         #define HAVE_BOOL
 170     #endif /*  compilers */
 171 #endif /*  HAVE_BOOL */
 172
 173 #if !defined(__MWERKS__) || !defined(true)
 174 #if !defined(HAVE_BOOL) && !defined(bool) && !defined(VMS)
 175     /*  NB: of course, this doesn't replace the standard type, because, for */
 176     /*      example, overloading based on bool/int parameter doesn't work and */
 177     /*      so should be avoided in portable programs */
 178     typedef unsigned int bool;
 179 #endif /*  bool */
 180
 181 /*  deal with TRUE/true stuff: we assume that if the compiler supports bool, it */
 182 /*  supports true/false as well and that, OTOH, if it does _not_ support bool, */
 183 /*  it doesn't support these keywords (this is less sure, in particular VC++ */
 184 /*  4.x could be a problem here) */
 185 #ifndef HAVE_BOOL
 186     #define true ((bool)1)
 187     #define false ((bool)0)
 188 #endif
 189 #endif
 190
 191 /*  for backwards compatibility, also define TRUE and FALSE */
 192 /*  */
 193 /*  note that these definitions should work both in C++ and C code, so don't */
 194 /*  use true/false below */
 195 #ifndef TRUE
 196     #define TRUE 1
 197 #endif
 198
 199 #ifndef FALSE
 200     #define FALSE 0
 201 #endif
 202
 203 typedef short int WXTYPE;
 204
 205 /*  special care should be taken with this type under Windows where the real */
 206 /*  window id is unsigned, so we must always do the cast before comparing them */
 207 /*  (or else they would be always different!). Using wxGetWindowId() which does */
 208 /*  the cast itself is recommended. Note that this type can't be unsigned */
 209 /*  because wxID_ANY == -1 is a valid (and largely used) value for window id. */
 210 typedef int wxWindowID;
 211
 212 /*  ---------------------------------------------------------------------------- */
 213 /*  other feature tests */
 214 /*  ---------------------------------------------------------------------------- */
 215
 216 /*  Every ride down a slippery slope begins with a single step.. */
 217 /*  */
 218 /*  Yes, using nested classes is indeed against our coding standards in */
 219 /*  general, but there are places where you can use them to advantage */
 220 /*  without totally breaking ports that cannot use them.  If you do, then */
 221 /*  wrap it in this guard, but such cases should still be relatively rare. */
 222 #define wxUSE_NESTED_CLASSES    1
 223
 224 /*  check for explicit keyword support */
 225 #ifndef HAVE_EXPLICIT
 226     #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
 227         /*  VC++ 6.0 and 5.0 have explicit (what about earlier versions?) */
 228         #define HAVE_EXPLICIT
 229     #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
 230           && wxCHECK_GCC_VERSION(2, 95)
 231         /*  GCC 2.95 has explicit, what about earlier versions? */
 232         #define HAVE_EXPLICIT
 233     #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x0520)
 234         /*  BC++ 4.52 doesn't support explicit, CBuilder 1 does */
 235         #define HAVE_EXPLICIT
 236     #elif defined(__MWERKS__) && (__MWERKS__ >= 0x2400)
 237         /*  Metrowerks CW6 or higher has explicit */
 238         #define HAVE_EXPLICIT
 239     #elif defined(__DIGITALMARS__)
 240         #define HAVE_EXPLICIT
 241     #endif
 242 #endif /*  !HAVE_EXPLICIT */
 243
 244 #ifdef HAVE_EXPLICIT
 245     #define wxEXPLICIT explicit
 246 #else /*  !HAVE_EXPLICIT */
 247     #define wxEXPLICIT
 248 #endif /*  HAVE_EXPLICIT/!HAVE_EXPLICIT */
 249
 250 /* check for static/const_cast<>() (we don't use the other ones for now) */
 251 #ifndef HAVE_CXX_CASTS
 252     #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
 253         /*  VC++ 6.0 and 5.0 have C++ casts (what about earlier versions?) */
 254         #define HAVE_CXX_CASTS
 255     #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
 256           && wxCHECK_GCC_VERSION(2, 95)
 257         /*  GCC 2.95 has C++ casts, what about earlier versions? */
 258         #define HAVE_CXX_CASTS
 259     #endif
 260 #endif /*  !HAVE_CXX_CASTS */
 261
 262 #ifdef HAVE_CXX_CASTS
 263     #ifndef HAVE_CONST_CAST
 264         #define HAVE_CONST_CAST
 265     #endif
 266     #ifndef HAVE_REINTERPRET_CAST
 267         #define HAVE_REINTERPRET_CAST
 268     #endif
 269     #ifndef HAVE_STATIC_CAST
 270         #define HAVE_STATIC_CAST
 271     #endif
 272     #ifndef HAVE_DYNAMIC_CAST
 273         #define HAVE_DYNAMIC_CAST
 274     #endif
 275 #endif /*  HAVE_CXX_CASTS */
 276
 277 #ifdef HAVE_STATIC_CAST
 278     #define wx_static_cast(t, x) static_cast<t>(x)
 279 #else
 280     #define wx_static_cast(t, x) ((t)(x))
 281 #endif
 282
 283 #ifdef HAVE_CONST_CAST
 284     #define wx_const_cast(t, x) const_cast<t>(x)
 285 #else
 286     #define wx_const_cast(t, x) ((t)(x))
 287 #endif
 288
 289 #ifdef HAVE_REINTERPRET_CAST
 290     #define wx_reinterpret_cast(t, x) reinterpret_cast<t>(x)
 291 #else
 292     #define wx_reinterpret_cast(t, x) ((t)(x))
 293 #endif
 294
 295 /* for consistency with wxStatic/DynamicCast defined in wx/object.h */
 296 #define wxConstCast(obj, className) wx_const_cast(className *, obj)
 297
 298 #ifndef HAVE_STD_WSTRING
 299     #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
 300         /*  VC++ 6.0 and 5.0 have std::wstring (what about earlier versions?) */
 301         #define HAVE_STD_WSTRING
 302     #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
 303           && wxCHECK_GCC_VERSION(3, 1)
 304         /*  GCC 3.1 has std::wstring; 3.0 never was in MinGW, 2.95 hasn't it */
 305         #define HAVE_STD_WSTRING
 306     #endif
 307 #endif
 308
 309 #ifndef HAVE_STD_STRING_COMPARE
 310     #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
 311         /*  VC++ 6.0 and 5.0 have std::string::compare */
 312         /*  (what about earlier versions?) */
 313         #define HAVE_STD_STRING_COMPARE
 314     #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
 315           && wxCHECK_GCC_VERSION(3, 1)
 316         /*  GCC 3.1 has std::string::compare; */
 317         /*  3.0 never was in MinGW, 2.95 hasn't it */
 318         #define HAVE_STD_STRING_COMPARE
 319     #endif
 320 #endif
 321
 322 /* provide replacement for C99 va_copy() if the compiler doesn't have it */
 323
 324 /* could be already defined by configure or the user */
 325 #ifndef wxVaCopy
 326     /* if va_copy is a macro or configure detected that we have it, use it */
 327     #if defined(va_copy) || defined(HAVE_VA_COPY)
 328         #define wxVaCopy va_copy
 329     #else /* no va_copy, try to provide a replacement */
 330         /*
 331            configure tries to determine whether va_list is an array or struct
 332            type, but it may not be used under Windows, so deal with a few
 333            special cases.
 334          */
 335
 336         #ifdef __WATCOMC__
 337             /* Watcom uses array type for va_list except for PPC and Alpha */
 338             #if !defined(__PPC__) && !defined(__AXP__)
 339                 #define VA_LIST_IS_ARRAY
 340             #endif
 341         #endif /* __WATCOMC__ */
 342
 343         #if defined(__PPC__) && (defined(_CALL_SYSV) || defined (_WIN32))
 344             /*
 345                 PPC using SysV ABI and NT/PPC are special in that they use an
 346                 extra level of indirection.
 347              */
 348             #define VA_LIST_IS_POINTER
 349         #endif /* SysV or Win32 on __PPC__ */
 350
 351         /*
 352             note that we use memmove(), not memcpy(), in case anybody tries
 353             to do wxVaCopy(ap, ap)
 354          */
 355         #if defined(VA_LIST_IS_POINTER)
 356             #define wxVaCopy(d, s)  memmove(*(d), *(s), sizeof(va_list))
 357         #elif defined(VA_LIST_IS_ARRAY)
 358             #define wxVaCopy(d, s) memmove((d), (s), sizeof(va_list))
 359         #else /* we can only hope that va_lists are simple lvalues */
 360             #define wxVaCopy(d, s) ((d) = (s))
 361         #endif
 362     #endif /* va_copy/!va_copy */
 363 #endif /* wxVaCopy */
 364
 365
 366 /*  ---------------------------------------------------------------------------- */
 367 /*  portable calling conventions macros */
 368 /*  ---------------------------------------------------------------------------- */
 369
 370 /*  stdcall is used for all functions called by Windows under Windows */
 371 #if defined(__WINDOWS__)
 372     #if defined(__GNUWIN32__)
 373         #define wxSTDCALL __attribute__((stdcall))
 374     #else
 375         /*  both VC++ and Borland understand this */
 376         #define wxSTDCALL _stdcall
 377     #endif
 378
 379 #else /*  Win */
 380     /*  no such stupidness under Unix */
 381     #define wxSTDCALL
 382 #endif /*  platform */
 383
 384 /*  LINKAGEMODE mode is empty for everyting except OS/2 */
 385 #ifndef LINKAGEMODE
 386     #define LINKAGEMODE
 387 #endif /*  LINKAGEMODE */
 388
 389 /*  wxCALLBACK should be used for the functions which are called back by */
 390 /*  Windows (such as compare function for wxListCtrl) */
 391 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
 392     #define wxCALLBACK wxSTDCALL
 393 #else
 394     /*  no stdcall under Unix nor Win16 */
 395     #define wxCALLBACK
 396 #endif /*  platform */
 397
 398 /*  generic calling convention for the extern "C" functions */
 399
 400 #if defined(__VISUALC__)
 401   #define   wxC_CALLING_CONV    _cdecl
 402 #elif defined(__VISAGECPP__)
 403   #define   wxC_CALLING_CONV    _Optlink
 404 #else   /*  !Visual C++ */
 405   #define   wxC_CALLING_CONV
 406 #endif  /*  compiler */
 407
 408 /*  callling convention for the qsort(3) callback */
 409 #define wxCMPFUNC_CONV wxC_CALLING_CONV
 410
 411 /*  compatibility :-( */
 412 #define CMPFUNC_CONV wxCMPFUNC_CONV
 413
 414 /*  DLL import/export declarations */
 415 #include "wx/dlimpexp.h"
 416
 417 /*  ---------------------------------------------------------------------------- */
 418 /*  Very common macros */
 419 /*  ---------------------------------------------------------------------------- */
 420
 421 /*  Printf-like attribute definitions to obtain warnings with GNU C/C++ */
 422 #if defined(__GNUC__) && !wxUSE_UNICODE
 423 #  ifndef ATTRIBUTE_PRINTF
 424 #    define ATTRIBUTE_PRINTF(m, n) __attribute__ ((__format__ (__printf__, m, n)))
 425 #    define ATTRIBUTE_PRINTF_1 ATTRIBUTE_PRINTF(1, 2)
 426 #    define ATTRIBUTE_PRINTF_2 ATTRIBUTE_PRINTF(2, 3)
 427 #    define ATTRIBUTE_PRINTF_3 ATTRIBUTE_PRINTF(3, 4)
 428 #    define ATTRIBUTE_PRINTF_4 ATTRIBUTE_PRINTF(4, 5)
 429 #    define ATTRIBUTE_PRINTF_5 ATTRIBUTE_PRINTF(5, 6)
 430 #  endif /* ATTRIBUTE_PRINTF */
 431 #else
 432 #  ifndef ATTRIBUTE_PRINTF
 433 #    define ATTRIBUTE_PRINTF
 434 #    define ATTRIBUTE_PRINTF_1
 435 #    define ATTRIBUTE_PRINTF_2
 436 #    define ATTRIBUTE_PRINTF_3
 437 #    define ATTRIBUTE_PRINTF_4
 438 #    define ATTRIBUTE_PRINTF_5
 439 #  endif /* ATTRIBUTE_PRINTF */
 440 #endif
 441
 442 /*  Macro to issue warning when using deprecated functions with gcc3 or MSVC7: */
 443 #if wxCHECK_GCC_VERSION(3, 1)
 444     #define wxDEPRECATED(x) x __attribute__ ((deprecated))
 445 #elif defined(__VISUALC__) && (__VISUALC__ >= 1300)
 446     #define wxDEPRECATED(x) __declspec(deprecated) x
 447 #else
 448     #define wxDEPRECATED(x) x
 449 #endif
 450
 451 /*  everybody gets the assert and other debug macros */
 452 #include "wx/debug.h"
 453
 454 /*  NULL declaration: it must be defined as 0 for C++ programs (in particular, */
 455 /*  it must not be defined as "(void *)0" which is standard for C but completely */
 456 /*  breaks C++ code) */
 457 #ifndef __HANDHELDPC__
 458 #include <stddef.h>
 459 #endif
 460
 461 /*  delete pointer if it is not NULL and NULL it afterwards */
 462 /*  (checking that it's !NULL before passing it to delete is just a */
 463 /*   a question of style, because delete will do it itself anyhow, but it might */
 464 /*   be considered as an error by some overzealous debugging implementations of */
 465 /*   the library, so we do it ourselves) */
 466 #define wxDELETE(p)      if ( (p) != NULL ) { delete p; p = NULL; }
 467
 468 /*  delete an array and NULL it (see comments above) */
 469 #define wxDELETEA(p)     if ( (p) ) { delete [] (p); p = NULL; }
 470
 471 /*  size of statically declared array */
 472 #define WXSIZEOF(array)   (sizeof(array)/sizeof(array[0]))
 473
 474 /*  helper macros to concatenate two tokens together */
 475 #define wxCONCAT_HELPER(text, line) text ## line
 476 #define wxCONCAT(text, line)        wxCONCAT_HELPER(text, line)
 477
 478 /*  helper macros to be able to define unique/anonymous objects: this works by */
 479 /*  appending the current line number to the given identifier to reduce the */
 480 /*  probability of the conflict (it may still happen if this is used in the */
 481 /*  headers, hence you should avoid doing it or provide unique prefixes then) */
 482 #if defined(__VISUALC__) && (__VISUALC__ >= 1300)
 483     /*
 484        __LINE__ handling is completely broken in VC++ when using "Edit and
 485        Continue" (/ZI option) and results in preprocessor errors if we use it
 486        inside the macros. Luckily VC7 has another standard macro which can be
 487        used like this and is even better than __LINE__ because it is globally
 488        unique.
 489      */
 490 #   define wxCONCAT_LINE(text)         wxCONCAT(text, __COUNTER__)
 491 #else /* normal compilers */
 492 #   define wxCONCAT_LINE(text)         wxCONCAT(text, __LINE__)
 493 #endif
 494 #define wxMAKE_UNIQUE_NAME(text)    wxCONCAT_LINE(text)
 495
 496 /*  symbolic constant used by all Find()-like functions returning positive */
 497 /*  integer on success as failure indicator */
 498 #define wxNOT_FOUND       (-1)
 499
 500 /*  ---------------------------------------------------------------------------- */
 501 /*  macros to avoid compiler warnings */
 502 /*  ---------------------------------------------------------------------------- */
 503
 504 /*  Macro to cut down on compiler warnings. */
 505 #if 1 /*  there should be no more any compilers needing the "#else" version */
 506     #define WXUNUSED(identifier) /* identifier */
 507 #else  /*  stupid, broken compiler */
 508     #define WXUNUSED(identifier) identifier
 509 #endif
 510
 511 /*  some arguments are only used in debug mode, but unused in release one */
 512 #ifdef __WXDEBUG__
 513     #define WXUNUSED_UNLESS_DEBUG(param)  param
 514 #else
 515     #define WXUNUSED_UNLESS_DEBUG(param)  WXUNUSED(param)
 516 #endif
 517
 518 /*  some arguments are not used in unicode mode */
 519 #if wxUSE_UNICODE
 520     #define WXUNUSED_IN_UNICODE(param)  WXUNUSED(param)
 521 #else
 522     #define WXUNUSED_IN_UNICODE(param)  param
 523 #endif
 524
 525 /*  some arguments are not used in WinCE build */
 526 #ifdef __WXWINCE__
 527     #define WXUNUSED_IN_WINCE(param)  WXUNUSED(param)
 528 #else
 529     #define WXUNUSED_IN_WINCE(param)  param
 530 #endif
 531
 532 /*  some compilers give warning about a possibly unused variable if it is */
 533 /*  initialized in both branches of if/else and shut up if it is initialized */
 534 /*  when declared, but other compilers then give warnings about unused variable */
 535 /*  value -- this should satisfy both of them */
 536 #if defined(__VISUALC__)
 537     #define wxDUMMY_INITIALIZE(val) = val
 538 #else
 539     #define wxDUMMY_INITIALIZE(val)
 540 #endif
 541
 542 /*  sometimes the value of a variable is *really* not used, to suppress  the */
 543 /*  resulting warning you may pass it to this function */
 544 #ifdef __cplusplus
 545 #   ifdef __BORLANDC__
 546 #       define wxUnusedVar(identifier) identifier
 547 #   else
 548         template <class T>
 549             inline void wxUnusedVar(const T& WXUNUSED(t)) { }
 550 #   endif
 551 #endif
 552
 553 /*  ---------------------------------------------------------------------------- */
 554 /*  compiler specific settings */
 555 /*  ---------------------------------------------------------------------------- */
 556
 557 /*  to allow compiling with warning level 4 under Microsoft Visual C++ some */
 558 /*  warnings just must be disabled */
 559 #ifdef  __VISUALC__
 560   #pragma warning(disable: 4514) /*  unreferenced inline func has been removed */
 561 /*
 562   you might be tempted to disable this one also: triggered by CHECK and FAIL
 563   macros in debug.h, but it's, overall, a rather useful one, so I leave it and
 564   will try to find some way to disable this warning just for CHECK/FAIL. Anyone?
 565 */
 566   #pragma warning(disable: 4127) /*  conditional expression is constant */
 567 #endif  /*  VC++ */
 568
 569 #if defined(__MWERKS__)
 570     #undef try
 571     #undef except
 572     #undef finally
 573     #define except(x) catch(...)
 574 #endif /*  Metrowerks */
 575
 576 #if defined(__WATCOMC__) && (__WATCOMC__ < 1240)
 577     typedef short mode_t;
 578 #endif
 579
 580 /*  where should i put this? we need to make sure of this as it breaks */
 581 /*  the <iostream> code. */
 582 #if !wxUSE_IOSTREAMH && defined(__WXDEBUG__)
 583 #  ifndef __MWERKS__
 584 /*  #undef __WXDEBUG__ */
 585 #    ifdef wxUSE_DEBUG_NEW_ALWAYS
 586 #    undef wxUSE_DEBUG_NEW_ALWAYS
 587 #    define wxUSE_DEBUG_NEW_ALWAYS 0
 588 #    endif
 589 #  endif
 590 #endif
 591
 592 /*  ---------------------------------------------------------------------------- */
 593 /*  OS mnemonics -- Identify the running OS (useful for Windows) */
 594 /*  ---------------------------------------------------------------------------- */
 595
 596 /*  Not all platforms are currently available or supported */
 597 enum
 598 {
 599     wxUNKNOWN_PLATFORM,
 600     wxCURSES,                 /*  Text-only CURSES */
 601     wxXVIEW_X,                /*  Sun's XView OpenLOOK toolkit */
 602     wxMOTIF_X,                /*  OSF Motif 1.x.x */
 603     wxCOSE_X,                 /*  OSF Common Desktop Environment */
 604     wxNEXTSTEP,               /*  NeXTStep */
 605     wxMAC,                    /*  Apple Mac OS 8/9/X with Mac paths */
 606     wxMAC_DARWIN,             /*  Apple Mac OS X with Unix paths */
 607     wxBEOS,                   /*  BeOS */
 608     wxGTK,                    /*  GTK on X */
 609     wxGTK_WIN32,              /*  GTK on Win32 */
 610     wxGTK_OS2,                /*  GTK on OS/2 */
 611     wxGTK_BEOS,               /*  GTK on BeOS */
 612     wxGEOS,                   /*  GEOS */
 613     wxOS2_PM,                 /*  OS/2 Workplace */
 614     wxWINDOWS,                /*  Windows or WfW */
 615     wxMICROWINDOWS,           /*  MicroWindows */
 616     wxPENWINDOWS,             /*  Windows for Pen Computing */
 617     wxWINDOWS_NT,             /*  Windows NT */
 618     wxWIN32S,                 /*  Windows 32S API */
 619     wxWIN95,                  /*  Windows 95 */
 620     wxWIN386,                 /*  Watcom 32-bit supervisor modus */
 621     wxWINDOWS_CE,             /*  Windows CE (generic) */
 622     wxWINDOWS_POCKETPC,       /*  Windows CE PocketPC */
 623     wxWINDOWS_SMARTPHONE,     /*  Windows CE Smartphone */
 624     wxMGL_UNIX,               /*  MGL with direct hardware access */
 625     wxMGL_X,                  /*  MGL on X */
 626     wxMGL_WIN32,              /*  MGL on Win32 */
 627     wxMGL_OS2,                /*  MGL on OS/2 */
 628     wxMGL_DOS,                /*  MGL on MS-DOS */
 629     wxWINDOWS_OS2,            /*  Native OS/2 PM */
 630     wxUNIX,                   /*  wxBase under Unix */
 631     wxX11,                    /*  Plain X11 and Universal widgets */
 632     wxPALMOS,                 /*  PalmOS */
 633     wxDOS                     /*  wxBase under MS-DOS */
 634 };
 635
 636 /*  ---------------------------------------------------------------------------- */
 637 /*  standard wxWidgets types */
 638 /*  ---------------------------------------------------------------------------- */
 639
 640 /*  the type for screen and DC coordinates */
 641 typedef int wxCoord;
 642
 643 enum {  wxDefaultCoord = -1 };
 644
 645 /*  ---------------------------------------------------------------------------- */
 646 /*  define fixed length types */
 647 /*  ---------------------------------------------------------------------------- */
 648
 649 #if defined(__WXPALMOS__) || defined(__MINGW32__)
 650     #include <sys/types.h>
 651 #endif
 652
 653 /*  chars are always one byte (by definition), shorts are always two (in */
 654 /*  practice) */
 655
 656 /*  8bit */
 657 #ifndef SIZEOF_CHAR
 658     #define SIZEOF_CHAR 1
 659 #endif
 660 typedef signed char wxInt8;
 661 typedef unsigned char wxUint8;
 662 typedef wxUint8 wxByte;
 663
 664
 665 /*  16bit */
 666 #ifdef SIZEOF_SHORT
 667     #if SIZEOF_SHORT != 2
 668         #error "wxWidgets assumes sizeof(short) == 2, please fix the code"
 669     #endif
 670 #else
 671     #define SIZEOF_SHORT 2
 672 #endif
 673
 674 typedef signed short wxInt16;
 675 typedef unsigned short wxUint16;
 676
 677 typedef wxUint16 wxWord;
 678
 679 /*
 680   things are getting more interesting with ints, longs and pointers
 681
 682   there are several different standard data models described by this table:
 683
 684   +-----------+----------------------------+
 685   |type\model | LP64 ILP64 LLP64 ILP32 LP32|
 686   +-----------+----------------------------+
 687   |char       |  8     8     8     8     8 |
 688   |short      | 16    16    16    16    16 |
 689   |int        | 32    64    32    32    16 |
 690   |long       | 64    64    32    32    32 |
 691   |long long  |             64             |
 692   |void *     | 64    64    64    32    32 |
 693   +-----------+----------------------------+
 694
 695   Win16 used LP32 (but we don't support it any longer), Win32 obviously used
 696   ILP32 and Win64 uses LLP64 (a.k.a. P64)
 697
 698   Under Unix LP64 is the most widely used (the only I've ever seen, in fact)
 699  */
 700
 701 /*  32bit */
 702 #ifdef __PALMOS__
 703     typedef int wxInt32;
 704     typedef unsigned int wxUint32;
 705     #define SIZEOF_INT 4
 706     #define SIZEOF_LONG 4
 707     #define SIZEOF_WCHAR_T 2
 708     #define SIZEOF_SIZE_T 4
 709     #define wxSIZE_T_IS_UINT
 710     #define SIZEOF_VOID_P 4
 711     #define SIZEOF_SIZE_T 4
 712 #elif defined(__WINDOWS__)
 713     /*  Win64 uses LLP64 model and so ints and longs have the same size as in */
 714     /*  Win32 */
 715     #if defined(__WIN32__)
 716         typedef int wxInt32;
 717         typedef unsigned int wxUint32;
 718
 719         /* Assume that if SIZEOF_INT is defined that all the other ones except
 720            SIZEOF_SIZE_T, are too.  See next #if below.  */
 721         #ifndef SIZEOF_INT
 722             #define SIZEOF_INT 4
 723             #define SIZEOF_LONG 4
 724             #define SIZEOF_WCHAR_T 2
 725
 726             /*
 727                under Win64 sizeof(size_t) == 8 and so it is neither unsigned
 728                int nor unsigned long!
 729              */
 730             #ifdef __WIN64__
 731                 #define SIZEOF_SIZE_T 8
 732
 733                 #undef wxSIZE_T_IS_UINT
 734             #else /* Win32 */
 735                 #define SIZEOF_SIZE_T 4
 736
 737                 #define wxSIZE_T_IS_UINT
 738             #endif
 739             #undef wxSIZE_T_IS_ULONG
 740
 741             #ifdef __WIN64__
 742                 #define SIZEOF_VOID_P 8
 743             #else /*  Win32 */
 744                 #define SIZEOF_VOID_P 4
 745             #endif /*  Win64/32 */
 746         #endif /*  !defined(SIZEOF_INT) */
 747
 748         /*
 749           If Python.h was included first, it defines all of the SIZEOF's above
 750           except for SIZEOF_SIZE_T, so we need to do it here to avoid
 751           triggering the #error in the ssize_t typedefs below...
 752         */
 753         #ifndef SIZEOF_SIZE_T
 754             #ifdef __WIN64__
 755                 #define SIZEOF_SIZE_T 8
 756             #else /* Win32 */
 757                 #define SIZEOF_SIZE_T 4
 758             #endif
 759         #endif
 760     #else
 761         #error "Unsupported Windows version"
 762     #endif
 763 #else /*  !Windows */
 764     /*  SIZEOF_XXX are normally defined by configure */
 765     #ifdef SIZEOF_INT
 766         #if SIZEOF_INT == 8
 767             /*  must be ILP64 data model, there is normally a special 32 bit */
 768             /*  type in it but we don't know what it is... */
 769             #error "No 32bit int type on this platform"
 770         #elif SIZEOF_INT == 4
 771             typedef int wxInt32;
 772             typedef unsigned int wxUint32;
 773         #elif SIZEOF_INT == 2
 774             /*  must be LP32 */
 775             #if SIZEOF_LONG != 4
 776                 #error "No 32bit int type on this platform"
 777             #endif
 778
 779             typedef long wxInt32;
 780             typedef unsigned long wxUint32;
 781         #else
 782             /*  wxWidgets is not ready for 128bit systems yet... */
 783             #error "Unknown sizeof(int) value, what are you compiling for?"
 784         #endif
 785     #else /*  !defined(SIZEOF_INT) */
 786         /*  assume default 32bit machine -- what else can we do? */
 787         wxCOMPILE_TIME_ASSERT( sizeof(int) == 4, IntMustBeExactly4Bytes);
 788         wxCOMPILE_TIME_ASSERT( sizeof(size_t) == 4, SizeTMustBeExactly4Bytes);
 789         wxCOMPILE_TIME_ASSERT( sizeof(void *) == 4, PtrMustBeExactly4Bytes);
 790
 791         #define SIZEOF_INT 4
 792         #define SIZEOF_SIZE_T 4
 793         #define SIZEOF_VOID_P 4
 794
 795         typedef int wxInt32;
 796         typedef unsigned int wxUint32;
 797
 798         #if defined(__MACH__) && !defined(SIZEOF_WCHAR_T)
 799             #define SIZEOF_WCHAR_T 4
 800         #endif
 801         #if wxUSE_WCHAR_T && !defined(SIZEOF_WCHAR_T)
 802             /*  also assume that sizeof(wchar_t) == 2 (under Unix the most */
 803             /*  common case is 4 but there configure would have defined */
 804             /*  SIZEOF_WCHAR_T for us) */
 805             /*  the most common case */
 806             wxCOMPILE_TIME_ASSERT( sizeof(wchar_t) == 2,
 807                                     Wchar_tMustBeExactly2Bytes);
 808
 809             #define SIZEOF_WCHAR_T 2
 810         #endif /*  wxUSE_WCHAR_T */
 811     #endif
 812 #endif /*  Win/!Win */
 813
 814 typedef wxUint32 wxDword;
 815
 816 /*
 817    Define an integral type big enough to contain all of long, size_t and void *.
 818  */
 819 #if SIZEOF_LONG >= SIZEOF_VOID_P && SIZEOF_LONG >= SIZEOF_SIZE_T
 820     /* normal case */
 821     typedef unsigned long wxUIntPtr;
 822 #elif SIZEOF_SIZE_T >= SIZEOF_VOID_P
 823     /* Win64 case */
 824     typedef size_t wxUIntPtr;
 825 #else
 826     /*
 827        This should never happen for the current architectures but if you're
 828        using one where it does, please contact wx-dev@lists.wxwidgets.org.
 829      */
 830     #error "Pointers can't be stored inside integer types."
 831 #endif
 832
 833 #ifdef __cplusplus
 834 /* And also define a couple of simple functions to cast pointer to/from it. */
 835 inline wxUIntPtr wxPtrToUInt(const void *p)
 836 {
 837     /*
 838        VC++ 7.1 gives warnings about casts such as below even when they're
 839        explicit with /Wp64 option, suppress them as we really know what we're
 840        doing here
 841      */
 842 #ifdef __VISUALC__
 843     #pragma warning(disable: 4311) /* pointer truncation from '' to '' */
 844 #endif
 845
 846     return wx_reinterpret_cast(wxUIntPtr, p);
 847
 848 #ifdef __VISUALC__
 849     #pragma warning(default: 4311)
 850 #endif
 851 }
 852
 853 inline void *wxUIntToPtr(wxUIntPtr p)
 854 {
 855 #ifdef __VISUALC__
 856     #pragma warning(disable: 4312) /* conversion to type of greater size */
 857 #endif
 858
 859     return wx_reinterpret_cast(void *, p);
 860
 861 #ifdef __VISUALC__
 862     #pragma warning(default: 4312)
 863 #endif
 864 }
 865 #endif /*__cplusplus*/
 866
 867
 868 /*  64 bit */
 869
 870 /*  NB: we #define and not typedef wxLongLong_t because we use "#ifdef */
 871 /*      wxLongLong_t" in wx/longlong.h */
 872
 873 /*      wxULongLong_t is set later (usually to unsigned wxLongLong_t) */
 874
 875 /*  to avoid compilation problems on 64bit machines with ambiguous method calls */
 876 /*  we will need to define this */
 877 #undef wxLongLongIsLong
 878
 879 /*  first check for generic cases which are long on 64bit machine and "long */
 880 /*  long", then check for specific compilers */
 881 #if defined(SIZEOF_LONG) && (SIZEOF_LONG == 8)
 882     #define wxLongLong_t long
 883     #define wxLongLongSuffix l
 884     #define wxLongLongFmtSpec _T("l")
 885     #define wxLongLongIsLong
 886 #elif defined(__WXPALMOS__)
 887     #define wxLongLong_t int64_t
 888     #define wxLongLongSuffix ll
 889     #define wxLongLongFmtSpec _T("ll")
 890 #elif (defined(__VISUALC__) && defined(__WIN32__))
 891     #define wxLongLong_t __int64
 892     #define wxLongLongSuffix i64
 893     #define wxLongLongFmtSpec _T("I64")
 894 #elif defined(__BORLANDC__) && defined(__WIN32__) && (__BORLANDC__ >= 0x520)
 895     #define wxLongLong_t __int64
 896     #define wxLongLongSuffix i64
 897     #define wxLongLongFmtSpec _T("L")
 898 #elif (defined(__WATCOMC__) && (defined(__WIN32__) || defined(__DOS__) || defined(__OS2__)))
 899       #define wxLongLong_t __int64
 900       #define wxLongLongSuffix i64
 901       #define wxLongLongFmtSpec _T("L")
 902 #elif defined(__DIGITALMARS__)
 903       #define wxLongLong_t __int64
 904       #define wxLongLongSuffix LL
 905       #define wxLongLongFmtSpec _T("ll")
 906 #elif defined(__MINGW32__)
 907     #define wxLongLong_t long long
 908     #define wxLongLongSuffix ll
 909     #define wxLongLongFmtSpec _T("I64")
 910 #elif (defined(SIZEOF_LONG_LONG) && SIZEOF_LONG_LONG >= 8)  || \
 911         defined(__GNUC__) || \
 912         defined(__CYGWIN__) || \
 913         defined(__WXMICROWIN__) || \
 914         (defined(__DJGPP__) && __DJGPP__ >= 2)
 915     #define wxLongLong_t long long
 916     #define wxLongLongSuffix ll
 917     #define wxLongLongFmtSpec _T("ll")
 918 #elif defined(__MWERKS__)
 919     #if __option(longlong)
 920         #define wxLongLong_t long long
 921         #define wxLongLongSuffix ll
 922         #define wxLongLongFmtSpec _T("ll")
 923     #else
 924         #error "The 64 bit integer support in CodeWarrior has been disabled."
 925         #error "See the documentation on the 'longlong' pragma."
 926     #endif
 927 #elif defined(__VISAGECPP__) && __IBMCPP__ >= 400
 928     #define wxLongLong_t long long
 929 #endif
 930
 931
 932 #ifdef wxLongLong_t
 933
 934     #ifdef __WXPALMOS__
 935         #define wxULongLong_t uint64_t
 936     #else
 937         #define wxULongLong_t unsigned wxLongLong_t
 938     #endif
 939
 940     /*  these macros allow to definea 64 bit constants in a portable way */
 941     #define wxLL(x) wxCONCAT(x, wxLongLongSuffix)
 942     #define wxULL(x) wxCONCAT(x, wxCONCAT(u, wxLongLongSuffix))
 943
 944     typedef wxLongLong_t wxInt64;
 945     typedef wxULongLong_t wxUint64;
 946 #endif
 947
 948
 949 /* Make sure ssize_t is defined (a signed type the same size as size_t) */
 950 /* HAVE_SSIZE_T should be defined for compiliers that already have it */
 951 #ifdef __MINGW32__
 952     #if defined(_SSIZE_T_) && !defined(HAVE_SSIZE_T)
 953         #define HAVE_SSIZE_T
 954     #endif
 955 #endif
 956 #if defined(__PALMOS__) && !defined(HAVE_SSIZE_T)
 957     #define HAVE_SSIZE_T
 958 #endif
 959 #if defined(__WATCOMC__) && __WATCOMC__ > 1230
 960     #define HAVE_SSIZE_T
 961 #endif
 962 #ifndef HAVE_SSIZE_T
 963     #if SIZEOF_SIZE_T == 4
 964         typedef wxInt32 ssize_t;
 965     #elif SIZEOF_SIZE_T == 8
 966         typedef wxInt64 ssize_t;
 967     #else
 968         #error "error defining ssize_t, size_t is not 4 or 8 bytes"
 969     #endif
 970 #endif
 971
 972
 973 /*  base floating point types */
 974 /*  wxFloat32: 32 bit IEEE float ( 1 sign, 8 exponent bits, 23 fraction bits */
 975 /*  wxFloat64: 64 bit IEEE float ( 1 sign, 11 exponent bits, 52 fraction bits */
 976 /*  wxDouble: native fastest representation that has at least wxFloat64 */
 977 /*            precision, so use the IEEE types for storage, and this for */
 978 /*            calculations */
 979
 980 typedef float wxFloat32;
 981 #if (defined( __WXMAC__ ) || defined(__WXCOCOA__))  && defined (__MWERKS__)
 982     typedef short double wxFloat64;
 983 #else
 984     typedef double wxFloat64;
 985 #endif
 986
 987 #if defined( __WXMAC__ )  && !defined( __POWERPC__ )
 988     typedef long double wxDouble;
 989 #else
 990     typedef double wxDouble;
 991 #endif
 992
 993 /*
 994     Some (non standard) compilers typedef wchar_t as an existing type instead
 995     of treating it as a real fundamental type, set wxWCHAR_T_IS_REAL_TYPE to 0
 996     for them and to 1 for all the others.
 997  */
 998 #if wxUSE_WCHAR_T
 999     /*
1000         VC++ typedefs wchar_t as unsigned short by default, that is unless
1001         /Za or /Zc:wchar_t option is used in which case _WCHAR_T_DEFINED is
1002         defined.
1003      */
1004 #   if defined(__VISUALC__) && !defined(_NATIVE_WCHAR_T_DEFINED)
1005 #       define wxWCHAR_T_IS_REAL_TYPE 0
1006 #   else /* compiler having standard-conforming wchar_t */
1007 #       define wxWCHAR_T_IS_REAL_TYPE 1
1008 #   endif
1009 #endif /* wxUSE_WCHAR_T */
1010
1011 /*  ---------------------------------------------------------------------------- */
1012 /*  byte ordering related definition and macros */
1013 /*  ---------------------------------------------------------------------------- */
1014
1015 /*  byte sex */
1016
1017 #define  wxBIG_ENDIAN     4321
1018 #define  wxLITTLE_ENDIAN  1234
1019 #define  wxPDP_ENDIAN     3412
1020
1021 #ifdef WORDS_BIGENDIAN
1022 #define  wxBYTE_ORDER  wxBIG_ENDIAN
1023 #else
1024 #define  wxBYTE_ORDER  wxLITTLE_ENDIAN
1025 #endif
1026
1027 /*  byte swapping */
1028
1029 #if defined (__MWERKS__) && ( (__MWERKS__ < 0x0900) || macintosh )
1030 /*  assembler versions for these */
1031 #ifdef __POWERPC__
1032     inline wxUint16 wxUINT16_SWAP_ALWAYS( wxUint16 i )
1033         {return (__lhbrx( &i , 0 ) );}
1034     inline wxInt16 wxINT16_SWAP_ALWAYS( wxInt16 i )
1035         {return (__lhbrx( &i , 0 ) );}
1036     inline wxUint32 wxUINT32_SWAP_ALWAYS( wxUint32 i )
1037         {return (__lwbrx( &i , 0 ) );}
1038     inline wxInt32 wxINT32_SWAP_ALWAYS( wxInt32 i )
1039         {return (__lwbrx( &i , 0 ) );}
1040 #else
1041     #pragma parameter __D0 wxUINT16_SWAP_ALWAYS(__D0)
1042     pascal wxUint16 wxUINT16_SWAP_ALWAYS(wxUint16 value)
1043         = { 0xE158 };
1044
1045     #pragma parameter __D0 wxINT16_SWAP_ALWAYS(__D0)
1046     pascal wxInt16 wxINT16_SWAP_ALWAYS(wxInt16 value)
1047         = { 0xE158 };
1048
1049     #pragma parameter __D0 wxUINT32_SWAP_ALWAYS (__D0)
1050     pascal wxUint32 wxUINT32_SWAP_ALWAYS(wxUint32 value)
1051         = { 0xE158, 0x4840, 0xE158 };
1052
1053     #pragma parameter __D0 wxINT32_SWAP_ALWAYS (__D0)
1054     pascal wxInt32 wxINT32_SWAP_ALWAYS(wxInt32 value)
1055         = { 0xE158, 0x4840, 0xE158 };
1056
1057 #endif
1058 #else /*  !MWERKS */
1059 #define wxUINT16_SWAP_ALWAYS(val) \
1060    ((wxUint16) ( \
1061     (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
1062     (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
1063
1064 #define wxINT16_SWAP_ALWAYS(val) \
1065    ((wxInt16) ( \
1066     (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
1067     (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
1068
1069 #define wxUINT32_SWAP_ALWAYS(val) \
1070    ((wxUint32) ( \
1071     (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1072     (((wxUint32) (val) & (wxUint32) 0x0000ff00U) <<  8) | \
1073     (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >>  8) | \
1074     (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
1075
1076 #define wxINT32_SWAP_ALWAYS(val) \
1077    ((wxInt32) ( \
1078     (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1079     (((wxUint32) (val) & (wxUint32) 0x0000ff00U) <<  8) | \
1080     (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >>  8) | \
1081     (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
1082 #endif
1083 /*  machine specific byte swapping */
1084
1085 #ifdef wxLongLong_t
1086     #define wxUINT64_SWAP_ALWAYS(val) \
1087        ((wxUint64) ( \
1088         (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1089         (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1090         (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1091         (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) <<  8) | \
1092         (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >>  8) | \
1093         (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1094         (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1095         (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
1096
1097     #define wxINT64_SWAP_ALWAYS(val) \
1098        ((wxInt64) ( \
1099         (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1100         (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1101         (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1102         (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) <<  8) | \
1103         (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >>  8) | \
1104         (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1105         (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1106         (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
1107 #else /*  !wxLongLong_t */
1108     #define wxUINT64_SWAP_ALWAYS(val) \
1109        ((wxUint64) ( \
1110         ((wxULongLong(val) & wxULongLong(0L, 0x000000ffU)) << 56) | \
1111         ((wxULongLong(val) & wxULongLong(0L, 0x0000ff00U)) << 40) | \
1112         ((wxULongLong(val) & wxULongLong(0L, 0x00ff0000U)) << 24) | \
1113         ((wxULongLong(val) & wxULongLong(0L, 0xff000000U)) <<  8) | \
1114         ((wxULongLong(val) & wxULongLong(0x000000ffL, 0U)) >>  8) | \
1115         ((wxULongLong(val) & wxULongLong(0x0000ff00L, 0U)) >> 24) | \
1116         ((wxULongLong(val) & wxULongLong(0x00ff0000L, 0U)) >> 40) | \
1117         ((wxULongLong(val) & wxULongLong(0xff000000L, 0U)) >> 56)))
1118
1119     #define wxINT64_SWAP_ALWAYS(val) \
1120        ((wxInt64) ( \
1121         ((wxLongLong(val) & wxLongLong(0L, 0x000000ffU)) << 56) | \
1122         ((wxLongLong(val) & wxLongLong(0L, 0x0000ff00U)) << 40) | \
1123         ((wxLongLong(val) & wxLongLong(0L, 0x00ff0000U)) << 24) | \
1124         ((wxLongLong(val) & wxLongLong(0L, 0xff000000U)) <<  8) | \
1125         ((wxLongLong(val) & wxLongLong(0x000000ffL, 0U)) >>  8) | \
1126         ((wxLongLong(val) & wxLongLong(0x0000ff00L, 0U)) >> 24) | \
1127         ((wxLongLong(val) & wxLongLong(0x00ff0000L, 0U)) >> 40) | \
1128         ((wxLongLong(val) & wxLongLong(0xff000000L, 0U)) >> 56)))
1129 #endif /*  wxLongLong_t/!wxLongLong_t */
1130
1131 #ifdef WORDS_BIGENDIAN
1132     #define wxUINT16_SWAP_ON_BE(val)  wxUINT16_SWAP_ALWAYS(val)
1133     #define wxINT16_SWAP_ON_BE(val)   wxINT16_SWAP_ALWAYS(val)
1134     #define wxUINT16_SWAP_ON_LE(val)  (val)
1135     #define wxINT16_SWAP_ON_LE(val)   (val)
1136     #define wxUINT32_SWAP_ON_BE(val)  wxUINT32_SWAP_ALWAYS(val)
1137     #define wxINT32_SWAP_ON_BE(val)   wxINT32_SWAP_ALWAYS(val)
1138     #define wxUINT32_SWAP_ON_LE(val)  (val)
1139     #define wxINT32_SWAP_ON_LE(val)   (val)
1140     #define wxUINT64_SWAP_ON_BE(val)  wxUINT64_SWAP_ALWAYS(val)
1141     #define wxUINT64_SWAP_ON_LE(val)  (val)
1142 #else
1143     #define wxUINT16_SWAP_ON_LE(val)  wxUINT16_SWAP_ALWAYS(val)
1144     #define wxINT16_SWAP_ON_LE(val)   wxINT16_SWAP_ALWAYS(val)
1145     #define wxUINT16_SWAP_ON_BE(val)  (val)
1146     #define wxINT16_SWAP_ON_BE(val)   (val)
1147     #define wxUINT32_SWAP_ON_LE(val)  wxUINT32_SWAP_ALWAYS(val)
1148     #define wxINT32_SWAP_ON_LE(val)   wxINT32_SWAP_ALWAYS(val)
1149     #define wxUINT32_SWAP_ON_BE(val)  (val)
1150     #define wxINT32_SWAP_ON_BE(val)   (val)
1151     #define wxUINT64_SWAP_ON_LE(val)  wxUINT64_SWAP_ALWAYS(val)
1152     #define wxUINT64_SWAP_ON_BE(val)  (val)
1153 #endif
1154
1155 /*  ---------------------------------------------------------------------------- */
1156 /*  Geometric flags */
1157 /*  ---------------------------------------------------------------------------- */
1158
1159 enum wxGeometryCentre
1160 {
1161     wxCENTRE                  = 0x0001,
1162     wxCENTER                  = wxCENTRE
1163 };
1164
1165 /*  centering into frame rather than screen (obsolete) */
1166 #define wxCENTER_FRAME          0x0000
1167 /*  centre on screen rather than parent */
1168 #define wxCENTRE_ON_SCREEN      0x0002
1169 #define wxCENTER_ON_SCREEN      wxCENTRE_ON_SCREEN
1170
1171 enum wxOrientation
1172 {
1173     /* don't change the values of these elements, they are used elsewhere */
1174     wxHORIZONTAL              = 0x0004,
1175     wxVERTICAL                = 0x0008,
1176
1177     wxBOTH                    = wxVERTICAL | wxHORIZONTAL
1178 };
1179
1180 enum wxDirection
1181 {
1182     wxLEFT                    = 0x0010,
1183     wxRIGHT                   = 0x0020,
1184     wxUP                      = 0x0040,
1185     wxDOWN                    = 0x0080,
1186
1187     wxTOP                     = wxUP,
1188     wxBOTTOM                  = wxDOWN,
1189
1190     wxNORTH                   = wxUP,
1191     wxSOUTH                   = wxDOWN,
1192     wxWEST                    = wxLEFT,
1193     wxEAST                    = wxRIGHT,
1194
1195     wxALL                     = (wxUP | wxDOWN | wxRIGHT | wxLEFT)
1196 };
1197
1198 enum wxAlignment
1199 {
1200     wxALIGN_NOT               = 0x0000,
1201     wxALIGN_CENTER_HORIZONTAL = 0x0100,
1202     wxALIGN_CENTRE_HORIZONTAL = wxALIGN_CENTER_HORIZONTAL,
1203     wxALIGN_LEFT              = wxALIGN_NOT,
1204     wxALIGN_TOP               = wxALIGN_NOT,
1205     wxALIGN_RIGHT             = 0x0200,
1206     wxALIGN_BOTTOM            = 0x0400,
1207     wxALIGN_CENTER_VERTICAL   = 0x0800,
1208     wxALIGN_CENTRE_VERTICAL   = wxALIGN_CENTER_VERTICAL,
1209
1210     wxALIGN_CENTER            = (wxALIGN_CENTER_HORIZONTAL | wxALIGN_CENTER_VERTICAL),
1211     wxALIGN_CENTRE            = wxALIGN_CENTER,
1212
1213     /*  a mask to extract alignment from the combination of flags */
1214     wxALIGN_MASK              = 0x0f00
1215 };
1216
1217 enum wxStretch
1218 {
1219     wxSTRETCH_NOT             = 0x0000,
1220     wxSHRINK                  = 0x1000,
1221     wxGROW                    = 0x2000,
1222     wxEXPAND                  = wxGROW,
1223     wxSHAPED                  = 0x4000,
1224     wxFIXED_MINSIZE           = 0x8000,
1225     wxTILE                    = 0xc000,
1226
1227     /* for compatibility only, default now, don't use explicitly any more */
1228 #if WXWIN_COMPATIBILITY_2_4
1229     wxADJUST_MINSIZE          = 0x00100000
1230 #else
1231     wxADJUST_MINSIZE          = 0
1232 #endif
1233 };
1234
1235 /*  border flags: the values are chosen for backwards compatibility */
1236 enum wxBorder
1237 {
1238     /*  this is different from wxBORDER_NONE as by default the controls do have */
1239     /*  border */
1240     wxBORDER_DEFAULT = 0,
1241
1242     wxBORDER_NONE   = 0x00200000,
1243     wxBORDER_STATIC = 0x01000000,
1244     wxBORDER_SIMPLE = 0x02000000,
1245     wxBORDER_RAISED = 0x04000000,
1246     wxBORDER_SUNKEN = 0x08000000,
1247     wxBORDER_DOUBLE = 0x10000000,
1248
1249     /*  a mask to extract border style from the combination of flags */
1250     wxBORDER_MASK   = 0x1f200000
1251 };
1252
1253 /* This makes it easier to specify a 'normal' border for a control */
1254 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
1255 #define wxDEFAULT_CONTROL_BORDER    wxBORDER_SIMPLE
1256 #else
1257 #define wxDEFAULT_CONTROL_BORDER    wxBORDER_SUNKEN
1258 #endif
1259
1260 /*  ---------------------------------------------------------------------------- */
1261 /*  Window style flags */
1262 /*  ---------------------------------------------------------------------------- */
1263
1264 /*
1265  * Values are chosen so they can be |'ed in a bit list.
1266  * Some styles are used across more than one group,
1267  * so the values mustn't clash with others in the group.
1268  * Otherwise, numbers can be reused across groups.
1269  *
1270  * From version 1.66:
1271  * Window (cross-group) styles now take up the first half
1272  * of the flag, and control-specific styles the
1273  * second half.
1274  *
1275  */
1276
1277 /*
1278  * Window (Frame/dialog/subwindow/panel item) style flags
1279  */
1280 #define wxVSCROLL               0x80000000
1281 #define wxHSCROLL               0x40000000
1282 #define wxCAPTION               0x20000000
1283
1284 /*  New styles (border styles are now in their own enum) */
1285 #define wxDOUBLE_BORDER         wxBORDER_DOUBLE
1286 #define wxSUNKEN_BORDER         wxBORDER_SUNKEN
1287 #define wxRAISED_BORDER         wxBORDER_RAISED
1288 #define wxBORDER                wxBORDER_SIMPLE
1289 #define wxSIMPLE_BORDER         wxBORDER_SIMPLE
1290 #define wxSTATIC_BORDER         wxBORDER_STATIC
1291 #define wxNO_BORDER             wxBORDER_NONE
1292
1293 /*  wxALWAYS_SHOW_SB: instead of hiding the scrollbar when it is not needed, */
1294 /*  disable it - but still show (see also wxLB_ALWAYS_SB style) */
1295 /*  */
1296 /*  NB: as this style is only supported by wxUniversal and wxMSW so far */
1297 #define wxALWAYS_SHOW_SB        0x00800000
1298
1299 /*  Clip children when painting, which reduces flicker in e.g. frames and */
1300 /*  splitter windows, but can't be used in a panel where a static box must be */
1301 /*  'transparent' (panel paints the background for it) */
1302 #define wxCLIP_CHILDREN         0x00400000
1303
1304 /*  Note we're reusing the wxCAPTION style because we won't need captions */
1305 /*  for subwindows/controls */
1306 #define wxCLIP_SIBLINGS         0x20000000
1307
1308 #define wxTRANSPARENT_WINDOW    0x00100000
1309
1310 /*  Add this style to a panel to get tab traversal working outside of dialogs */
1311 /*  (on by default for wxPanel, wxDialog, wxScrolledWindow) */
1312 #define wxTAB_TRAVERSAL         0x00080000
1313
1314 /*  Add this style if the control wants to get all keyboard messages (under */
1315 /*  Windows, it won't normally get the dialog navigation key events) */
1316 #define wxWANTS_CHARS           0x00040000
1317
1318 /*  Make window retained (Motif only, see src/generic/scrolwing.cpp)
1319  *  This is non-zero only under wxMotif, to avoid a clash with wxPOPUP_WINDOW
1320  *  on other platforms
1321  */
1322
1323 #ifdef __WXMOTIF__
1324 #define wxRETAINED              0x00020000
1325 #else
1326 #define wxRETAINED              0x00000000
1327 #endif
1328 #define wxBACKINGSTORE          wxRETAINED
1329
1330 /*  set this flag to create a special popup window: it will be always shown on */
1331 /*  top of other windows, will capture the mouse and will be dismissed when the */
1332 /*  mouse is clicked outside of it or if it loses focus in any other way */
1333 #define wxPOPUP_WINDOW          0x00020000
1334
1335 /*  force a full repaint when the window is resized (instead of repainting just */
1336 /*  the invalidated area) */
1337 #define wxFULL_REPAINT_ON_RESIZE 0x00010000
1338
1339 /*  obsolete: now this is the default behaviour */
1340 /*  */
1341 /*  don't invalidate the whole window (resulting in a PAINT event) when the */
1342 /*  window is resized (currently, makes sense for wxMSW only) */
1343 #define wxNO_FULL_REPAINT_ON_RESIZE 0
1344
1345 /*
1346  * Extra window style flags (use wxWS_EX prefix to make it clear that they
1347  * should be passed to wxWindow::SetExtraStyle(), not SetWindowStyle())
1348  */
1349
1350 /*  by default, TransferDataTo/FromWindow() only work on direct children of the */
1351 /*  window (compatible behaviour), set this flag to make them recursively */
1352 /*  descend into all subwindows */
1353 #define wxWS_EX_VALIDATE_RECURSIVELY    0x00000001
1354
1355 /*  wxCommandEvents and the objects of the derived classes are forwarded to the */
1356 /*  parent window and so on recursively by default. Using this flag for the */
1357 /*  given window allows to block this propagation at this window, i.e. prevent */
1358 /*  the events from being propagated further upwards. The dialogs have this */
1359 /*  flag on by default. */
1360 #define wxWS_EX_BLOCK_EVENTS            0x00000002
1361
1362 /*  don't use this window as an implicit parent for the other windows: this must */
1363 /*  be used with transient windows as otherwise there is the risk of creating a */
1364 /*  dialog/frame with this window as a parent which would lead to a crash if the */
1365 /*  parent is destroyed before the child */
1366 #define wxWS_EX_TRANSIENT               0x00000004
1367
1368 /*  don't paint the window background, we'll assume it will */
1369 /*  be done by a theming engine. This is not yet used but could */
1370 /*  possibly be made to work in the future, at least on Windows */
1371 #define wxWS_EX_THEMED_BACKGROUND       0x00000008
1372
1373 /*  this window should always process idle events */
1374 #define wxWS_EX_PROCESS_IDLE            0x00000010
1375
1376 /*  this window should always process UI update events */
1377 #define wxWS_EX_PROCESS_UI_UPDATES      0x00000020
1378
1379 /*  Use this style to add a context-sensitive help to the window (currently for */
1380 /*  Win32 only and it doesn't work if wxMINIMIZE_BOX or wxMAXIMIZE_BOX are used) */
1381 #define wxFRAME_EX_CONTEXTHELP  0x00000004
1382 #define wxDIALOG_EX_CONTEXTHELP 0x00000004
1383
1384 /*  Draw the window in a metal theme on Mac */
1385 #define wxFRAME_EX_METAL                0x00000040
1386 #define wxDIALOG_EX_METAL               0x00000040
1387
1388 /*  Create a window which is attachable to another top level window */
1389 #define wxFRAME_DRAWER          0x0020
1390
1391 /*
1392  * MDI parent frame style flags
1393  * Can overlap with some of the above.
1394  */
1395
1396 #define wxFRAME_NO_WINDOW_MENU  0x0100
1397
1398 /*
1399  * wxMenuBar style flags
1400  */
1401 /*  use native docking */
1402 #define wxMB_DOCKABLE       0x0001
1403
1404 /*
1405  * wxMenu style flags
1406  */
1407 #define wxMENU_TEAROFF      0x0001
1408
1409 /*
1410  * Apply to all panel items
1411  */
1412 #define wxCOLOURED          0x0800
1413 #define wxFIXED_LENGTH      0x0400
1414
1415 /*
1416  * Styles for wxListBox
1417  */
1418 #define wxLB_SORT           0x0010
1419 #define wxLB_SINGLE         0x0020
1420 #define wxLB_MULTIPLE       0x0040
1421 #define wxLB_EXTENDED       0x0080
1422 /*  wxLB_OWNERDRAW is Windows-only */
1423 #define wxLB_OWNERDRAW      0x0100
1424 #define wxLB_NEEDED_SB      0x0200
1425 #define wxLB_ALWAYS_SB      0x0400
1426 #define wxLB_HSCROLL        wxHSCROLL
1427 /*  always show an entire number of rows */
1428 #define wxLB_INT_HEIGHT     0x0800
1429
1430 /*  deprecated synonyms */
1431 #define wxPROCESS_ENTER     0x0400  /*  wxTE_PROCESS_ENTER */
1432 #define wxPASSWORD          0x0800  /*  wxTE_PASSWORD */
1433
1434 /*
1435  * wxComboBox style flags
1436  */
1437 #define wxCB_SIMPLE         0x0004
1438 #define wxCB_SORT           0x0008
1439 #define wxCB_READONLY       0x0010
1440 #define wxCB_DROPDOWN       0x0020
1441
1442 /*
1443  * wxRadioBox style flags
1444  */
1445 /*  should we number the items from left to right or from top to bottom in a 2d */
1446 /*  radiobox? */
1447 #define wxRA_LEFTTORIGHT    0x0001
1448 #define wxRA_TOPTOBOTTOM    0x0002
1449
1450 /*  New, more intuitive names to specify majorDim argument */
1451 #define wxRA_SPECIFY_COLS   wxHORIZONTAL
1452 #define wxRA_SPECIFY_ROWS   wxVERTICAL
1453
1454 /*  Old names for compatibility */
1455 #define wxRA_HORIZONTAL     wxHORIZONTAL
1456 #define wxRA_VERTICAL       wxVERTICAL
1457 #define wxRA_USE_CHECKBOX   0x0010 /* alternative native subcontrols (wxPalmOS) */
1458
1459 /*
1460  * wxRadioButton style flag
1461  */
1462 #define wxRB_GROUP          0x0004
1463 #define wxRB_SINGLE         0x0008
1464 #define wxRB_USE_CHECKBOX   0x0010 /* alternative native control (wxPalmOS) */
1465
1466 /*
1467  * wxScrollBar flags
1468  */
1469 #define wxSB_HORIZONTAL      wxHORIZONTAL
1470 #define wxSB_VERTICAL        wxVERTICAL
1471
1472 /*
1473  * wxSpinButton flags.
1474  * Note that a wxSpinCtrl is sometimes defined as
1475  * a wxTextCtrl, and so the flags must be different
1476  * from wxTextCtrl's.
1477  */
1478 #define wxSP_HORIZONTAL       wxHORIZONTAL /*  4 */
1479 #define wxSP_VERTICAL         wxVERTICAL   /*  8 */
1480 #define wxSP_ARROW_KEYS       0x1000
1481 #define wxSP_WRAP             0x2000
1482
1483 /*
1484  * wxNotebook flags
1485  */
1486 #define wxNB_FIXEDWIDTH       0x0010
1487 #define wxNB_TOP              0x0000    /*  default */
1488 #define wxNB_LEFT             0x0020
1489 #define wxNB_RIGHT            0x0040
1490 #define wxNB_BOTTOM           0x0080
1491 #define wxNB_MULTILINE        0x0100
1492 #define wxNB_NOPAGETHEME      0x0200
1493 #define wxNB_FLAT             0x0400
1494 #define wxNB_DEFAULT          wxNB_TOP
1495
1496 /*
1497  * wxListbook flags
1498  */
1499 #define wxLB_DEFAULT          0x0
1500 #define wxLB_TOP              0x1
1501 #define wxLB_BOTTOM           0x2
1502 #define wxLB_LEFT             0x4
1503 #define wxLB_RIGHT            0x8
1504 #define wxLB_ALIGN_MASK       0xf
1505
1506 /*
1507  * wxChoicebook flags
1508  */
1509 #define wxCHB_DEFAULT         0x0
1510 #define wxCHB_TOP             0x1
1511 #define wxCHB_BOTTOM          0x2
1512 #define wxCHB_LEFT            0x4
1513 #define wxCHB_RIGHT           0x8
1514 #define wxCHB_ALIGN_MASK      0xf
1515
1516 /*
1517  * wxTabCtrl flags
1518  */
1519 #define wxTC_RIGHTJUSTIFY     0x0010
1520 #define wxTC_FIXEDWIDTH       0x0020
1521 #define wxTC_TOP              0x0000    /*  default */
1522 #define wxTC_LEFT             0x0020
1523 #define wxTC_RIGHT            0x0040
1524 #define wxTC_BOTTOM           0x0080
1525 #define wxTC_MULTILINE        wxNB_MULTILINE
1526 #define wxTC_OWNERDRAW        0x0200
1527
1528 /*
1529  * wxStatusBar95 flags
1530  */
1531 #define wxST_SIZEGRIP         0x0010
1532
1533 /*
1534  * wxStaticText flags
1535  */
1536 #define wxST_NO_AUTORESIZE    0x0001
1537
1538 /*
1539  * wxStaticBitmap flags
1540  */
1541 #define wxBI_EXPAND           wxEXPAND
1542
1543 /*
1544  * wxStaticLine flags
1545  */
1546 #define wxLI_HORIZONTAL         wxHORIZONTAL
1547 #define wxLI_VERTICAL           wxVERTICAL
1548
1549 /*
1550  * wxProgressDialog flags
1551  */
1552 #define wxPD_CAN_ABORT          0x0001
1553 #define wxPD_APP_MODAL          0x0002
1554 #define wxPD_AUTO_HIDE          0x0004
1555 #define wxPD_ELAPSED_TIME       0x0008
1556 #define wxPD_ESTIMATED_TIME     0x0010
1557 #define wxPD_SMOOTH             0x0020
1558 #define wxPD_REMAINING_TIME     0x0040
1559 #define wxPD_CAN_SKIP           0x0080
1560
1561 /*
1562  * wxDirDialog styles
1563  */
1564
1565 #define wxDD_NEW_DIR_BUTTON     0x0080
1566
1567 /*
1568  * extended dialog specifiers. these values are stored in a different
1569  * flag and thus do not overlap with other style flags. note that these
1570  * values do not correspond to the return values of the dialogs (for
1571  * those values, look at the wxID_XXX defines).
1572  */
1573
1574 /*  wxCENTRE already defined as  0x00000001 */
1575 #define wxYES                   0x00000002
1576 #define wxOK                    0x00000004
1577 #define wxNO                    0x00000008
1578 #define wxYES_NO                (wxYES | wxNO)
1579 #define wxCANCEL                0x00000010
1580
1581 #define wxYES_DEFAULT           0x00000000  /*  has no effect (default) */
1582 #define wxNO_DEFAULT            0x00000080
1583
1584 #define wxICON_EXCLAMATION      0x00000100
1585 #define wxICON_HAND             0x00000200
1586 #define wxICON_WARNING          wxICON_EXCLAMATION
1587 #define wxICON_ERROR            wxICON_HAND
1588 #define wxICON_QUESTION         0x00000400
1589 #define wxICON_INFORMATION      0x00000800
1590 #define wxICON_STOP             wxICON_HAND
1591 #define wxICON_ASTERISK         wxICON_INFORMATION
1592 #define wxICON_MASK             (0x00000100|0x00000200|0x00000400|0x00000800)
1593
1594 #define  wxFORWARD              0x00001000
1595 #define  wxBACKWARD             0x00002000
1596 #define  wxRESET                0x00004000
1597 #define  wxHELP                 0x00008000
1598 #define  wxMORE                 0x00010000
1599 #define  wxSETUP                0x00020000
1600
1601 /*
1602  * Background styles. See wxWindow::SetBackgroundStyle
1603  */
1604
1605 enum wxBackgroundStyle
1606 {
1607   wxBG_STYLE_SYSTEM,
1608   wxBG_STYLE_COLOUR,
1609   wxBG_STYLE_CUSTOM
1610 };
1611
1612 /*  ---------------------------------------------------------------------------- */
1613 /*  standard IDs */
1614 /*  ---------------------------------------------------------------------------- */
1615
1616 /*  Standard menu IDs */
1617 enum
1618 {
1619     /* no id matches this one when compared to it */
1620     wxID_NONE = -3,
1621
1622     /*  id for a separator line in the menu (invalid for normal item) */
1623     wxID_SEPARATOR = -2,
1624
1625     /* any id: means that we don't care about the id, whether when installing
1626      * an event handler or when creating a new window */
1627     wxID_ANY = -1,
1628
1629
1630     /* all predefined ids are between wxID_LOWEST and wxID_HIGHEST */
1631     wxID_LOWEST = 4999,
1632
1633     wxID_OPEN,
1634     wxID_CLOSE,
1635     wxID_NEW,
1636     wxID_SAVE,
1637     wxID_SAVEAS,
1638     wxID_REVERT,
1639     wxID_EXIT,
1640     wxID_UNDO,
1641     wxID_REDO,
1642     wxID_HELP,
1643     wxID_PRINT,
1644     wxID_PRINT_SETUP,
1645     wxID_PREVIEW,
1646     wxID_ABOUT,
1647     wxID_HELP_CONTENTS,
1648     wxID_HELP_COMMANDS,
1649     wxID_HELP_PROCEDURES,
1650     wxID_HELP_CONTEXT,
1651     wxID_CLOSE_ALL,
1652     wxID_PREFERENCES ,
1653
1654     wxID_CUT = 5030,
1655     wxID_COPY,
1656     wxID_PASTE,
1657     wxID_CLEAR,
1658     wxID_FIND,
1659     wxID_DUPLICATE,
1660     wxID_SELECTALL,
1661     wxID_DELETE,
1662     wxID_REPLACE,
1663     wxID_REPLACE_ALL,
1664     wxID_PROPERTIES,
1665
1666     wxID_VIEW_DETAILS,
1667     wxID_VIEW_LARGEICONS,
1668     wxID_VIEW_SMALLICONS,
1669     wxID_VIEW_LIST,
1670     wxID_VIEW_SORTDATE,
1671     wxID_VIEW_SORTNAME,
1672     wxID_VIEW_SORTSIZE,
1673     wxID_VIEW_SORTTYPE,
1674
1675     wxID_FILE1 = 5050,
1676     wxID_FILE2,
1677     wxID_FILE3,
1678     wxID_FILE4,
1679     wxID_FILE5,
1680     wxID_FILE6,
1681     wxID_FILE7,
1682     wxID_FILE8,
1683     wxID_FILE9,
1684
1685     /*  Standard button and menu IDs */
1686     wxID_OK = 5100,
1687     wxID_CANCEL,
1688     wxID_APPLY,
1689     wxID_YES,
1690     wxID_NO,
1691     wxID_STATIC,
1692     wxID_FORWARD,
1693     wxID_BACKWARD,
1694     wxID_DEFAULT,
1695     wxID_MORE,
1696     wxID_SETUP,
1697     wxID_RESET,
1698     wxID_CONTEXT_HELP,
1699     wxID_YESTOALL,
1700     wxID_NOTOALL,
1701     wxID_ABORT,
1702     wxID_RETRY,
1703     wxID_IGNORE,
1704     wxID_ADD,
1705     wxID_REMOVE,
1706
1707     wxID_UP,
1708     wxID_DOWN,
1709     wxID_HOME,
1710     wxID_REFRESH,
1711     wxID_STOP,
1712     wxID_INDEX,
1713
1714     wxID_BOLD,
1715     wxID_ITALIC,
1716     wxID_JUSTIFY_CENTER,
1717     wxID_JUSTIFY_FILL,
1718     wxID_JUSTIFY_RIGHT,
1719     wxID_JUSTIFY_LEFT,
1720     wxID_UNDERLINE,
1721     wxID_INDENT,
1722     wxID_UNINDENT,
1723     wxID_ZOOM_100,
1724     wxID_ZOOM_FIT,
1725     wxID_ZOOM_IN,
1726     wxID_ZOOM_OUT,
1727     wxID_UNDELETE,
1728     wxID_REVERT_TO_SAVED,
1729
1730     /*  System menu IDs (used by wxUniv): */
1731     wxID_SYSTEM_MENU = 5200,
1732     wxID_CLOSE_FRAME,
1733     wxID_MOVE_FRAME,
1734     wxID_RESIZE_FRAME,
1735     wxID_MAXIMIZE_FRAME,
1736     wxID_ICONIZE_FRAME,
1737     wxID_RESTORE_FRAME,
1738
1739     /*  IDs used by generic file dialog (13 consecutive starting from this value) */
1740     wxID_FILEDLGG = 5900,
1741
1742     wxID_HIGHEST = 5999
1743 };
1744
1745 /*  ---------------------------------------------------------------------------- */
1746 /*  other constants */
1747 /*  ---------------------------------------------------------------------------- */
1748
1749 /*  menu and toolbar item kinds */
1750 enum wxItemKind
1751 {
1752     wxITEM_SEPARATOR = -1,
1753     wxITEM_NORMAL,
1754     wxITEM_CHECK,
1755     wxITEM_RADIO,
1756     wxITEM_MAX
1757 };
1758
1759 /*  hit test results */
1760 enum wxHitTest
1761 {
1762     wxHT_NOWHERE,
1763
1764     /*  scrollbar */
1765     wxHT_SCROLLBAR_FIRST = wxHT_NOWHERE,
1766     wxHT_SCROLLBAR_ARROW_LINE_1,    /*  left or upper arrow to scroll by line */
1767     wxHT_SCROLLBAR_ARROW_LINE_2,    /*  right or down */
1768     wxHT_SCROLLBAR_ARROW_PAGE_1,    /*  left or upper arrow to scroll by page */
1769     wxHT_SCROLLBAR_ARROW_PAGE_2,    /*  right or down */
1770     wxHT_SCROLLBAR_THUMB,           /*  on the thumb */
1771     wxHT_SCROLLBAR_BAR_1,           /*  bar to the left/above the thumb */
1772     wxHT_SCROLLBAR_BAR_2,           /*  bar to the right/below the thumb */
1773     wxHT_SCROLLBAR_LAST,
1774
1775     /*  window */
1776     wxHT_WINDOW_OUTSIDE,            /*  not in this window at all */
1777     wxHT_WINDOW_INSIDE,             /*  in the client area */
1778     wxHT_WINDOW_VERT_SCROLLBAR,     /*  on the vertical scrollbar */
1779     wxHT_WINDOW_HORZ_SCROLLBAR,     /*  on the horizontal scrollbar */
1780     wxHT_WINDOW_CORNER,             /*  on the corner between 2 scrollbars */
1781
1782     wxHT_MAX
1783 };
1784
1785 /*  ---------------------------------------------------------------------------- */
1786 /*  Possible SetSize flags */
1787 /*  ---------------------------------------------------------------------------- */
1788
1789 /*  Use internally-calculated width if -1 */
1790 #define wxSIZE_AUTO_WIDTH       0x0001
1791 /*  Use internally-calculated height if -1 */
1792 #define wxSIZE_AUTO_HEIGHT      0x0002
1793 /*  Use internally-calculated width and height if each is -1 */
1794 #define wxSIZE_AUTO             (wxSIZE_AUTO_WIDTH|wxSIZE_AUTO_HEIGHT)
1795 /*  Ignore missing (-1) dimensions (use existing). */
1796 /*  For readability only: test for wxSIZE_AUTO_WIDTH/HEIGHT in code. */
1797 #define wxSIZE_USE_EXISTING     0x0000
1798 /*  Allow -1 as a valid position */
1799 #define wxSIZE_ALLOW_MINUS_ONE  0x0004
1800 /*  Don't do parent client adjustments (for implementation only) */
1801 #define wxSIZE_NO_ADJUSTMENTS   0x0008
1802
1803 #if wxABI_VERSION >= 20602
1804 /*  Change the window position even if it seems to be already correct */
1805 #define wxSIZE_FORCE            0x0010
1806 #endif // 2.6.2+
1807
1808 /*  ---------------------------------------------------------------------------- */
1809 /*  GDI descriptions */
1810 /*  ---------------------------------------------------------------------------- */
1811
1812 enum
1813 {
1814     /*  Text font families */
1815     wxDEFAULT    = 70,
1816     wxDECORATIVE,
1817     wxROMAN,
1818     wxSCRIPT,
1819     wxSWISS,
1820     wxMODERN,
1821     wxTELETYPE,  /* @@@@ */
1822
1823     /*  Proportional or Fixed width fonts (not yet used) */
1824     wxVARIABLE   = 80,
1825     wxFIXED,
1826
1827     wxNORMAL     = 90,
1828     wxLIGHT,
1829     wxBOLD,
1830     /*  Also wxNORMAL for normal (non-italic text) */
1831     wxITALIC,
1832     wxSLANT,
1833
1834     /*  Pen styles */
1835     wxSOLID      =   100,
1836     wxDOT,
1837     wxLONG_DASH,
1838     wxSHORT_DASH,
1839     wxDOT_DASH,
1840     wxUSER_DASH,
1841
1842     wxTRANSPARENT,
1843
1844     /*  Brush & Pen Stippling. Note that a stippled pen cannot be dashed!! */
1845     /*  Note also that stippling a Pen IS meaningfull, because a Line is */
1846     wxSTIPPLE_MASK_OPAQUE, /* mask is used for blitting monochrome using text fore and back ground colors */
1847     wxSTIPPLE_MASK,        /* mask is used for masking areas in the stipple bitmap (TO DO) */
1848     /*  drawn with a Pen, and without any Brush -- and it can be stippled. */
1849     wxSTIPPLE =          110,
1850
1851     wxBDIAGONAL_HATCH,     /* In wxWidgets < 2.6 use WX_HATCH macro  */
1852     wxCROSSDIAG_HATCH,     /* to verify these wx*_HATCH are in style */
1853     wxFDIAGONAL_HATCH,     /* of wxBrush. In wxWidgets >= 2.6 use    */
1854     wxCROSS_HATCH,         /* wxBrush::IsHatch() instead.            */
1855     wxHORIZONTAL_HATCH,
1856     wxVERTICAL_HATCH,
1857     wxFIRST_HATCH = wxBDIAGONAL_HATCH,
1858     wxLAST_HATCH = wxVERTICAL_HATCH,
1859
1860     wxJOIN_BEVEL =     120,
1861     wxJOIN_MITER,
1862     wxJOIN_ROUND,
1863
1864     wxCAP_ROUND =      130,
1865     wxCAP_PROJECTING,
1866     wxCAP_BUTT
1867 };
1868
1869 #if WXWIN_COMPATIBILITY_2_4
1870     #define IS_HATCH(s)    ((s)>=wxFIRST_HATCH && (s)<=wxLAST_HATCH)
1871 #else
1872     /* use wxBrush::IsHatch() instead thought wxMotif still uses it in src/motif/dcclient.cpp */
1873 #endif
1874
1875 /*  Logical ops */
1876 typedef enum
1877 {
1878     wxCLEAR,        wxROP_BLACK = wxCLEAR,             wxBLIT_BLACKNESS = wxCLEAR,        /*  0 */
1879     wxXOR,          wxROP_XORPEN = wxXOR,              wxBLIT_SRCINVERT = wxXOR,          /*  src XOR dst */
1880     wxINVERT,       wxROP_NOT = wxINVERT,              wxBLIT_DSTINVERT = wxINVERT,       /*  NOT dst */
1881     wxOR_REVERSE,   wxROP_MERGEPENNOT = wxOR_REVERSE,  wxBLIT_00DD0228 = wxOR_REVERSE,    /*  src OR (NOT dst) */
1882     wxAND_REVERSE,  wxROP_MASKPENNOT = wxAND_REVERSE,  wxBLIT_SRCERASE = wxAND_REVERSE,   /*  src AND (NOT dst) */
1883     wxCOPY,         wxROP_COPYPEN = wxCOPY,            wxBLIT_SRCCOPY = wxCOPY,           /*  src */
1884     wxAND,          wxROP_MASKPEN = wxAND,             wxBLIT_SRCAND = wxAND,             /*  src AND dst */
1885     wxAND_INVERT,   wxROP_MASKNOTPEN = wxAND_INVERT,   wxBLIT_00220326 = wxAND_INVERT,    /*  (NOT src) AND dst */
1886     wxNO_OP,        wxROP_NOP = wxNO_OP,               wxBLIT_00AA0029 = wxNO_OP,         /*  dst */
1887     wxNOR,          wxROP_NOTMERGEPEN = wxNOR,         wxBLIT_NOTSRCERASE = wxNOR,        /*  (NOT src) AND (NOT dst) */
1888     wxEQUIV,        wxROP_NOTXORPEN = wxEQUIV,         wxBLIT_00990066 = wxEQUIV,         /*  (NOT src) XOR dst */
1889     wxSRC_INVERT,   wxROP_NOTCOPYPEN = wxSRC_INVERT,   wxBLIT_NOTSCRCOPY = wxSRC_INVERT,  /*  (NOT src) */
1890     wxOR_INVERT,    wxROP_MERGENOTPEN = wxOR_INVERT,   wxBLIT_MERGEPAINT = wxOR_INVERT,   /*  (NOT src) OR dst */
1891     wxNAND,         wxROP_NOTMASKPEN = wxNAND,         wxBLIT_007700E6 = wxNAND,          /*  (NOT src) OR (NOT dst) */
1892     wxOR,           wxROP_MERGEPEN = wxOR,             wxBLIT_SRCPAINT = wxOR,            /*  src OR dst */
1893     wxSET,          wxROP_WHITE = wxSET,               wxBLIT_WHITENESS = wxSET           /*  1 */
1894 } form_ops_t;
1895
1896 /*  Flood styles */
1897 enum
1898 {
1899     wxFLOOD_SURFACE = 1,
1900     wxFLOOD_BORDER
1901 };
1902
1903 /*  Polygon filling mode */
1904 enum
1905 {
1906     wxODDEVEN_RULE = 1,
1907     wxWINDING_RULE
1908 };
1909
1910 /*  ToolPanel in wxFrame (VZ: unused?) */
1911 enum
1912 {
1913     wxTOOL_TOP = 1,
1914     wxTOOL_BOTTOM,
1915     wxTOOL_LEFT,
1916     wxTOOL_RIGHT
1917 };
1918
1919 /*  the values of the format constants should be the same as corresponding */
1920 /*  CF_XXX constants in Windows API */
1921 enum wxDataFormatId
1922 {
1923     wxDF_INVALID =          0,
1924     wxDF_TEXT =             1,  /* CF_TEXT */
1925     wxDF_BITMAP =           2,  /* CF_BITMAP */
1926     wxDF_METAFILE =         3,  /* CF_METAFILEPICT */
1927     wxDF_SYLK =             4,
1928     wxDF_DIF =              5,
1929     wxDF_TIFF =             6,
1930     wxDF_OEMTEXT =          7,  /* CF_OEMTEXT */
1931     wxDF_DIB =              8,  /* CF_DIB */
1932     wxDF_PALETTE =          9,
1933     wxDF_PENDATA =          10,
1934     wxDF_RIFF =             11,
1935     wxDF_WAVE =             12,
1936     wxDF_UNICODETEXT =      13,
1937     wxDF_ENHMETAFILE =      14,
1938     wxDF_FILENAME =         15, /* CF_HDROP */
1939     wxDF_LOCALE =           16,
1940     wxDF_PRIVATE =          20,
1941     wxDF_HTML =             30, /* Note: does not correspond to CF_ constant */
1942     wxDF_MAX
1943 };
1944
1945 /*  Virtual keycodes */
1946 enum wxKeyCode
1947 {
1948     WXK_BACK    =    8,
1949     WXK_TAB     =    9,
1950     WXK_RETURN  =    13,
1951     WXK_ESCAPE  =    27,
1952     WXK_SPACE   =    32,
1953     WXK_DELETE  =    127,
1954
1955     /* These are, by design, not compatible with unicode characters.
1956        If you want to get a unicode character from a key event, use
1957        wxKeyEvent::GetUnicodeKey instead.                           */
1958     WXK_START   = 300,
1959     WXK_LBUTTON,
1960     WXK_RBUTTON,
1961     WXK_CANCEL,
1962     WXK_MBUTTON,
1963     WXK_CLEAR,
1964     WXK_SHIFT,
1965     WXK_ALT,
1966     WXK_CONTROL,
1967     WXK_MENU,
1968     WXK_PAUSE,
1969     WXK_CAPITAL,
1970     WXK_PRIOR,  /*  Page up */
1971     WXK_NEXT,   /*  Page down */
1972     WXK_END,
1973     WXK_HOME,
1974     WXK_LEFT,
1975     WXK_UP,
1976     WXK_RIGHT,
1977     WXK_DOWN,
1978     WXK_SELECT,
1979     WXK_PRINT,
1980     WXK_EXECUTE,
1981     WXK_SNAPSHOT,
1982     WXK_INSERT,
1983     WXK_HELP,
1984     WXK_NUMPAD0,
1985     WXK_NUMPAD1,
1986     WXK_NUMPAD2,
1987     WXK_NUMPAD3,
1988     WXK_NUMPAD4,
1989     WXK_NUMPAD5,
1990     WXK_NUMPAD6,
1991     WXK_NUMPAD7,
1992     WXK_NUMPAD8,
1993     WXK_NUMPAD9,
1994     WXK_MULTIPLY,
1995     WXK_ADD,
1996     WXK_SEPARATOR,
1997     WXK_SUBTRACT,
1998     WXK_DECIMAL,
1999     WXK_DIVIDE,
2000     WXK_F1,
2001     WXK_F2,
2002     WXK_F3,
2003     WXK_F4,
2004     WXK_F5,
2005     WXK_F6,
2006     WXK_F7,
2007     WXK_F8,
2008     WXK_F9,
2009     WXK_F10,
2010     WXK_F11,
2011     WXK_F12,
2012     WXK_F13,
2013     WXK_F14,
2014     WXK_F15,
2015     WXK_F16,
2016     WXK_F17,
2017     WXK_F18,
2018     WXK_F19,
2019     WXK_F20,
2020     WXK_F21,
2021     WXK_F22,
2022     WXK_F23,
2023     WXK_F24,
2024     WXK_NUMLOCK,
2025     WXK_SCROLL,
2026     WXK_PAGEUP,
2027     WXK_PAGEDOWN,
2028
2029     WXK_NUMPAD_SPACE,
2030     WXK_NUMPAD_TAB,
2031     WXK_NUMPAD_ENTER,
2032     WXK_NUMPAD_F1,
2033     WXK_NUMPAD_F2,
2034     WXK_NUMPAD_F3,
2035     WXK_NUMPAD_F4,
2036     WXK_NUMPAD_HOME,
2037     WXK_NUMPAD_LEFT,
2038     WXK_NUMPAD_UP,
2039     WXK_NUMPAD_RIGHT,
2040     WXK_NUMPAD_DOWN,
2041     WXK_NUMPAD_PRIOR,
2042     WXK_NUMPAD_PAGEUP,
2043     WXK_NUMPAD_NEXT,
2044     WXK_NUMPAD_PAGEDOWN,
2045     WXK_NUMPAD_END,
2046     WXK_NUMPAD_BEGIN,
2047     WXK_NUMPAD_INSERT,
2048     WXK_NUMPAD_DELETE,
2049     WXK_NUMPAD_EQUAL,
2050     WXK_NUMPAD_MULTIPLY,
2051     WXK_NUMPAD_ADD,
2052     WXK_NUMPAD_SEPARATOR,
2053     WXK_NUMPAD_SUBTRACT,
2054     WXK_NUMPAD_DECIMAL,
2055     WXK_NUMPAD_DIVIDE,
2056
2057     WXK_WINDOWS_LEFT,
2058     WXK_WINDOWS_RIGHT,
2059     WXK_WINDOWS_MENU ,
2060     WXK_COMMAND,
2061
2062     /* Hardware-specific buttons */
2063     WXK_SPECIAL1 = 193,
2064     WXK_SPECIAL2,
2065     WXK_SPECIAL3,
2066     WXK_SPECIAL4,
2067     WXK_SPECIAL5,
2068     WXK_SPECIAL6,
2069     WXK_SPECIAL7,
2070     WXK_SPECIAL8,
2071     WXK_SPECIAL9,
2072     WXK_SPECIAL10,
2073     WXK_SPECIAL11,
2074     WXK_SPECIAL12,
2075     WXK_SPECIAL13,
2076     WXK_SPECIAL14,
2077     WXK_SPECIAL15,
2078     WXK_SPECIAL16,
2079     WXK_SPECIAL17,
2080     WXK_SPECIAL18,
2081     WXK_SPECIAL19,
2082     WXK_SPECIAL20
2083 };
2084
2085 #if wxUSE_HOTKEY
2086 enum wxHotkeyModifier
2087 {
2088     wxMOD_NONE = 0,
2089     wxMOD_ALT = 1,
2090     wxMOD_CONTROL = 2,
2091     wxMOD_SHIFT = 4,
2092     wxMOD_WIN = 8
2093 };
2094 #endif
2095
2096 /*  Mapping modes (same values as used by Windows, don't change) */
2097 enum
2098 {
2099     wxMM_TEXT = 1,
2100     wxMM_LOMETRIC,
2101     wxMM_HIMETRIC,
2102     wxMM_LOENGLISH,
2103     wxMM_HIENGLISH,
2104     wxMM_TWIPS,
2105     wxMM_ISOTROPIC,
2106     wxMM_ANISOTROPIC,
2107     wxMM_POINTS,
2108     wxMM_METRIC
2109 };
2110
2111 /* Shortcut for easier dialog-unit-to-pixel conversion */
2112 #define wxDLG_UNIT(parent, pt) parent->ConvertDialogToPixels(pt)
2113
2114 /* Paper types */
2115 typedef enum
2116 {
2117     wxPAPER_NONE,               /*  Use specific dimensions */
2118     wxPAPER_LETTER,             /*  Letter, 8 1/2 by 11 inches */
2119     wxPAPER_LEGAL,              /*  Legal, 8 1/2 by 14 inches */
2120     wxPAPER_A4,                 /*  A4 Sheet, 210 by 297 millimeters */
2121     wxPAPER_CSHEET,             /*  C Sheet, 17 by 22 inches */
2122     wxPAPER_DSHEET,             /*  D Sheet, 22 by 34 inches */
2123     wxPAPER_ESHEET,             /*  E Sheet, 34 by 44 inches */
2124     wxPAPER_LETTERSMALL,        /*  Letter Small, 8 1/2 by 11 inches */
2125     wxPAPER_TABLOID,            /*  Tabloid, 11 by 17 inches */
2126     wxPAPER_LEDGER,             /*  Ledger, 17 by 11 inches */
2127     wxPAPER_STATEMENT,          /*  Statement, 5 1/2 by 8 1/2 inches */
2128     wxPAPER_EXECUTIVE,          /*  Executive, 7 1/4 by 10 1/2 inches */
2129     wxPAPER_A3,                 /*  A3 sheet, 297 by 420 millimeters */
2130     wxPAPER_A4SMALL,            /*  A4 small sheet, 210 by 297 millimeters */
2131     wxPAPER_A5,                 /*  A5 sheet, 148 by 210 millimeters */
2132     wxPAPER_B4,                 /*  B4 sheet, 250 by 354 millimeters */
2133     wxPAPER_B5,                 /*  B5 sheet, 182-by-257-millimeter paper */
2134     wxPAPER_FOLIO,              /*  Folio, 8-1/2-by-13-inch paper */
2135     wxPAPER_QUARTO,             /*  Quarto, 215-by-275-millimeter paper */
2136     wxPAPER_10X14,              /*  10-by-14-inch sheet */
2137     wxPAPER_11X17,              /*  11-by-17-inch sheet */
2138     wxPAPER_NOTE,               /*  Note, 8 1/2 by 11 inches */
2139     wxPAPER_ENV_9,              /*  #9 Envelope, 3 7/8 by 8 7/8 inches */
2140     wxPAPER_ENV_10,             /*  #10 Envelope, 4 1/8 by 9 1/2 inches */
2141     wxPAPER_ENV_11,             /*  #11 Envelope, 4 1/2 by 10 3/8 inches */
2142     wxPAPER_ENV_12,             /*  #12 Envelope, 4 3/4 by 11 inches */
2143     wxPAPER_ENV_14,             /*  #14 Envelope, 5 by 11 1/2 inches */
2144     wxPAPER_ENV_DL,             /*  DL Envelope, 110 by 220 millimeters */
2145     wxPAPER_ENV_C5,             /*  C5 Envelope, 162 by 229 millimeters */
2146     wxPAPER_ENV_C3,             /*  C3 Envelope, 324 by 458 millimeters */
2147     wxPAPER_ENV_C4,             /*  C4 Envelope, 229 by 324 millimeters */
2148     wxPAPER_ENV_C6,             /*  C6 Envelope, 114 by 162 millimeters */
2149     wxPAPER_ENV_C65,            /*  C65 Envelope, 114 by 229 millimeters */
2150     wxPAPER_ENV_B4,             /*  B4 Envelope, 250 by 353 millimeters */
2151     wxPAPER_ENV_B5,             /*  B5 Envelope, 176 by 250 millimeters */
2152     wxPAPER_ENV_B6,             /*  B6 Envelope, 176 by 125 millimeters */
2153     wxPAPER_ENV_ITALY,          /*  Italy Envelope, 110 by 230 millimeters */
2154     wxPAPER_ENV_MONARCH,        /*  Monarch Envelope, 3 7/8 by 7 1/2 inches */
2155     wxPAPER_ENV_PERSONAL,       /*  6 3/4 Envelope, 3 5/8 by 6 1/2 inches */
2156     wxPAPER_FANFOLD_US,         /*  US Std Fanfold, 14 7/8 by 11 inches */
2157     wxPAPER_FANFOLD_STD_GERMAN, /*  German Std Fanfold, 8 1/2 by 12 inches */
2158     wxPAPER_FANFOLD_LGL_GERMAN, /*  German Legal Fanfold, 8 1/2 by 13 inches */
2159
2160     wxPAPER_ISO_B4,             /*  B4 (ISO) 250 x 353 mm */
2161     wxPAPER_JAPANESE_POSTCARD,  /*  Japanese Postcard 100 x 148 mm */
2162     wxPAPER_9X11,               /*  9 x 11 in */
2163     wxPAPER_10X11,              /*  10 x 11 in */
2164     wxPAPER_15X11,              /*  15 x 11 in */
2165     wxPAPER_ENV_INVITE,         /*  Envelope Invite 220 x 220 mm */
2166     wxPAPER_LETTER_EXTRA,       /*  Letter Extra 9 \275 x 12 in */
2167     wxPAPER_LEGAL_EXTRA,        /*  Legal Extra 9 \275 x 15 in */
2168     wxPAPER_TABLOID_EXTRA,      /*  Tabloid Extra 11.69 x 18 in */
2169     wxPAPER_A4_EXTRA,           /*  A4 Extra 9.27 x 12.69 in */
2170     wxPAPER_LETTER_TRANSVERSE,  /*  Letter Transverse 8 \275 x 11 in */
2171     wxPAPER_A4_TRANSVERSE,      /*  A4 Transverse 210 x 297 mm */
2172     wxPAPER_LETTER_EXTRA_TRANSVERSE, /*  Letter Extra Transverse 9\275 x 12 in */
2173     wxPAPER_A_PLUS,             /*  SuperA/SuperA/A4 227 x 356 mm */
2174     wxPAPER_B_PLUS,             /*  SuperB/SuperB/A3 305 x 487 mm */
2175     wxPAPER_LETTER_PLUS,        /*  Letter Plus 8.5 x 12.69 in */
2176     wxPAPER_A4_PLUS,            /*  A4 Plus 210 x 330 mm */
2177     wxPAPER_A5_TRANSVERSE,      /*  A5 Transverse 148 x 210 mm */
2178     wxPAPER_B5_TRANSVERSE,      /*  B5 (JIS) Transverse 182 x 257 mm */
2179     wxPAPER_A3_EXTRA,           /*  A3 Extra 322 x 445 mm */
2180     wxPAPER_A5_EXTRA,           /*  A5 Extra 174 x 235 mm */
2181     wxPAPER_B5_EXTRA,           /*  B5 (ISO) Extra 201 x 276 mm */
2182     wxPAPER_A2,                 /*  A2 420 x 594 mm */
2183     wxPAPER_A3_TRANSVERSE,      /*  A3 Transverse 297 x 420 mm */
2184     wxPAPER_A3_EXTRA_TRANSVERSE, /*  A3 Extra Transverse 322 x 445 mm */
2185
2186     wxPAPER_DBL_JAPANESE_POSTCARD,/* Japanese Double Postcard 200 x 148 mm */
2187     wxPAPER_A6,                 /* A6 105 x 148 mm */
2188     wxPAPER_JENV_KAKU2,         /* Japanese Envelope Kaku #2 */
2189     wxPAPER_JENV_KAKU3,         /* Japanese Envelope Kaku #3 */
2190     wxPAPER_JENV_CHOU3,         /* Japanese Envelope Chou #3 */
2191     wxPAPER_JENV_CHOU4,         /* Japanese Envelope Chou #4 */
2192     wxPAPER_LETTER_ROTATED,     /* Letter Rotated 11 x 8 1/2 in */
2193     wxPAPER_A3_ROTATED,         /* A3 Rotated 420 x 297 mm */
2194     wxPAPER_A4_ROTATED,         /* A4 Rotated 297 x 210 mm */
2195     wxPAPER_A5_ROTATED,         /* A5 Rotated 210 x 148 mm */
2196     wxPAPER_B4_JIS_ROTATED,     /* B4 (JIS) Rotated 364 x 257 mm */
2197     wxPAPER_B5_JIS_ROTATED,     /* B5 (JIS) Rotated 257 x 182 mm */
2198     wxPAPER_JAPANESE_POSTCARD_ROTATED,/* Japanese Postcard Rotated 148 x 100 mm */
2199     wxPAPER_DBL_JAPANESE_POSTCARD_ROTATED,/* Double Japanese Postcard Rotated 148 x 200 mm */
2200     wxPAPER_A6_ROTATED,         /* A6 Rotated 148 x 105 mm */
2201     wxPAPER_JENV_KAKU2_ROTATED, /* Japanese Envelope Kaku #2 Rotated */
2202     wxPAPER_JENV_KAKU3_ROTATED, /* Japanese Envelope Kaku #3 Rotated */
2203     wxPAPER_JENV_CHOU3_ROTATED, /* Japanese Envelope Chou #3 Rotated */
2204     wxPAPER_JENV_CHOU4_ROTATED, /* Japanese Envelope Chou #4 Rotated */
2205     wxPAPER_B6_JIS,             /* B6 (JIS) 128 x 182 mm */
2206     wxPAPER_B6_JIS_ROTATED,     /* B6 (JIS) Rotated 182 x 128 mm */
2207     wxPAPER_12X11,              /* 12 x 11 in */
2208     wxPAPER_JENV_YOU4,          /* Japanese Envelope You #4 */
2209     wxPAPER_JENV_YOU4_ROTATED,  /* Japanese Envelope You #4 Rotated */
2210     wxPAPER_P16K,               /* PRC 16K 146 x 215 mm */
2211     wxPAPER_P32K,               /* PRC 32K 97 x 151 mm */
2212     wxPAPER_P32KBIG,            /* PRC 32K(Big) 97 x 151 mm */
2213     wxPAPER_PENV_1,             /* PRC Envelope #1 102 x 165 mm */
2214     wxPAPER_PENV_2,             /* PRC Envelope #2 102 x 176 mm */
2215     wxPAPER_PENV_3,             /* PRC Envelope #3 125 x 176 mm */
2216     wxPAPER_PENV_4,             /* PRC Envelope #4 110 x 208 mm */
2217     wxPAPER_PENV_5,             /* PRC Envelope #5 110 x 220 mm */
2218     wxPAPER_PENV_6,             /* PRC Envelope #6 120 x 230 mm */
2219     wxPAPER_PENV_7,             /* PRC Envelope #7 160 x 230 mm */
2220     wxPAPER_PENV_8,             /* PRC Envelope #8 120 x 309 mm */
2221     wxPAPER_PENV_9,             /* PRC Envelope #9 229 x 324 mm */
2222     wxPAPER_PENV_10,            /* PRC Envelope #10 324 x 458 mm */
2223     wxPAPER_P16K_ROTATED,       /* PRC 16K Rotated */
2224     wxPAPER_P32K_ROTATED,       /* PRC 32K Rotated */
2225     wxPAPER_P32KBIG_ROTATED,    /* PRC 32K(Big) Rotated */
2226     wxPAPER_PENV_1_ROTATED,     /* PRC Envelope #1 Rotated 165 x 102 mm */
2227     wxPAPER_PENV_2_ROTATED,     /* PRC Envelope #2 Rotated 176 x 102 mm */
2228     wxPAPER_PENV_3_ROTATED,     /* PRC Envelope #3 Rotated 176 x 125 mm */
2229     wxPAPER_PENV_4_ROTATED,     /* PRC Envelope #4 Rotated 208 x 110 mm */
2230     wxPAPER_PENV_5_ROTATED,     /* PRC Envelope #5 Rotated 220 x 110 mm */
2231     wxPAPER_PENV_6_ROTATED,     /* PRC Envelope #6 Rotated 230 x 120 mm */
2232     wxPAPER_PENV_7_ROTATED,     /* PRC Envelope #7 Rotated 230 x 160 mm */
2233     wxPAPER_PENV_8_ROTATED,     /* PRC Envelope #8 Rotated 309 x 120 mm */
2234     wxPAPER_PENV_9_ROTATED,     /* PRC Envelope #9 Rotated 324 x 229 mm */
2235     wxPAPER_PENV_10_ROTATED    /* PRC Envelope #10 Rotated 458 x 324 m */
2236 } wxPaperSize;
2237
2238 /* Printing orientation */
2239 #ifndef wxPORTRAIT
2240 #define wxPORTRAIT      1
2241 #define wxLANDSCAPE     2
2242 #endif
2243
2244 /* Duplex printing modes
2245  */
2246
2247 enum wxDuplexMode
2248 {
2249     wxDUPLEX_SIMPLEX, /*  Non-duplex */
2250     wxDUPLEX_HORIZONTAL,
2251     wxDUPLEX_VERTICAL
2252 };
2253
2254 /* Print quality.
2255  */
2256
2257 #define wxPRINT_QUALITY_HIGH    -1
2258 #define wxPRINT_QUALITY_MEDIUM  -2
2259 #define wxPRINT_QUALITY_LOW     -3
2260 #define wxPRINT_QUALITY_DRAFT   -4
2261
2262 typedef int wxPrintQuality;
2263
2264 /* Print mode (currently PostScript only)
2265  */
2266
2267 enum wxPrintMode
2268 {
2269     wxPRINT_MODE_NONE =    0,
2270     wxPRINT_MODE_PREVIEW = 1,   /*  Preview in external application */
2271     wxPRINT_MODE_FILE =    2,   /*  Print to file */
2272     wxPRINT_MODE_PRINTER = 3,   /*  Send to printer */
2273     wxPRINT_MODE_STREAM =  4    /*  Send postscript data into a stream */
2274 };
2275
2276 /*  ---------------------------------------------------------------------------- */
2277 /*  UpdateWindowUI flags */
2278 /*  ---------------------------------------------------------------------------- */
2279
2280 enum wxUpdateUI
2281 {
2282     wxUPDATE_UI_NONE          = 0x0000,
2283     wxUPDATE_UI_RECURSE       = 0x0001,
2284     wxUPDATE_UI_FROMIDLE      = 0x0002 /*  Invoked from On(Internal)Idle */
2285 };
2286
2287 /*  ---------------------------------------------------------------------------- */
2288 /*  miscellaneous */
2289 /*  ---------------------------------------------------------------------------- */
2290
2291 /*  define this macro if font handling is done using the X font names */
2292 #if (defined(__WXGTK__) && !defined(__WXGTK20__)) || defined(__X__)
2293     #define _WX_X_FONTLIKE
2294 #endif
2295
2296 /*  macro to specify "All Files" on different platforms */
2297 #if defined(__WXMSW__) || defined(__WXPM__)
2298 #   define wxALL_FILES_PATTERN   wxT("*.*")
2299 #   define wxALL_FILES           gettext_noop("All files (*.*)|*.*")
2300 #else
2301 #   define wxALL_FILES_PATTERN   wxT("*")
2302 #   define wxALL_FILES           gettext_noop("All files (*)|*")
2303 #endif
2304
2305 #if defined(__CYGWIN__) && defined(__WXMSW__)
2306 #   if wxUSE_STL || defined(wxUSE_STD_STRING)
2307          /*
2308             NASTY HACK because the gethostname in sys/unistd.h which the gnu
2309             stl includes and wx builds with by default clash with each other
2310             (windows version 2nd param is int, sys/unistd.h version is unsigned
2311             int).
2312           */
2313 #        define gethostname gethostnameHACK
2314 #        include <unistd.h>
2315 #        undef gethostname
2316 #   endif
2317 #endif
2318
2319 /*  --------------------------------------------------------------------------- */
2320 /*  macros that enable wxWidgets apps to be compiled in absence of the */
2321 /*  sytem headers, although some platform specific types are used in the */
2322 /*  platform specific (implementation) parts of the headers */
2323 /*  --------------------------------------------------------------------------- */
2324
2325 #ifdef __WXMAC__
2326
2327 #define WX_OPAQUE_TYPE( name ) struct wxOpaque##name
2328
2329 typedef unsigned char WXCOLORREF[6];
2330 typedef void*       WXCGIMAGEREF;
2331 typedef void*       WXHBITMAP;
2332 typedef void*       WXHCURSOR;
2333 typedef void*       WXHRGN;
2334 typedef void*       WXRECTPTR;
2335 typedef void*       WXPOINTPTR;
2336 typedef void*       WXHWND;
2337 typedef void*       WXEVENTREF;
2338 typedef void*       WXEVENTHANDLERREF;
2339 typedef void*       WXEVENTHANDLERCALLREF;
2340 typedef void*       WXAPPLEEVENTREF;
2341 typedef void*       WXHDC;
2342 typedef void*       WXHMENU;
2343 typedef unsigned int    WXUINT;
2344 typedef unsigned long   WXDWORD;
2345 typedef unsigned short  WXWORD;
2346
2347 typedef WX_OPAQUE_TYPE(CIconHandle ) * WXHICON ;
2348 typedef WX_OPAQUE_TYPE(PicHandle ) * WXHMETAFILE ;
2349
2350
2351 /* typedef void*       WXWidget; */
2352 /* typedef void*       WXWindow; */
2353 typedef WX_OPAQUE_TYPE(ControlRef ) * WXWidget ;
2354 typedef WX_OPAQUE_TYPE(WindowRef) * WXWindow ;
2355 typedef void*       WXDisplay;
2356
2357 /* typedef WindowPtr       WXHWND; */
2358 /* typedef Handle          WXHANDLE; */
2359 /* typedef CIconHandle     WXHICON; */
2360 /* typedef unsigned long   WXHFONT; */
2361 /* typedef MenuHandle      WXHMENU; */
2362 /* typedef unsigned long   WXHPEN; */
2363 /* typedef unsigned long   WXHBRUSH; */
2364 /* typedef unsigned long   WXHPALETTE; */
2365 /* typedef CursHandle      WXHCURSOR; */
2366 /* typedef RgnHandle       WXHRGN; */
2367 /* typedef unsigned long   WXHACCEL; */
2368 /* typedef unsigned long   WXHINSTANCE; */
2369 /* typedef unsigned long   WXHIMAGELIST; */
2370 /* typedef unsigned long   WXHGLOBAL; */
2371 /* typedef GrafPtr         WXHDC; */
2372 /* typedef unsigned int    WXWPARAM; */
2373 /* typedef long            WXLPARAM; */
2374 /* typedef void *          WXRGNDATA; */
2375 /* typedef void *          WXMSG; */
2376 /* typedef unsigned long   WXHCONV; */
2377 /* typedef unsigned long   WXHKEY; */
2378 /* typedef void *          WXDRAWITEMSTRUCT; */
2379 /* typedef void *          WXMEASUREITEMSTRUCT; */
2380 /* typedef void *          WXLPCREATESTRUCT; */
2381 /* typedef int (*WXFARPROC)(); */
2382
2383 /* typedef WindowPtr       WXWindow; */
2384 /* typedef ControlHandle   WXWidget; */
2385
2386 #endif
2387
2388 #ifdef __WXCOCOA__
2389
2390 /*  NOTE: This ought to work with other compilers too, but I'm being cautious */
2391 #if (defined(__GNUC__) && defined(__APPLE__)) || defined(__MWERKS__)
2392 /* It's desirable to have type safety for Objective-C(++) code as it does
2393 at least catch typos of method names among other things.  However, it
2394 is not possible to declare an Objective-C class from plain old C or C++
2395 code.  Furthermore, because of C++ name mangling, the type name must
2396 be the same for both C++ and Objective-C++ code.  Therefore, we define
2397 what should be a pointer to an Objective-C class as a pointer to a plain
2398 old C struct with the same name.  Unfortunately, because the compiler
2399 does not see a struct as an Objective-C class we cannot declare it
2400 as a struct in Objective-C(++) mode.
2401 */
2402 #if defined(__OBJC__)
2403 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2404 @class klass; \
2405 typedef klass *WX_##klass
2406 #else /*  not defined(__OBJC__) */
2407 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2408 typedef struct klass *WX_##klass
2409 #endif /*  defined(__OBJC__) */
2410
2411 #else /*  not Apple's GNU or CodeWarrior */
2412 #warning "Objective-C types will not be checked by the compiler."
2413 /*  NOTE: typedef struct objc_object *id; */
2414 /*  IOW, we're declaring these using the id type without using that name, */
2415 /*  since "id" is used extensively not only within wxWidgets itself, but */
2416 /*  also in wxWidgets application code.  The following works fine when */
2417 /*  compiling C(++) code, and works without typesafety for Obj-C(++) code */
2418 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2419 typedef struct objc_object *WX_##klass
2420
2421 #endif /*  (defined(__GNUC__) && defined(__APPLE__)) || defined(__MWERKS__) */
2422
2423 DECLARE_WXCOCOA_OBJC_CLASS(NSApplication);
2424 DECLARE_WXCOCOA_OBJC_CLASS(NSBitmapImageRep);
2425 DECLARE_WXCOCOA_OBJC_CLASS(NSBox);
2426 DECLARE_WXCOCOA_OBJC_CLASS(NSButton);
2427 DECLARE_WXCOCOA_OBJC_CLASS(NSColor);
2428 DECLARE_WXCOCOA_OBJC_CLASS(NSColorPanel);
2429 DECLARE_WXCOCOA_OBJC_CLASS(NSControl);
2430 DECLARE_WXCOCOA_OBJC_CLASS(NSCursor);
2431 DECLARE_WXCOCOA_OBJC_CLASS(NSEvent);
2432 DECLARE_WXCOCOA_OBJC_CLASS(NSFontPanel);
2433 DECLARE_WXCOCOA_OBJC_CLASS(NSImage);
2434 DECLARE_WXCOCOA_OBJC_CLASS(NSLayoutManager);
2435 DECLARE_WXCOCOA_OBJC_CLASS(NSMenu);
2436 DECLARE_WXCOCOA_OBJC_CLASS(NSMenuExtra);
2437 DECLARE_WXCOCOA_OBJC_CLASS(NSMenuItem);
2438 DECLARE_WXCOCOA_OBJC_CLASS(NSMutableArray);
2439 DECLARE_WXCOCOA_OBJC_CLASS(NSNotification);
2440 DECLARE_WXCOCOA_OBJC_CLASS(NSObject);
2441 DECLARE_WXCOCOA_OBJC_CLASS(NSPanel);
2442 DECLARE_WXCOCOA_OBJC_CLASS(NSScrollView);
2443 DECLARE_WXCOCOA_OBJC_CLASS(NSSound);
2444 DECLARE_WXCOCOA_OBJC_CLASS(NSStatusItem);
2445 DECLARE_WXCOCOA_OBJC_CLASS(NSTableColumn);
2446 DECLARE_WXCOCOA_OBJC_CLASS(NSTableView);
2447 DECLARE_WXCOCOA_OBJC_CLASS(NSTextContainer);
2448 DECLARE_WXCOCOA_OBJC_CLASS(NSTextField);
2449 DECLARE_WXCOCOA_OBJC_CLASS(NSTextStorage);
2450 DECLARE_WXCOCOA_OBJC_CLASS(NSThread);
2451 DECLARE_WXCOCOA_OBJC_CLASS(NSWindow);
2452 DECLARE_WXCOCOA_OBJC_CLASS(NSView);
2453 typedef WX_NSView WXWidget; /*  wxWidgets BASE definition */
2454 #endif /*  __WXCOCOA__ */
2455
2456 #if defined(__WXPALMOS__)
2457
2458 typedef void *          WXHWND;
2459 typedef void *          WXHANDLE;
2460 typedef void *          WXHICON;
2461 typedef void *          WXHFONT;
2462 typedef void *          WXHMENU;
2463 typedef void *          WXHPEN;
2464 typedef void *          WXHBRUSH;
2465 typedef void *          WXHPALETTE;
2466 typedef void *          WXHCURSOR;
2467 typedef void *          WXHRGN;
2468 typedef void *          WXHACCEL;
2469 typedef void *          WXHINSTANCE;
2470 typedef void *          WXHBITMAP;
2471 typedef void *          WXHIMAGELIST;
2472 typedef void *          WXHGLOBAL;
2473 typedef void *          WXHDC;
2474 typedef unsigned int    WXUINT;
2475 typedef unsigned long   WXDWORD;
2476 typedef unsigned short  WXWORD;
2477
2478 typedef unsigned long   WXCOLORREF;
2479 typedef struct tagMSG   WXMSG;
2480
2481 typedef WXHWND          WXWINHANDLE; /* WinHandle of PalmOS */
2482 typedef WXWINHANDLE     WXWidget;
2483
2484 typedef void *          WXFORMPTR;
2485 typedef void *          WXEVENTPTR;
2486 typedef void *          WXRECTANGLEPTR;
2487
2488 #endif /* __WXPALMOS__ */
2489
2490
2491 /* ABX: check __WIN32__ instead of __WXMSW__ for the same MSWBase in any Win32 port */
2492 #if defined(__WIN32__)
2493
2494 /*  the keywords needed for WinMain() declaration */
2495 #ifndef WXFAR
2496 #    define WXFAR
2497 #endif
2498
2499 /*  Stand-ins for Windows types to avoid #including all of windows.h */
2500 typedef void *          WXHWND;
2501 typedef void *          WXHANDLE;
2502 typedef void *          WXHICON;
2503 typedef void *          WXHFONT;
2504 typedef void *          WXHMENU;
2505 typedef void *          WXHPEN;
2506 typedef void *          WXHBRUSH;
2507 typedef void *          WXHPALETTE;
2508 typedef void *          WXHCURSOR;
2509 typedef void *          WXHRGN;
2510 typedef void *          WXRECTPTR;
2511 typedef void *          WXHACCEL;
2512 typedef void WXFAR  *   WXHINSTANCE;
2513 typedef void *          WXHBITMAP;
2514 typedef void *          WXHIMAGELIST;
2515 typedef void *          WXHGLOBAL;
2516 typedef void *          WXHDC;
2517 typedef unsigned int    WXUINT;
2518 typedef unsigned long   WXDWORD;
2519 typedef unsigned short  WXWORD;
2520
2521 typedef unsigned long   WXCOLORREF;
2522 typedef void *          WXRGNDATA;
2523 typedef struct tagMSG   WXMSG;
2524 typedef void *          WXHCONV;
2525 typedef void *          WXHKEY;
2526 typedef void *          WXHTREEITEM;
2527
2528 typedef void *          WXDRAWITEMSTRUCT;
2529 typedef void *          WXMEASUREITEMSTRUCT;
2530 typedef void *          WXLPCREATESTRUCT;
2531
2532 typedef WXHWND          WXWidget;
2533
2534 #ifdef __WIN64__
2535 typedef unsigned __int64    WXWPARAM;
2536 typedef __int64            WXLPARAM;
2537 typedef __int64            WXLRESULT;
2538 #else
2539 typedef unsigned int    WXWPARAM;
2540 typedef long            WXLPARAM;
2541 typedef long            WXLRESULT;
2542 #endif
2543
2544 #if defined(__GNUWIN32__) || defined(__WXMICROWIN__)
2545 typedef int             (*WXFARPROC)();
2546 #else
2547 typedef int             (__stdcall *WXFARPROC)();
2548 #endif
2549 #endif /*  __WIN32__ */
2550
2551
2552 #if defined(__WXPM__) || defined(__EMX__)
2553 #ifdef __WXPM__
2554 /*  Stand-ins for OS/2 types, to avoid #including all of os2.h */
2555 typedef unsigned long   WXHWND;
2556 typedef unsigned long   WXHANDLE;
2557 typedef unsigned long   WXHICON;
2558 typedef unsigned long   WXHFONT;
2559 typedef unsigned long   WXHMENU;
2560 typedef unsigned long   WXHPEN;
2561 typedef unsigned long   WXHBRUSH;
2562 typedef unsigned long   WXHPALETTE;
2563 typedef unsigned long   WXHCURSOR;
2564 typedef unsigned long   WXHRGN;
2565 typedef unsigned long   WXHACCEL;
2566 typedef unsigned long   WXHBITMAP;
2567 typedef unsigned long   WXHDC;
2568 typedef unsigned int    WXUINT;
2569 typedef unsigned long   WXDWORD;
2570 typedef unsigned short  WXWORD;
2571
2572 typedef unsigned long   WXCOLORREF;
2573 typedef void *          WXMSG;
2574 typedef unsigned long   WXHTREEITEM;
2575
2576 typedef void *          WXDRAWITEMSTRUCT;
2577 typedef void *          WXMEASUREITEMSTRUCT;
2578 typedef void *          WXLPCREATESTRUCT;
2579
2580 typedef WXHWND          WXWidget;
2581 #endif
2582 #ifdef __EMX__
2583 /* Need a well-known type for WXFARPROC
2584    below. MPARAM is typedef'ed too late. */
2585 #define WXWPARAM        void *
2586 #define WXLPARAM        void *
2587 #else
2588 #define WXWPARAM        MPARAM
2589 #define WXLPARAM        MPARAM
2590 #endif
2591 #define RECT            RECTL
2592 #define LOGFONT         FATTRS
2593 #define LOWORD          SHORT1FROMMP
2594 #define HIWORD          SHORT2FROMMP
2595
2596 typedef unsigned long   WXMPARAM;
2597 typedef unsigned long   WXMSGID;
2598 typedef void*           WXRESULT;
2599 /* typedef int             (*WXFARPROC)(); */
2600 /*  some windows handles not defined by PM */
2601 typedef unsigned long   HANDLE;
2602 typedef unsigned long   HICON;
2603 typedef unsigned long   HFONT;
2604 typedef unsigned long   HMENU;
2605 typedef unsigned long   HPEN;
2606 typedef unsigned long   HBRUSH;
2607 typedef unsigned long   HPALETTE;
2608 typedef unsigned long   HCURSOR;
2609 typedef unsigned long   HINSTANCE;
2610 typedef unsigned long   HIMAGELIST;
2611 typedef unsigned long   HGLOBAL;
2612 typedef unsigned long   DWORD;
2613 typedef unsigned short  WORD;
2614 #endif /*  WXPM || EMX */
2615
2616 #if defined (__WXPM__)
2617 /*  WIN32 graphics types for OS/2 GPI */
2618
2619 /*  RGB under OS2 is more like a PALETTEENTRY struct under Windows so we need a real RGB def */
2620 /*  WARNING: The OS/2 headers typedef BYTE simply as 'char'; if the default is signed, all */
2621 /*  hell will break loose! */
2622 /* #define OS2RGB(r,g,b) ((DWORD ((BYTE) (b) | ((WORD) (g) << 8)) | (((DWORD)(BYTE)(r)) << 16))) */
2623 #define OS2RGB(r,g,b) ((DWORD)((unsigned char)(b) | ((unsigned char)(g) << 8)) | ((unsigned char)(r) << 16))
2624
2625 typedef unsigned long COLORREF;
2626 #define GetBValue(rgb) ((BYTE)((rgb) >> 16))
2627 #define GetGValue(rgb) ((BYTE)(((WORD)(rgb)) >> 8))
2628 #define GetRValue(rgb) ((BYTE)(rgb))
2629 #define PALETTEINDEX(i) ((COLORREF)(0x01000000 | (DWORD)(WORD)(i)))
2630 #define PALETTERGB(r,g,b) (0x02000000 | OS2RGB(r,g,b))
2631 /*  OS2's RGB/RGB2 is backwards from this */
2632 typedef struct tagPALETTEENTRY
2633 {
2634     char bRed;
2635     char bGreen;
2636     char bBlue;
2637     char bFlags;
2638 } PALETTEENTRY;
2639 typedef struct tagLOGPALETTE
2640 {
2641     WORD palVersion;
2642     WORD palNumentries;
2643     WORD PALETTEENTRY[1];
2644 } LOGPALETTE;
2645
2646 #if (defined(__VISAGECPP__) && (__IBMCPP__ < 400)) || defined (__WATCOMC__)
2647     /*  VA 3.0 for some reason needs base data types when typedefing a proc proto??? */
2648 typedef void* (_System *WXFARPROC)(unsigned long, unsigned long, void*, void*);
2649 #else
2650 #if defined(__EMX__) && !defined(_System)
2651 #define _System
2652 #endif
2653 typedef WXRESULT (_System *WXFARPROC)(WXHWND, WXMSGID, WXWPARAM, WXLPARAM);
2654 #endif
2655
2656 #endif /* __WXPM__ */
2657
2658
2659 #if defined(__WXMOTIF__) || defined(__WXX11__)
2660 /* Stand-ins for X/Xt/Motif types */
2661 typedef void*           WXWindow;
2662 typedef void*           WXWidget;
2663 typedef void*           WXAppContext;
2664 typedef void*           WXColormap;
2665 typedef void*           WXColor;
2666 typedef void            WXDisplay;
2667 typedef void            WXEvent;
2668 typedef void*           WXCursor;
2669 typedef void*           WXPixmap;
2670 typedef void*           WXFontStructPtr;
2671 typedef void*           WXGC;
2672 typedef void*           WXRegion;
2673 typedef void*           WXFont;
2674 typedef void*           WXImage;
2675 typedef void*           WXFontList;
2676 typedef void*           WXFontSet;
2677 typedef void*           WXRendition;
2678 typedef void*           WXRenderTable;
2679 typedef void*           WXFontType; /* either a XmFontList or XmRenderTable */
2680 typedef void*           WXString;
2681
2682 typedef unsigned long   Atom;  /* this might fail on a few architectures */
2683
2684 #endif /*  Motif */
2685
2686 #ifdef __WXGTK__
2687
2688 /* Stand-ins for GLIB types */
2689 typedef char           gchar;
2690 typedef signed char    gint8;
2691 typedef int            gint;
2692 typedef unsigned       guint;
2693 typedef unsigned long  gulong;
2694 typedef void*          gpointer;
2695 typedef struct _GSList GSList;
2696
2697 /* Stand-ins for GDK types */
2698 typedef struct _GdkColor        GdkColor;
2699 typedef struct _GdkColormap     GdkColormap;
2700 typedef struct _GdkFont         GdkFont;
2701 typedef struct _GdkGC           GdkGC;
2702 typedef struct _GdkVisual       GdkVisual;
2703
2704 #ifdef __WXGTK20__
2705 typedef struct _GdkAtom        *GdkAtom;
2706 typedef struct _GdkDrawable     GdkWindow;
2707 typedef struct _GdkDrawable     GdkBitmap;
2708 typedef struct _GdkDrawable     GdkPixmap;
2709 #else /*  GTK+ 1.2 */
2710 typedef gulong                  GdkAtom;
2711 typedef struct _GdkWindow       GdkWindow;
2712 typedef struct _GdkWindow       GdkBitmap;
2713 typedef struct _GdkWindow       GdkPixmap;
2714 #endif /*  GTK+ 1.2/2.0 */
2715
2716 typedef struct _GdkCursor       GdkCursor;
2717 typedef struct _GdkRegion       GdkRegion;
2718 typedef struct _GdkDragContext  GdkDragContext;
2719
2720 #ifdef HAVE_XIM
2721 typedef struct _GdkIC           GdkIC;
2722 typedef struct _GdkICAttr       GdkICAttr;
2723 #endif
2724
2725 /* Stand-ins for GTK types */
2726 typedef struct _GtkWidget         GtkWidget;
2727 typedef struct _GtkRcStyle        GtkRcStyle;
2728 typedef struct _GtkAdjustment     GtkAdjustment;
2729 typedef struct _GtkList           GtkList;
2730 typedef struct _GtkToolbar        GtkToolbar;
2731 typedef struct _GtkTooltips       GtkTooltips;
2732 typedef struct _GtkNotebook       GtkNotebook;
2733 typedef struct _GtkNotebookPage   GtkNotebookPage;
2734 typedef struct _GtkAccelGroup     GtkAccelGroup;
2735 typedef struct _GtkItemFactory    GtkItemFactory;
2736 typedef struct _GtkSelectionData  GtkSelectionData;
2737 typedef struct _GtkTextBuffer     GtkTextBuffer;
2738
2739 typedef GtkWidget *WXWidget;
2740
2741 #ifndef __WXGTK20__
2742 #define GTK_OBJECT_GET_CLASS(object) (GTK_OBJECT(object)->klass)
2743 #define GTK_CLASS_TYPE(klass) ((klass)->type)
2744 #endif
2745
2746 #endif /*  __WXGTK__ */
2747
2748 #if defined(__WXGTK20__) || (defined(__WXX11__) && wxUSE_UNICODE)
2749 #define wxUSE_PANGO 1
2750 #else
2751 #define wxUSE_PANGO 0
2752 #endif
2753
2754 #if wxUSE_PANGO
2755 /* Stand-ins for Pango types */
2756 typedef struct _PangoContext         PangoContext;
2757 typedef struct _PangoLayout          PangoLayout;
2758 typedef struct _PangoFontDescription PangoFontDescription;
2759 #endif
2760
2761 #ifdef __WXMGL__
2762 typedef struct window_t *WXWidget;
2763 #endif /*  MGL */
2764
2765 /*  This is required because of clashing macros in windows.h, which may be */
2766 /*  included before or after wxWidgets classes, and therefore must be */
2767 /*  disabled here before any significant wxWidgets headers are included. */
2768 #ifdef __WXMSW__
2769 #ifdef GetClassInfo
2770 #undef GetClassInfo
2771 #endif
2772
2773 #ifdef GetClassName
2774 #undef GetClassName
2775 #endif
2776
2777 #ifdef DrawText
2778 #undef DrawText
2779 #endif
2780
2781 #ifdef GetCharWidth
2782 #undef GetCharWidth
2783 #endif
2784
2785 #ifdef StartDoc
2786 #undef StartDoc
2787 #endif
2788
2789 #ifdef FindWindow
2790 #undef FindWindow
2791 #endif
2792
2793 #ifdef FindResource
2794 #undef FindResource
2795 #endif
2796 #endif
2797   /*  __WXMSW__ */
2798
2799 /*  --------------------------------------------------------------------------- */
2800 /*  macro to define a class without copy ctor nor assignment operator */
2801 /*  --------------------------------------------------------------------------- */
2802
2803 #define DECLARE_NO_COPY_CLASS(classname)        \
2804     private:                                    \
2805         classname(const classname&);            \
2806         classname& operator=(const classname&);
2807
2808 #define DECLARE_NO_ASSIGN_CLASS(classname)      \
2809     private:                                    \
2810         classname& operator=(const classname&);
2811
2812 #endif
2813     /*  _WX_DEFS_H_ */