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