3 * Purpose: Declarations/definitions common to all wx source files
4 * Author: Julian Smart and others
5 * Modified by: Ryan Norton (Converted to C)
9 * Licence: wxWindows licence
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
17 /* ---------------------------------------------------------------------------- */
18 /* compiler and OS identification */
19 /* ---------------------------------------------------------------------------- */
21 #include "wx/platform.h"
23 /* RN - only double-check the environment when building in C++
24 Shouldn't configure pass the environment to all sub-libs too? */
26 /* Make sure the environment is set correctly */
27 # if defined(__WXMSW__) && defined(__X__)
28 # error "Target can't be both X and Windows"
29 # elif !defined(__WXMOTIF__) && \
30 !defined(__WXMSW__) && \
31 !defined(__WXGTK__) && \
32 !defined(__WXPM__) && \
33 !defined(__WXMAC__) && \
34 !defined(__WXCOCOA__) && \
36 !defined(__WXMGL__) && \
37 !defined(__WXX11__) && \
40 # error "No Target! You should use wx-config program for compilation flags!"
42 # error "No Target! You should use supplied makefiles for compilation!"
43 # endif /* Unix/!Unix */
45 #endif /*__cplusplus*/
48 #define __WXWINDOWS__ 1
52 /* by default consider that this is a monolithic build */
56 #if !wxUSE_GUI && !defined(__WXBASE__)
60 /* include the feature test macros */
61 #include "wx/features.h"
63 /* suppress some Visual C++ warnings */
65 /* the only "real" warning here is 4244 but there are just too many of them */
66 /* in our code... one day someone should go and fix them but until then... */
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:4710) /* function not inlined */
70 # pragma warning(disable:4097) /* typedef used as class */
71 # pragma warning(disable:4511) /* copy ctor couldn't be generated */
72 # pragma warning(disable:4512) /* operator=() couldn't be generated */
74 # pragma warning(disable:4135) /* conversion between different integral types */
75 # pragma warning(disable:4769) /* assignment of near pointer to long integer */
76 /* This one is really annoying, since it occurs for each cast to (HANDLE)... */
77 # pragma warning(disable:4305) /* truncation of long to near ptr */
79 #endif /* __VISUALC__ */
81 /* suppress some Salford C++ warnings */
83 # pragma suppress 353 /* Possible nested comments */
84 # pragma suppress 593 /* Define not used */
85 # pragma suppress 61 /* enum has no name (doesn't suppress!) */
86 # pragma suppress 106 /* unnamed, unused parameter */
87 # pragma suppress 571 /* Virtual function hiding */
88 #endif /* __SALFORDC__ */
90 /* suppress some Borland C++ warnings */
92 # pragma warn -inl /* Functions containing reserved words and certain constructs are not expanded inline */
93 #endif /* __BORLANDC__ */
95 /* ---------------------------------------------------------------------------- */
96 /* wxWidgets version and compatibility defines */
97 /* ---------------------------------------------------------------------------- */
99 #include "wx/version.h"
101 /* ============================================================================ */
102 /* non portable C++ features */
103 /* ============================================================================ */
105 /* ---------------------------------------------------------------------------- */
106 /* compiler defects workarounds */
107 /* ---------------------------------------------------------------------------- */
110 Digital Unix C++ compiler only defines this symbol for .cxx and .hxx files,
111 so define it ourselves (newer versions do it for all files, though, and
112 don't allow it to be redefined)
114 #if defined(__DECCXX) && !defined(__VMS) && !defined(__cplusplus)
116 #endif /* __DECCXX */
118 /* Resolves linking problems under HP-UX when compiling with gcc/g++ */
119 #if defined(__HPUX__) && defined(__GNUG__)
120 #define va_list __gnuc_va_list
123 /* ---------------------------------------------------------------------------- */
124 /* check for native bool type and TRUE/FALSE constants */
125 /* ---------------------------------------------------------------------------- */
127 /* Add more tests here for Windows compilers that already define bool */
128 /* (under Unix, configure tests for this) */
130 #if defined( __MWERKS__ )
131 #if (__MWERKS__ >= 0x1000) && __option(bool)
134 #elif defined(__APPLE__) && defined(__APPLE_CC__)
135 /* Apple bundled gcc supports bool */
137 #elif defined(__VISUALC__) && (__VISUALC__ == 1020)
138 /* in VC++ 4.2 the bool keyword is reserved (hence can't be typedefed) */
139 /* but not implemented, so we must #define it */
140 #define bool unsigned int
141 #elif defined(__VISUALC__) && (__VISUALC__ == 1010)
142 /* For VisualC++ 4.1, we need to define */
143 /* bool as something between 4.0 & 5.0... */
144 typedef unsigned int wxbool
;
147 #elif defined(__VISUALC__) && (__VISUALC__ > 1020)
148 /* VC++ supports bool since 4.2 */
150 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x500)
151 /* Borland 5.0+ supports bool */
153 #elif defined(__WATCOMC__) && (__WATCOMC__ >= 1100)
154 /* Watcom 11+ supports bool */
156 #elif defined(__DIGITALMARS__)
157 /* DigitalMars supports bool */
159 #elif defined(__GNUWIN32__) || defined(__MINGW32__) || defined(__CYGWIN__)
160 /* Cygwin supports bool */
162 #elif defined(__VISAGECPP__)
164 typedef unsigned long bool;
165 #define true ((bool)1)
166 #define false ((bool)0)
169 #endif /* compilers */
170 #endif /* HAVE_BOOL */
172 #if !defined(HAVE_BOOL) && !defined(bool) && !defined(VMS)
173 /* NB: of course, this doesn't replace the standard type, because, for */
174 /* example, overloading based on bool/int parameter doesn't work and */
175 /* so should be avoided in portable programs */
176 typedef unsigned int bool;
179 /* deal with TRUE/true stuff: we assume that if the compiler supports bool, it */
180 /* supports true/false as well and that, OTOH, if it does _not_ support bool, */
181 /* it doesn't support these keywords (this is less sure, in particular VC++ */
182 /* 4.x could be a problem here) */
184 #define true ((bool)1)
185 #define false ((bool)0)
188 /* for backwards compatibility, also define TRUE and FALSE */
190 /* note that these definitions should work both in C++ and C code, so don't */
191 /* use true/false below */
200 typedef short int WXTYPE
;
202 /* special care should be taken with this type under Windows where the real */
203 /* window id is unsigned, so we must always do the cast before comparing them */
204 /* (or else they would be always different!). Using wxGetWindowId() which does */
205 /* the cast itself is recommended. Note that this type can't be unsigned */
206 /* because wxID_ANY == -1 is a valid (and largely used) value for window id. */
207 typedef int wxWindowID
;
209 /* ---------------------------------------------------------------------------- */
210 /* other feature tests */
211 /* ---------------------------------------------------------------------------- */
213 /* Every ride down a slippery slope begins with a single step.. */
215 /* Yes, using nested classes is indeed against our coding standards in */
216 /* general, but there are places where you can use them to advantage */
217 /* without totally breaking ports that cannot use them. If you do, then */
218 /* wrap it in this guard, but such cases should still be relatively rare. */
219 #define wxUSE_NESTED_CLASSES 1
221 /* check for explicit keyword support */
222 #ifndef HAVE_EXPLICIT
223 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
224 /* VC++ 6.0 and 5.0 have explicit (what about earlier versions?) */
225 #define HAVE_EXPLICIT
226 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
227 && wxCHECK_GCC_VERSION(2, 95)
228 /* GCC 2.95 has explicit, what about earlier versions? */
229 #define HAVE_EXPLICIT
230 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x0520)
231 /* BC++ 4.52 doesn't support explicit, CBuilder 1 does */
232 #define HAVE_EXPLICIT
233 #elif defined(__MWERKS__) && (__MWERKS__ >= 0x2400)
234 /* Metrowerks CW6 or higher has explicit */
235 #define HAVE_EXPLICIT
236 #elif defined(__DIGITALMARS__)
237 #define HAVE_EXPLICIT
239 #endif /* !HAVE_EXPLICIT */
242 #define wxEXPLICIT explicit
243 #else /* !HAVE_EXPLICIT */
245 #endif /* HAVE_EXPLICIT/!HAVE_EXPLICIT */
247 /* check for static/const_cast<>() (we don't use the other ones for now) */
248 #ifndef HAVE_CXX_CASTS
249 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
250 /* VC++ 6.0 and 5.0 have C++ casts (what about earlier versions?) */
251 #define HAVE_CXX_CASTS
252 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
253 && wxCHECK_GCC_VERSION(2, 95)
254 /* GCC 2.95 has C++ casts, what about earlier versions? */
255 #define HAVE_CXX_CASTS
257 #endif /* !HAVE_CXX_CASTS */
259 #ifdef HAVE_CXX_CASTS
260 #ifndef HAVE_CONST_CAST
261 #define HAVE_CONST_CAST
263 #ifndef HAVE_REINTERPRET_CAST
264 #define HAVE_REINTERPRET_CAST
266 #ifndef HAVE_STATIC_CAST
267 #define HAVE_STATIC_CAST
269 #endif /* HAVE_CXX_CASTS */
271 #ifdef HAVE_STATIC_CAST
272 #define wx_static_cast(t, x) static_cast<t>(x)
274 #define wx_static_cast(t, x) ((t)(x))
277 #ifdef HAVE_CONST_CAST
278 #define wx_const_cast(t, x) const_cast<t>(x)
280 #define wx_const_cast(t, x) ((t)(x))
283 #ifdef HAVE_REINTERPRET_CAST
284 #define wx_reinterpret_cast(t, x) reinterpret_cast<t>(x)
286 #define wx_reinterpret_cast(t, x) ((t)(x))
289 /* for consistency with wxStatic/DynamicCast defined in wx/object.h */
290 #define wxConstCast(obj, className) wx_const_cast(className *, obj)
292 #ifndef HAVE_STD_WSTRING
293 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
294 /* VC++ 6.0 and 5.0 have std::wstring (what about earlier versions?) */
295 #define HAVE_STD_WSTRING
296 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
297 && wxCHECK_GCC_VERSION(3, 1)
298 /* GCC 3.1 has std::wstring; 3.0 never was in MinGW, 2.95 hasn't it */
299 #define HAVE_STD_WSTRING
303 #ifndef HAVE_STD_STRING_COMPARE
304 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
305 /* VC++ 6.0 and 5.0 have std::string::compare */
306 /* (what about earlier versions?) */
307 #define HAVE_STD_STRING_COMPARE
308 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
309 && wxCHECK_GCC_VERSION(3, 1)
310 /* GCC 3.1 has std::string::compare; */
311 /* 3.0 never was in MinGW, 2.95 hasn't it */
312 #define HAVE_STD_STRING_COMPARE
316 /* provide replacement for C99 va_copy() if the compiler doesn't have it */
318 /* could be already defined by configure or the user */
320 /* if va_copy is a macro or configure detected that we have it, use it */
321 #if defined(va_copy) || defined(HAVE_VA_COPY)
322 #define wxVaCopy va_copy
323 #else /* no va_copy, try to provide a replacement */
325 configure tries to determine whether va_list is an array or struct
326 type, but it may not be used under Windows, so deal with a few
331 /* Watcom uses array type for va_list except for PPC and Alpha */
332 #if !defined(__PPC__) && !defined(__AXP__)
333 #define VA_LIST_IS_ARRAY
335 #endif /* __WATCOMC__ */
337 #if defined(__PPC__) && (defined(_CALL_SYSV) || defined (_WIN32))
339 PPC using SysV ABI and NT/PPC are special in that they use an
340 extra level of indirection.
342 #define VA_LIST_IS_POINTER
343 #endif /* SysV or Win32 on __PPC__ */
346 note that we use memmove(), not memcpy(), in case anybody tries
347 to do wxVaCopy(ap, ap)
349 #if defined(VA_LIST_IS_POINTER)
350 #define wxVaCopy(d, s) memmove(*(d), *(s), sizeof(va_list))
351 #elif defined(VA_LIST_IS_ARRAY)
352 #define wxVaCopy(d, s) memmove((d), (s), sizeof(va_list))
353 #else /* we can only hope that va_lists are simple lvalues */
354 #define wxVaCopy(d, s) ((d) = (s))
356 #endif /* va_copy/!va_copy */
360 /* ---------------------------------------------------------------------------- */
361 /* portable calling conventions macros */
362 /* ---------------------------------------------------------------------------- */
364 /* stdcall is used for all functions called by Windows under Windows */
365 #if defined(__WINDOWS__)
366 #if defined(__GNUWIN32__)
367 #define wxSTDCALL __attribute__((stdcall))
369 /* both VC++ and Borland understand this */
370 #define wxSTDCALL _stdcall
374 /* no such stupidness under Unix */
376 #endif /* platform */
378 /* LINKAGEMODE mode is empty for everyting except OS/2 */
381 #endif /* LINKAGEMODE */
383 /* wxCALLBACK should be used for the functions which are called back by */
384 /* Windows (such as compare function for wxListCtrl) */
385 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
386 #define wxCALLBACK wxSTDCALL
388 /* no stdcall under Unix nor Win16 */
390 #endif /* platform */
392 /* generic calling convention for the extern "C" functions */
394 #if defined(__VISUALC__)
395 #define wxC_CALLING_CONV _cdecl
396 #elif defined(__VISAGECPP__)
397 #define wxC_CALLING_CONV _Optlink
398 #else /* !Visual C++ */
399 #define wxC_CALLING_CONV
400 #endif /* compiler */
402 /* callling convention for the qsort(3) callback */
403 #define wxCMPFUNC_CONV wxC_CALLING_CONV
405 /* compatibility :-( */
406 #define CMPFUNC_CONV wxCMPFUNC_CONV
408 /* DLL import/export declarations */
409 #include "wx/dlimpexp.h"
411 /* ---------------------------------------------------------------------------- */
412 /* Very common macros */
413 /* ---------------------------------------------------------------------------- */
415 /* Printf-like attribute definitions to obtain warnings with GNU C/C++ */
416 #if defined(__GNUC__) && !wxUSE_UNICODE
417 # ifndef ATTRIBUTE_PRINTF
418 # define ATTRIBUTE_PRINTF(m, n) __attribute__ ((__format__ (__printf__, m, n)))
419 # define ATTRIBUTE_PRINTF_1 ATTRIBUTE_PRINTF(1, 2)
420 # define ATTRIBUTE_PRINTF_2 ATTRIBUTE_PRINTF(2, 3)
421 # define ATTRIBUTE_PRINTF_3 ATTRIBUTE_PRINTF(3, 4)
422 # define ATTRIBUTE_PRINTF_4 ATTRIBUTE_PRINTF(4, 5)
423 # define ATTRIBUTE_PRINTF_5 ATTRIBUTE_PRINTF(5, 6)
424 # endif /* ATTRIBUTE_PRINTF */
426 # ifndef ATTRIBUTE_PRINTF
427 # define ATTRIBUTE_PRINTF
428 # define ATTRIBUTE_PRINTF_1
429 # define ATTRIBUTE_PRINTF_2
430 # define ATTRIBUTE_PRINTF_3
431 # define ATTRIBUTE_PRINTF_4
432 # define ATTRIBUTE_PRINTF_5
433 # endif /* ATTRIBUTE_PRINTF */
436 /* Macro to issue warning when using deprecated functions with gcc3 or MSVC7: */
437 #if wxCHECK_GCC_VERSION(3, 1)
438 #define wxDEPRECATED(x) x __attribute__ ((deprecated))
439 #elif defined(__VISUALC__) && (__VISUALC__ >= 1300)
440 #define wxDEPRECATED(x) __declspec(deprecated) x
442 #define wxDEPRECATED(x) x
445 /* everybody gets the assert and other debug macros */
446 #include "wx/debug.h"
448 /* NULL declaration: it must be defined as 0 for C++ programs (in particular, */
449 /* it must not be defined as "(void *)0" which is standard for C but completely */
450 /* breaks C++ code) */
451 #ifndef __HANDHELDPC__
455 /* delete pointer if it is not NULL and NULL it afterwards */
456 /* (checking that it's !NULL before passing it to delete is just a */
457 /* a question of style, because delete will do it itself anyhow, but it might */
458 /* be considered as an error by some overzealous debugging implementations of */
459 /* the library, so we do it ourselves) */
460 #define wxDELETE(p) if ( (p) != NULL ) { delete p; p = NULL; }
462 /* delete an array and NULL it (see comments above) */
463 #define wxDELETEA(p) if ( (p) ) { delete [] (p); p = NULL; }
465 /* size of statically declared array */
466 #define WXSIZEOF(array) (sizeof(array)/sizeof(array[0]))
468 /* helper macros to concatenate two tokens together */
469 #define wxCONCAT_HELPER(text, line) text ## line
470 #define wxCONCAT(text, line) wxCONCAT_HELPER(text, line)
472 /* helper macros to be able to define unique/anonymous objects: this works by */
473 /* appending the current line number to the given identifier to reduce the */
474 /* probability of the conflict (it may still happen if this is used in the */
475 /* headers, hence you should avoid doing it or provide unique prefixes then) */
476 #if defined(__VISUALC__) && (__VISUALC__ >= 1300)
478 __LINE__ handling is completely broken in VC++ when using "Edit and
479 Continue" (/ZI option) and results in preprocessor errors if we use it
480 inside the macros. Luckily VC7 has another standard macro which can be
481 used like this and is even better than __LINE__ because it is globally
484 # define wxCONCAT_LINE(text) wxCONCAT(text, __COUNTER__)
485 #else /* normal compilers */
486 # define wxCONCAT_LINE(text) wxCONCAT(text, __LINE__)
488 #define wxMAKE_UNIQUE_NAME(text) wxCONCAT_LINE(text)
490 /* symbolic constant used by all Find()-like functions returning positive */
491 /* integer on success as failure indicator */
492 #define wxNOT_FOUND (-1)
494 /* ---------------------------------------------------------------------------- */
495 /* macros to avoid compiler warnings */
496 /* ---------------------------------------------------------------------------- */
498 /* Macro to cut down on compiler warnings. */
499 #if 1 /* there should be no more any compilers needing the "#else" version */
500 #define WXUNUSED(identifier) /* identifier */
501 #else /* stupid, broken compiler */
502 #define WXUNUSED(identifier) identifier
505 /* some arguments are only used in debug mode, but unused in release one */
507 #define WXUNUSED_UNLESS_DEBUG(param) param
509 #define WXUNUSED_UNLESS_DEBUG(param) WXUNUSED(param)
512 /* some compilers give warning about a possibly unused variable if it is */
513 /* initialized in both branches of if/else and shut up if it is initialized */
514 /* when declared, but other compilers then give warnings about unused variable */
515 /* value -- this should satisfy both of them */
516 #if defined(__VISUALC__)
517 #define wxDUMMY_INITIALIZE(val) = val
519 #define wxDUMMY_INITIALIZE(val)
522 /* sometimes the value of a variable is *really* not used, to suppress the */
523 /* resulting warning you may pass it to this function */
526 # define wxUnusedVar(identifier) identifier
529 inline void wxUnusedVar(const T
& WXUNUSED(t
)) { }
533 /* ---------------------------------------------------------------------------- */
534 /* compiler specific settings */
535 /* ---------------------------------------------------------------------------- */
537 /* to allow compiling with warning level 4 under Microsoft Visual C++ some */
538 /* warnings just must be disabled */
540 #pragma warning(disable: 4514) /* unreferenced inline func has been removed */
542 you might be tempted to disable this one also: triggered by CHECK and FAIL
543 macros in debug.h, but it's, overall, a rather useful one, so I leave it and
544 will try to find some way to disable this warning just for CHECK/FAIL. Anyone?
546 #pragma warning(disable: 4127) /* conditional expression is constant */
549 #if defined(__MWERKS__)
553 #define except(x) catch(...)
554 #endif /* Metrowerks */
556 #if defined(__WATCOMC__)
557 typedef short mode_t
;
560 /* where should i put this? we need to make sure of this as it breaks */
561 /* the <iostream> code. */
562 #if !wxUSE_IOSTREAMH && defined(__WXDEBUG__)
564 /* #undef __WXDEBUG__ */
565 # ifdef wxUSE_DEBUG_NEW_ALWAYS
566 # undef wxUSE_DEBUG_NEW_ALWAYS
567 # define wxUSE_DEBUG_NEW_ALWAYS 0
572 /* ---------------------------------------------------------------------------- */
573 /* OS mnemonics -- Identify the running OS (useful for Windows) */
574 /* ---------------------------------------------------------------------------- */
576 /* Not all platforms are currently available or supported */
580 wxCURSES
, /* Text-only CURSES */
581 wxXVIEW_X
, /* Sun's XView OpenLOOK toolkit */
582 wxMOTIF_X
, /* OSF Motif 1.x.x */
583 wxCOSE_X
, /* OSF Common Desktop Environment */
584 wxNEXTSTEP
, /* NeXTStep */
585 wxMAC
, /* Apple Mac OS 8/9/X with Mac paths */
586 wxMAC_DARWIN
, /* Apple Mac OS X with Unix paths */
588 wxGTK
, /* GTK on X */
589 wxGTK_WIN32
, /* GTK on Win32 */
590 wxGTK_OS2
, /* GTK on OS/2 */
591 wxGTK_BEOS
, /* GTK on BeOS */
593 wxOS2_PM
, /* OS/2 Workplace */
594 wxWINDOWS
, /* Windows or WfW */
595 wxMICROWINDOWS
, /* MicroWindows */
596 wxPENWINDOWS
, /* Windows for Pen Computing */
597 wxWINDOWS_NT
, /* Windows NT */
598 wxWIN32S
, /* Windows 32S API */
599 wxWIN95
, /* Windows 95 */
600 wxWIN386
, /* Watcom 32-bit supervisor modus */
601 wxWINDOWS_CE
, /* Windows CE */
602 wxMGL_UNIX
, /* MGL with direct hardware access */
603 wxMGL_X
, /* MGL on X */
604 wxMGL_WIN32
, /* MGL on Win32 */
605 wxMGL_OS2
, /* MGL on OS/2 */
606 wxMGL_DOS
, /* MGL on MS-DOS */
607 wxWINDOWS_OS2
, /* Native OS/2 PM */
608 wxUNIX
, /* wxBase under Unix */
609 wxX11
/* Plain X11 and Universal widgets */
612 /* ---------------------------------------------------------------------------- */
613 /* standard wxWidgets types */
614 /* ---------------------------------------------------------------------------- */
616 /* the type for screen and DC coordinates */
618 #if wxUSE_COMPATIBLE_COORD_TYPES
619 /* to ensure compatibility with 2.0, we must use long */
621 #else /* !wxUSE_COMPATIBLE_COORD_TYPES */
622 /* other platforms we support have at least 32bit int - quite enough */
624 #endif /* wxUSE_COMPATIBLE_COORD_TYPES/!wxUSE_COMPATIBLE_COORD_TYPES */
626 enum { wxDefaultCoord
= -1 };
628 /* ---------------------------------------------------------------------------- */
629 /* define fixed length types */
630 /* ---------------------------------------------------------------------------- */
632 /* chars are always one byte (by definition), shorts are always two (in */
637 #define SIZEOF_CHAR 1
639 typedef signed char wxInt8
;
640 typedef unsigned char wxUint8
;
641 typedef wxUint8 wxByte
;
646 #if SIZEOF_SHORT != 2
647 #error "wxWidgets assumes sizeof(short) == 2, please fix the code"
650 #define SIZEOF_SHORT 2
653 typedef signed short wxInt16
;
654 typedef unsigned short wxUint16
;
656 typedef wxUint16 wxWord
;
659 things are getting more interesting with ints, longs and pointers
661 there are several different standard data models described by this table:
663 +-----------+----------------------------+
664 |type\model | LP64 ILP64 LLP64 ILP32 LP32|
665 +-----------+----------------------------+
667 |short | 16 16 16 16 16 |
668 |int | 32 64 32 32 16 |
669 |long | 64 64 32 32 32 |
671 |void * | 64 64 64 32 32 |
672 +-----------+----------------------------+
674 Win16 used LP32 (but we don't support it any longer), Win32 obviously used
675 ILP32 and Win64 uses LLP64 (a.k.a. P64)
677 Under Unix LP64 is the most widely used (the only I've ever seen, in fact)
682 /* Win64 uses LLP64 model and so ints and longs have the same size as in */
684 #if defined(__WIN32__)
686 typedef unsigned int wxUint32
;
688 /* conside that if SIZEOF_INT is defined, all the other ones are too */
691 #define SIZEOF_LONG 4
692 #define SIZEOF_WCHAR_T 2
695 under Win64 sizeof(size_t) == 8 and so it is neither unsigned
696 int nor unsigned long!
699 #define SIZEOF_SIZE_T 8
701 #undef wxSIZE_T_IS_UINT
703 #define SIZEOF_SIZE_T 4
705 #define wxSIZE_T_IS_UINT
707 #undef wxSIZE_T_IS_ULONG
710 #define SIZEOF_VOID_P 8
712 #define SIZEOF_VOID_P 4
713 #endif /* Win64/32 */
714 #endif /* !defined(SIZEOF_INT) */
716 #error "Unsupported Windows version"
719 /* SIZEOF_XXX are normally defined by configure */
722 /* must be ILP64 data model, there is normally a special 32 bit */
723 /* type in it but we don't know what it is... */
724 #error "No 32bit int type on this platform"
725 #elif SIZEOF_INT == 4
727 typedef unsigned int wxUint32
;
728 #elif SIZEOF_INT == 2
731 #error "No 32bit int type on this platform"
734 typedef long wxInt32
;
735 typedef unsigned long wxUint32
;
737 /* wxWidgets is not ready for 128bit systems yet... */
738 #error "Unknown sizeof(int) value, what are you compiling for?"
740 #else /* !defined(SIZEOF_INT) */
741 /* assume default 32bit machine -- what else can we do? */
742 wxCOMPILE_TIME_ASSERT( sizeof(int) == 4, IntMustBeExactly4Bytes
);
743 wxCOMPILE_TIME_ASSERT( sizeof(size_t) == 4, SizeTMustBeExactly4Bytes
);
744 wxCOMPILE_TIME_ASSERT( sizeof(void *) == 4, PtrMustBeExactly4Bytes
);
747 #define SIZEOF_SIZE_T 4
748 #define SIZEOF_VOID_P 4
751 typedef unsigned int wxUint32
;
753 #if defined(__MACH__) && !defined(SIZEOF_WCHAR_T)
754 #define SIZEOF_WCHAR_T 4
756 #if wxUSE_WCHAR_T && !defined(SIZEOF_WCHAR_T)
757 /* also assume that sizeof(wchar_t) == 2 (under Unix the most */
758 /* common case is 4 but there configure would have defined */
759 /* SIZEOF_WCHAR_T for us) */
760 /* the most common case */
761 wxCOMPILE_TIME_ASSERT( sizeof(wchar_t) == 2,
762 Wchar_tMustBeExactly2Bytes
);
764 #define SIZEOF_WCHAR_T 2
765 #endif /* wxUSE_WCHAR_T */
767 #endif /* Win/!Win */
769 typedef wxUint32 wxDword
;
772 Define an integral type big enough to contain all of long, size_t and void *.
774 #if SIZEOF_LONG >= SIZEOF_VOID_P && SIZEOF_LONG >= SIZEOF_SIZE_T
776 typedef unsigned long wxUIntPtr
;
777 #elif SIZEOF_SIZE_T >= SIZEOF_VOID_P
779 typedef size_t wxUIntPtr
;
782 This should never happen for the current architectures but if you're
783 using one where it does, please contact wx-dev@lists.wxwidgets.org.
785 #error "Pointers can't be stored inside integer types."
789 /* And also define a couple of simple functions to cast pointer to/from it. */
790 inline wxUIntPtr
wxPtrToUInt(const void *p
)
793 VC++ 7.1 gives warnings about casts such as below even when they're
794 explicit with /Wp64 option, suppress them as we really know what we're
798 #pragma warning(disable: 4311) /* pointer truncation from '' to '' */
801 return wx_reinterpret_cast(wxUIntPtr
, p
);
804 #pragma warning(default: 4311)
808 inline void *wxUIntToPtr(wxUIntPtr p
)
811 #pragma warning(disable: 4312) /* conversion to type of greater size */
814 return wx_reinterpret_cast(void *, p
);
817 #pragma warning(default: 4312)
820 #endif /*__cplusplus*/
825 /* NB: we #define and not typedef wxLongLong_t because we want to be able to */
826 /* use 'unsigned wxLongLong_t' as well and because we use "#ifdef */
827 /* wxLongLong_t" in wx/longlong.h */
829 /* to avoid compilation problems on 64bit machines with ambiguous method calls */
830 /* we will need to define this */
831 #undef wxLongLongIsLong
833 /* first check for generic cases which are long on 64bit machine and "long */
834 /* long", then check for specific compilers */
835 #if defined(SIZEOF_LONG) && (SIZEOF_LONG == 8)
836 #define wxLongLong_t long
837 #define wxLongLongSuffix l
838 #define wxLongLongFmtSpec _T("l")
839 #define wxLongLongIsLong
840 #elif (defined(__VISUALC__) && defined(__WIN32__))
841 #define wxLongLong_t __int64
842 #define wxLongLongSuffix i64
843 #define wxLongLongFmtSpec _T("I64")
844 #elif defined(__BORLANDC__) && defined(__WIN32__) && (__BORLANDC__ >= 0x520)
845 #define wxLongLong_t __int64
846 #define wxLongLongSuffix i64
847 #define wxLongLongFmtSpec _T("Ld")
848 #elif (defined(__WATCOMC__) && (defined(__WIN32__) || defined(__DOS__)))
849 #define wxLongLong_t __int64
850 #define wxLongLongSuffix i64
851 #define wxLongLongFmtSpec _T("Ld")
852 #elif defined(__DIGITALMARS__)
853 #define wxLongLong_t __int64
854 #define wxLongLongSuffix LL
855 #define wxLongLongFmtSpec _T("ll")
856 #elif (defined(SIZEOF_LONG_LONG) && SIZEOF_LONG_LONG >= 8) || \
857 defined(__MINGW32__) || \
858 defined(__GNUC__) || \
859 defined(__CYGWIN__) || \
860 defined(__WXMICROWIN__) || \
861 (defined(__DJGPP__) && __DJGPP__ >= 2)
862 #define wxLongLong_t long long
863 #define wxLongLongSuffix ll
864 #define wxLongLongFmtSpec _T("ll")
865 #elif defined(__MWERKS__)
866 #if __option(longlong)
867 #define wxLongLong_t long long
868 #define wxLongLongSuffix ll
869 #define wxLongLongFmtSpec _T("ll")
871 #error "The 64 bit integer support in CodeWarrior has been disabled."
872 #error "See the documentation on the 'longlong' pragma."
874 #elif defined(__VISAGECPP__) && __IBMCPP__ >= 400
875 #define wxLongLong_t long long
880 /* these macros allow to definea 64 bit constants in a portable way */
881 #define wxLL(x) wxCONCAT(x, wxLongLongSuffix)
882 #define wxULL(x) wxCONCAT(x, wxCONCAT(u, wxLongLongSuffix))
884 typedef wxLongLong_t wxInt64
;
885 typedef unsigned wxLongLong_t wxUint64
;
889 /* Make sure ssize_t is defined (a signed type the same size as size_t) */
890 /* HAVE_SSIZE_T should be defined for compiliers that already have it */
892 #include <sys/types.h>
893 #if defined(_SSIZE_T_) && !defined(HAVE_SSIZE_T)
898 #if SIZEOF_SIZE_T == 4
899 typedef wxInt32 ssize_t
;
900 #elif SIZEOF_SIZE_T == 8
901 typedef wxInt64 ssize_t
903 #error "error defining ssize_t, size_t is not 4 or 8 bytes"
908 /* base floating point types */
909 /* wxFloat32: 32 bit IEEE float ( 1 sign, 8 exponent bits, 23 fraction bits */
910 /* wxFloat64: 64 bit IEEE float ( 1 sign, 11 exponent bits, 52 fraction bits */
911 /* wxDouble: native fastest representation that has at least wxFloat64 */
912 /* precision, so use the IEEE types for storage, and this for */
915 typedef float wxFloat32
;
916 #if (defined( __WXMAC__ ) || defined(__WXCOCOA__)) && defined (__MWERKS__)
917 typedef short double wxFloat64
;
919 typedef double wxFloat64
;
922 #if defined( __WXMAC__ ) && !defined( __POWERPC__ )
923 typedef long double wxDouble
;
925 typedef double wxDouble
;
929 Some (non standard) compilers typedef wchar_t as an existing type instead
930 of treating it as a real fundamental type, set wxWCHAR_T_IS_REAL_TYPE to 0
931 for them and to 1 for all the others.
935 VC++ typedefs wchar_t as unsigned short by default, that is unless
936 /Za or /Zc:wchar_t option is used in which case _WCHAR_T_DEFINED is
939 # if defined(__VISUALC__) && !defined(_NATIVE_WCHAR_T_DEFINED)
940 # define wxWCHAR_T_IS_REAL_TYPE 0
941 # else /* compiler having standard-conforming wchar_t */
942 # define wxWCHAR_T_IS_REAL_TYPE 1
944 #endif /* wxUSE_WCHAR_T */
946 /* ---------------------------------------------------------------------------- */
947 /* byte ordering related definition and macros */
948 /* ---------------------------------------------------------------------------- */
952 #define wxBIG_ENDIAN 4321
953 #define wxLITTLE_ENDIAN 1234
954 #define wxPDP_ENDIAN 3412
956 #ifdef WORDS_BIGENDIAN
957 #define wxBYTE_ORDER wxBIG_ENDIAN
959 #define wxBYTE_ORDER wxLITTLE_ENDIAN
964 #if defined (__MWERKS__) && ( (__MWERKS__ < 0x0900) || macintosh )
965 /* assembler versions for these */
967 inline wxUint16
wxUINT16_SWAP_ALWAYS( wxUint16 i
)
968 {return (__lhbrx( &i
, 0 ) );}
969 inline wxInt16
wxINT16_SWAP_ALWAYS( wxInt16 i
)
970 {return (__lhbrx( &i
, 0 ) );}
971 inline wxUint32
wxUINT32_SWAP_ALWAYS( wxUint32 i
)
972 {return (__lwbrx( &i
, 0 ) );}
973 inline wxInt32
wxINT32_SWAP_ALWAYS( wxInt32 i
)
974 {return (__lwbrx( &i
, 0 ) );}
976 #pragma parameter __D0 wxUINT16_SWAP_ALWAYS(__D0)
977 pascal wxUint16
wxUINT16_SWAP_ALWAYS(wxUint16 value
)
980 #pragma parameter __D0 wxINT16_SWAP_ALWAYS(__D0)
981 pascal wxInt16
wxINT16_SWAP_ALWAYS(wxInt16 value
)
984 #pragma parameter __D0 wxUINT32_SWAP_ALWAYS (__D0)
985 pascal wxUint32
wxUINT32_SWAP_ALWAYS(wxUint32 value
)
986 = { 0xE158, 0x4840, 0xE158 };
988 #pragma parameter __D0 wxINT32_SWAP_ALWAYS (__D0)
989 pascal wxInt32
wxINT32_SWAP_ALWAYS(wxInt32 value
)
990 = { 0xE158, 0x4840, 0xE158 };
994 #define wxUINT16_SWAP_ALWAYS(val) \
996 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
997 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
999 #define wxINT16_SWAP_ALWAYS(val) \
1001 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
1002 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
1004 #define wxUINT32_SWAP_ALWAYS(val) \
1006 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1007 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
1008 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
1009 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
1011 #define wxINT32_SWAP_ALWAYS(val) \
1013 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1014 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
1015 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
1016 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
1018 /* machine specific byte swapping */
1021 #define wxUINT64_SWAP_ALWAYS(val) \
1023 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1024 (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1025 (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1026 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) << 8) | \
1027 (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >> 8) | \
1028 (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1029 (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1030 (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
1032 #define wxINT64_SWAP_ALWAYS(val) \
1034 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1035 (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1036 (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1037 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) << 8) | \
1038 (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >> 8) | \
1039 (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1040 (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1041 (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
1042 #else /* !wxLongLong_t */
1043 #define wxUINT64_SWAP_ALWAYS(val) \
1045 ((wxULongLong(val) & wxULongLong(0L, 0x000000ffU)) << 56) | \
1046 ((wxULongLong(val) & wxULongLong(0L, 0x0000ff00U)) << 40) | \
1047 ((wxULongLong(val) & wxULongLong(0L, 0x00ff0000U)) << 24) | \
1048 ((wxULongLong(val) & wxULongLong(0L, 0xff000000U)) << 8) | \
1049 ((wxULongLong(val) & wxULongLong(0x000000ffL, 0U)) >> 8) | \
1050 ((wxULongLong(val) & wxULongLong(0x0000ff00L, 0U)) >> 24) | \
1051 ((wxULongLong(val) & wxULongLong(0x00ff0000L, 0U)) >> 40) | \
1052 ((wxULongLong(val) & wxULongLong(0xff000000L, 0U)) >> 56)))
1054 #define wxINT64_SWAP_ALWAYS(val) \
1056 ((wxLongLong(val) & wxLongLong(0L, 0x000000ffU)) << 56) | \
1057 ((wxLongLong(val) & wxLongLong(0L, 0x0000ff00U)) << 40) | \
1058 ((wxLongLong(val) & wxLongLong(0L, 0x00ff0000U)) << 24) | \
1059 ((wxLongLong(val) & wxLongLong(0L, 0xff000000U)) << 8) | \
1060 ((wxLongLong(val) & wxLongLong(0x000000ffL, 0U)) >> 8) | \
1061 ((wxLongLong(val) & wxLongLong(0x0000ff00L, 0U)) >> 24) | \
1062 ((wxLongLong(val) & wxLongLong(0x00ff0000L, 0U)) >> 40) | \
1063 ((wxLongLong(val) & wxLongLong(0xff000000L, 0U)) >> 56)))
1064 #endif /* wxLongLong_t/!wxLongLong_t */
1066 #ifdef WORDS_BIGENDIAN
1067 #define wxUINT16_SWAP_ON_BE(val) wxUINT16_SWAP_ALWAYS(val)
1068 #define wxINT16_SWAP_ON_BE(val) wxINT16_SWAP_ALWAYS(val)
1069 #define wxUINT16_SWAP_ON_LE(val) (val)
1070 #define wxINT16_SWAP_ON_LE(val) (val)
1071 #define wxUINT32_SWAP_ON_BE(val) wxUINT32_SWAP_ALWAYS(val)
1072 #define wxINT32_SWAP_ON_BE(val) wxINT32_SWAP_ALWAYS(val)
1073 #define wxUINT32_SWAP_ON_LE(val) (val)
1074 #define wxINT32_SWAP_ON_LE(val) (val)
1075 #define wxUINT64_SWAP_ON_BE(val) wxUINT64_SWAP_ALWAYS(val)
1076 #define wxUINT64_SWAP_ON_LE(val) (val)
1078 #define wxUINT16_SWAP_ON_LE(val) wxUINT16_SWAP_ALWAYS(val)
1079 #define wxINT16_SWAP_ON_LE(val) wxINT16_SWAP_ALWAYS(val)
1080 #define wxUINT16_SWAP_ON_BE(val) (val)
1081 #define wxINT16_SWAP_ON_BE(val) (val)
1082 #define wxUINT32_SWAP_ON_LE(val) wxUINT32_SWAP_ALWAYS(val)
1083 #define wxINT32_SWAP_ON_LE(val) wxINT32_SWAP_ALWAYS(val)
1084 #define wxUINT32_SWAP_ON_BE(val) (val)
1085 #define wxINT32_SWAP_ON_BE(val) (val)
1086 #define wxUINT64_SWAP_ON_LE(val) wxUINT64_SWAP_ALWAYS(val)
1087 #define wxUINT64_SWAP_ON_BE(val) (val)
1090 /* ---------------------------------------------------------------------------- */
1091 /* Geometric flags */
1092 /* ---------------------------------------------------------------------------- */
1094 enum wxGeometryCentre
1100 /* centering into frame rather than screen (obsolete) */
1101 #define wxCENTER_FRAME 0x0000
1102 /* centre on screen rather than parent */
1103 #define wxCENTRE_ON_SCREEN 0x0002
1104 #define wxCENTER_ON_SCREEN wxCENTRE_ON_SCREEN
1108 wxHORIZONTAL
= 0x0004,
1109 wxVERTICAL
= 0x0008,
1111 wxBOTH
= (wxVERTICAL
| wxHORIZONTAL
)
1129 wxALL
= (wxUP
| wxDOWN
| wxRIGHT
| wxLEFT
)
1134 wxALIGN_NOT
= 0x0000,
1135 wxALIGN_CENTER_HORIZONTAL
= 0x0100,
1136 wxALIGN_CENTRE_HORIZONTAL
= wxALIGN_CENTER_HORIZONTAL
,
1137 wxALIGN_LEFT
= wxALIGN_NOT
,
1138 wxALIGN_TOP
= wxALIGN_NOT
,
1139 wxALIGN_RIGHT
= 0x0200,
1140 wxALIGN_BOTTOM
= 0x0400,
1141 wxALIGN_CENTER_VERTICAL
= 0x0800,
1142 wxALIGN_CENTRE_VERTICAL
= wxALIGN_CENTER_VERTICAL
,
1144 wxALIGN_CENTER
= (wxALIGN_CENTER_HORIZONTAL
| wxALIGN_CENTER_VERTICAL
),
1145 wxALIGN_CENTRE
= wxALIGN_CENTER
,
1147 /* a mask to extract alignment from the combination of flags */
1148 wxALIGN_MASK
= 0x0f00
1153 wxSTRETCH_NOT
= 0x0000,
1158 wxFIXED_MINSIZE
= 0x8000,
1161 /* for compatibility only, default now, don't use explicitly any more */
1162 #if WXWIN_COMPATIBILITY_2_4
1163 wxADJUST_MINSIZE
= 0x00100000
1165 wxADJUST_MINSIZE
= 0
1169 /* border flags: the values are chosen for backwards compatibility */
1172 /* this is different from wxBORDER_NONE as by default the controls do have */
1174 wxBORDER_DEFAULT
= 0,
1176 wxBORDER_NONE
= 0x00200000,
1177 wxBORDER_STATIC
= 0x01000000,
1178 wxBORDER_SIMPLE
= 0x02000000,
1179 wxBORDER_RAISED
= 0x04000000,
1180 wxBORDER_SUNKEN
= 0x08000000,
1181 wxBORDER_DOUBLE
= 0x10000000,
1183 /* a mask to extract border style from the combination of flags */
1184 wxBORDER_MASK
= 0x1f200000
1187 /* ---------------------------------------------------------------------------- */
1188 /* Window style flags */
1189 /* ---------------------------------------------------------------------------- */
1192 * Values are chosen so they can be |'ed in a bit list.
1193 * Some styles are used across more than one group,
1194 * so the values mustn't clash with others in the group.
1195 * Otherwise, numbers can be reused across groups.
1197 * From version 1.66:
1198 * Window (cross-group) styles now take up the first half
1199 * of the flag, and control-specific styles the
1205 * Window (Frame/dialog/subwindow/panel item) style flags
1207 #define wxVSCROLL 0x80000000
1208 #define wxHSCROLL 0x40000000
1209 #define wxCAPTION 0x20000000
1211 /* New styles (border styles are now in their own enum) */
1212 #define wxDOUBLE_BORDER wxBORDER_DOUBLE
1213 #define wxSUNKEN_BORDER wxBORDER_SUNKEN
1214 #define wxRAISED_BORDER wxBORDER_RAISED
1215 #define wxBORDER wxBORDER_SIMPLE
1216 #define wxSIMPLE_BORDER wxBORDER_SIMPLE
1217 #define wxSTATIC_BORDER wxBORDER_STATIC
1218 #define wxNO_BORDER wxBORDER_NONE
1220 /* wxALWAYS_SHOW_SB: instead of hiding the scrollbar when it is not needed, */
1221 /* disable it - but still show (see also wxLB_ALWAYS_SB style) */
1223 /* NB: as this style is only supported by wxUniversal and wxMSW so far */
1224 #define wxALWAYS_SHOW_SB 0x00800000
1226 /* Clip children when painting, which reduces flicker in e.g. frames and */
1227 /* splitter windows, but can't be used in a panel where a static box must be */
1228 /* 'transparent' (panel paints the background for it) */
1229 #define wxCLIP_CHILDREN 0x00400000
1231 /* Note we're reusing the wxCAPTION style because we won't need captions */
1232 /* for subwindows/controls */
1233 #define wxCLIP_SIBLINGS 0x20000000
1235 #define wxTRANSPARENT_WINDOW 0x00100000
1237 /* Add this style to a panel to get tab traversal working outside of dialogs */
1238 /* (on by default for wxPanel, wxDialog, wxScrolledWindow) */
1239 #define wxTAB_TRAVERSAL 0x00080000
1241 /* Add this style if the control wants to get all keyboard messages (under */
1242 /* Windows, it won't normally get the dialog navigation key events) */
1243 #define wxWANTS_CHARS 0x00040000
1245 /* Make window retained (Motif only, see src/generic/scrolwing.cpp)
1246 * This is non-zero only under wxMotif, to avoid a clash with wxPOPUP_WINDOW
1247 * on other platforms
1251 #define wxRETAINED 0x00020000
1253 #define wxRETAINED 0x00000000
1255 #define wxBACKINGSTORE wxRETAINED
1257 /* set this flag to create a special popup window: it will be always shown on */
1258 /* top of other windows, will capture the mouse and will be dismissed when the */
1259 /* mouse is clicked outside of it or if it loses focus in any other way */
1260 #define wxPOPUP_WINDOW 0x00020000
1262 /* force a full repaint when the window is resized (instead of repainting just */
1263 /* the invalidated area) */
1264 #define wxFULL_REPAINT_ON_RESIZE 0x00010000
1266 /* obsolete: now this is the default behaviour */
1268 /* don't invalidate the whole window (resulting in a PAINT event) when the */
1269 /* window is resized (currently, makes sense for wxMSW only) */
1270 #define wxNO_FULL_REPAINT_ON_RESIZE 0
1273 * Extra window style flags (use wxWS_EX prefix to make it clear that they
1274 * should be passed to wxWindow::SetExtraStyle(), not SetWindowStyle())
1277 /* by default, TransferDataTo/FromWindow() only work on direct children of the */
1278 /* window (compatible behaviour), set this flag to make them recursively */
1279 /* descend into all subwindows */
1280 #define wxWS_EX_VALIDATE_RECURSIVELY 0x00000001
1282 /* wxCommandEvents and the objects of the derived classes are forwarded to the */
1283 /* parent window and so on recursively by default. Using this flag for the */
1284 /* given window allows to block this propagation at this window, i.e. prevent */
1285 /* the events from being propagated further upwards. The dialogs have this */
1286 /* flag on by default. */
1287 #define wxWS_EX_BLOCK_EVENTS 0x00000002
1289 /* don't use this window as an implicit parent for the other windows: this must */
1290 /* be used with transient windows as otherwise there is the risk of creating a */
1291 /* dialog/frame with this window as a parent which would lead to a crash if the */
1292 /* parent is destroyed before the child */
1293 #define wxWS_EX_TRANSIENT 0x00000004
1295 /* don't paint the window background, we'll assume it will */
1296 /* be done by a theming engine. This is not yet used but could */
1297 /* possibly be made to work in the future, at least on Windows */
1298 #define wxWS_EX_THEMED_BACKGROUND 0x00000008
1300 /* this window should always process idle events */
1301 #define wxWS_EX_PROCESS_IDLE 0x00000010
1303 /* this window should always process UI update events */
1304 #define wxWS_EX_PROCESS_UI_UPDATES 0x00000020
1306 /* Use this style to add a context-sensitive help to the window (currently for */
1307 /* Win32 only and it doesn't work if wxMINIMIZE_BOX or wxMAXIMIZE_BOX are used) */
1308 #define wxFRAME_EX_CONTEXTHELP 0x00000004
1309 #define wxDIALOG_EX_CONTEXTHELP 0x00000004
1311 /* Create a window which is attachable to another top level window */
1312 #define wxFRAME_DRAWER 0x0020
1315 * MDI parent frame style flags
1316 * Can overlap with some of the above.
1319 #define wxFRAME_NO_WINDOW_MENU 0x0100
1322 * wxExtDialog style flags
1324 #define wxED_CLIENT_MARGIN 0x0004
1325 #define wxED_BUTTONS_BOTTOM 0x0000 /* has no effect */
1326 #define wxED_BUTTONS_RIGHT 0x0002
1327 #define wxED_STATIC_LINE 0x0001
1329 #if defined(__WXMSW__) || defined(__WXMAC__)
1330 # define wxEXT_DIALOG_STYLE (wxDEFAULT_DIALOG_STYLE|wxED_CLIENT_MARGIN)
1332 # define wxEXT_DIALOG_STYLE (wxDEFAULT_DIALOG_STYLE|wxED_CLIENT_MARGIN|wxED_STATIC_LINE)
1336 * wxMenuBar style flags
1338 /* use native docking */
1339 #define wxMB_DOCKABLE 0x0001
1342 * wxMenu style flags
1344 #define wxMENU_TEAROFF 0x0001
1347 * Apply to all panel items
1349 #define wxCOLOURED 0x0800
1350 #define wxFIXED_LENGTH 0x0400
1353 * Styles for wxListBox
1355 #define wxLB_SORT 0x0010
1356 #define wxLB_SINGLE 0x0020
1357 #define wxLB_MULTIPLE 0x0040
1358 #define wxLB_EXTENDED 0x0080
1359 /* wxLB_OWNERDRAW is Windows-only */
1360 #define wxLB_OWNERDRAW 0x0100
1361 #define wxLB_NEEDED_SB 0x0200
1362 #define wxLB_ALWAYS_SB 0x0400
1363 #define wxLB_HSCROLL wxHSCROLL
1364 /* always show an entire number of rows */
1365 #define wxLB_INT_HEIGHT 0x0800
1367 /* deprecated synonyms */
1368 #define wxPROCESS_ENTER 0x0400 /* wxTE_PROCESS_ENTER */
1369 #define wxPASSWORD 0x0800 /* wxTE_PASSWORD */
1372 * wxComboBox style flags
1374 #define wxCB_SIMPLE 0x0004
1375 #define wxCB_SORT 0x0008
1376 #define wxCB_READONLY 0x0010
1377 #define wxCB_DROPDOWN 0x0020
1380 * wxRadioBox style flags
1382 /* should we number the items from left to right or from top to bottom in a 2d */
1384 #define wxRA_LEFTTORIGHT 0x0001
1385 #define wxRA_TOPTOBOTTOM 0x0002
1387 /* New, more intuitive names to specify majorDim argument */
1388 #define wxRA_SPECIFY_COLS wxHORIZONTAL
1389 #define wxRA_SPECIFY_ROWS wxVERTICAL
1391 /* Old names for compatibility */
1392 #define wxRA_HORIZONTAL wxHORIZONTAL
1393 #define wxRA_VERTICAL wxVERTICAL
1396 * wxRadioButton style flag
1398 #define wxRB_GROUP 0x0004
1399 #define wxRB_SINGLE 0x0008
1404 #define wxSL_HORIZONTAL wxHORIZONTAL /* 4 */
1405 #define wxSL_VERTICAL wxVERTICAL /* 8 */
1406 /* The next one is obsolete - use scroll events instead */
1407 #define wxSL_NOTIFY_DRAG 0x0000
1408 #define wxSL_TICKS 0x0010
1409 #define wxSL_AUTOTICKS wxSL_TICKS /* we don't support manual ticks */
1410 #define wxSL_LABELS 0x0020
1411 #define wxSL_LEFT 0x0040
1412 #define wxSL_TOP 0x0080
1413 #define wxSL_RIGHT 0x0100
1414 #define wxSL_BOTTOM 0x0200
1415 #define wxSL_BOTH 0x0400
1416 #define wxSL_SELRANGE 0x0800
1421 #define wxSB_HORIZONTAL wxHORIZONTAL
1422 #define wxSB_VERTICAL wxVERTICAL
1425 * wxSpinButton flags.
1426 * Note that a wxSpinCtrl is sometimes defined as
1427 * a wxTextCtrl, and so the flags must be different
1428 * from wxTextCtrl's.
1430 #define wxSP_HORIZONTAL wxHORIZONTAL /* 4 */
1431 #define wxSP_VERTICAL wxVERTICAL /* 8 */
1432 #define wxSP_ARROW_KEYS 0x1000
1433 #define wxSP_WRAP 0x2000
1438 #define wxNB_FIXEDWIDTH 0x0010
1439 #define wxNB_TOP 0x0000 /* default */
1440 #define wxNB_LEFT 0x0020
1441 #define wxNB_RIGHT 0x0040
1442 #define wxNB_BOTTOM 0x0080
1443 #define wxNB_MULTILINE 0x0100
1444 #define wxNB_DEFAULT wxNB_TOP
1449 #define wxLB_DEFAULT 0x0
1450 #define wxLB_TOP 0x1
1451 #define wxLB_BOTTOM 0x2
1452 #define wxLB_LEFT 0x4
1453 #define wxLB_RIGHT 0x8
1454 #define wxLB_ALIGN_MASK 0xf
1457 * wxChoicebook flags
1459 #define wxCHB_DEFAULT 0x0
1460 #define wxCHB_TOP 0x1
1461 #define wxCHB_BOTTOM 0x2
1462 #define wxCHB_LEFT 0x4
1463 #define wxCHB_RIGHT 0x8
1464 #define wxCHB_ALIGN_MASK 0xf
1469 #define wxTC_RIGHTJUSTIFY 0x0010
1470 #define wxTC_FIXEDWIDTH 0x0020
1471 #define wxTC_TOP 0x0000 /* default */
1472 #define wxTC_LEFT 0x0020
1473 #define wxTC_RIGHT 0x0040
1474 #define wxTC_BOTTOM 0x0080
1475 #define wxTC_MULTILINE wxNB_MULTILINE
1476 #define wxTC_OWNERDRAW 0x0200
1479 * wxStatusBar95 flags
1481 #define wxST_SIZEGRIP 0x0010
1484 * wxStaticText flags
1486 #define wxST_NO_AUTORESIZE 0x0001
1489 * wxStaticBitmap flags
1491 #define wxBI_EXPAND wxEXPAND
1494 * wxStaticLine flags
1496 #define wxLI_HORIZONTAL wxHORIZONTAL
1497 #define wxLI_VERTICAL wxVERTICAL
1500 * wxProgressDialog flags
1502 #define wxPD_CAN_ABORT 0x0001
1503 #define wxPD_APP_MODAL 0x0002
1504 #define wxPD_AUTO_HIDE 0x0004
1505 #define wxPD_ELAPSED_TIME 0x0008
1506 #define wxPD_ESTIMATED_TIME 0x0010
1507 /* wxGA_SMOOTH = 0x0020 may also be used with wxProgressDialog */
1508 /* NO!!! This is wxDIALOG_MODAL and will cause the progress dialog to */
1509 /* be modal. No progress will then be made at all. */
1510 #define wxPD_REMAINING_TIME 0x0040
1513 * wxDirDialog styles
1516 #define wxDD_NEW_DIR_BUTTON 0x0080
1519 * extended dialog specifiers. these values are stored in a different
1520 * flag and thus do not overlap with other style flags. note that these
1521 * values do not correspond to the return values of the dialogs (for
1522 * those values, look at the wxID_XXX defines).
1525 /* wxCENTRE already defined as 0x00000001 */
1526 #define wxYES 0x00000002
1527 #define wxOK 0x00000004
1528 #define wxNO 0x00000008
1529 #define wxYES_NO (wxYES | wxNO)
1530 #define wxCANCEL 0x00000010
1532 #define wxYES_DEFAULT 0x00000000 /* has no effect (default) */
1533 #define wxNO_DEFAULT 0x00000080
1535 #define wxICON_EXCLAMATION 0x00000100
1536 #define wxICON_HAND 0x00000200
1537 #define wxICON_WARNING wxICON_EXCLAMATION
1538 #define wxICON_ERROR wxICON_HAND
1539 #define wxICON_QUESTION 0x00000400
1540 #define wxICON_INFORMATION 0x00000800
1541 #define wxICON_STOP wxICON_HAND
1542 #define wxICON_ASTERISK wxICON_INFORMATION
1543 #define wxICON_MASK (0x00000100|0x00000200|0x00000400|0x00000800)
1545 #define wxFORWARD 0x00001000
1546 #define wxBACKWARD 0x00002000
1547 #define wxRESET 0x00004000
1548 #define wxHELP 0x00008000
1549 #define wxMORE 0x00010000
1550 #define wxSETUP 0x00020000
1553 * Background styles. See wxWindow::SetBackgroundStyle
1556 enum wxBackgroundStyle
1563 /* ---------------------------------------------------------------------------- */
1565 /* ---------------------------------------------------------------------------- */
1567 /* any id: means that we don't care about the id, whether when installing an */
1568 /* event handler or when creating a new window */
1574 /* id for a separator line in the menu (invalid for normal item) */
1580 /* Standard menu IDs */
1601 wxID_HELP_PROCEDURES
,
1619 wxID_VIEW_LARGEICONS
,
1620 wxID_VIEW_SMALLICONS
,
1637 /* Standard button and menu IDs */
1668 wxID_JUSTIFY_CENTER
,
1680 wxID_REVERT_TO_SAVED
,
1682 /* System menu IDs (used by wxUniv): */
1683 wxID_SYSTEM_MENU
= 5200,
1687 wxID_MAXIMIZE_FRAME
,
1691 /* IDs used by generic file dialog (13 consecutive starting from this value) */
1692 wxID_FILEDLGG
= 5900,
1697 /* ---------------------------------------------------------------------------- */
1698 /* other constants */
1699 /* ---------------------------------------------------------------------------- */
1701 /* menu and toolbar item kinds */
1704 wxITEM_SEPARATOR
= -1,
1711 /* hit test results */
1717 wxHT_SCROLLBAR_FIRST
= wxHT_NOWHERE
,
1718 wxHT_SCROLLBAR_ARROW_LINE_1
, /* left or upper arrow to scroll by line */
1719 wxHT_SCROLLBAR_ARROW_LINE_2
, /* right or down */
1720 wxHT_SCROLLBAR_ARROW_PAGE_1
, /* left or upper arrow to scroll by page */
1721 wxHT_SCROLLBAR_ARROW_PAGE_2
, /* right or down */
1722 wxHT_SCROLLBAR_THUMB
, /* on the thumb */
1723 wxHT_SCROLLBAR_BAR_1
, /* bar to the left/above the thumb */
1724 wxHT_SCROLLBAR_BAR_2
, /* bar to the right/below the thumb */
1725 wxHT_SCROLLBAR_LAST
,
1728 wxHT_WINDOW_OUTSIDE
, /* not in this window at all */
1729 wxHT_WINDOW_INSIDE
, /* in the client area */
1730 wxHT_WINDOW_VERT_SCROLLBAR
, /* on the vertical scrollbar */
1731 wxHT_WINDOW_HORZ_SCROLLBAR
, /* on the horizontal scrollbar */
1732 wxHT_WINDOW_CORNER
, /* on the corner between 2 scrollbars */
1737 /* ---------------------------------------------------------------------------- */
1738 /* Possible SetSize flags */
1739 /* ---------------------------------------------------------------------------- */
1741 /* Use internally-calculated width if -1 */
1742 #define wxSIZE_AUTO_WIDTH 0x0001
1743 /* Use internally-calculated height if -1 */
1744 #define wxSIZE_AUTO_HEIGHT 0x0002
1745 /* Use internally-calculated width and height if each is -1 */
1746 #define wxSIZE_AUTO (wxSIZE_AUTO_WIDTH|wxSIZE_AUTO_HEIGHT)
1747 /* Ignore missing (-1) dimensions (use existing). */
1748 /* For readability only: test for wxSIZE_AUTO_WIDTH/HEIGHT in code. */
1749 #define wxSIZE_USE_EXISTING 0x0000
1750 /* Allow -1 as a valid position */
1751 #define wxSIZE_ALLOW_MINUS_ONE 0x0004
1752 /* Don't do parent client adjustments (for implementation only) */
1753 #define wxSIZE_NO_ADJUSTMENTS 0x0008
1755 /* ---------------------------------------------------------------------------- */
1756 /* GDI descriptions */
1757 /* ---------------------------------------------------------------------------- */
1761 /* Text font families */
1768 wxTELETYPE
, /* @@@@ */
1770 /* Proportional or Fixed width fonts (not yet used) */
1777 /* Also wxNORMAL for normal (non-italic text) */
1791 /* Brush & Pen Stippling. Note that a stippled pen cannot be dashed!! */
1792 /* Note also that stippling a Pen IS meaningfull, because a Line is */
1793 wxSTIPPLE_MASK_OPAQUE
, /* mask is used for blitting monochrome using text fore and back ground colors */
1794 wxSTIPPLE_MASK
, /* mask is used for masking areas in the stipple bitmap (TO DO) */
1795 /* drawn with a Pen, and without any Brush -- and it can be stippled. */
1813 /* VZ: why doesn't it start with "wx"? FIXME */
1814 #define IS_HATCH(s) ((s)>=wxBDIAGONAL_HATCH && (s)<=wxVERTICAL_HATCH)
1819 wxCLEAR
, wxROP_BLACK
= wxCLEAR
, wxBLIT_BLACKNESS
= wxCLEAR
, /* 0 */
1820 wxXOR
, wxROP_XORPEN
= wxXOR
, wxBLIT_SRCINVERT
= wxXOR
, /* src XOR dst */
1821 wxINVERT
, wxROP_NOT
= wxINVERT
, wxBLIT_DSTINVERT
= wxINVERT
, /* NOT dst */
1822 wxOR_REVERSE
, wxROP_MERGEPENNOT
= wxOR_REVERSE
, wxBLIT_00DD0228
= wxOR_REVERSE
, /* src OR (NOT dst) */
1823 wxAND_REVERSE
, wxROP_MASKPENNOT
= wxAND_REVERSE
, wxBLIT_SRCERASE
= wxAND_REVERSE
, /* src AND (NOT dst) */
1824 wxCOPY
, wxROP_COPYPEN
= wxCOPY
, wxBLIT_SRCCOPY
= wxCOPY
, /* src */
1825 wxAND
, wxROP_MASKPEN
= wxAND
, wxBLIT_SRCAND
= wxAND
, /* src AND dst */
1826 wxAND_INVERT
, wxROP_MASKNOTPEN
= wxAND_INVERT
, wxBLIT_00220326
= wxAND_INVERT
, /* (NOT src) AND dst */
1827 wxNO_OP
, wxROP_NOP
= wxNO_OP
, wxBLIT_00AA0029
= wxNO_OP
, /* dst */
1828 wxNOR
, wxROP_NOTMERGEPEN
= wxNOR
, wxBLIT_NOTSRCERASE
= wxNOR
, /* (NOT src) AND (NOT dst) */
1829 wxEQUIV
, wxROP_NOTXORPEN
= wxEQUIV
, wxBLIT_00990066
= wxEQUIV
, /* (NOT src) XOR dst */
1830 wxSRC_INVERT
, wxROP_NOTCOPYPEN
= wxSRC_INVERT
, wxBLIT_NOTSCRCOPY
= wxSRC_INVERT
, /* (NOT src) */
1831 wxOR_INVERT
, wxROP_MERGENOTPEN
= wxOR_INVERT
, wxBLIT_MERGEPAINT
= wxOR_INVERT
, /* (NOT src) OR dst */
1832 wxNAND
, wxROP_NOTMASKPEN
= wxNAND
, wxBLIT_007700E6
= wxNAND
, /* (NOT src) OR (NOT dst) */
1833 wxOR
, wxROP_MERGEPEN
= wxOR
, wxBLIT_SRCPAINT
= wxOR
, /* src OR dst */
1834 wxSET
, wxROP_WHITE
= wxSET
, wxBLIT_WHITENESS
= wxSET
/* 1 */
1840 wxFLOOD_SURFACE
= 1,
1844 /* Polygon filling mode */
1851 /* ToolPanel in wxFrame (VZ: unused?) */
1860 /* the values of the format constants should be the same as correspondign */
1861 /* CF_XXX constants in Windows API */
1865 wxDF_TEXT
= 1, /* CF_TEXT */
1866 wxDF_BITMAP
= 2, /* CF_BITMAP */
1867 wxDF_METAFILE
= 3, /* CF_METAFILEPICT */
1871 wxDF_OEMTEXT
= 7, /* CF_OEMTEXT */
1872 wxDF_DIB
= 8, /* CF_DIB */
1877 wxDF_UNICODETEXT
= 13,
1878 wxDF_ENHMETAFILE
= 14,
1879 wxDF_FILENAME
= 15, /* CF_HDROP */
1882 wxDF_HTML
= 30, /* Note: does not correspond to CF_ constant */
1886 /* Virtual keycodes */
1896 /* These are, by design, not compatable with unicode characters.
1897 If you want to get a unicode character from a key event, use
1898 wxKeyEvent::GetUnicodeKey instead. */
1911 WXK_PRIOR
, /* Page up */
1912 WXK_NEXT
, /* Page down */
1985 WXK_NUMPAD_PAGEDOWN
,
1991 WXK_NUMPAD_MULTIPLY
,
1993 WXK_NUMPAD_SEPARATOR
,
1994 WXK_NUMPAD_SUBTRACT
,
2005 enum wxHotkeyModifier
2015 /* Mapping modes (same values as used by Windows, don't change) */
2030 /* Shortcut for easier dialog-unit-to-pixel conversion */
2031 #define wxDLG_UNIT(parent, pt) parent->ConvertDialogToPixels(pt)
2036 wxPAPER_NONE
, /* Use specific dimensions */
2037 wxPAPER_LETTER
, /* Letter, 8 1/2 by 11 inches */
2038 wxPAPER_LEGAL
, /* Legal, 8 1/2 by 14 inches */
2039 wxPAPER_A4
, /* A4 Sheet, 210 by 297 millimeters */
2040 wxPAPER_CSHEET
, /* C Sheet, 17 by 22 inches */
2041 wxPAPER_DSHEET
, /* D Sheet, 22 by 34 inches */
2042 wxPAPER_ESHEET
, /* E Sheet, 34 by 44 inches */
2043 wxPAPER_LETTERSMALL
, /* Letter Small, 8 1/2 by 11 inches */
2044 wxPAPER_TABLOID
, /* Tabloid, 11 by 17 inches */
2045 wxPAPER_LEDGER
, /* Ledger, 17 by 11 inches */
2046 wxPAPER_STATEMENT
, /* Statement, 5 1/2 by 8 1/2 inches */
2047 wxPAPER_EXECUTIVE
, /* Executive, 7 1/4 by 10 1/2 inches */
2048 wxPAPER_A3
, /* A3 sheet, 297 by 420 millimeters */
2049 wxPAPER_A4SMALL
, /* A4 small sheet, 210 by 297 millimeters */
2050 wxPAPER_A5
, /* A5 sheet, 148 by 210 millimeters */
2051 wxPAPER_B4
, /* B4 sheet, 250 by 354 millimeters */
2052 wxPAPER_B5
, /* B5 sheet, 182-by-257-millimeter paper */
2053 wxPAPER_FOLIO
, /* Folio, 8-1/2-by-13-inch paper */
2054 wxPAPER_QUARTO
, /* Quarto, 215-by-275-millimeter paper */
2055 wxPAPER_10X14
, /* 10-by-14-inch sheet */
2056 wxPAPER_11X17
, /* 11-by-17-inch sheet */
2057 wxPAPER_NOTE
, /* Note, 8 1/2 by 11 inches */
2058 wxPAPER_ENV_9
, /* #9 Envelope, 3 7/8 by 8 7/8 inches */
2059 wxPAPER_ENV_10
, /* #10 Envelope, 4 1/8 by 9 1/2 inches */
2060 wxPAPER_ENV_11
, /* #11 Envelope, 4 1/2 by 10 3/8 inches */
2061 wxPAPER_ENV_12
, /* #12 Envelope, 4 3/4 by 11 inches */
2062 wxPAPER_ENV_14
, /* #14 Envelope, 5 by 11 1/2 inches */
2063 wxPAPER_ENV_DL
, /* DL Envelope, 110 by 220 millimeters */
2064 wxPAPER_ENV_C5
, /* C5 Envelope, 162 by 229 millimeters */
2065 wxPAPER_ENV_C3
, /* C3 Envelope, 324 by 458 millimeters */
2066 wxPAPER_ENV_C4
, /* C4 Envelope, 229 by 324 millimeters */
2067 wxPAPER_ENV_C6
, /* C6 Envelope, 114 by 162 millimeters */
2068 wxPAPER_ENV_C65
, /* C65 Envelope, 114 by 229 millimeters */
2069 wxPAPER_ENV_B4
, /* B4 Envelope, 250 by 353 millimeters */
2070 wxPAPER_ENV_B5
, /* B5 Envelope, 176 by 250 millimeters */
2071 wxPAPER_ENV_B6
, /* B6 Envelope, 176 by 125 millimeters */
2072 wxPAPER_ENV_ITALY
, /* Italy Envelope, 110 by 230 millimeters */
2073 wxPAPER_ENV_MONARCH
, /* Monarch Envelope, 3 7/8 by 7 1/2 inches */
2074 wxPAPER_ENV_PERSONAL
, /* 6 3/4 Envelope, 3 5/8 by 6 1/2 inches */
2075 wxPAPER_FANFOLD_US
, /* US Std Fanfold, 14 7/8 by 11 inches */
2076 wxPAPER_FANFOLD_STD_GERMAN
, /* German Std Fanfold, 8 1/2 by 12 inches */
2077 wxPAPER_FANFOLD_LGL_GERMAN
, /* German Legal Fanfold, 8 1/2 by 13 inches */
2079 wxPAPER_ISO_B4
, /* B4 (ISO) 250 x 353 mm */
2080 wxPAPER_JAPANESE_POSTCARD
, /* Japanese Postcard 100 x 148 mm */
2081 wxPAPER_9X11
, /* 9 x 11 in */
2082 wxPAPER_10X11
, /* 10 x 11 in */
2083 wxPAPER_15X11
, /* 15 x 11 in */
2084 wxPAPER_ENV_INVITE
, /* Envelope Invite 220 x 220 mm */
2085 wxPAPER_LETTER_EXTRA
, /* Letter Extra 9 \275 x 12 in */
2086 wxPAPER_LEGAL_EXTRA
, /* Legal Extra 9 \275 x 15 in */
2087 wxPAPER_TABLOID_EXTRA
, /* Tabloid Extra 11.69 x 18 in */
2088 wxPAPER_A4_EXTRA
, /* A4 Extra 9.27 x 12.69 in */
2089 wxPAPER_LETTER_TRANSVERSE
, /* Letter Transverse 8 \275 x 11 in */
2090 wxPAPER_A4_TRANSVERSE
, /* A4 Transverse 210 x 297 mm */
2091 wxPAPER_LETTER_EXTRA_TRANSVERSE
, /* Letter Extra Transverse 9\275 x 12 in */
2092 wxPAPER_A_PLUS
, /* SuperA/SuperA/A4 227 x 356 mm */
2093 wxPAPER_B_PLUS
, /* SuperB/SuperB/A3 305 x 487 mm */
2094 wxPAPER_LETTER_PLUS
, /* Letter Plus 8.5 x 12.69 in */
2095 wxPAPER_A4_PLUS
, /* A4 Plus 210 x 330 mm */
2096 wxPAPER_A5_TRANSVERSE
, /* A5 Transverse 148 x 210 mm */
2097 wxPAPER_B5_TRANSVERSE
, /* B5 (JIS) Transverse 182 x 257 mm */
2098 wxPAPER_A3_EXTRA
, /* A3 Extra 322 x 445 mm */
2099 wxPAPER_A5_EXTRA
, /* A5 Extra 174 x 235 mm */
2100 wxPAPER_B5_EXTRA
, /* B5 (ISO) Extra 201 x 276 mm */
2101 wxPAPER_A2
, /* A2 420 x 594 mm */
2102 wxPAPER_A3_TRANSVERSE
, /* A3 Transverse 297 x 420 mm */
2103 wxPAPER_A3_EXTRA_TRANSVERSE
/* A3 Extra Transverse 322 x 445 mm */
2107 /* Printing orientation */
2109 #define wxPORTRAIT 1
2110 #define wxLANDSCAPE 2
2113 /* Duplex printing modes
2118 wxDUPLEX_SIMPLEX
, /* Non-duplex */
2119 wxDUPLEX_HORIZONTAL
,
2126 #define wxPRINT_QUALITY_HIGH -1
2127 #define wxPRINT_QUALITY_MEDIUM -2
2128 #define wxPRINT_QUALITY_LOW -3
2129 #define wxPRINT_QUALITY_DRAFT -4
2131 typedef int wxPrintQuality
;
2133 /* Print mode (currently PostScript only)
2138 wxPRINT_MODE_NONE
= 0,
2139 wxPRINT_MODE_PREVIEW
= 1, /* Preview in external application */
2140 wxPRINT_MODE_FILE
= 2, /* Print to file */
2141 wxPRINT_MODE_PRINTER
= 3, /* Send to printer */
2142 wxPRINT_MODE_STREAM
= 4 /* Send postscript data into a stream */
2145 /* ---------------------------------------------------------------------------- */
2146 /* UpdateWindowUI flags */
2147 /* ---------------------------------------------------------------------------- */
2151 wxUPDATE_UI_NONE
= 0x0000,
2152 wxUPDATE_UI_RECURSE
= 0x0001,
2153 wxUPDATE_UI_FROMIDLE
= 0x0002 /* Invoked from On(Internal)Idle */
2156 /* ---------------------------------------------------------------------------- */
2158 /* ---------------------------------------------------------------------------- */
2160 /* define this macro if font handling is done using the X font names */
2161 #if (defined(__WXGTK__) && !defined(__WXGTK20__)) || defined(__X__)
2162 #define _WX_X_FONTLIKE
2165 /* macro to specify "All Files" on different platforms */
2166 #if defined(__WXMSW__) || defined(__WXPM__)
2167 # define wxALL_FILES_PATTERN wxT("*.*")
2168 # define wxALL_FILES gettext_noop("All files (*.*)|*.*")
2170 # define wxALL_FILES_PATTERN wxT("*")
2171 # define wxALL_FILES gettext_noop("All files (*)|*")
2174 /* --------------------------------------------------------------------------- */
2175 /* macros that enable wxWidgets apps to be compiled in absence of the */
2176 /* sytem headers, although some platform specific types are used in the */
2177 /* platform specific (implementation) parts of the headers */
2178 /* --------------------------------------------------------------------------- */
2182 #define WX_OPAQUE_TYPE( name ) struct wxOpaque##name
2184 typedef unsigned char WXCOLORREF
[6];
2185 typedef void* WXHBITMAP
;
2186 typedef void* WXHMETAFILE
;
2187 typedef void* WXHICON
;
2188 typedef void* WXHCURSOR
;
2189 typedef void* WXHRGN
;
2190 typedef void* WXRECTPTR
;
2191 typedef void* WXPOINTPTR
;
2192 typedef void* WXHWND
;
2193 typedef void* WXEVENTREF
;
2194 typedef void* WXEVENTHANDLERREF
;
2195 typedef void* WXEVENTHANDLERCALLREF
;
2196 typedef void* WXAPPLEEVENTREF
;
2197 typedef void* WXHDC
;
2198 typedef void* WXHMENU
;
2199 typedef unsigned int WXUINT
;
2200 typedef unsigned long WXDWORD
;
2201 typedef unsigned short WXWORD
;
2204 /* typedef void* WXWidget; */
2205 /* typedef void* WXWindow; */
2206 typedef WX_OPAQUE_TYPE(ControlRef
) * WXWidget
;
2207 typedef WX_OPAQUE_TYPE(WindowRef
) * WXWindow
;
2208 typedef void* WXDisplay
;
2210 /* typedef WindowPtr WXHWND; */
2211 /* typedef Handle WXHANDLE; */
2212 /* typedef CIconHandle WXHICON; */
2213 /* typedef unsigned long WXHFONT; */
2214 /* typedef MenuHandle WXHMENU; */
2215 /* typedef unsigned long WXHPEN; */
2216 /* typedef unsigned long WXHBRUSH; */
2217 /* typedef unsigned long WXHPALETTE; */
2218 /* typedef CursHandle WXHCURSOR; */
2219 /* typedef RgnHandle WXHRGN; */
2220 /* typedef unsigned long WXHACCEL; */
2221 /* typedef unsigned long WXHINSTANCE; */
2222 /* typedef unsigned long WXHIMAGELIST; */
2223 /* typedef unsigned long WXHGLOBAL; */
2224 /* typedef GrafPtr WXHDC; */
2225 /* typedef unsigned int WXWPARAM; */
2226 /* typedef long WXLPARAM; */
2227 /* typedef void * WXRGNDATA; */
2228 /* typedef void * WXMSG; */
2229 /* typedef unsigned long WXHCONV; */
2230 /* typedef unsigned long WXHKEY; */
2231 /* typedef void * WXDRAWITEMSTRUCT; */
2232 /* typedef void * WXMEASUREITEMSTRUCT; */
2233 /* typedef void * WXLPCREATESTRUCT; */
2234 /* typedef int (*WXFARPROC)(); */
2236 /* typedef WindowPtr WXWindow; */
2237 /* typedef ControlHandle WXWidget; */
2243 /* NOTE: This ought to work with other compilers too, but I'm being cautious */
2244 #if (defined(__GNUC__) && defined(__APPLE__)) || defined(__MWERKS__)
2245 /* It's desirable to have type safety for Objective-C(++) code as it does
2246 at least catch typos of method names among other things. However, it
2247 is not possible to declare an Objective-C class from plain old C or C++
2248 code. Furthermore, because of C++ name mangling, the type name must
2249 be the same for both C++ and Objective-C++ code. Therefore, we define
2250 what should be a pointer to an Objective-C class as a pointer to a plain
2251 old C struct with the same name. Unfortunately, because the compiler
2252 does not see a struct as an Objective-C class we cannot declare it
2253 as a struct in Objective-C(++) mode.
2255 #if defined(__OBJC__)
2256 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2258 typedef klass *WX_##klass
2259 #else /* not defined(__OBJC__) */
2260 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2261 typedef struct klass *WX_##klass
2262 #endif /* defined(__OBJC__) */
2264 #else /* not Apple's GNU or CodeWarrior */
2265 #warning "Objective-C types will not be checked by the compiler."
2266 /* NOTE: typedef struct objc_object *id; */
2267 /* IOW, we're declaring these using the id type without using that name, */
2268 /* since "id" is used extensively not only within wxWidgets itself, but */
2269 /* also in wxWidgets application code. The following works fine when */
2270 /* compiling C(++) code, and works without typesafety for Obj-C(++) code */
2271 #define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2272 typedef struct objc_object *WX_##klass
2274 #endif /* (defined(__GNUC__) && defined(__APPLE__)) || defined(__MWERKS__) */
2276 DECLARE_WXCOCOA_OBJC_CLASS(NSApplication
);
2277 DECLARE_WXCOCOA_OBJC_CLASS(NSBitmapImageRep
);
2278 DECLARE_WXCOCOA_OBJC_CLASS(NSBox
);
2279 DECLARE_WXCOCOA_OBJC_CLASS(NSButton
);
2280 DECLARE_WXCOCOA_OBJC_CLASS(NSColor
);
2281 DECLARE_WXCOCOA_OBJC_CLASS(NSColorPanel
);
2282 DECLARE_WXCOCOA_OBJC_CLASS(NSControl
);
2283 DECLARE_WXCOCOA_OBJC_CLASS(NSCursor
);
2284 DECLARE_WXCOCOA_OBJC_CLASS(NSEvent
);
2285 DECLARE_WXCOCOA_OBJC_CLASS(NSFontPanel
);
2286 DECLARE_WXCOCOA_OBJC_CLASS(NSImage
);
2287 DECLARE_WXCOCOA_OBJC_CLASS(NSLayoutManager
);
2288 DECLARE_WXCOCOA_OBJC_CLASS(NSMenu
);
2289 DECLARE_WXCOCOA_OBJC_CLASS(NSMenuExtra
);
2290 DECLARE_WXCOCOA_OBJC_CLASS(NSMenuItem
);
2291 DECLARE_WXCOCOA_OBJC_CLASS(NSMutableArray
);
2292 DECLARE_WXCOCOA_OBJC_CLASS(NSNotification
);
2293 DECLARE_WXCOCOA_OBJC_CLASS(NSObject
);
2294 DECLARE_WXCOCOA_OBJC_CLASS(NSPanel
);
2295 DECLARE_WXCOCOA_OBJC_CLASS(NSScrollView
);
2296 DECLARE_WXCOCOA_OBJC_CLASS(NSSound
);
2297 DECLARE_WXCOCOA_OBJC_CLASS(NSStatusItem
);
2298 DECLARE_WXCOCOA_OBJC_CLASS(NSTableColumn
);
2299 DECLARE_WXCOCOA_OBJC_CLASS(NSTableView
);
2300 DECLARE_WXCOCOA_OBJC_CLASS(NSTextContainer
);
2301 DECLARE_WXCOCOA_OBJC_CLASS(NSTextField
);
2302 DECLARE_WXCOCOA_OBJC_CLASS(NSTextStorage
);
2303 DECLARE_WXCOCOA_OBJC_CLASS(NSThread
);
2304 DECLARE_WXCOCOA_OBJC_CLASS(NSWindow
);
2305 DECLARE_WXCOCOA_OBJC_CLASS(NSView
);
2306 typedef WX_NSView WXWidget
; /* wxWidgets BASE definition */
2307 #endif /* __WXCOCOA__ */
2311 /* the keywords needed for WinMain() declaration */
2316 /* Stand-ins for Windows types to avoid #including all of windows.h */
2317 typedef void * WXHWND
;
2318 typedef void * WXHANDLE
;
2319 typedef void * WXHICON
;
2320 typedef void * WXHFONT
;
2321 typedef void * WXHMENU
;
2322 typedef void * WXHPEN
;
2323 typedef void * WXHBRUSH
;
2324 typedef void * WXHPALETTE
;
2325 typedef void * WXHCURSOR
;
2326 typedef void * WXHRGN
;
2327 typedef void * WXHACCEL
;
2328 typedef void WXFAR
* WXHINSTANCE
;
2329 typedef void * WXHBITMAP
;
2330 typedef void * WXHIMAGELIST
;
2331 typedef void * WXHGLOBAL
;
2332 typedef void * WXHDC
;
2333 typedef unsigned int WXUINT
;
2334 typedef unsigned long WXDWORD
;
2335 typedef unsigned short WXWORD
;
2337 typedef unsigned long WXCOLORREF
;
2338 typedef void * WXRGNDATA
;
2339 typedef struct tagMSG WXMSG
;
2340 typedef void * WXHCONV
;
2341 typedef void * WXHKEY
;
2342 typedef void * WXHTREEITEM
;
2344 typedef void * WXDRAWITEMSTRUCT
;
2345 typedef void * WXMEASUREITEMSTRUCT
;
2346 typedef void * WXLPCREATESTRUCT
;
2348 typedef WXHWND WXWidget
;
2351 typedef unsigned __int64 WXWPARAM
;
2352 typedef __int64 WXLPARAM
;
2353 typedef __int64 WXLRESULT
;
2355 typedef unsigned int WXWPARAM
;
2356 typedef long WXLPARAM
;
2357 typedef long WXLRESULT
;
2360 #if !defined(__WIN32__) || defined(__GNUWIN32__) || defined(__WXMICROWIN__)
2361 typedef int (*WXFARPROC
)();
2363 typedef int (__stdcall
*WXFARPROC
)();
2365 #endif /* __WXMSW__ */
2368 #if defined(__WXPM__) || defined(__EMX__)
2370 /* Stand-ins for OS/2 types, to avoid #including all of os2.h */
2371 typedef unsigned long WXHWND
;
2372 typedef unsigned long WXHANDLE
;
2373 typedef unsigned long WXHICON
;
2374 typedef unsigned long WXHFONT
;
2375 typedef unsigned long WXHMENU
;
2376 typedef unsigned long WXHPEN
;
2377 typedef unsigned long WXHBRUSH
;
2378 typedef unsigned long WXHPALETTE
;
2379 typedef unsigned long WXHCURSOR
;
2380 typedef unsigned long WXHRGN
;
2381 typedef unsigned long WXHACCEL
;
2382 typedef unsigned long WXHBITMAP
;
2383 typedef unsigned long WXHDC
;
2384 typedef unsigned int WXUINT
;
2385 typedef unsigned long WXDWORD
;
2386 typedef unsigned short WXWORD
;
2388 typedef unsigned long WXCOLORREF
;
2389 typedef void * WXMSG
;
2390 typedef unsigned long WXHTREEITEM
;
2392 typedef void * WXDRAWITEMSTRUCT
;
2393 typedef void * WXMEASUREITEMSTRUCT
;
2394 typedef void * WXLPCREATESTRUCT
;
2396 typedef WXHWND WXWidget
;
2399 /* Need a well-known type for WXFARPROC
2400 below. MPARAM is typedef'ed too late. */
2401 #define WXWPARAM void *
2402 #define WXLPARAM void *
2404 #define WXWPARAM MPARAM
2405 #define WXLPARAM MPARAM
2408 #define LOGFONT FATTRS
2409 #define LOWORD SHORT1FROMMP
2410 #define HIWORD SHORT2FROMMP
2412 typedef unsigned long WXMPARAM
;
2413 typedef unsigned long WXMSGID
;
2414 typedef void* WXRESULT
;
2415 /* typedef int (*WXFARPROC)(); */
2416 /* some windows handles not defined by PM */
2417 typedef unsigned long HANDLE
;
2418 typedef unsigned long HICON
;
2419 typedef unsigned long HFONT
;
2420 typedef unsigned long HMENU
;
2421 typedef unsigned long HPEN
;
2422 typedef unsigned long HBRUSH
;
2423 typedef unsigned long HPALETTE
;
2424 typedef unsigned long HCURSOR
;
2425 typedef unsigned long HINSTANCE
;
2426 typedef unsigned long HIMAGELIST
;
2427 typedef unsigned long HGLOBAL
;
2428 typedef unsigned long DWORD
;
2429 typedef unsigned short WORD
;
2430 #endif /* WXPM || EMX */
2432 #if defined (__WXPM__)
2433 /* WIN32 graphics types for OS/2 GPI */
2435 /* RGB under OS2 is more like a PALETTEENTRY struct under Windows so we need a real RGB def */
2436 /* WARNING: The OS/2 headers typedef BYTE simply as 'char'; if the default is signed, all */
2437 /* hell will break loose! */
2438 /* #define OS2RGB(r,g,b) ((DWORD ((BYTE) (b) | ((WORD) (g) << 8)) | (((DWORD)(BYTE)(r)) << 16))) */
2439 #define OS2RGB(r,g,b) ((DWORD)((unsigned char)(b) | ((unsigned char)(g) << 8)) | ((unsigned char)(r) << 16))
2441 typedef unsigned long COLORREF
;
2442 #define GetBValue(rgb) ((BYTE)((rgb) >> 16))
2443 #define GetGValue(rgb) ((BYTE)(((WORD)(rgb)) >> 8))
2444 #define GetRValue(rgb) ((BYTE)(rgb))
2445 #define PALETTEINDEX(i) ((COLORREF)(0x01000000 | (DWORD)(WORD)(i)))
2446 #define PALETTERGB(r,g,b) (0x02000000 | OS2RGB(r,g,b))
2447 /* OS2's RGB/RGB2 is backwards from this */
2448 typedef struct tagPALETTEENTRY
2455 typedef struct tagLOGPALETTE
2459 WORD PALETTEENTRY
[1];
2462 #if (defined(__VISAGECPP__) && (__IBMCPP__ < 400)) || defined (__WATCOMC__)
2463 /* VA 3.0 for some reason needs base data types when typedefing a proc proto??? */
2464 typedef void* (_System
*WXFARPROC
)(unsigned long, unsigned long, void*, void*);
2466 #if defined(__EMX__) && !defined(_System)
2469 typedef WXRESULT (_System
*WXFARPROC
)(WXHWND
, WXMSGID
, WXWPARAM
, WXLPARAM
);
2472 #endif /* __WXPM__ */
2475 #if defined(__WXMOTIF__) || defined(__WXX11__)
2476 /* Stand-ins for X/Xt/Motif types */
2477 typedef void* WXWindow
;
2478 typedef void* WXWidget
;
2479 typedef void* WXAppContext
;
2480 typedef void* WXColormap
;
2481 typedef void* WXColor
;
2482 typedef void WXDisplay
;
2483 typedef void WXEvent
;
2484 typedef void* WXCursor
;
2485 typedef void* WXPixmap
;
2486 typedef void* WXFontStructPtr
;
2488 typedef void* WXRegion
;
2489 typedef void* WXFont
;
2490 typedef void* WXImage
;
2491 typedef void* WXFontList
;
2492 typedef void* WXRendition
;
2493 typedef void* WXRenderTable
;
2494 typedef void* WXFontType
; /* either a XmFontList or XmRenderTable */
2495 typedef void* WXString
;
2497 typedef unsigned long Atom
; /* this might fail on a few architectures */
2503 /* Stand-ins for GLIB types */
2505 typedef signed char gint8
;
2507 typedef unsigned guint
;
2508 typedef unsigned long gulong
;
2509 typedef void* gpointer
;
2510 typedef struct _GSList GSList
;
2512 /* Stand-ins for GDK types */
2513 typedef struct _GdkColor GdkColor
;
2514 typedef struct _GdkColormap GdkColormap
;
2515 typedef struct _GdkFont GdkFont
;
2516 typedef struct _GdkGC GdkGC
;
2517 typedef struct _GdkVisual GdkVisual
;
2520 typedef struct _GdkAtom
*GdkAtom
;
2521 typedef struct _GdkDrawable GdkWindow
;
2522 typedef struct _GdkDrawable GdkBitmap
;
2523 typedef struct _GdkDrawable GdkPixmap
;
2524 #else /* GTK+ 1.2 */
2525 typedef gulong GdkAtom
;
2526 typedef struct _GdkWindow GdkWindow
;
2527 typedef struct _GdkWindow GdkBitmap
;
2528 typedef struct _GdkWindow GdkPixmap
;
2529 #endif /* GTK+ 1.2/2.0 */
2531 typedef struct _GdkCursor GdkCursor
;
2532 typedef struct _GdkRegion GdkRegion
;
2533 typedef struct _GdkDragContext GdkDragContext
;
2536 typedef struct _GdkIC GdkIC
;
2537 typedef struct _GdkICAttr GdkICAttr
;
2540 /* Stand-ins for GTK types */
2541 typedef struct _GtkWidget GtkWidget
;
2542 typedef struct _GtkRcStyle GtkRcStyle
;
2543 typedef struct _GtkAdjustment GtkAdjustment
;
2544 typedef struct _GtkList GtkList
;
2545 typedef struct _GtkToolbar GtkToolbar
;
2546 typedef struct _GtkTooltips GtkTooltips
;
2547 typedef struct _GtkNotebook GtkNotebook
;
2548 typedef struct _GtkNotebookPage GtkNotebookPage
;
2549 typedef struct _GtkAccelGroup GtkAccelGroup
;
2550 typedef struct _GtkItemFactory GtkItemFactory
;
2551 typedef struct _GtkSelectionData GtkSelectionData
;
2553 typedef GtkWidget
*WXWidget
;
2556 #define GTK_OBJECT_GET_CLASS(object) (GTK_OBJECT(object)->klass)
2557 #define GTK_CLASS_TYPE(klass) ((klass)->type)
2560 #endif /* __WXGTK__ */
2562 #if defined(__WXGTK20__) || (defined(__WXX11__) && wxUSE_UNICODE)
2563 #define wxUSE_PANGO 1
2565 #define wxUSE_PANGO 0
2569 /* Stand-ins for Pango types */
2570 typedef struct _PangoContext PangoContext
;
2571 typedef struct _PangoLayout PangoLayout
;
2572 typedef struct _PangoFontDescription PangoFontDescription
;
2576 typedef struct window_t
*WXWidget
;
2579 /* This is required because of clashing macros in windows.h, which may be */
2580 /* included before or after wxWidgets classes, and therefore must be */
2581 /* disabled here before any significant wxWidgets headers are included. */
2613 /* --------------------------------------------------------------------------- */
2614 /* macro to define a class without copy ctor nor assignment operator */
2615 /* --------------------------------------------------------------------------- */
2617 #define DECLARE_NO_COPY_CLASS(classname) \
2619 classname(const classname&); \
2620 classname& operator=(const classname&);
2622 #define DECLARE_NO_ASSIGN_CLASS(classname) \
2624 classname& operator=(const classname&);