include/wx/defs.h

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