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