]> git.saurik.com Git - wxWidgets.git/blame - include/wx/defs.h
projects / wxWidgets.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Use (newly) added wxStaticCastVariantData() to fix wxNO_RTTI build.
[wxWidgets.git] / include / wx / defs.h
CommitLineData
cdd8d745
VZ		 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 */
34cbe514
RN		 11
12/* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
c801d85f 13
34138703
JS		 14#ifndef _WX_DEFS_H_
15#define _WX_DEFS_H_
c801d85f 16
e78c47e3
DS		 17/*
18 NOTE: this symbol will be replaced with "WXWIN_COMPATIBILITY_3_0" as soon
19 as the development branch for 3.1 is created
20 */
ac3688c0
FM		 21#define FUTURE_WXWIN_COMPATIBILITY_3_0 1
22#define wxDEPRECATED_FUTURE( x ) x
23
34cbe514
RN		 24/* ---------------------------------------------------------------------------- */
25/* compiler and OS identification */
26/* ---------------------------------------------------------------------------- */
c801d85f 27
78340847 28#include "wx/platform.h"
bb48ed2c 29
fa9982d7 30#ifdef __cplusplus
34cbe514 31/* Make sure the environment is set correctly */
fa9982d7 32# if defined(__WXMSW__) && defined(__X__)
fa3f1180 33# error "Target can't be both X and MSW"
21d09ecd
WS		 34# elif !defined(__WXMOTIF__) && \
35 !defined(__WXMSW__) && \
36 !defined(__WXGTK__) && \
37 !defined(__WXPM__) && \
bfa29337
SC		 38 !defined(__WXOSX_CARBON__) && \
39 !defined(__WXOSX_COCOA__) && \
40 !defined(__WXOSX_IPHONE__) && \
21d09ecd
WS		 41 !defined(__WXCOCOA__) && \
42 !defined(__X__) && \
b3c86150 43 !defined(__WXDFB__) && \
21d09ecd
WS		 44 !defined(__WXX11__) && \
45 wxUSE_GUI
fa9982d7
RN		 46# ifdef __UNIX__
47# error "No Target! You should use wx-config program for compilation flags!"
48# else /* !Unix */
49# error "No Target! You should use supplied makefiles for compilation!"
50# endif /* Unix/!Unix */
51# endif
52#endif /*__cplusplus*/
886dd7d2
VZ		 53
54#ifndef __WXWINDOWS__
55 #define __WXWINDOWS__ 1
56#endif
57
58#ifndef wxUSE_BASE
34cbe514 59 /* by default consider that this is a monolithic build */
886dd7d2 60 #define wxUSE_BASE 1
aaa63f66
VZ		 61#endif
62
a6ab05be
VZ		 63#if !wxUSE_GUI && !defined(__WXBASE__)
64 #define __WXBASE__
65#endif
66
34cbe514 67/* suppress some Visual C++ warnings */
3f4a0c5b 68#ifdef __VISUALC__
7a5cebca 69 /* the only "real" warning here is 4244 but there are just too many of them */
34cbe514 70 /* in our code... one day someone should go and fix them but until then... */
77df51f4 71# pragma warning(disable:4097) /* typedef used as class */
34cbe514
RN		 72# pragma warning(disable:4201) /* nonstandard extension used: nameless struct/union */
73# pragma warning(disable:4244) /* conversion from double to float */
77df51f4 74# pragma warning(disable:4355) /* 'this' used in base member initializer list */
34cbe514
RN		 75# pragma warning(disable:4511) /* copy ctor couldn't be generated */
76# pragma warning(disable:4512) /* operator=() couldn't be generated */
a8db7a5f 77# pragma warning(disable:4514) /* unreferenced inline func has been removed */
77df51f4 78# pragma warning(disable:4710) /* function not inlined */
16357053 79
e78c47e3
DS		 80 /*
81 TODO: this warning should really be enabled as it can be genuinely
82 useful, check where does it occur in wxWidgets
83 */
a8db7a5f
VZ		 84 #pragma warning(disable: 4127) /* conditional expression is constant */
85
b85e0ae0
VS		 86 /* There are too many false positivies for this one, particularly when
87 using templates like wxVector<T> */
88 /* class 'foo' needs to have dll-interface to be used by clients of
89 class 'bar'" */
90# pragma warning(disable:4251)
91
01871bf6
VZ		 92 /*
93 This is a similar warning which occurs when deriving from standard
94 containers. MSDN even mentions that it can be ignored in this case
95 (albeit only in debug build while the warning is the same in release
96 too and seems equally harmless).
97 */
98#if wxUSE_STD_CONTAINERS
99# pragma warning(disable:4275)
e78c47e3 100#endif /* wxUSE_STD_CONTAINERS */
01871bf6 101
a8db7a5f 102# ifdef __VISUALC5__
8d7eaf91
MW		 103 /* For VC++ 5.0 for release mode, the warning 'C4702: unreachable code */
104 /* is buggy, and occurs for code that does actually get executed */
a8db7a5f 105# ifndef __WXDEBUG__
faa94f3e 106# pragma warning(disable:4702) /* unreachable code */
ac55e0a1 107# endif
a8db7a5f 108
ac55e0a1
MW		 109 /* The VC++ 5.0 warning 'C4003: not enough actual parameters for macro'
110 * is incompatible with the wxWidgets headers since it is given when
111 * parameters are empty but not missing. */
ac55e0a1 112# pragma warning(disable:4003) /* not enough actual parameters for macro */
8d7eaf91
MW		 113# endif
114
a8db7a5f 115 /*
0c14b6c3 116 VC6 insists on complaining about
a8db7a5f
VZ		 117
118 return type for 'wxVector<T>::reverse_iterator::operator ->' is 'T **'
119 (ie; not a UDT or reference to a UDT. Will produce errors if applied
120 using infix notation)
121
122 which is perfectly fine because template classes do routinely define
123 operators which don't make sense for all template parameter values
124 (besides this warning was removed in subsequent versions).
125 */
126 #ifdef __VISUALC6__
127 #pragma warning(disable: 4284)
e78c47e3 128 #endif /* VC6 */
a8db7a5f 129
19472770
VZ		 130 /*
131 When compiling with VC++ 7 /Wp64 option we get thousands of warnings for
132 conversion from size_t to int or long. Some precious few of them might
133 be worth looking into but unfortunately it seems infeasible to fix all
134 the other, harmless ones (e.g. inserting static_cast<int>(s.length())
135 everywhere this method is used though we are quite sure that using >4GB
136 strings is a bad idea anyhow) so just disable it globally for now.
137 */
138 #if wxCHECK_VISUALC_VERSION(7)
139 /* conversion from 'size_t' to 'unsigned long', possible loss of data */
140 #pragma warning(disable:4267)
141 #endif /* VC++ 7 or later */
142
4c820583
VZ		 143 /*
144 VC++ 8 gives a warning when using standard functions such as sprintf,
145 localtime, ... -- stop this madness, unless the user had already done it
146 */
19472770 147 #if wxCHECK_VISUALC_VERSION(8)
4c820583
VZ		 148 #ifndef _CRT_SECURE_NO_DEPRECATE
149 #define _CRT_SECURE_NO_DEPRECATE 1
150 #endif
151 #ifndef _CRT_NON_CONFORMING_SWPRINTFS
152 #define _CRT_NON_CONFORMING_SWPRINTFS 1
153 #endif
7faab5c5
VZ		 154 #ifndef _SCL_SECURE_NO_WARNINGS
155 #define _SCL_SECURE_NO_WARNINGS 1
156 #endif
4c820583 157 #endif /* VC++ 8 */
34cbe514 158#endif /* __VISUALC__ */
c801d85f 159
34cbe514 160/* suppress some Borland C++ warnings */
4f6e963c 161#ifdef __BORLANDC__
34cbe514
RN		 162# pragma warn -inl /* Functions containing reserved words and certain constructs are not expanded inline */
163#endif /* __BORLANDC__ */
4f6e963c 164
b47f1f95
VZ		 165/*
166 g++ gives a warning when a class has private dtor if it has no friends but
167 this is a perfectly valid situation for a ref-counted class which destroys
168 itself when its ref count drops to 0, so provide a macro to suppress this
169 warning
170 */
171#ifdef __GNUG__
172# define wxSUPPRESS_GCC_PRIVATE_DTOR_WARNING(name) \
173 friend class wxDummyFriendFor ## name;
174#else /* !g++ */
175# define wxSUPPRESS_GCC_PRIVATE_DTOR_WARNING(name)
176#endif
177
9deded79
SC		 178/*
179 Clang Support
180 */
181
182#ifndef WX_HAS_CLANG_FEATURE
183# ifndef __has_feature
184# define WX_HAS_CLANG_FEATURE(x) 0
185# else
186# define WX_HAS_CLANG_FEATURE(x) __has_feature(x)
187# endif
188#endif
189
34cbe514 190/* ---------------------------------------------------------------------------- */
77ffb593 191/* wxWidgets version and compatibility defines */
34cbe514 192/* ---------------------------------------------------------------------------- */
e90c1d2a 193
78340847
VZ		 194#include "wx/version.h"
195
34cbe514
RN		 196/* ============================================================================ */
197/* non portable C++ features */
198/* ============================================================================ */
57493f9f 199
34cbe514
RN		 200/* ---------------------------------------------------------------------------- */
201/* compiler defects workarounds */
202/* ---------------------------------------------------------------------------- */
78340847 203
78340847
VZ		 204/*
205 Digital Unix C++ compiler only defines this symbol for .cxx and .hxx files,
206 so define it ourselves (newer versions do it for all files, though, and
207 don't allow it to be redefined)
208 */
4f89dbc4
RL		 209#if defined(__DECCXX) && !defined(__VMS) && !defined(__cplusplus)
210#define __cplusplus
78340847
VZ		 211#endif /* __DECCXX */
212
34cbe514 213/* Resolves linking problems under HP-UX when compiling with gcc/g++ */
78340847 214#if defined(__HPUX__) && defined(__GNUG__)
4f89dbc4 215#define va_list __gnuc_va_list
34cbe514 216#endif /* HP-UX */
78340847 217
715e4f7e
VZ		 218/* Prevents conflicts between sys/types.h and winsock.h with Cygwin, */
219/* when using Windows sockets. */
acbed114 220#if defined(__CYGWIN__) && defined(__WXMSW__)
715e4f7e
VZ		 221#define __USE_W32_SOCKETS
222#endif
223
34cbe514
RN		 224/* ---------------------------------------------------------------------------- */
225/* check for native bool type and TRUE/FALSE constants */
226/* ---------------------------------------------------------------------------- */
57493f9f 227
34cbe514
RN		 228/* for backwards compatibility, also define TRUE and FALSE */
229/* */
230/* note that these definitions should work both in C++ and C code, so don't */
231/* use true/false below */
90b1d65f
VZ		 232#ifndef TRUE
233 #define TRUE 1
234#endif
235
236#ifndef FALSE
237 #define FALSE 0
238#endif
a2d541ca 239
c801d85f 240typedef short int WXTYPE;
42e69d6b 241
c801d85f 242
34cbe514
RN		 243/* ---------------------------------------------------------------------------- */
244/* other feature tests */
245/* ---------------------------------------------------------------------------- */
0b9ab0bd 246
34cbe514
RN		 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. */
3a5bcc4d 253#define wxUSE_NESTED_CLASSES 1
0b9ab0bd 254
34cbe514 255/* check for explicit keyword support */
986ecc86 256#ifndef HAVE_EXPLICIT
521196a2 257 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
34cbe514 258 /* VC++ 6.0 and 5.0 have explicit (what about earlier versions?) */
521196a2
MB		 259 #define HAVE_EXPLICIT
260 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
261 && wxCHECK_GCC_VERSION(2, 95)
34cbe514 262 /* GCC 2.95 has explicit, what about earlier versions? */
cabf185c
VZ		 263 #define HAVE_EXPLICIT
264 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x0520)
34cbe514 265 /* BC++ 4.52 doesn't support explicit, CBuilder 1 does */
74bdbc46 266 #define HAVE_EXPLICIT
0b3f29b3 267 #elif defined(__DIGITALMARS__)
76c71809 268 #define HAVE_EXPLICIT
8a3bc532
VS		 269 #elif defined(__WATCOMC__)
270 #define HAVE_EXPLICIT
986ecc86 271 #endif
34cbe514 272#endif /* !HAVE_EXPLICIT */
986ecc86
VZ		 273
274#ifdef HAVE_EXPLICIT
275 #define wxEXPLICIT explicit
34cbe514 276#else /* !HAVE_EXPLICIT */
986ecc86 277 #define wxEXPLICIT
34cbe514 278#endif /* HAVE_EXPLICIT/!HAVE_EXPLICIT */
986ecc86 279
4c1d5d5a
VZ		 280/* these macros are obsolete, use the standard C++ casts directly now */
281#define wx_static_cast(t, x) static_cast<t>(x)
282#define wx_const_cast(t, x) const_cast<t>(x)
283#define wx_reinterpret_cast(t, x) reinterpret_cast<t>(x)
8c8d66c5 284
c781c316
VZ		 285/*
286 This one is a wx invention: like static cast but used when we intentionally
287 truncate from a larger to smaller type, static_cast<> can't be used for it
288 as it results in warnings when using some compilers (SGI mipspro for example)
289 */
17a1ebd1
VZ		 290#if defined(__INTELC__) && defined(__cplusplus)
291 template <typename T, typename X>
292 inline T wx_truncate_cast_impl(X x)
293 {
294 #pragma warning(push)
e5d92e2b
MW		 295 /* implicit conversion of a 64-bit integral type to a smaller integral type */
296 #pragma warning(disable: 1682)
297 /* conversion from "X" to "T" may lose significant bits */
298 #pragma warning(disable: 810)
5c69ef61
VZ		 299 /* non-pointer conversion from "foo" to "bar" may lose significant bits */
300 #pragma warning(disable: 2259)
17a1ebd1 301
e5d92e2b 302 return x;
17a1ebd1
VZ		 303
304 #pragma warning(pop)
305 }
306
307 #define wx_truncate_cast(t, x) wx_truncate_cast_impl<t>(x)
c1b61782
MW		 308
309#elif defined(__cplusplus) && defined(__VISUALC__) && __VISUALC__ >= 1310
310 template <typename T, typename X>
311 inline T wx_truncate_cast_impl(X x)
312 {
313 #pragma warning(push)
314 /* conversion from 'X' to 'T', possible loss of data */
315 #pragma warning(disable: 4267)
316
317 return x;
318
319 #pragma warning(pop)
320 }
321
322 #define wx_truncate_cast(t, x) wx_truncate_cast_impl<t>(x)
323#else
17a1ebd1 324 #define wx_truncate_cast(t, x) ((t)(x))
c1b61782 325#endif
c781c316 326
f29fe169
VZ		 327/* for consistency with wxStatic/DynamicCast defined in wx/object.h */
328#define wxConstCast(obj, className) wx_const_cast(className *, obj)
329
e87b7833
MB		 330#ifndef HAVE_STD_WSTRING
331 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
34cbe514 332 /* VC++ 6.0 and 5.0 have std::wstring (what about earlier versions?) */
e87b7833 333 #define HAVE_STD_WSTRING
3cd9070c 334 #elif defined(__MINGW32__) && wxCHECK_GCC_VERSION(3, 3)
34cbe514 335 /* GCC 3.1 has std::wstring; 3.0 never was in MinGW, 2.95 hasn't it */
e87b7833
MB		 336 #define HAVE_STD_WSTRING
337 #endif
338#endif
339
340#ifndef HAVE_STD_STRING_COMPARE
341 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
34cbe514
RN		 342 /* VC++ 6.0 and 5.0 have std::string::compare */
343 /* (what about earlier versions?) */
e87b7833
MB		 344 #define HAVE_STD_STRING_COMPARE
345 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
346 && wxCHECK_GCC_VERSION(3, 1)
34cbe514
RN		 347 /* GCC 3.1 has std::string::compare; */
348 /* 3.0 never was in MinGW, 2.95 hasn't it */
e87b7833
MB		 349 #define HAVE_STD_STRING_COMPARE
350 #endif
351#endif
352
0f895b0c
VS		 353#ifndef HAVE_TR1_TYPE_TRAITS
354 #if defined(__VISUALC__) && (_MSC_FULL_VER >= 150030729)
355 #define HAVE_TR1_TYPE_TRAITS
356 #endif
357#endif
358
d85cfb37
VZ		 359/* provide replacement for C99 va_copy() if the compiler doesn't have it */
360
361/* could be already defined by configure or the user */
362#ifndef wxVaCopy
363 /* if va_copy is a macro or configure detected that we have it, use it */
364 #if defined(va_copy) || defined(HAVE_VA_COPY)
365 #define wxVaCopy va_copy
366 #else /* no va_copy, try to provide a replacement */
367 /*
368 configure tries to determine whether va_list is an array or struct
369 type, but it may not be used under Windows, so deal with a few
370 special cases.
371 */
372
373 #ifdef __WATCOMC__
374 /* Watcom uses array type for va_list except for PPC and Alpha */
375 #if !defined(__PPC__) && !defined(__AXP__)
376 #define VA_LIST_IS_ARRAY
377 #endif
378 #endif /* __WATCOMC__ */
379
380 #if defined(__PPC__) && (defined(_CALL_SYSV) || defined (_WIN32))
381 /*
382 PPC using SysV ABI and NT/PPC are special in that they use an
383 extra level of indirection.
384 */
385 #define VA_LIST_IS_POINTER
386 #endif /* SysV or Win32 on __PPC__ */
387
388 /*
389 note that we use memmove(), not memcpy(), in case anybody tries
390 to do wxVaCopy(ap, ap)
391 */
392 #if defined(VA_LIST_IS_POINTER)
393 #define wxVaCopy(d, s) memmove(*(d), *(s), sizeof(va_list))
394 #elif defined(VA_LIST_IS_ARRAY)
395 #define wxVaCopy(d, s) memmove((d), (s), sizeof(va_list))
396 #else /* we can only hope that va_lists are simple lvalues */
397 #define wxVaCopy(d, s) ((d) = (s))
398 #endif
399 #endif /* va_copy/!va_copy */
14778505 400#endif /* wxVaCopy */
d85cfb37 401
37db38bc
VS		 402#ifndef HAVE_VARIADIC_MACROS
403 #if wxCHECK_WATCOM_VERSION(1,2)
404 #define HAVE_VARIADIC_MACROS
405 #endif
96c96402
VZ		 406
407 #if wxCHECK_VISUALC_VERSION(9)
408 #define HAVE_VARIADIC_MACROS
409 #endif
37db38bc
VS		 410#endif /* HAVE_VARIADIC_MACROS */
411
d85cfb37 412
6a6ea041 413#ifndef HAVE_WOSTREAM
e78c47e3 414 /*
bd362275 415 Mingw <= 3.4 and all versions of Cygwin don't have std::wostream
e78c47e3 416 */
bd362275 417 #if (defined(__MINGW32__) && !wxCHECK_GCC_VERSION(4, 0)) || \
3cd9070c 418 defined(__CYGWIN__)
41aeb94e
VZ		 419 #define wxNO_WOSTREAM
420 #endif
421
e78c47e3 422 /* VC++ doesn't have it in the old iostream library */
41aeb94e
VZ		 423 #if defined(__VISUALC__) && wxUSE_IOSTREAMH
424 #define wxNO_WOSTREAM
425 #endif
426
427 #ifndef wxNO_WOSTREAM
6a6ea041
VS		 428 #define HAVE_WOSTREAM
429 #endif
41aeb94e
VZ		 430
431 #undef wxNO_WOSTREAM
6a6ea041
VS		 432#endif /* HAVE_WOSTREAM */
433
e78c47e3
DS		 434/* ---------------------------------------------------------------------------- */
435/* other C++ features */
436/* ---------------------------------------------------------------------------- */
cc6ceca7
VZ		 437
438#ifndef HAVE_PARTIAL_SPECIALIZATION
e78c47e3 439 /* be optimistic by default */
cc6ceca7
VZ		 440 #define HAVE_PARTIAL_SPECIALIZATION
441#endif
442
443#ifdef __VISUALC__
444 #if __VISUALC__ < 1310
445 #undef HAVE_PARTIAL_SPECIALIZATION
446 #endif
e78c47e3 447#endif /* __VISUALC__ */
cc6ceca7 448
7005cf44
VZ		 449
450#ifndef HAVE_TEMPLATE_OVERLOAD_RESOLUTION
e78c47e3
DS		 451 /* assume the compiler can use type or const expressions as template
452 arguments if it supports partial specialization -- except if it's a
453 Borland one which can't */
18caa1e9 454 #if defined(HAVE_PARTIAL_SPECIALIZATION) && !defined(__BORLANDC__)
7005cf44 455 #define HAVE_TEMPLATE_OVERLOAD_RESOLUTION
e78c47e3
DS		 456 #endif /* (HAVE_PARTIAL_SPECIALIZATION) && !defined(__BORLANDC__) */
457#endif /* !defined(HAVE_TEMPLATE_OVERLOAD_RESOLUTION) */
7005cf44 458
34cbe514
RN		 459/* ---------------------------------------------------------------------------- */
460/* portable calling conventions macros */
461/* ---------------------------------------------------------------------------- */
0661ec39 462
34cbe514 463/* stdcall is used for all functions called by Windows under Windows */
b4da152e 464#if defined(__WINDOWS__)
1222db72 465 #if defined(__GNUWIN32__)
ba2d8605 466 #define wxSTDCALL __attribute__((stdcall))
0661ec39 467 #else
34cbe514 468 /* both VC++ and Borland understand this */
ba2d8605 469 #define wxSTDCALL _stdcall
0661ec39 470 #endif
ba2d8605 471
34cbe514
RN		 472#else /* Win */
473 /* no such stupidness under Unix */
1222db72 474 #define wxSTDCALL
34cbe514 475#endif /* platform */
1222db72 476
34cbe514 477/* LINKAGEMODE mode is empty for everyting except OS/2 */
78340847
VZ		 478#ifndef LINKAGEMODE
479 #define LINKAGEMODE
34cbe514 480#endif /* LINKAGEMODE */
78340847 481
34cbe514
RN		 482/* wxCALLBACK should be used for the functions which are called back by */
483/* Windows (such as compare function for wxListCtrl) */
04ef50df 484#if defined(__WIN32__) && !defined(__WXMICROWIN__)
1222db72 485 #define wxCALLBACK wxSTDCALL
0661ec39 486#else
34cbe514 487 /* no stdcall under Unix nor Win16 */
0661ec39 488 #define wxCALLBACK
34cbe514 489#endif /* platform */
0661ec39 490
34cbe514 491/* generic calling convention for the extern "C" functions */
0661ec39
VZ		 492
493#if defined(__VISUALC__)
90350682 494 #define wxC_CALLING_CONV _cdecl
0661ec39 495#elif defined(__VISAGECPP__)
90350682 496 #define wxC_CALLING_CONV _Optlink
34cbe514 497#else /* !Visual C++ */
90350682 498 #define wxC_CALLING_CONV
34cbe514 499#endif /* compiler */
0661ec39 500
34cbe514 501/* callling convention for the qsort(3) callback */
90350682
VZ		 502#define wxCMPFUNC_CONV wxC_CALLING_CONV
503
34cbe514 504/* compatibility :-( */
0661ec39
VZ		 505#define CMPFUNC_CONV wxCMPFUNC_CONV
506
34cbe514 507/* DLL import/export declarations */
0cc66b6c 508#include "wx/dlimpexp.h"
c801d85f 509
34cbe514
RN		 510/* ---------------------------------------------------------------------------- */
511/* Very common macros */
512/* ---------------------------------------------------------------------------- */
f6bcfd97 513
34cbe514 514/* Printf-like attribute definitions to obtain warnings with GNU C/C++ */
862bb5c7 515#ifndef WX_ATTRIBUTE_PRINTF
e57ee9bb 516# if defined(__GNUC__) && !wxUSE_UNICODE
862bb5c7 517# define WX_ATTRIBUTE_PRINTF(m, n) __attribute__ ((__format__ (__printf__, m, n)))
e57ee9bb 518# else
862bb5c7 519# define WX_ATTRIBUTE_PRINTF(m, n)
e57ee9bb
VZ		 520# endif
521
862bb5c7
VS		 522# define WX_ATTRIBUTE_PRINTF_1 WX_ATTRIBUTE_PRINTF(1, 2)
523# define WX_ATTRIBUTE_PRINTF_2 WX_ATTRIBUTE_PRINTF(2, 3)
524# define WX_ATTRIBUTE_PRINTF_3 WX_ATTRIBUTE_PRINTF(3, 4)
525# define WX_ATTRIBUTE_PRINTF_4 WX_ATTRIBUTE_PRINTF(4, 5)
526# define WX_ATTRIBUTE_PRINTF_5 WX_ATTRIBUTE_PRINTF(5, 6)
527#endif /* !defined(WX_ATTRIBUTE_PRINTF) */
e57ee9bb 528
9deded79
SC		 529#ifndef WX_ATTRIBUTE_NORETURN
530# if WX_HAS_CLANG_FEATURE(attribute_analyzer_noreturn)
531# define WX_ATTRIBUTE_NORETURN __attribute__((analyzer_noreturn))
532# elif defined( __GNUC__ )
533# define WX_ATTRIBUTE_NORETURN __attribute__ ((noreturn))
534# elif wxCHECK_VISUALC_VERSION(7)
535# define WX_ATTRIBUTE_NORETURN __declspec(noreturn)
536# else
537# define WX_ATTRIBUTE_NORETURN
538# endif
539#endif
54afeafe 540
34cbe514 541/* Macro to issue warning when using deprecated functions with gcc3 or MSVC7: */
7071c928 542#if wxCHECK_GCC_VERSION(3, 1)
a9dce889 543 #define wxDEPRECATED(x) __attribute__((deprecated)) x
c75274f9
VS		 544#elif defined(__VISUALC__) && (__VISUALC__ >= 1300)
545 #define wxDEPRECATED(x) __declspec(deprecated) x
546#else
547 #define wxDEPRECATED(x) x
548#endif
549
02106526
VZ		 550#if defined(__GNUC__) && !wxCHECK_GCC_VERSION(3, 4)
551 /*
552 We need to add dummy "inline" to allow gcc < 3.4 to handle the
553 deprecation attribute on the constructors.
554 */
70bf3295 555 #define wxDEPRECATED_CONSTRUCTOR(x) wxDEPRECATED( inline x)
02106526
VZ		 556#else
557 #define wxDEPRECATED_CONSTRUCTOR(x) wxDEPRECATED(x)
70bf3295 558#endif
0c14b6c3 559
a9dce889
VZ		 560/*
561 Macro which marks the function as being deprecated but also defines it
562 inline.
563
564 Currently it's defined in the same trivial way in all cases but it could
565 need a special definition with some other compilers in the future which
566 explains why do we have it.
567 */
568#define wxDEPRECATED_INLINE(func, body) wxDEPRECATED(func) { body }
569
2352862a
VZ		 570/*
571 A macro to define a simple deprecated accessor.
572 */
573#define wxDEPRECATED_ACCESSOR(func, what) wxDEPRECATED_INLINE(func, return what;)
574
5d88a6b5
VZ		 575/*
576 Special variant of the macro above which should be used for the functions
577 which are deprecated but called by wx itself: this often happens with
578 deprecated virtual functions which are called by the library.
579 */
580#ifdef WXBUILDING
581# define wxDEPRECATED_BUT_USED_INTERNALLY(x) x
582#else
583# define wxDEPRECATED_BUT_USED_INTERNALLY(x) wxDEPRECATED(x)
584#endif
585
531cfed2
VZ		 586/*
587 Combination of the two variants above: should be used for deprecated
588 functions which are defined inline and are used by wxWidgets itself.
589 */
590#ifdef WXBUILDING
591# define wxDEPRECATED_BUT_USED_INTERNALLY_INLINE(func, body) func { body }
592#else
593# define wxDEPRECATED_BUT_USED_INTERNALLY_INLINE(func, body) \
594 wxDEPRECATED(func) { body }
595#endif
596
34cbe514
RN		 597/* NULL declaration: it must be defined as 0 for C++ programs (in particular, */
598/* it must not be defined as "(void *)0" which is standard for C but completely */
599/* breaks C++ code) */
bd362275 600#if !defined(__HANDHELDPC__)
aaa63f66 601#include <stddef.h>
daeb8330 602#endif
aaa63f66 603
604fba2d 604#ifdef __cplusplus
993df040
VZ		 605
606// everybody gets the assert and other debug macros
607#include "wx/debug.h"
608
604fba2d
VZ		 609 // delete pointer if it is not NULL and NULL it afterwards
610 template <typename T>
611 inline void wxDELETE(T*& ptr)
612 {
613 typedef char TypeIsCompleteCheck[sizeof(T)];
614
615 if ( ptr != NULL )
616 {
617 delete ptr;
618 ptr = NULL;
619 }
620 }
621
622 // delete an array and NULL it (see comments above)
623 template <typename T>
624 inline void wxDELETEA(T*& ptr)
625 {
626 typedef char TypeIsCompleteCheck[sizeof(T)];
627
628 if ( ptr != NULL )
629 {
630 delete [] ptr;
631 ptr = NULL;
632 }
633 }
6ebd2716
VZ		 634
635 // trivial implementation of std::swap() for primitive types
636 template <typename T>
637 inline void wxSwap(T& first, T& second)
638 {
639 T tmp(first);
640 first = second;
641 second = tmp;
642 }
604fba2d 643#endif /*__cplusplus*/
c801d85f 644
34cbe514 645/* size of statically declared array */
c801d85f
KB		 646#define WXSIZEOF(array) (sizeof(array)/sizeof(array[0]))
647
34cbe514
RN		 648/* symbolic constant used by all Find()-like functions returning positive */
649/* integer on success as failure indicator */
886dd7d2
VZ		 650#define wxNOT_FOUND (-1)
651
6df09f32
VS		 652/* the default value for some length parameters meaning that the string is */
653/* NUL-terminated */
654#define wxNO_LEN ((size_t)-1)
655
fb52c2b6
VZ		 656/* ---------------------------------------------------------------------------- */
657/* macros dealing with comparison operators */
658/* ---------------------------------------------------------------------------- */
659
660/*
661 Expands into m(op, args...) for each op in the set { ==, !=, <, <=, >, >= }.
662 */
663#define wxFOR_ALL_COMPARISONS(m) \
664 m(==) m(!=) m(>=) m(<=) m(>) m(<)
665
666#define wxFOR_ALL_COMPARISONS_1(m, x) \
667 m(==,x) m(!=,x) m(>=,x) m(<=,x) m(>,x) m(<,x)
668
669#define wxFOR_ALL_COMPARISONS_2(m, x, y) \
670 m(==,x,y) m(!=,x,y) m(>=,x,y) m(<=,x,y) m(>,x,y) m(<,x,y)
671
672#define wxFOR_ALL_COMPARISONS_3(m, x, y, z) \
673 m(==,x,y,z) m(!=,x,y,z) m(>=,x,y,z) m(<=,x,y,z) m(>,x,y,z) m(<,x,y,z)
674
831faf97
VZ		 675/*
676 This is only used with wxDEFINE_COMPARISON_REV: it passes both the normal
677 and the reversed comparison operators to the macro.
678 */
679#define wxFOR_ALL_COMPARISONS_3_REV(m, x, y, z) \
680 m(==,x,y,z,==) m(!=,x,y,z,!=) m(>=,x,y,z,<=) \
681 m(<=,x,y,z,>=) m(>,x,y,z,<) m(<,x,y,z,>)
682
fb52c2b6
VZ		 683
684#define wxDEFINE_COMPARISON(op, T1, T2, cmp) \
685 inline bool operator op(T1 x, T2 y) { return cmp(x, y, op); }
686
831faf97
VZ		 687#define wxDEFINE_COMPARISON_REV(op, T1, T2, cmp, oprev) \
688 inline bool operator op(T2 y, T1 x) { return cmp(x, y, oprev); }
fb52c2b6
VZ		 689
690/*
691 Define all 6 comparison operators (==, !=, <, <=, >, >=) for the given
692 types in the specified order. The implementation is provided by the cmp
693 macro. Normally wxDEFINE_ALL_COMPARISONS should be used as comparison
694 operators are usually symmetric.
695 */
696#define wxDEFINE_COMPARISONS(T1, T2, cmp) \
697 wxFOR_ALL_COMPARISONS_3(wxDEFINE_COMPARISON, T1, T2, cmp)
698
699/*
700 This macro allows to define all 12 comparison operators (6 operators for
701 both orders of arguments) for the given types using the provided "cmp"
702 macro to implement the actual comparison: the macro is called with the 2
703 arguments names, the first of type T1 and the second of type T2, and the
704 comparison operator being implemented.
705 */
706#define wxDEFINE_ALL_COMPARISONS(T1, T2, cmp) \
707 wxFOR_ALL_COMPARISONS_3(wxDEFINE_COMPARISON, T1, T2, cmp) \
831faf97 708 wxFOR_ALL_COMPARISONS_3_REV(wxDEFINE_COMPARISON_REV, T1, T2, cmp)
fb52c2b6 709
34cbe514
RN		 710/* ---------------------------------------------------------------------------- */
711/* macros to avoid compiler warnings */
712/* ---------------------------------------------------------------------------- */
0cc66b6c 713
34cbe514
RN		 714/* Macro to cut down on compiler warnings. */
715#if 1 /* there should be no more any compilers needing the "#else" version */
0cc66b6c 716 #define WXUNUSED(identifier) /* identifier */
34cbe514 717#else /* stupid, broken compiler */
0cc66b6c
VZ		 718 #define WXUNUSED(identifier) identifier
719#endif
720
7bea7b91
WS		 721/* some arguments are not used in unicode mode */
722#if wxUSE_UNICODE
723 #define WXUNUSED_IN_UNICODE(param) WXUNUSED(param)
724#else
725 #define WXUNUSED_IN_UNICODE(param) param
726#endif
727
728/* some arguments are not used in WinCE build */
729#ifdef __WXWINCE__
730 #define WXUNUSED_IN_WINCE(param) WXUNUSED(param)
731#else
732 #define WXUNUSED_IN_WINCE(param) param
733#endif
734
9a6384ca
WS		 735/* unused parameters in non stream builds */
736#if wxUSE_STREAMS
737 #define WXUNUSED_UNLESS_STREAMS(param) param
738#else
739 #define WXUNUSED_UNLESS_STREAMS(param) WXUNUSED(param)
740#endif
741
34cbe514
RN		 742/* some compilers give warning about a possibly unused variable if it is */
743/* initialized in both branches of if/else and shut up if it is initialized */
744/* when declared, but other compilers then give warnings about unused variable */
745/* value -- this should satisfy both of them */
0cc66b6c
VZ		 746#if defined(__VISUALC__)
747 #define wxDUMMY_INITIALIZE(val) = val
748#else
749 #define wxDUMMY_INITIALIZE(val)
750#endif
751
34cbe514
RN		 752/* sometimes the value of a variable is *really* not used, to suppress the */
753/* resulting warning you may pass it to this function */
754#ifdef __cplusplus
755# ifdef __BORLANDC__
756# define wxUnusedVar(identifier) identifier
757# else
758 template <class T>
759 inline void wxUnusedVar(const T& WXUNUSED(t)) { }
760# endif
8703bc01 761#endif
0cc66b6c 762
34cbe514
RN		 763/* ---------------------------------------------------------------------------- */
764/* compiler specific settings */
765/* ---------------------------------------------------------------------------- */
c801d85f 766
6d3d756a 767#if wxONLY_WATCOM_EARLIER_THAN(1,4)
18da7cf2
VZ		 768 typedef short mode_t;
769#endif
770
34cbe514
RN		 771/* where should i put this? we need to make sure of this as it breaks */
772/* the <iostream> code. */
ea57084d 773#if !wxUSE_IOSTREAMH && defined(__WXDEBUG__)
f6bcfd97
BP		 774# ifdef wxUSE_DEBUG_NEW_ALWAYS
775# undef wxUSE_DEBUG_NEW_ALWAYS
776# define wxUSE_DEBUG_NEW_ALWAYS 0
777# endif
518f33a4 778#endif
85ee3474 779
34cbe514 780/* ---------------------------------------------------------------------------- */
77ffb593 781/* standard wxWidgets types */
34cbe514 782/* ---------------------------------------------------------------------------- */
d716d967 783
34cbe514 784/* the type for screen and DC coordinates */
376a8ce2 785typedef int wxCoord;
72cdf4c9 786
1f319228 787enum { wxDefaultCoord = -1 };
d716d967 788
34cbe514
RN		 789/* ---------------------------------------------------------------------------- */
790/* define fixed length types */
791/* ---------------------------------------------------------------------------- */
8fb37472 792
bd362275 793#if defined(__MINGW32__)
20bc5ad8
WS		 794 #include <sys/types.h>
795#endif
796
34cbe514
RN		 797/* chars are always one byte (by definition), shorts are always two (in */
798/* practice) */
8fb37472 799
34cbe514 800/* 8bit */
8fb37472
VZ		 801typedef signed char wxInt8;
802typedef unsigned char wxUint8;
803typedef wxUint8 wxByte;
804
805
34cbe514 806/* 16bit */
8fb37472
VZ		 807#ifdef SIZEOF_SHORT
808 #if SIZEOF_SHORT != 2
77ffb593 809 #error "wxWidgets assumes sizeof(short) == 2, please fix the code"
8fb37472
VZ		 810 #endif
811#else
812 #define SIZEOF_SHORT 2
813#endif
814
815typedef signed short wxInt16;
816typedef unsigned short wxUint16;
817
818typedef wxUint16 wxWord;
819
820/*
821 things are getting more interesting with ints, longs and pointers
822
823 there are several different standard data models described by this table:
824
825 +-----------+----------------------------+
826 |type\model | LP64 ILP64 LLP64 ILP32 LP32|
827 +-----------+----------------------------+
828 |char | 8 8 8 8 8 |
829 |short | 16 16 16 16 16 |
830 |int | 32 64 32 32 16 |
831 |long | 64 64 32 32 32 |
8279e59a 832 |long long | 64 64 64 -- -- |
8fb37472
VZ		 833 |void * | 64 64 64 32 32 |
834 +-----------+----------------------------+
835
836 Win16 used LP32 (but we don't support it any longer), Win32 obviously used
837 ILP32 and Win64 uses LLP64 (a.k.a. P64)
d716d967 838
8fb37472
VZ		 839 Under Unix LP64 is the most widely used (the only I've ever seen, in fact)
840 */
841
34cbe514 842/* 32bit */
bd362275 843#if defined(__WINDOWS__)
8fb37472
VZ		 844 #if defined(__WIN32__)
845 typedef int wxInt32;
846 typedef unsigned int wxUint32;
847
f2b50497
VZ		 848 /*
849 Win64 uses LLP64 model and so ints and longs have the same size as
850 in Win32.
851 */
8fb37472
VZ		 852 #ifndef SIZEOF_INT
853 #define SIZEOF_INT 4
f2b50497
VZ		 854 #endif
855
856 #ifndef SIZEOF_LONG
8fb37472 857 #define SIZEOF_LONG 4
f2b50497
VZ		 858 #endif
859
860 #ifndef SIZEOF_WCHAR_T
861 /* Windows uses UTF-16 */
8fb37472 862 #define SIZEOF_WCHAR_T 2
f2b50497 863 #endif
8fb37472 864
f2b50497 865 #ifndef SIZEOF_SIZE_T
a369f7c8 866 /*
f2b50497 867 Under Win64 sizeof(size_t) == 8 and so it is neither unsigned
a369f7c8
VZ		 868 int nor unsigned long!
869 */
870 #ifdef __WIN64__
871 #define SIZEOF_SIZE_T 8
872
873 #undef wxSIZE_T_IS_UINT
874 #else /* Win32 */
875 #define SIZEOF_SIZE_T 4
876
877 #define wxSIZE_T_IS_UINT
878 #endif
8fb37472 879 #undef wxSIZE_T_IS_ULONG
f2b50497 880 #endif
8fb37472 881
f2b50497 882 #ifndef SIZEOF_VOID_P
8fb37472 883 #ifdef __WIN64__
a369f7c8 884 #define SIZEOF_VOID_P 8
34cbe514 885 #else /* Win32 */
a369f7c8 886 #define SIZEOF_VOID_P 4
34cbe514 887 #endif /* Win64/32 */
d4808d76 888 #endif
988a8d44 889 #else
8fb37472 890 #error "Unsupported Windows version"
988a8d44 891 #endif
34cbe514
RN		 892#else /* !Windows */
893 /* SIZEOF_XXX are normally defined by configure */
8fb37472
VZ		 894 #ifdef SIZEOF_INT
895 #if SIZEOF_INT == 8
34cbe514
RN		 896 /* must be ILP64 data model, there is normally a special 32 bit */
897 /* type in it but we don't know what it is... */
8fb37472
VZ		 898 #error "No 32bit int type on this platform"
899 #elif SIZEOF_INT == 4
900 typedef int wxInt32;
901 typedef unsigned int wxUint32;
902 #elif SIZEOF_INT == 2
34cbe514 903 /* must be LP32 */
8fb37472
VZ		 904 #if SIZEOF_LONG != 4
905 #error "No 32bit int type on this platform"
906 #endif
907
908 typedef long wxInt32;
909 typedef unsigned long wxUint32;
af79064d 910 #else
77ffb593 911 /* wxWidgets is not ready for 128bit systems yet... */
8fb37472
VZ		 912 #error "Unknown sizeof(int) value, what are you compiling for?"
913 #endif
34cbe514 914 #else /* !defined(SIZEOF_INT) */
a369f7c8 915 /* assume default 32bit machine -- what else can we do? */
988a8d44 916 wxCOMPILE_TIME_ASSERT( sizeof(int) == 4, IntMustBeExactly4Bytes);
a369f7c8
VZ		 917 wxCOMPILE_TIME_ASSERT( sizeof(size_t) == 4, SizeTMustBeExactly4Bytes);
918 wxCOMPILE_TIME_ASSERT( sizeof(void *) == 4, PtrMustBeExactly4Bytes);
988a8d44 919
8fb37472 920 #define SIZEOF_INT 4
a369f7c8
VZ		 921 #define SIZEOF_SIZE_T 4
922 #define SIZEOF_VOID_P 4
8fb37472
VZ		 923
924 typedef int wxInt32;
925 typedef unsigned int wxUint32;
926
68379eaf
WS		 927 #if defined(__MACH__) && !defined(SIZEOF_WCHAR_T)
928 #define SIZEOF_WCHAR_T 4
929 #endif
8d94819c 930 #if !defined(SIZEOF_WCHAR_T)
34cbe514
RN		 931 /* also assume that sizeof(wchar_t) == 2 (under Unix the most */
932 /* common case is 4 but there configure would have defined */
933 /* SIZEOF_WCHAR_T for us) */
934 /* the most common case */
97696279
VZ		 935 wxCOMPILE_TIME_ASSERT( sizeof(wchar_t) == 2,
936 Wchar_tMustBeExactly2Bytes);
937
938 #define SIZEOF_WCHAR_T 2
8d94819c 939 #endif /* !defined(SIZEOF_WCHAR_T) */
988a8d44 940 #endif
34cbe514 941#endif /* Win/!Win */
d716d967 942
8d94819c
VS		 943#ifndef SIZEOF_WCHAR_T
944 #error "SIZEOF_WCHAR_T must be defined, but isn't"
945#endif
946
8279e59a
VZ		 947/* also define C99-like sized MIN/MAX constants */
948#define wxINT8_MIN CHAR_MIN
949#define wxINT8_MAX CHAR_MAX
febd3dca 950#define wxUINT8_MAX UCHAR_MAX
8279e59a
VZ		 951
952#define wxINT16_MIN SHRT_MIN
953#define wxINT16_MAX SHRT_MAX
febd3dca 954#define wxUINT16_MAX USHRT_MAX
8279e59a
VZ		 955
956#if SIZEOF_INT == 4
957 #define wxINT32_MIN INT_MIN
958 #define wxINT32_MAX INT_MAX
febd3dca 959 #define wxUINT32_MAX UINT_MAX
8279e59a
VZ		 960#elif SIZEOF_LONG == 4
961 #define wxINT32_MIN LONG_MIN
962 #define wxINT32_MAX LONG_MAX
febd3dca 963 #define wxUINT32_MAX ULONG_MAX
8279e59a
VZ		 964#else
965 #error "Unknown 32 bit type"
966#endif
967
8fb37472
VZ		 968typedef wxUint32 wxDword;
969
17482893 970#ifdef LLONG_MAX
17482893 971 #define wxINT64_MIN LLONG_MIN
febd3dca
VZ		 972 #define wxINT64_MAX LLONG_MAX
973 #define wxUINT64_MAX ULLONG_MAX
17482893 974#else
94eff479 975 #define wxINT64_MIN (wxLL(-9223372036854775807)-1)
febd3dca
VZ		 976 #define wxINT64_MAX wxLL(9223372036854775807)
977 #define wxUINT64_MAX wxULL(0xFFFFFFFFFFFFFFFF)
17482893
VZ		 978#endif
979
34cbe514 980/* 64 bit */
8fb37472 981
60582201 982/* NB: we #define and not typedef wxLongLong_t because we use "#ifdef */
34cbe514 983/* wxLongLong_t" in wx/longlong.h */
8fb37472 984
60582201
WS		 985/* wxULongLong_t is set later (usually to unsigned wxLongLong_t) */
986
34cbe514
RN		 987/* to avoid compilation problems on 64bit machines with ambiguous method calls */
988/* we will need to define this */
8fb37472
VZ		 989#undef wxLongLongIsLong
990
edff6201
VZ		 991/*
992 First check for specific compilers which have known 64 bit integer types,
993 this avoids clashes with SIZEOF_LONG[_LONG] being defined incorrectly for
994 e.g. MSVC builds (Python.h defines it as 8 even for MSVC).
995
996 Also notice that we check for "long long" before checking for 64 bit long as
997 we still want to use "long long" and not "long" for wxLongLong_t on 64 bit
998 architectures to be able to pass wxLongLong_t to the standard functions
999 prototyped as taking "long long" such as strtoll().
1000 */
1001#if (defined(__VISUALC__) && defined(__WIN32__))
8fb37472
VZ		 1002 #define wxLongLong_t __int64
1003 #define wxLongLongSuffix i64
65154866 1004 #define wxLongLongFmtSpec "I64"
8fb37472
VZ		 1005#elif defined(__BORLANDC__) && defined(__WIN32__) && (__BORLANDC__ >= 0x520)
1006 #define wxLongLong_t __int64
1007 #define wxLongLongSuffix i64
65154866 1008 #define wxLongLongFmtSpec "L"
0872eaf9 1009#elif (defined(__WATCOMC__) && (defined(__WIN32__) || defined(__DOS__) || defined(__OS2__)))
e84c7178
CE		 1010 #define wxLongLong_t __int64
1011 #define wxLongLongSuffix i64
65154866 1012 #define wxLongLongFmtSpec "L"
f29fe169 1013#elif defined(__DIGITALMARS__)
641a7c45
CE		 1014 #define wxLongLong_t __int64
1015 #define wxLongLongSuffix LL
65154866 1016 #define wxLongLongFmtSpec "ll"
06eab902
VZ		 1017#elif defined(__MINGW32__)
1018 #define wxLongLong_t long long
1019 #define wxLongLongSuffix ll
65154866 1020 #define wxLongLongFmtSpec "I64"
8fb37472
VZ		 1021#elif defined(__VISAGECPP__) && __IBMCPP__ >= 400
1022 #define wxLongLong_t long long
edff6201
VZ		 1023#elif (defined(SIZEOF_LONG_LONG) && SIZEOF_LONG_LONG >= 8) || \
1024 defined(__GNUC__) || \
1025 defined(__CYGWIN__) || \
1026 defined(__WXMICROWIN__) || \
1027 (defined(__DJGPP__) && __DJGPP__ >= 2)
1028 #define wxLongLong_t long long
1029 #define wxLongLongSuffix ll
65154866 1030 #define wxLongLongFmtSpec "ll"
89fd8148
VZ		 1031#elif defined(SIZEOF_LONG) && (SIZEOF_LONG == 8)
1032 #define wxLongLong_t long
1033 #define wxLongLongSuffix l
65154866 1034 #define wxLongLongFmtSpec "l"
89fd8148 1035 #define wxLongLongIsLong
8fb37472
VZ		 1036#endif
1037
1038
1039#ifdef wxLongLong_t
bd362275 1040 #define wxULongLong_t unsigned wxLongLong_t
60582201 1041
25859335
VZ		 1042 /*
1043 wxLL() and wxULL() macros allow to define 64 bit constants in a
1044 portable way.
1045 */
1046 #ifndef wxCOMPILER_BROKEN_CONCAT_OPER
1047 #define wxLL(x) wxCONCAT(x, wxLongLongSuffix)
1048 #define wxULL(x) wxCONCAT(x, wxCONCAT(u, wxLongLongSuffix))
1049 #else
e78c47e3
DS		 1050 /*
1051 Currently only Borland compiler has broken concatenation operator
1052 and this compiler is known to use [u]i64 suffix.
1053 */
25859335
VZ		 1054 #define wxLL(x) wxAPPEND_i64(x)
1055 #define wxULL(x) wxAPPEND_ui64(x)
1056 #endif
84ed77ef 1057
8fb37472 1058 typedef wxLongLong_t wxInt64;
60582201 1059 typedef wxULongLong_t wxUint64;
216a72f3
VZ		 1060
1061 #define wxHAS_INT64 1
1062
066e5e3f
VZ		 1063 #ifndef wxLongLongIsLong
1064 #define wxHAS_LONG_LONG_T_DIFFERENT_FROM_LONG
1065 #endif
216a72f3 1066#elif wxUSE_LONGLONG
ea960ae8 1067 /* these macros allow to define 64 bit constants in a portable way */
216a72f3
VZ		 1068 #define wxLL(x) wxLongLong(x)
1069 #define wxULL(x) wxULongLong(x)
1070
1071 #define wxInt64 wxLongLong
1072 #define wxUint64 wxULongLong
1073
1074 #define wxHAS_INT64 1
1075
8e13c1ec 1076#else /* !wxUSE_LONGLONG */
216a72f3
VZ		 1077
1078 #define wxHAS_INT64 0
1079
d716d967
RR		 1080#endif
1081
d716d967 1082
d12fd3eb
VZ		 1083/* Make sure ssize_t is defined (a signed type the same size as size_t). */
1084/* (HAVE_SSIZE_T is not already defined by configure) */
1085#ifndef HAVE_SSIZE_T
954ec276 1086#ifdef __MINGW32__
d12fd3eb 1087 #if defined(_SSIZE_T_) || defined(_SSIZE_T_DEFINED)
954ec276
WS		 1088 #define HAVE_SSIZE_T
1089 #endif
d12fd3eb 1090#elif wxCHECK_WATCOM_VERSION(1,4)
c40158e4
WS		 1091 #define HAVE_SSIZE_T
1092#endif
d12fd3eb
VZ		 1093#endif /* !HAVE_SSIZE_T */
1094
1095/* If we really don't have ssize_t, provide our own version. */
47bec43d
VZ		 1096#ifdef HAVE_SSIZE_T
1097 #ifdef __UNIX__
1098 #include <sys/types.h>
1099 #endif
e78c47e3 1100#else /* !HAVE_SSIZE_T */
d51253e8
RL		 1101 #if SIZEOF_SIZE_T == 4
1102 typedef wxInt32 ssize_t;
1103 #elif SIZEOF_SIZE_T == 8
f1b1ecf0 1104 typedef wxInt64 ssize_t;
d51253e8
RL		 1105 #else
1106 #error "error defining ssize_t, size_t is not 4 or 8 bytes"
1107 #endif
24a5629a
VZ		 1108
1109 /* prevent ssize_t redefinitions in other libraries */
1110 #define HAVE_SSIZE_T
d51253e8
RL		 1111#endif
1112
e78c47e3
DS		 1113/*
1114 We can't rely on Windows _W64 being defined as windows.h may not be
1115 included so define our own equivalent: this should be used with types
1116 like WXLPARAM or WXWPARAM which are 64 bit under Win64 to avoid warnings
1117 each time we cast it to a pointer or a handle (which results in hundreds
1118 of warnings as Win32 API often passes pointers in them)
1119 */
47bec43d
VZ		 1120#if wxCHECK_VISUALC_VERSION(7)
1121 #define wxW64 __w64
1122#else
1123 #define wxW64
1124#endif
1125
b796ba39
VZ		 1126/*
1127 Define signed and unsigned integral types big enough to contain all of long,
1128 size_t and void *.
1129 */
76b51307
VZ		 1130#if SIZEOF_LONG >= SIZEOF_VOID_P
1131 /*
1132 Normal case when long is the largest integral type.
1133 */
1134 typedef long wxIntPtr;
1135 typedef unsigned long wxUIntPtr;
1136#elif SIZEOF_SIZE_T >= SIZEOF_VOID_P
b796ba39
VZ		 1137 /*
1138 Win64 case: size_t is the only integral type big enough for "void *".
1139
47bec43d
VZ		 1140 Notice that we must use __w64 to avoid warnings about casting pointers
1141 to wxIntPtr (which we do often as this is what it is defined for) in 32
1142 bit build with MSVC.
b796ba39 1143 */
47bec43d 1144 typedef wxW64 ssize_t wxIntPtr;
b796ba39 1145 typedef size_t wxUIntPtr;
b796ba39
VZ		 1146#else
1147 /*
1148 This should never happen for the current architectures but if you're
1149 using one where it does, please contact wx-dev@lists.wxwidgets.org.
1150 */
1151 #error "Pointers can't be stored inside integer types."
1152#endif
1153
1154#ifdef __cplusplus
1155/* And also define a couple of simple functions to cast pointer to/from it. */
1156inline wxUIntPtr wxPtrToUInt(const void *p)
1157{
1158 /*
1159 VC++ 7.1 gives warnings about casts such as below even when they're
1160 explicit with /Wp64 option, suppress them as we really know what we're
1161 doing here. Same thing with icc with -Wall.
1162 */
1163#ifdef __VISUALC__
1164 #if __VISUALC__ >= 1200
1165 #pragma warning(push)
1166 #endif
1167 /* pointer truncation from '' to '' */
1168 #pragma warning(disable: 4311)
1169#elif defined(__INTELC__)
1170 #pragma warning(push)
1171 /* conversion from pointer to same-sized integral type */
1172 #pragma warning(disable: 1684)
1173#endif
1174
1175 return wx_reinterpret_cast(wxUIntPtr, p);
1176
1177#if (defined(__VISUALC__) && __VISUALC__ >= 1200) || defined(__INTELC__)
1178 #pragma warning(pop)
1179#endif
1180}
1181
1182inline void *wxUIntToPtr(wxUIntPtr p)
1183{
1184#ifdef __VISUALC__
1185 #if __VISUALC__ >= 1200
1186 #pragma warning(push)
1187 #endif
1188 /* conversion to type of greater size */
1189 #pragma warning(disable: 4312)
1190#elif defined(__INTELC__)
1191 #pragma warning(push)
1192 /* invalid type conversion: "wxUIntPtr={unsigned long}" to "void *" */
1193 #pragma warning(disable: 171)
1194#endif
1195
1196 return wx_reinterpret_cast(void *, p);
1197
1198#if (defined(__VISUALC__) && __VISUALC__ >= 1200) || defined(__INTELC__)
1199 #pragma warning(pop)
1200#endif
1201}
1202#endif /*__cplusplus*/
1203
1204
d51253e8 1205
34cbe514 1206/* base floating point types */
d29505ac
FM		 1207/* wxFloat32: 32 bit IEEE float ( 1 sign, 8 exponent bits, 23 fraction bits ) */
1208/* wxFloat64: 64 bit IEEE float ( 1 sign, 11 exponent bits, 52 fraction bits ) */
34cbe514
RN		 1209/* wxDouble: native fastest representation that has at least wxFloat64 */
1210/* precision, so use the IEEE types for storage, and this for */
1211/* calculations */
7c74e7fe 1212
8fb37472 1213typedef float wxFloat32;
2415cf67 1214typedef double wxFloat64;
7c74e7fe 1215
671c43ff 1216typedef double wxDouble;
7c74e7fe 1217
50531bd2
VZ		 1218/*
1219 Some (non standard) compilers typedef wchar_t as an existing type instead
1220 of treating it as a real fundamental type, set wxWCHAR_T_IS_REAL_TYPE to 0
1221 for them and to 1 for all the others.
1222 */
c5cf8663 1223#ifndef wxWCHAR_T_IS_REAL_TYPE
50531bd2 1224 /*
c5cf8663
VS		 1225 VC++ typedefs wchar_t as unsigned short by default until VC8, that is
1226 unless /Za or /Zc:wchar_t option is used in which case _WCHAR_T_DEFINED
1227 is defined.
50531bd2
VZ		 1228 */
1229# if defined(__VISUALC__) && !defined(_NATIVE_WCHAR_T_DEFINED)
1230# define wxWCHAR_T_IS_REAL_TYPE 0
1231# else /* compiler having standard-conforming wchar_t */
1232# define wxWCHAR_T_IS_REAL_TYPE 1
1233# endif
c5cf8663
VS		 1234#endif /* !defined(wxWCHAR_T_IS_REAL_TYPE) */
1235
1236/* Helper macro for doing something dependent on whether wchar_t is or isn't a
1237 typedef inside another macro. */
1238#if wxWCHAR_T_IS_REAL_TYPE
1239 #define wxIF_WCHAR_T_TYPE(x) x
1240#else /* !wxWCHAR_T_IS_REAL_TYPE */
1241 #define wxIF_WCHAR_T_TYPE(x)
1242#endif /* wxWCHAR_T_IS_REAL_TYPE/!wxWCHAR_T_IS_REAL_TYPE */
50531bd2 1243
7c37eb10
VZ		 1244/*
1245 This constant should be used instead of NULL in vararg functions taking
1246 wxChar* arguments: passing NULL (which is the same as 0, unless the compiler
1247 defines it specially, e.g. like gcc does with its __null built-in) doesn't
1248 work in this case as va_arg() wouldn't interpret the integer 0 correctly
1249 when trying to convert it to a pointer on architectures where sizeof(int) is
1250 strictly less than sizeof(void *).
1251
1252 Examples of places where this must be used include wxFileTypeInfo ctor.
1253 */
1254#define wxNullPtr ((void *)NULL)
1255
9a6d1438
RR		 1256
1257/* Define wxChar16 and wxChar32 */
1258
8d94819c 1259#if SIZEOF_WCHAR_T == 2
9a6d1438 1260 #define wxWCHAR_T_IS_WXCHAR16
0c14b6c3 1261 typedef wchar_t wxChar16;
9a6d1438
RR		 1262#else
1263 typedef wxUint16 wxChar16;
1264#endif
1265
8d94819c 1266#if SIZEOF_WCHAR_T == 4
9a6d1438
RR		 1267 #define wxWCHAR_T_IS_WXCHAR32
1268 typedef wchar_t wxChar32;
1269#else
1270 typedef wxUint32 wxChar32;
1271#endif
1272
1273
34cbe514
RN		 1274/* ---------------------------------------------------------------------------- */
1275/* byte ordering related definition and macros */
1276/* ---------------------------------------------------------------------------- */
72cdf4c9 1277
34cbe514 1278/* byte sex */
d716d967
RR		 1279
1280#define wxBIG_ENDIAN 4321
1281#define wxLITTLE_ENDIAN 1234
1282#define wxPDP_ENDIAN 3412
1283
1284#ifdef WORDS_BIGENDIAN
1285#define wxBYTE_ORDER wxBIG_ENDIAN
1286#else
1287#define wxBYTE_ORDER wxLITTLE_ENDIAN
1288#endif
1289
34cbe514 1290/* byte swapping */
d716d967
RR		 1291
1292#define wxUINT16_SWAP_ALWAYS(val) \
1293 ((wxUint16) ( \
1294 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
1295 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
bac507e0 1296
d716d967
RR		 1297#define wxINT16_SWAP_ALWAYS(val) \
1298 ((wxInt16) ( \
7e2c43b8
RR		 1299 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
1300 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
bac507e0 1301
d716d967
RR		 1302#define wxUINT32_SWAP_ALWAYS(val) \
1303 ((wxUint32) ( \
1304 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1305 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
1306 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
1307 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
1308
1309#define wxINT32_SWAP_ALWAYS(val) \
1310 ((wxInt32) ( \
7e2c43b8
RR		 1311 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
1312 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
1313 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
1314 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
34cbe514 1315/* machine specific byte swapping */
d716d967 1316
84ed77ef
VZ		 1317#ifdef wxLongLong_t
1318 #define wxUINT64_SWAP_ALWAYS(val) \
1319 ((wxUint64) ( \
1320 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1321 (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1322 (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1323 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) << 8) | \
1324 (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >> 8) | \
1325 (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1326 (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1327 (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
1328
1329 #define wxINT64_SWAP_ALWAYS(val) \
1330 ((wxInt64) ( \
1331 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000000000ff)) << 56) | \
1332 (((wxUint64) (val) & (wxUint64) wxULL(0x000000000000ff00)) << 40) | \
1333 (((wxUint64) (val) & (wxUint64) wxULL(0x0000000000ff0000)) << 24) | \
1334 (((wxUint64) (val) & (wxUint64) wxULL(0x00000000ff000000)) << 8) | \
1335 (((wxUint64) (val) & (wxUint64) wxULL(0x000000ff00000000)) >> 8) | \
1336 (((wxUint64) (val) & (wxUint64) wxULL(0x0000ff0000000000)) >> 24) | \
1337 (((wxUint64) (val) & (wxUint64) wxULL(0x00ff000000000000)) >> 40) | \
1338 (((wxUint64) (val) & (wxUint64) wxULL(0xff00000000000000)) >> 56)))
216a72f3 1339#elif wxUSE_LONGLONG /* !wxLongLong_t */
84ed77ef
VZ		 1340 #define wxUINT64_SWAP_ALWAYS(val) \
1341 ((wxUint64) ( \
1342 ((wxULongLong(val) & wxULongLong(0L, 0x000000ffU)) << 56) | \
1343 ((wxULongLong(val) & wxULongLong(0L, 0x0000ff00U)) << 40) | \
1344 ((wxULongLong(val) & wxULongLong(0L, 0x00ff0000U)) << 24) | \
1345 ((wxULongLong(val) & wxULongLong(0L, 0xff000000U)) << 8) | \
1346 ((wxULongLong(val) & wxULongLong(0x000000ffL, 0U)) >> 8) | \
1347 ((wxULongLong(val) & wxULongLong(0x0000ff00L, 0U)) >> 24) | \
1348 ((wxULongLong(val) & wxULongLong(0x00ff0000L, 0U)) >> 40) | \
1349 ((wxULongLong(val) & wxULongLong(0xff000000L, 0U)) >> 56)))
1350
1351 #define wxINT64_SWAP_ALWAYS(val) \
1352 ((wxInt64) ( \
1353 ((wxLongLong(val) & wxLongLong(0L, 0x000000ffU)) << 56) | \
1354 ((wxLongLong(val) & wxLongLong(0L, 0x0000ff00U)) << 40) | \
1355 ((wxLongLong(val) & wxLongLong(0L, 0x00ff0000U)) << 24) | \
1356 ((wxLongLong(val) & wxLongLong(0L, 0xff000000U)) << 8) | \
1357 ((wxLongLong(val) & wxLongLong(0x000000ffL, 0U)) >> 8) | \
1358 ((wxLongLong(val) & wxLongLong(0x0000ff00L, 0U)) >> 24) | \
1359 ((wxLongLong(val) & wxLongLong(0x00ff0000L, 0U)) >> 40) | \
1360 ((wxLongLong(val) & wxLongLong(0xff000000L, 0U)) >> 56)))
34cbe514 1361#endif /* wxLongLong_t/!wxLongLong_t */
41b0a113 1362
d716d967 1363#ifdef WORDS_BIGENDIAN
84ed77ef
VZ		 1364 #define wxUINT16_SWAP_ON_BE(val) wxUINT16_SWAP_ALWAYS(val)
1365 #define wxINT16_SWAP_ON_BE(val) wxINT16_SWAP_ALWAYS(val)
1366 #define wxUINT16_SWAP_ON_LE(val) (val)
1367 #define wxINT16_SWAP_ON_LE(val) (val)
1368 #define wxUINT32_SWAP_ON_BE(val) wxUINT32_SWAP_ALWAYS(val)
1369 #define wxINT32_SWAP_ON_BE(val) wxINT32_SWAP_ALWAYS(val)
1370 #define wxUINT32_SWAP_ON_LE(val) (val)
1371 #define wxINT32_SWAP_ON_LE(val) (val)
216a72f3
VZ		 1372 #if wxHAS_INT64
1373 #define wxUINT64_SWAP_ON_BE(val) wxUINT64_SWAP_ALWAYS(val)
1374 #define wxUINT64_SWAP_ON_LE(val) (val)
223255fd
RR		 1375 #define wxINT64_SWAP_ON_BE(val) wxINT64_SWAP_ALWAYS(val)
1376 #define wxINT64_SWAP_ON_LE(val) (val)
216a72f3 1377 #endif
d716d967 1378#else
84ed77ef
VZ		 1379 #define wxUINT16_SWAP_ON_LE(val) wxUINT16_SWAP_ALWAYS(val)
1380 #define wxINT16_SWAP_ON_LE(val) wxINT16_SWAP_ALWAYS(val)
1381 #define wxUINT16_SWAP_ON_BE(val) (val)
1382 #define wxINT16_SWAP_ON_BE(val) (val)
1383 #define wxUINT32_SWAP_ON_LE(val) wxUINT32_SWAP_ALWAYS(val)
1384 #define wxINT32_SWAP_ON_LE(val) wxINT32_SWAP_ALWAYS(val)
1385 #define wxUINT32_SWAP_ON_BE(val) (val)
1386 #define wxINT32_SWAP_ON_BE(val) (val)
216a72f3
VZ		 1387 #if wxHAS_INT64
1388 #define wxUINT64_SWAP_ON_LE(val) wxUINT64_SWAP_ALWAYS(val)
1389 #define wxUINT64_SWAP_ON_BE(val) (val)
223255fd
RR		 1390 #define wxINT64_SWAP_ON_LE(val) wxINT64_SWAP_ALWAYS(val)
1391 #define wxINT64_SWAP_ON_BE(val) (val)
216a72f3 1392 #endif
d716d967
RR		 1393#endif
1394
28953245 1395/* ---------------------------------------------------------------------------- */
f06d6937 1396/* template workarounds for buggy compilers */
28953245
SC		 1397/* ---------------------------------------------------------------------------- */
1398
1399#if defined(__GNUC__) && !wxCHECK_GCC_VERSION( 3, 4 )
e78c47e3 1400 /* GCC <= 3.4 has buggy template support */
28953245
SC		 1401# define wxUSE_MEMBER_TEMPLATES 0
1402#endif
1403
1404#if defined(_MSC_VER) && _MSC_VER <= 1200
e78c47e3 1405 /* MSVC <= 6.0 has buggy template support */
28953245
SC		 1406# define wxUSE_MEMBER_TEMPLATES 0
1407# define wxUSE_FUNC_TEMPLATE_POINTER 0
1408#endif
1409
1410#ifndef wxUSE_MEMBER_TEMPLATES
1411# define wxUSE_MEMBER_TEMPLATES 1
1412#endif
1413
1414#ifndef wxUSE_FUNC_TEMPLATE_POINTER
1415# define wxUSE_FUNC_TEMPLATE_POINTER 1
1416#endif
1417
1418#if wxUSE_MEMBER_TEMPLATES
1419# define wxTEMPLATED_MEMBER_CALL( method, type ) method<type>()
1420# define wxTEMPLATED_MEMBER_FIX( type )
1421#else
1422# define wxTEMPLATED_MEMBER_CALL( method, type ) method((type*)NULL)
1423# define wxTEMPLATED_MEMBER_FIX( type ) type* =NULL
1424#endif
1425
1426#if defined(_MSC_VER) && _MSC_VER <= 1200
1427# define wxTEMPLATED_FUNCTION_FIX( type ), wxTEMPLATED_MEMBER_FIX(type)
1428# define wxINFUNC_CLASS_TYPE_FIX( type ) typedef type type;
1429#else
1430# define wxTEMPLATED_FUNCTION_FIX( type )
1431# define wxINFUNC_CLASS_TYPE_FIX( type )
1432#endif
1433
34cbe514
RN		 1434/* ---------------------------------------------------------------------------- */
1435/* Geometric flags */
1436/* ---------------------------------------------------------------------------- */
d597fcb7
RR		 1437
1438enum wxGeometryCentre
1439{
1440 wxCENTRE = 0x0001,
1441 wxCENTER = wxCENTRE
1442};
1443
34cbe514 1444/* centering into frame rather than screen (obsolete) */
d597fcb7 1445#define wxCENTER_FRAME 0x0000
34cbe514 1446/* centre on screen rather than parent */
d597fcb7
RR		 1447#define wxCENTRE_ON_SCREEN 0x0002
1448#define wxCENTER_ON_SCREEN wxCENTRE_ON_SCREEN
1449
1450enum wxOrientation
1451{
17fce800 1452 /* don't change the values of these elements, they are used elsewhere */
d597fcb7
RR		 1453 wxHORIZONTAL = 0x0004,
1454 wxVERTICAL = 0x0008,
2f78bd2c 1455
0ba6faae
VS		 1456 wxBOTH = wxVERTICAL | wxHORIZONTAL,
1457
1458 /* a mask to extract orientation from the combination of flags */
1459 wxORIENTATION_MASK = wxBOTH
d597fcb7
RR		 1460};
1461
1462enum wxDirection
1463{
1464 wxLEFT = 0x0010,
1465 wxRIGHT = 0x0020,
1466 wxUP = 0x0040,
1467 wxDOWN = 0x0080,
2f78bd2c 1468
d597fcb7
RR		 1469 wxTOP = wxUP,
1470 wxBOTTOM = wxDOWN,
2f78bd2c 1471
d597fcb7
RR		 1472 wxNORTH = wxUP,
1473 wxSOUTH = wxDOWN,
1474 wxWEST = wxLEFT,
1475 wxEAST = wxRIGHT,
2f78bd2c 1476
0ba6faae
VS		 1477 wxALL = (wxUP | wxDOWN | wxRIGHT | wxLEFT),
1478
1479 /* a mask to extract direction from the combination of flags */
1480 wxDIRECTION_MASK = wxALL
d597fcb7
RR		 1481};
1482
1483enum wxAlignment
1484{
e78c47e3
DS		 1485 /*
1486 0 is a valid wxAlignment value (both wxALIGN_LEFT and wxALIGN_TOP
1487 use it) so define a symbolic name for an invalid alignment value
1488 which can be assumed to be different from anything else
1489 */
ba0185b5
VZ		 1490 wxALIGN_INVALID = -1,
1491
d597fcb7 1492 wxALIGN_NOT = 0x0000,
be2577e4
RD		 1493 wxALIGN_CENTER_HORIZONTAL = 0x0100,
1494 wxALIGN_CENTRE_HORIZONTAL = wxALIGN_CENTER_HORIZONTAL,
d597fcb7
RR		 1495 wxALIGN_LEFT = wxALIGN_NOT,
1496 wxALIGN_TOP = wxALIGN_NOT,
1497 wxALIGN_RIGHT = 0x0200,
be2577e4
RD		 1498 wxALIGN_BOTTOM = 0x0400,
1499 wxALIGN_CENTER_VERTICAL = 0x0800,
1500 wxALIGN_CENTRE_VERTICAL = wxALIGN_CENTER_VERTICAL,
1501
1502 wxALIGN_CENTER = (wxALIGN_CENTER_HORIZONTAL | wxALIGN_CENTER_VERTICAL),
1e6feb95
VZ		 1503 wxALIGN_CENTRE = wxALIGN_CENTER,
1504
34cbe514 1505 /* a mask to extract alignment from the combination of flags */
1e6feb95 1506 wxALIGN_MASK = 0x0f00
d597fcb7
RR		 1507};
1508
0ba6faae
VS		 1509/* misc. flags for wxSizer items */
1510enum wxSizerFlagBits
d597fcb7 1511{
e78c47e3
DS		 1512 /*
1513 wxADJUST_MINSIZE doesn't do anything any more but we still define
1514 it for compatibility. Notice that it may be also predefined (as 0,
1515 hopefully) in the user code in order to use it even in
1516 !WXWIN_COMPATIBILITY_2_8 builds so don't redefine it in such case.
1517 */
d1594638 1518#if WXWIN_COMPATIBILITY_2_8 && !defined(wxADJUST_MINSIZE)
0ba6faae 1519 wxADJUST_MINSIZE = 0,
a757b4a7 1520#endif
0ba6faae
VS		 1521 wxFIXED_MINSIZE = 0x8000,
1522 wxRESERVE_SPACE_EVEN_IF_HIDDEN = 0x0002,
1523
1524 /* a mask to extract wxSizerFlagBits from combination of flags */
1525 wxSIZER_FLAG_BITS_MASK = 0x8002
1526};
a757b4a7 1527
0ba6faae
VS		 1528enum wxStretch
1529{
d597fcb7
RR		 1530 wxSTRETCH_NOT = 0x0000,
1531 wxSHRINK = 0x1000,
1532 wxGROW = 0x2000,
be2577e4 1533 wxEXPAND = wxGROW,
15ba5c27 1534 wxSHAPED = 0x4000,
0ba6faae
VS		 1535 wxTILE = wxSHAPED | wxFIXED_MINSIZE,
1536
1537 /* a mask to extract stretch from the combination of flags */
1538 wxSTRETCH_MASK = 0x7000 /* sans wxTILE */
1e6feb95
VZ		 1539};
1540
34cbe514 1541/* border flags: the values are chosen for backwards compatibility */
1e6feb95
VZ		 1542enum wxBorder
1543{
34cbe514
RN		 1544 /* this is different from wxBORDER_NONE as by default the controls do have */
1545 /* border */
1e6feb95
VZ		 1546 wxBORDER_DEFAULT = 0,
1547
1548 wxBORDER_NONE = 0x00200000,
1549 wxBORDER_STATIC = 0x01000000,
1550 wxBORDER_SIMPLE = 0x02000000,
1551 wxBORDER_RAISED = 0x04000000,
1552 wxBORDER_SUNKEN = 0x08000000,
a047aff2 1553 wxBORDER_DOUBLE = 0x10000000, /* deprecated */
78cd9c69 1554 wxBORDER_THEME = wxBORDER_DOUBLE,
1e6feb95 1555
34cbe514 1556 /* a mask to extract border style from the combination of flags */
1e6feb95 1557 wxBORDER_MASK = 0x1f200000
d597fcb7
RR		 1558};
1559
0bbd4f0f
JS		 1560/* This makes it easier to specify a 'normal' border for a control */
1561#if defined(__SMARTPHONE__) || defined(__POCKETPC__)
1562#define wxDEFAULT_CONTROL_BORDER wxBORDER_SIMPLE
1563#else
1564#define wxDEFAULT_CONTROL_BORDER wxBORDER_SUNKEN
1565#endif
1566
34cbe514
RN		 1567/* ---------------------------------------------------------------------------- */
1568/* Window style flags */
1569/* ---------------------------------------------------------------------------- */
d716d967 1570
c801d85f 1571/*
c801d85f
KB		 1572 * Values are chosen so they can be |'ed in a bit list.
1573 * Some styles are used across more than one group,
1574 * so the values mustn't clash with others in the group.
1575 * Otherwise, numbers can be reused across groups.
f16fad90
VZ		 1576 */
1577
1578/*
1579 Summary of the bits used by various styles.
1580
1581 High word, containing styles which can be used with many windows:
1582
1583 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
1584 |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|
1585 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
1586 | | | | | | | | | | | | | | | |
1587 | | | | | | | | | | | | | | | \_ wxFULL_REPAINT_ON_RESIZE
1588 | | | | | | | | | | | | | | \____ wxPOPUP_WINDOW
1589 | | | | | | | | | | | | | \_______ wxWANTS_CHARS
1590 | | | | | | | | | | | | \__________ wxTAB_TRAVERSAL
1591 | | | | | | | | | | | \_____________ wxTRANSPARENT_WINDOW
1592 | | | | | | | | | | \________________ wxBORDER_NONE
1593 | | | | | | | | | \___________________ wxCLIP_CHILDREN
1594 | | | | | | | | \______________________ wxALWAYS_SHOW_SB
1595 | | | | | | | \_________________________ wxBORDER_STATIC
1596 | | | | | | \____________________________ wxBORDER_SIMPLE
1597 | | | | | \_______________________________ wxBORDER_RAISED
1598 | | | | \__________________________________ wxBORDER_SUNKEN
1599 | | | \_____________________________________ wxBORDER_{DOUBLE,THEME}
1600 | | \________________________________________ wxCAPTION/wxCLIP_SIBLINGS
1601 | \___________________________________________ wxHSCROLL
1602 \______________________________________________ wxVSCROLL
1603
1604
1605 Low word style bits is class-specific meaning that the same bit can have
1606 different meanings for different controls (e.g. 0x10 is wxCB_READONLY
1607 meaning that the control can't be modified for wxComboBox but wxLB_SORT
1608 meaning that the control should be kept sorted for wxListBox, while
1609 wxLB_SORT has a different value -- and this is just fine).
c801d85f
KB		 1610 */
1611
1612/*
1613 * Window (Frame/dialog/subwindow/panel item) style flags
1614 */
329e86bf
RR		 1615#define wxVSCROLL 0x80000000
1616#define wxHSCROLL 0x40000000
1617#define wxCAPTION 0x20000000
c801d85f 1618
34cbe514 1619/* New styles (border styles are now in their own enum) */
1e6feb95
VZ		 1620#define wxDOUBLE_BORDER wxBORDER_DOUBLE
1621#define wxSUNKEN_BORDER wxBORDER_SUNKEN
1622#define wxRAISED_BORDER wxBORDER_RAISED
1623#define wxBORDER wxBORDER_SIMPLE
1624#define wxSIMPLE_BORDER wxBORDER_SIMPLE
1625#define wxSTATIC_BORDER wxBORDER_STATIC
1626#define wxNO_BORDER wxBORDER_NONE
329e86bf 1627
34cbe514
RN		 1628/* wxALWAYS_SHOW_SB: instead of hiding the scrollbar when it is not needed, */
1629/* disable it - but still show (see also wxLB_ALWAYS_SB style) */
1630/* */
1631/* NB: as this style is only supported by wxUniversal and wxMSW so far */
1e6feb95
VZ		 1632#define wxALWAYS_SHOW_SB 0x00800000
1633
34cbe514
RN		 1634/* Clip children when painting, which reduces flicker in e.g. frames and */
1635/* splitter windows, but can't be used in a panel where a static box must be */
1636/* 'transparent' (panel paints the background for it) */
329e86bf 1637#define wxCLIP_CHILDREN 0x00400000
1e6feb95 1638
34cbe514
RN		 1639/* Note we're reusing the wxCAPTION style because we won't need captions */
1640/* for subwindows/controls */
d11bb14f 1641#define wxCLIP_SIBLINGS 0x20000000
c801d85f 1642
1e6feb95
VZ		 1643#define wxTRANSPARENT_WINDOW 0x00100000
1644
34cbe514
RN		 1645/* Add this style to a panel to get tab traversal working outside of dialogs */
1646/* (on by default for wxPanel, wxDialog, wxScrolledWindow) */
329e86bf 1647#define wxTAB_TRAVERSAL 0x00080000
c801d85f 1648
34cbe514
RN		 1649/* Add this style if the control wants to get all keyboard messages (under */
1650/* Windows, it won't normally get the dialog navigation key events) */
329e86bf 1651#define wxWANTS_CHARS 0x00040000
9bf84618 1652
22c9005d
JS		 1653/* Make window retained (Motif only, see src/generic/scrolwing.cpp)
1654 * This is non-zero only under wxMotif, to avoid a clash with wxPOPUP_WINDOW
1655 * on other platforms
1656 */
1657
1658#ifdef __WXMOTIF__
d9ea011f 1659#define wxRETAINED 0x00020000
22c9005d
JS		 1660#else
1661#define wxRETAINED 0x00000000
1662#endif
329e86bf 1663#define wxBACKINGSTORE wxRETAINED
c801d85f 1664
34cbe514
RN		 1665/* set this flag to create a special popup window: it will be always shown on */
1666/* top of other windows, will capture the mouse and will be dismissed when the */
1667/* mouse is clicked outside of it or if it loses focus in any other way */
1e6feb95
VZ		 1668#define wxPOPUP_WINDOW 0x00020000
1669
34cbe514
RN		 1670/* force a full repaint when the window is resized (instead of repainting just */
1671/* the invalidated area) */
e441e1f4
VZ		 1672#define wxFULL_REPAINT_ON_RESIZE 0x00010000
1673
34cbe514
RN		 1674/* obsolete: now this is the default behaviour */
1675/* */
1676/* don't invalidate the whole window (resulting in a PAINT event) when the */
1677/* window is resized (currently, makes sense for wxMSW only) */
e441e1f4 1678#define wxNO_FULL_REPAINT_ON_RESIZE 0
d80cd92a 1679
ec376c8f
VZ		 1680/* A mask which can be used to filter (out) all wxWindow-specific styles.
1681 */
1682#define wxWINDOW_STYLE_MASK \
1683 (wxVSCROLL|wxHSCROLL|wxBORDER_MASK|wxALWAYS_SHOW_SB|wxCLIP_CHILDREN| \
1684 wxCLIP_SIBLINGS|wxTRANSPARENT_WINDOW|wxTAB_TRAVERSAL|wxWANTS_CHARS| \
1685 wxRETAINED|wxPOPUP_WINDOW|wxFULL_REPAINT_ON_RESIZE)
1686
d80cd92a
VZ		 1687/*
1688 * Extra window style flags (use wxWS_EX prefix to make it clear that they
1689 * should be passed to wxWindow::SetExtraStyle(), not SetWindowStyle())
1690 */
1691
34cbe514
RN		 1692/* by default, TransferDataTo/FromWindow() only work on direct children of the */
1693/* window (compatible behaviour), set this flag to make them recursively */
1694/* descend into all subwindows */
d80cd92a
VZ		 1695#define wxWS_EX_VALIDATE_RECURSIVELY 0x00000001
1696
34cbe514
RN		 1697/* wxCommandEvents and the objects of the derived classes are forwarded to the */
1698/* parent window and so on recursively by default. Using this flag for the */
1699/* given window allows to block this propagation at this window, i.e. prevent */
1700/* the events from being propagated further upwards. The dialogs have this */
1701/* flag on by default. */
e4b713a2
VZ		 1702#define wxWS_EX_BLOCK_EVENTS 0x00000002
1703
34cbe514
RN		 1704/* don't use this window as an implicit parent for the other windows: this must */
1705/* be used with transient windows as otherwise there is the risk of creating a */
1706/* dialog/frame with this window as a parent which would lead to a crash if the */
1707/* parent is destroyed before the child */
39cc7a0b
VZ		 1708#define wxWS_EX_TRANSIENT 0x00000004
1709
34cbe514
RN		 1710/* don't paint the window background, we'll assume it will */
1711/* be done by a theming engine. This is not yet used but could */
1712/* possibly be made to work in the future, at least on Windows */
85b43fbf
JS		 1713#define wxWS_EX_THEMED_BACKGROUND 0x00000008
1714
34cbe514 1715/* this window should always process idle events */
e39af974
JS		 1716#define wxWS_EX_PROCESS_IDLE 0x00000010
1717
34cbe514 1718/* this window should always process UI update events */
e39af974
JS		 1719#define wxWS_EX_PROCESS_UI_UPDATES 0x00000020
1720
5bd78bbc
JS		 1721/* Draw the window in a metal theme on Mac */
1722#define wxFRAME_EX_METAL 0x00000040
1723#define wxDIALOG_EX_METAL 0x00000040
1724
7ce6cc9b
VZ		 1725/* Use this style to add a context-sensitive help to the window (currently for */
1726/* Win32 only and it doesn't work if wxMINIMIZE_BOX or wxMAXIMIZE_BOX are used) */
1727#define wxWS_EX_CONTEXTHELP 0x00000080
1728
1729/* synonyms for wxWS_EX_CONTEXTHELP for compatibility */
1730#define wxFRAME_EX_CONTEXTHELP wxWS_EX_CONTEXTHELP
1731#define wxDIALOG_EX_CONTEXTHELP wxWS_EX_CONTEXTHELP
1732
3e17bc3f 1733/* Create a window which is attachable to another top level window */
d4c25daa 1734#define wxFRAME_DRAWER 0x0020
3e17bc3f 1735
df61c009
JS		 1736/*
1737 * MDI parent frame style flags
1738 * Can overlap with some of the above.
1739 */
1740
1741#define wxFRAME_NO_WINDOW_MENU 0x0100
c801d85f 1742
c801d85f 1743/*
3502e687 1744 * wxMenuBar style flags
c801d85f 1745 */
34cbe514 1746/* use native docking */
3502e687
RR		 1747#define wxMB_DOCKABLE 0x0001
1748
ae53c98c
KB		 1749/*
1750 * wxMenu style flags
1751 */
1752#define wxMENU_TEAROFF 0x0001
d4b67f95 1753
3502e687
RR		 1754/*
1755 * Apply to all panel items
1756 */
c801d85f 1757#define wxCOLOURED 0x0800
c801d85f 1758#define wxFIXED_LENGTH 0x0400
c801d85f
KB		 1759
1760/*
1761 * Styles for wxListBox
1762 */
c801d85f 1763#define wxLB_SORT 0x0010
9c331ded 1764#define wxLB_SINGLE 0x0020
c801d85f
KB		 1765#define wxLB_MULTIPLE 0x0040
1766#define wxLB_EXTENDED 0x0080
34cbe514 1767/* wxLB_OWNERDRAW is Windows-only */
58dcd1ae 1768#define wxLB_NEEDED_SB 0x0000
c801d85f 1769#define wxLB_OWNERDRAW 0x0100
58dcd1ae
VZ		 1770#define wxLB_ALWAYS_SB 0x0200
1771#define wxLB_NO_SB 0x0400
c801d85f 1772#define wxLB_HSCROLL wxHSCROLL
34cbe514 1773/* always show an entire number of rows */
1e6feb95 1774#define wxLB_INT_HEIGHT 0x0800
1e6feb95 1775
8e13c1ec
WS		 1776#if WXWIN_COMPATIBILITY_2_6
1777 /* deprecated synonyms */
1778 #define wxPROCESS_ENTER 0x0400 /* wxTE_PROCESS_ENTER */
1779 #define wxPASSWORD 0x0800 /* wxTE_PASSWORD */
1780#endif
c801d85f 1781
ef43e62e
VZ		 1782/*
1783 * wxComboBox style flags
1784 */
1785#define wxCB_SIMPLE 0x0004
1786#define wxCB_SORT 0x0008
1787#define wxCB_READONLY 0x0010
1788#define wxCB_DROPDOWN 0x0020
ef43e62e 1789
c801d85f 1790/*
0544bc0a 1791 * wxRadioBox style flags
c801d85f 1792 */
34cbe514
RN		 1793/* should we number the items from left to right or from top to bottom in a 2d */
1794/* radiobox? */
1e6feb95
VZ		 1795#define wxRA_LEFTTORIGHT 0x0001
1796#define wxRA_TOPTOBOTTOM 0x0002
1797
34cbe514 1798/* New, more intuitive names to specify majorDim argument */
0544bc0a
RR		 1799#define wxRA_SPECIFY_COLS wxHORIZONTAL
1800#define wxRA_SPECIFY_ROWS wxVERTICAL
1e6feb95 1801
34cbe514 1802/* Old names for compatibility */
c801d85f
KB		 1803#define wxRA_HORIZONTAL wxHORIZONTAL
1804#define wxRA_VERTICAL wxVERTICAL
9a727a3b 1805
0544bc0a
RR		 1806/*
1807 * wxRadioButton style flag
1808 */
c801d85f 1809#define wxRB_GROUP 0x0004
2b5f62a0 1810#define wxRB_SINGLE 0x0008
c801d85f 1811
c801d85f
KB		 1812/*
1813 * wxScrollBar flags
1814 */
c801d85f
KB		 1815#define wxSB_HORIZONTAL wxHORIZONTAL
1816#define wxSB_VERTICAL wxVERTICAL
1817
c801d85f 1818/*
dc1efb1d 1819 * wxSpinButton flags.
02a4d0b7
VZ		 1820 * Note that a wxSpinCtrl is sometimes defined as a wxTextCtrl, and so the
1821 * flags shouldn't overlap with wxTextCtrl flags that can be used for a single
1822 * line controls (currently we reuse wxTE_CHARWRAP and wxTE_RICH2 neither of
1823 * which makes sense for them).
c801d85f 1824 */
34cbe514
RN		 1825#define wxSP_HORIZONTAL wxHORIZONTAL /* 4 */
1826#define wxSP_VERTICAL wxVERTICAL /* 8 */
02a4d0b7
VZ		 1827#define wxSP_ARROW_KEYS 0x4000
1828#define wxSP_WRAP 0x8000
c801d85f 1829
b54e41c5
VZ		 1830/*
1831 * wxTabCtrl flags
1832 */
1833#define wxTC_RIGHTJUSTIFY 0x0010
1834#define wxTC_FIXEDWIDTH 0x0020
34cbe514 1835#define wxTC_TOP 0x0000 /* default */
2b5f62a0
VZ		 1836#define wxTC_LEFT 0x0020
1837#define wxTC_RIGHT 0x0040
1838#define wxTC_BOTTOM 0x0080
1e0e7f7d
VZ		 1839#define wxTC_MULTILINE 0x0200 /* == wxNB_MULTILINE */
1840#define wxTC_OWNERDRAW 0x0400
b54e41c5 1841
1e6feb95
VZ		 1842/*
1843 * wxStaticBitmap flags
1844 */
1845#define wxBI_EXPAND wxEXPAND
1846
b0351fc9
RR		 1847/*
1848 * wxStaticLine flags
1849 */
329e86bf
RR		 1850#define wxLI_HORIZONTAL wxHORIZONTAL
1851#define wxLI_VERTICAL wxVERTICAL
b0351fc9 1852
dabd1377 1853
c801d85f 1854/*
bac507e0 1855 * extended dialog specifiers. these values are stored in a different
329e86bf
RR		 1856 * flag and thus do not overlap with other style flags. note that these
1857 * values do not correspond to the return values of the dialogs (for
bac507e0 1858 * those values, look at the wxID_XXX defines).
c801d85f 1859 */
d597fcb7 1860
34cbe514 1861/* wxCENTRE already defined as 0x00000001 */
a8141d3f 1862#define wxYES 0x00000002
d597fcb7 1863#define wxOK 0x00000004
a8141d3f
VZ		 1864#define wxNO 0x00000008
1865#define wxYES_NO (wxYES | wxNO)
d597fcb7 1866#define wxCANCEL 0x00000010
57d7f988
VZ		 1867#define wxAPPLY 0x00000020
1868#define wxCLOSE 0x00000040
a8141d3f 1869
72513c36
VZ		 1870#define wxOK_DEFAULT 0x00000000 /* has no effect (default) */
1871#define wxYES_DEFAULT 0x00000000 /* has no effect (default) */
1872#define wxNO_DEFAULT 0x00000080 /* only valid with wxYES_NO */
1873#define wxCANCEL_DEFAULT 0x80000000 /* only valid with wxCANCEL */
329e86bf 1874
d597fcb7
RR		 1875#define wxICON_EXCLAMATION 0x00000100
1876#define wxICON_HAND 0x00000200
ebea0891
KB		 1877#define wxICON_WARNING wxICON_EXCLAMATION
1878#define wxICON_ERROR wxICON_HAND
d597fcb7
RR		 1879#define wxICON_QUESTION 0x00000400
1880#define wxICON_INFORMATION 0x00000800
329e86bf
RR		 1881#define wxICON_STOP wxICON_HAND
1882#define wxICON_ASTERISK wxICON_INFORMATION
329e86bf 1883
e65ae1d3
VZ		 1884#define wxHELP 0x00001000
1885#define wxFORWARD 0x00002000
1886#define wxBACKWARD 0x00004000
1887#define wxRESET 0x00008000
1888#define wxMORE 0x00010000
1889#define wxSETUP 0x00020000
7e3204b4 1890#define wxICON_NONE 0x00040000
329e86bf 1891
2e61f76a
VZ		 1892#define wxICON_MASK \
1893 (wxICON_EXCLAMATION|wxICON_HAND|wxICON_QUESTION|wxICON_INFORMATION|wxICON_NONE)
1894
50c53860
JS		 1895/*
1896 * Background styles. See wxWindow::SetBackgroundStyle
1897 */
50c53860
JS		 1898enum wxBackgroundStyle
1899{
e78c47e3
DS		 1900 /*
1901 background is erased in the EVT_ERASE_BACKGROUND handler or using
1902 the system default background if no such handler is defined (this
1903 is the default style)
1904 */
9c61c5b0
VZ		 1905 wxBG_STYLE_ERASE,
1906
e78c47e3
DS		 1907 /*
1908 background is erased by the system, no EVT_ERASE_BACKGROUND event
1909 is generated at all
1910 */
9c61c5b0
VZ		 1911 wxBG_STYLE_SYSTEM,
1912
e78c47e3
DS		 1913 /*
1914 background is erased in EVT_PAINT handler and not erased at all
1915 before it, this should be used if the paint handler paints over
1916 the entire window to avoid flicker
1917 */
9c61c5b0
VZ		 1918 wxBG_STYLE_PAINT,
1919
1920
e78c47e3 1921 /* this is a Mac-only style, don't use in portable code */
9c61c5b0
VZ		 1922 wxBG_STYLE_TRANSPARENT,
1923
e78c47e3 1924 /* this style is deprecated and doesn't do anything, don't use */
9c61c5b0
VZ		 1925 wxBG_STYLE_COLOUR,
1926
e78c47e3
DS		 1927 /*
1928 this style is deprecated and is synonymous with
1929 wxBG_STYLE_PAINT, use the new name
1930 */
9c61c5b0 1931 wxBG_STYLE_CUSTOM = wxBG_STYLE_PAINT
50c53860
JS		 1932};
1933
248d0a89
VZ		 1934/*
1935 * Key types used by (old style) lists and hashes.
1936 */
1937enum wxKeyType
1938{
1939 wxKEY_NONE,
1940 wxKEY_INTEGER,
1941 wxKEY_STRING
1942};
1943
34cbe514
RN		 1944/* ---------------------------------------------------------------------------- */
1945/* standard IDs */
1946/* ---------------------------------------------------------------------------- */
329e86bf 1947
dadacffc 1948/* Standard menu IDs */
99d82720 1949enum wxStandardID
497dbbd3 1950{
f35fdf7e
VZ		 1951 /*
1952 These ids delimit the range used by automatically-generated ids
1953 (i.e. those used when wxID_ANY is specified during construction).
1954 */
cf2810aa
VZ		 1955#if defined(__WXMSW__) || wxUSE_AUTOID_MANAGEMENT
1956 /*
1957 On MSW the range is always restricted no matter if id management
1958 is used or not because the native window ids are limited to short
1959 range. On other platforms the range is only restricted if id
1960 management is used so the reference count buffer won't be so big.
1961 */
f35fdf7e
VZ		 1962 wxID_AUTO_LOWEST = -32000,
1963 wxID_AUTO_HIGHEST = -2000,
cf2810aa
VZ		 1964#else
1965 wxID_AUTO_LOWEST = -1000000,
1966 wxID_AUTO_HIGHEST = -2000,
1967#endif
f35fdf7e 1968
dadacffc
VZ		 1969 /* no id matches this one when compared to it */
1970 wxID_NONE = -3,
497dbbd3 1971
dadacffc
VZ		 1972 /* id for a separator line in the menu (invalid for normal item) */
1973 wxID_SEPARATOR = -2,
20d9661c 1974
dadacffc
VZ		 1975 /* any id: means that we don't care about the id, whether when installing
1976 * an event handler or when creating a new window */
1977 wxID_ANY = -1,
1978
1979
1980 /* all predefined ids are between wxID_LOWEST and wxID_HIGHEST */
497dbbd3
VZ		 1981 wxID_LOWEST = 4999,
1982
1983 wxID_OPEN,
1984 wxID_CLOSE,
1985 wxID_NEW,
1986 wxID_SAVE,
1987 wxID_SAVEAS,
1988 wxID_REVERT,
1989 wxID_EXIT,
1990 wxID_UNDO,
1991 wxID_REDO,
1992 wxID_HELP,
1993 wxID_PRINT,
1994 wxID_PRINT_SETUP,
e63f19ba 1995 wxID_PAGE_SETUP,
497dbbd3
VZ		 1996 wxID_PREVIEW,
1997 wxID_ABOUT,
1998 wxID_HELP_CONTENTS,
40f51262
VZ		 1999 wxID_HELP_INDEX,
2000 wxID_HELP_SEARCH,
497dbbd3
VZ		 2001 wxID_HELP_COMMANDS,
2002 wxID_HELP_PROCEDURES,
2003 wxID_HELP_CONTEXT,
2004 wxID_CLOSE_ALL,
40f51262 2005 wxID_PREFERENCES,
497dbbd3 2006
ee0a94cf
RR		 2007 wxID_EDIT = 5030,
2008 wxID_CUT,
497dbbd3
VZ		 2009 wxID_COPY,
2010 wxID_PASTE,
2011 wxID_CLEAR,
2012 wxID_FIND,
2013 wxID_DUPLICATE,
2014 wxID_SELECTALL,
bf95a04f
JS		 2015 wxID_DELETE,
2016 wxID_REPLACE,
2017 wxID_REPLACE_ALL,
2018 wxID_PROPERTIES,
2019
2020 wxID_VIEW_DETAILS,
2021 wxID_VIEW_LARGEICONS,
2022 wxID_VIEW_SMALLICONS,
2023 wxID_VIEW_LIST,
2024 wxID_VIEW_SORTDATE,
2025 wxID_VIEW_SORTNAME,
2026 wxID_VIEW_SORTSIZE,
2027 wxID_VIEW_SORTTYPE,
497dbbd3 2028
ee0a94cf
RR		 2029 wxID_FILE = 5050,
2030 wxID_FILE1,
497dbbd3
VZ		 2031 wxID_FILE2,
2032 wxID_FILE3,
2033 wxID_FILE4,
2034 wxID_FILE5,
2035 wxID_FILE6,
2036 wxID_FILE7,
2037 wxID_FILE8,
2038 wxID_FILE9,
2039
5f7bcb48 2040 /* Standard button and menu IDs */
497dbbd3
VZ		 2041 wxID_OK = 5100,
2042 wxID_CANCEL,
2043 wxID_APPLY,
2044 wxID_YES,
2045 wxID_NO,
2046 wxID_STATIC,
2047 wxID_FORWARD,
2048 wxID_BACKWARD,
2049 wxID_DEFAULT,
2050 wxID_MORE,
2051 wxID_SETUP,
2052 wxID_RESET,
2053 wxID_CONTEXT_HELP,
2054 wxID_YESTOALL,
2055 wxID_NOTOALL,
2056 wxID_ABORT,
2057 wxID_RETRY,
2058 wxID_IGNORE,
5f7bcb48
VS		 2059 wxID_ADD,
2060 wxID_REMOVE,
2061
2062 wxID_UP,
2063 wxID_DOWN,
2064 wxID_HOME,
2065 wxID_REFRESH,
2066 wxID_STOP,
2067 wxID_INDEX,
2068
2069 wxID_BOLD,
2070 wxID_ITALIC,
2071 wxID_JUSTIFY_CENTER,
2072 wxID_JUSTIFY_FILL,
2073 wxID_JUSTIFY_RIGHT,
2074 wxID_JUSTIFY_LEFT,
2075 wxID_UNDERLINE,
2076 wxID_INDENT,
2077 wxID_UNINDENT,
2078 wxID_ZOOM_100,
2079 wxID_ZOOM_FIT,
2080 wxID_ZOOM_IN,
2081 wxID_ZOOM_OUT,
2082 wxID_UNDELETE,
2083 wxID_REVERT_TO_SAVED,
6b1eedc1
VZ		 2084 wxID_CDROM,
2085 wxID_CONVERT,
2086 wxID_EXECUTE,
2087 wxID_FLOPPY,
2088 wxID_HARDDISK,
2089 wxID_BOTTOM,
2090 wxID_FIRST,
2091 wxID_LAST,
2092 wxID_TOP,
2093 wxID_INFO,
2094 wxID_JUMP_TO,
2095 wxID_NETWORK,
2096 wxID_SELECT_COLOR,
2097 wxID_SELECT_FONT,
2098 wxID_SORT_ASCENDING,
2099 wxID_SORT_DESCENDING,
2100 wxID_SPELL_CHECK,
2101 wxID_STRIKETHROUGH,
497dbbd3 2102
34cbe514 2103 /* System menu IDs (used by wxUniv): */
497dbbd3
VZ		 2104 wxID_SYSTEM_MENU = 5200,
2105 wxID_CLOSE_FRAME,
2106 wxID_MOVE_FRAME,
2107 wxID_RESIZE_FRAME,
2108 wxID_MAXIMIZE_FRAME,
2109 wxID_ICONIZE_FRAME,
2110 wxID_RESTORE_FRAME,
2111
1483e5db
VZ		 2112 /* MDI window menu ids */
2113 wxID_MDI_WINDOW_FIRST = 5230,
2114 wxID_MDI_WINDOW_CASCADE = wxID_MDI_WINDOW_FIRST,
2115 wxID_MDI_WINDOW_TILE_HORZ,
2116 wxID_MDI_WINDOW_TILE_VERT,
2117 wxID_MDI_WINDOW_ARRANGE_ICONS,
2118 wxID_MDI_WINDOW_PREV,
2119 wxID_MDI_WINDOW_NEXT,
2120 wxID_MDI_WINDOW_LAST = wxID_MDI_WINDOW_NEXT,
2121
c46d0503
SC		 2122 /* OS X system menu ids */
2123 wxID_OSX_MENU_FIRST = 5250,
2124 wxID_OSX_HIDE = wxID_OSX_MENU_FIRST,
2125 wxID_OSX_HIDEOTHERS,
2126 wxID_OSX_SHOWALL,
2127 wxID_OSX_MENU_LAST = wxID_OSX_SHOWALL,
2128
34cbe514 2129 /* IDs used by generic file dialog (13 consecutive starting from this value) */
497dbbd3 2130 wxID_FILEDLGG = 5900,
3e6858cd 2131
0cf3e587
VZ		 2132 /* IDs used by generic file ctrl (4 consecutive starting from this value) */
2133 wxID_FILECTRL = 5950,
497dbbd3
VZ		 2134
2135 wxID_HIGHEST = 5999
2136};
329e86bf 2137
cf2810aa
VZ		 2138/* ---------------------------------------------------------------------------- */
2139/* wxWindowID type (after wxID_XYZ enum, platform detection, and dlimpexp.h) */
2140/* ---------------------------------------------------------------------------- */
2141
2142/* special care should be taken with this type under Windows where the real */
2143/* window id is unsigned, so we must always do the cast before comparing them */
2144/* (or else they would be always different!). Using wxGetWindowId() which does */
2145/* the cast itself is recommended. Note that this type can't be unsigned */
2146/* because wxID_ANY == -1 is a valid (and largely used) value for window id. */
7c08b471 2147#if defined(__cplusplus) && wxUSE_GUI
cf2810aa
VZ		 2148 #include "wx/windowid.h"
2149#endif
2150
34cbe514
RN		 2151/* ---------------------------------------------------------------------------- */
2152/* other constants */
2153/* ---------------------------------------------------------------------------- */
1e6feb95 2154
34cbe514 2155/* menu and toolbar item kinds */
d65c269b
VZ		 2156enum wxItemKind
2157{
546bfbea
VS		 2158 wxITEM_SEPARATOR = -1,
2159 wxITEM_NORMAL,
2160 wxITEM_CHECK,
2161 wxITEM_RADIO,
a9a0ceca 2162 wxITEM_DROPDOWN,
546bfbea 2163 wxITEM_MAX
d65c269b
VZ		 2164};
2165
64ee1d68
VZ		 2166/*
2167 * The possible states of a 3-state checkbox (Compatible
2168 * with the 2-state checkbox).
2169 */
2170enum wxCheckBoxState
2171{
2172 wxCHK_UNCHECKED,
2173 wxCHK_CHECKED,
2174 wxCHK_UNDETERMINED /* 3-state checkbox only */
2175};
2176
2177
34cbe514 2178/* hit test results */
1e6feb95
VZ		 2179enum wxHitTest
2180{
2181 wxHT_NOWHERE,
2182
34cbe514 2183 /* scrollbar */
1e6feb95 2184 wxHT_SCROLLBAR_FIRST = wxHT_NOWHERE,
34cbe514
RN		 2185 wxHT_SCROLLBAR_ARROW_LINE_1, /* left or upper arrow to scroll by line */
2186 wxHT_SCROLLBAR_ARROW_LINE_2, /* right or down */
2187 wxHT_SCROLLBAR_ARROW_PAGE_1, /* left or upper arrow to scroll by page */
2188 wxHT_SCROLLBAR_ARROW_PAGE_2, /* right or down */
2189 wxHT_SCROLLBAR_THUMB, /* on the thumb */
2190 wxHT_SCROLLBAR_BAR_1, /* bar to the left/above the thumb */
2191 wxHT_SCROLLBAR_BAR_2, /* bar to the right/below the thumb */
1e6feb95
VZ		 2192 wxHT_SCROLLBAR_LAST,
2193
34cbe514
RN		 2194 /* window */
2195 wxHT_WINDOW_OUTSIDE, /* not in this window at all */
2196 wxHT_WINDOW_INSIDE, /* in the client area */
2197 wxHT_WINDOW_VERT_SCROLLBAR, /* on the vertical scrollbar */
2198 wxHT_WINDOW_HORZ_SCROLLBAR, /* on the horizontal scrollbar */
2199 wxHT_WINDOW_CORNER, /* on the corner between 2 scrollbars */
1e6feb95
VZ		 2200
2201 wxHT_MAX
2202};
2203
34cbe514
RN		 2204/* ---------------------------------------------------------------------------- */
2205/* Possible SetSize flags */
2206/* ---------------------------------------------------------------------------- */
329e86bf 2207
34cbe514 2208/* Use internally-calculated width if -1 */
329e86bf 2209#define wxSIZE_AUTO_WIDTH 0x0001
34cbe514 2210/* Use internally-calculated height if -1 */
329e86bf 2211#define wxSIZE_AUTO_HEIGHT 0x0002
34cbe514 2212/* Use internally-calculated width and height if each is -1 */
329e86bf 2213#define wxSIZE_AUTO (wxSIZE_AUTO_WIDTH|wxSIZE_AUTO_HEIGHT)
34cbe514
RN		 2214/* Ignore missing (-1) dimensions (use existing). */
2215/* For readability only: test for wxSIZE_AUTO_WIDTH/HEIGHT in code. */
329e86bf 2216#define wxSIZE_USE_EXISTING 0x0000
34cbe514 2217/* Allow -1 as a valid position */
329e86bf 2218#define wxSIZE_ALLOW_MINUS_ONE 0x0004
34cbe514 2219/* Don't do parent client adjustments (for implementation only) */
329e86bf 2220#define wxSIZE_NO_ADJUSTMENTS 0x0008
952f2aaa
VZ		 2221/* Change the window position even if it seems to be already correct */
2222#define wxSIZE_FORCE 0x0010
e47e063a
RR		 2223/* Emit size event even if size didn't change */
2224#define wxSIZE_FORCE_EVENT 0x0020
952f2aaa 2225
34cbe514
RN		 2226/* ---------------------------------------------------------------------------- */
2227/* GDI descriptions */
2228/* ---------------------------------------------------------------------------- */
c801d85f 2229
c17eafaa
VZ		 2230// Hatch styles used by both pen and brush styles.
2231//
2232// NB: Do not use these constants directly, they're for internal use only, use
2233// wxBRUSHSTYLE_XXX_HATCH and wxPENSTYLE_XXX_HATCH instead.
2234enum wxHatchStyle
2235{
2236 wxHATCHSTYLE_INVALID = -1,
2237
2238 /*
2239 The value of the first style is chosen to fit with
2240 wxDeprecatedGUIConstants values below, don't change it.
2241 */
2242 wxHATCHSTYLE_FIRST = 111,
2243 wxHATCHSTYLE_BDIAGONAL = wxHATCHSTYLE_FIRST,
2244 wxHATCHSTYLE_CROSSDIAG,
2245 wxHATCHSTYLE_FDIAGONAL,
2246 wxHATCHSTYLE_CROSS,
2247 wxHATCHSTYLE_HORIZONTAL,
2248 wxHATCHSTYLE_VERTICAL,
2249 wxHATCHSTYLE_LAST = wxHATCHSTYLE_VERTICAL
2250};
2251
0c14b6c3
FM		 2252/*
2253 WARNING: the following styles are deprecated; use the
2254 wxFontFamily, wxFontStyle, wxFontWeight, wxBrushStyle,
2255 wxPenStyle, wxPenCap, wxPenJoin enum values instead!
2256*/
2257
2258#if FUTURE_WXWIN_COMPATIBILITY_3_0
2259
8907a7e2
VZ		 2260/* don't use any elements of this enum in the new code */
2261enum wxDeprecatedGUIConstants
497dbbd3 2262{
34cbe514 2263 /* Text font families */
497dbbd3
VZ		 2264 wxDEFAULT = 70,
2265 wxDECORATIVE,
2266 wxROMAN,
2267 wxSCRIPT,
2268 wxSWISS,
2269 wxMODERN,
2270 wxTELETYPE, /* @@@@ */
2271
34cbe514 2272 /* Proportional or Fixed width fonts (not yet used) */
497dbbd3
VZ		 2273 wxVARIABLE = 80,
2274 wxFIXED,
2275
2276 wxNORMAL = 90,
2277 wxLIGHT,
2278 wxBOLD,
34cbe514 2279 /* Also wxNORMAL for normal (non-italic text) */
497dbbd3
VZ		 2280 wxITALIC,
2281 wxSLANT,
ac3688c0 2282
ac3688c0
FM		 2283 /* Pen styles */
2284 wxSOLID = 100,
2285 wxDOT,
2286 wxLONG_DASH,
2287 wxSHORT_DASH,
2288 wxDOT_DASH,
2289 wxUSER_DASH,
2290
2291 wxTRANSPARENT,
2292
2293 /* Brush & Pen Stippling. Note that a stippled pen cannot be dashed!! */
d13b34d3 2294 /* Note also that stippling a Pen IS meaningful, because a Line is */
ac3688c0
FM		 2295 wxSTIPPLE_MASK_OPAQUE, /* mask is used for blitting monochrome using text fore and back ground colors */
2296 wxSTIPPLE_MASK, /* mask is used for masking areas in the stipple bitmap (TO DO) */
2297 /* drawn with a Pen, and without any Brush -- and it can be stippled. */
2298 wxSTIPPLE = 110,
2299
c17eafaa
VZ		 2300 wxBDIAGONAL_HATCH = wxHATCHSTYLE_BDIAGONAL,
2301 wxCROSSDIAG_HATCH = wxHATCHSTYLE_CROSSDIAG,
2302 wxFDIAGONAL_HATCH = wxHATCHSTYLE_FDIAGONAL,
2303 wxCROSS_HATCH = wxHATCHSTYLE_CROSS,
2304 wxHORIZONTAL_HATCH = wxHATCHSTYLE_HORIZONTAL,
2305 wxVERTICAL_HATCH = wxHATCHSTYLE_VERTICAL,
2306 wxFIRST_HATCH = wxHATCHSTYLE_FIRST,
2307 wxLAST_HATCH = wxHATCHSTYLE_LAST
c801d85f 2308};
0c14b6c3 2309#endif
c801d85f 2310
34cbe514 2311/* ToolPanel in wxFrame (VZ: unused?) */
497dbbd3
VZ		 2312enum
2313{
2314 wxTOOL_TOP = 1,
2315 wxTOOL_BOTTOM,
2316 wxTOOL_LEFT,
2317 wxTOOL_RIGHT
2318};
c801d85f 2319
3103e8a9 2320/* the values of the format constants should be the same as corresponding */
34cbe514 2321/* CF_XXX constants in Windows API */
3f480da3 2322enum wxDataFormatId
e3e65dac 2323{
9e2896e5
VZ		 2324 wxDF_INVALID = 0,
2325 wxDF_TEXT = 1, /* CF_TEXT */
2326 wxDF_BITMAP = 2, /* CF_BITMAP */
2327 wxDF_METAFILE = 3, /* CF_METAFILEPICT */
2328 wxDF_SYLK = 4,
2329 wxDF_DIF = 5,
2330 wxDF_TIFF = 6,
2331 wxDF_OEMTEXT = 7, /* CF_OEMTEXT */
2332 wxDF_DIB = 8, /* CF_DIB */
2333 wxDF_PALETTE = 9,
2334 wxDF_PENDATA = 10,
2335 wxDF_RIFF = 11,
2336 wxDF_WAVE = 12,
2337 wxDF_UNICODETEXT = 13,
2338 wxDF_ENHMETAFILE = 14,
2339 wxDF_FILENAME = 15, /* CF_HDROP */
2340 wxDF_LOCALE = 16,
2341 wxDF_PRIVATE = 20,
387ebd3e 2342 wxDF_HTML = 30, /* Note: does not correspond to CF_ constant */
9e2896e5 2343 wxDF_MAX
e3e65dac 2344};
c801d85f 2345
86408a03 2346/* Key codes */
3f4a0c5b 2347enum wxKeyCode
83624f79 2348{
86408a03
VZ		 2349 WXK_NONE = 0,
2350
09bdb1cb
VZ		 2351 WXK_CONTROL_A = 1,
2352 WXK_CONTROL_B,
2353 WXK_CONTROL_C,
2354 WXK_CONTROL_D,
2355 WXK_CONTROL_E,
2356 WXK_CONTROL_F,
2357 WXK_CONTROL_G,
2358 WXK_CONTROL_H,
2359 WXK_CONTROL_I,
2360 WXK_CONTROL_J,
2361 WXK_CONTROL_K,
2362 WXK_CONTROL_L,
2363 WXK_CONTROL_M,
2364 WXK_CONTROL_N,
2365 WXK_CONTROL_O,
2366 WXK_CONTROL_P,
2367 WXK_CONTROL_Q,
2368 WXK_CONTROL_R,
2369 WXK_CONTROL_S,
2370 WXK_CONTROL_T,
2371 WXK_CONTROL_U,
2372 WXK_CONTROL_V,
2373 WXK_CONTROL_W,
2374 WXK_CONTROL_X,
2375 WXK_CONTROL_Y,
2376 WXK_CONTROL_Z,
2377
e78c47e3 2378 WXK_BACK = 8, /* backspace */
497dbbd3
VZ		 2379 WXK_TAB = 9,
2380 WXK_RETURN = 13,
2381 WXK_ESCAPE = 27,
d29505ac
FM		 2382
2383 /* values from 33 to 126 are reserved for the standard ASCII characters */
2384
497dbbd3
VZ		 2385 WXK_SPACE = 32,
2386 WXK_DELETE = 127,
2387
d29505ac 2388 /* values from 128 to 255 are reserved for ASCII extended characters
fef6a2f1 2389 (note that there isn't a single fixed standard for the meaning
d29505ac
FM		 2390 of these values; avoid them in portable apps!) */
2391
fef6a2f1 2392 /* These are not compatible with unicode characters.
ca269f77 2393 If you want to get a unicode character from a key event, use
fef6a2f1 2394 wxKeyEvent::GetUnicodeKey */
ab9d0a8c 2395 WXK_START = 300,
497dbbd3
VZ		 2396 WXK_LBUTTON,
2397 WXK_RBUTTON,
2398 WXK_CANCEL,
2399 WXK_MBUTTON,
2400 WXK_CLEAR,
2401 WXK_SHIFT,
2402 WXK_ALT,
2403 WXK_CONTROL,
2404 WXK_MENU,
2405 WXK_PAUSE,
2406 WXK_CAPITAL,
497dbbd3
VZ		 2407 WXK_END,
2408 WXK_HOME,
2409 WXK_LEFT,
2410 WXK_UP,
2411 WXK_RIGHT,
2412 WXK_DOWN,
2413 WXK_SELECT,
2414 WXK_PRINT,
2415 WXK_EXECUTE,
2416 WXK_SNAPSHOT,
2417 WXK_INSERT,
2418 WXK_HELP,
2419 WXK_NUMPAD0,
2420 WXK_NUMPAD1,
2421 WXK_NUMPAD2,
2422 WXK_NUMPAD3,
2423 WXK_NUMPAD4,
2424 WXK_NUMPAD5,
2425 WXK_NUMPAD6,
2426 WXK_NUMPAD7,
2427 WXK_NUMPAD8,
2428 WXK_NUMPAD9,
2429 WXK_MULTIPLY,
2430 WXK_ADD,
2431 WXK_SEPARATOR,
2432 WXK_SUBTRACT,
2433 WXK_DECIMAL,
2434 WXK_DIVIDE,
2435 WXK_F1,
2436 WXK_F2,
2437 WXK_F3,
2438 WXK_F4,
2439 WXK_F5,
2440 WXK_F6,
2441 WXK_F7,
2442 WXK_F8,
2443 WXK_F9,
2444 WXK_F10,
2445 WXK_F11,
2446 WXK_F12,
2447 WXK_F13,
2448 WXK_F14,
2449 WXK_F15,
2450 WXK_F16,
2451 WXK_F17,
2452 WXK_F18,
2453 WXK_F19,
2454 WXK_F20,
2455 WXK_F21,
2456 WXK_F22,
2457 WXK_F23,
2458 WXK_F24,
2459 WXK_NUMLOCK,
2460 WXK_SCROLL,
2461 WXK_PAGEUP,
2462 WXK_PAGEDOWN,
faa94f3e 2463#if WXWIN_COMPATIBILITY_2_6
5bd24f72
RD		 2464 WXK_PRIOR = WXK_PAGEUP,
2465 WXK_NEXT = WXK_PAGEDOWN,
faa94f3e 2466#endif
497dbbd3
VZ		 2467
2468 WXK_NUMPAD_SPACE,
2469 WXK_NUMPAD_TAB,
2470 WXK_NUMPAD_ENTER,
2471 WXK_NUMPAD_F1,
2472 WXK_NUMPAD_F2,
2473 WXK_NUMPAD_F3,
2474 WXK_NUMPAD_F4,
2475 WXK_NUMPAD_HOME,
2476 WXK_NUMPAD_LEFT,
2477 WXK_NUMPAD_UP,
2478 WXK_NUMPAD_RIGHT,
2479 WXK_NUMPAD_DOWN,
497dbbd3 2480 WXK_NUMPAD_PAGEUP,
497dbbd3 2481 WXK_NUMPAD_PAGEDOWN,
faa94f3e 2482#if WXWIN_COMPATIBILITY_2_6
5bd24f72
RD		 2483 WXK_NUMPAD_PRIOR = WXK_NUMPAD_PAGEUP,
2484 WXK_NUMPAD_NEXT = WXK_NUMPAD_PAGEDOWN,
faa94f3e 2485#endif
497dbbd3
VZ		 2486 WXK_NUMPAD_END,
2487 WXK_NUMPAD_BEGIN,
2488 WXK_NUMPAD_INSERT,
2489 WXK_NUMPAD_DELETE,
2490 WXK_NUMPAD_EQUAL,
2491 WXK_NUMPAD_MULTIPLY,
2492 WXK_NUMPAD_ADD,
2493 WXK_NUMPAD_SEPARATOR,
2494 WXK_NUMPAD_SUBTRACT,
2495 WXK_NUMPAD_DECIMAL,
702c4208
VZ		 2496 WXK_NUMPAD_DIVIDE,
2497
2498 WXK_WINDOWS_LEFT,
2499 WXK_WINDOWS_RIGHT,
43cfe46c 2500 WXK_WINDOWS_MENU ,
84381ea4
SC		 2501#ifdef __WXOSX__
2502 WXK_RAW_CONTROL,
2503#else
2504 WXK_RAW_CONTROL = WXK_CONTROL,
2505#endif
2506 WXK_COMMAND = WXK_CONTROL,
afafd942 2507
6ca154fc 2508 /* Hardware-specific buttons */
afafd942
JS		 2509 WXK_SPECIAL1 = 193,
2510 WXK_SPECIAL2,
2511 WXK_SPECIAL3,
2512 WXK_SPECIAL4,
2513 WXK_SPECIAL5,
2514 WXK_SPECIAL6,
2515 WXK_SPECIAL7,
2516 WXK_SPECIAL8,
2517 WXK_SPECIAL9,
2518 WXK_SPECIAL10,
2519 WXK_SPECIAL11,
2520 WXK_SPECIAL12,
2521 WXK_SPECIAL13,
2522 WXK_SPECIAL14,
2523 WXK_SPECIAL15,
2524 WXK_SPECIAL16,
2525 WXK_SPECIAL17,
2526 WXK_SPECIAL18,
2527 WXK_SPECIAL19,
2528 WXK_SPECIAL20
c801d85f
KB		 2529};
2530
e7102772
VZ		 2531/* This enum contains bit mask constants used in wxKeyEvent */
2532enum wxKeyModifier
5048c832 2533{
e7102772
VZ		 2534 wxMOD_NONE = 0x0000,
2535 wxMOD_ALT = 0x0001,
2536 wxMOD_CONTROL = 0x0002,
2537 wxMOD_ALTGR = wxMOD_ALT | wxMOD_CONTROL,
2538 wxMOD_SHIFT = 0x0004,
2539 wxMOD_META = 0x0008,
2540 wxMOD_WIN = wxMOD_META,
2541#if defined(__WXMAC__) || defined(__WXCOCOA__)
8b9e0938 2542 wxMOD_RAW_CONTROL = 0x0010,
e7102772 2543#else
5266f345 2544 wxMOD_RAW_CONTROL = wxMOD_CONTROL,
5048c832 2545#endif
5266f345 2546 wxMOD_CMD = wxMOD_CONTROL,
e7102772
VZ		 2547 wxMOD_ALL = 0xffff
2548};
5048c832 2549
83624f79 2550/* Shortcut for easier dialog-unit-to-pixel conversion */
387a3b02 2551#define wxDLG_UNIT(parent, pt) parent->ConvertDialogToPixels(pt)
fd71308f 2552
7bcb11d3 2553/* Paper types */
497dbbd3
VZ		 2554typedef enum
2555{
34cbe514
RN		 2556 wxPAPER_NONE, /* Use specific dimensions */
2557 wxPAPER_LETTER, /* Letter, 8 1/2 by 11 inches */
2558 wxPAPER_LEGAL, /* Legal, 8 1/2 by 14 inches */
2559 wxPAPER_A4, /* A4 Sheet, 210 by 297 millimeters */
2560 wxPAPER_CSHEET, /* C Sheet, 17 by 22 inches */
2561 wxPAPER_DSHEET, /* D Sheet, 22 by 34 inches */
2562 wxPAPER_ESHEET, /* E Sheet, 34 by 44 inches */
2563 wxPAPER_LETTERSMALL, /* Letter Small, 8 1/2 by 11 inches */
2564 wxPAPER_TABLOID, /* Tabloid, 11 by 17 inches */
2565 wxPAPER_LEDGER, /* Ledger, 17 by 11 inches */
2566 wxPAPER_STATEMENT, /* Statement, 5 1/2 by 8 1/2 inches */
2567 wxPAPER_EXECUTIVE, /* Executive, 7 1/4 by 10 1/2 inches */
2568 wxPAPER_A3, /* A3 sheet, 297 by 420 millimeters */
2569 wxPAPER_A4SMALL, /* A4 small sheet, 210 by 297 millimeters */
2570 wxPAPER_A5, /* A5 sheet, 148 by 210 millimeters */
2571 wxPAPER_B4, /* B4 sheet, 250 by 354 millimeters */
2572 wxPAPER_B5, /* B5 sheet, 182-by-257-millimeter paper */
2573 wxPAPER_FOLIO, /* Folio, 8-1/2-by-13-inch paper */
2574 wxPAPER_QUARTO, /* Quarto, 215-by-275-millimeter paper */
2575 wxPAPER_10X14, /* 10-by-14-inch sheet */
2576 wxPAPER_11X17, /* 11-by-17-inch sheet */
2577 wxPAPER_NOTE, /* Note, 8 1/2 by 11 inches */
2578 wxPAPER_ENV_9, /* #9 Envelope, 3 7/8 by 8 7/8 inches */
2579 wxPAPER_ENV_10, /* #10 Envelope, 4 1/8 by 9 1/2 inches */
2580 wxPAPER_ENV_11, /* #11 Envelope, 4 1/2 by 10 3/8 inches */
2581 wxPAPER_ENV_12, /* #12 Envelope, 4 3/4 by 11 inches */
2582 wxPAPER_ENV_14, /* #14 Envelope, 5 by 11 1/2 inches */
2583 wxPAPER_ENV_DL, /* DL Envelope, 110 by 220 millimeters */
2584 wxPAPER_ENV_C5, /* C5 Envelope, 162 by 229 millimeters */
2585 wxPAPER_ENV_C3, /* C3 Envelope, 324 by 458 millimeters */
2586 wxPAPER_ENV_C4, /* C4 Envelope, 229 by 324 millimeters */
2587 wxPAPER_ENV_C6, /* C6 Envelope, 114 by 162 millimeters */
2588 wxPAPER_ENV_C65, /* C65 Envelope, 114 by 229 millimeters */
2589 wxPAPER_ENV_B4, /* B4 Envelope, 250 by 353 millimeters */
2590 wxPAPER_ENV_B5, /* B5 Envelope, 176 by 250 millimeters */
2591 wxPAPER_ENV_B6, /* B6 Envelope, 176 by 125 millimeters */
2592 wxPAPER_ENV_ITALY, /* Italy Envelope, 110 by 230 millimeters */
2593 wxPAPER_ENV_MONARCH, /* Monarch Envelope, 3 7/8 by 7 1/2 inches */
2594 wxPAPER_ENV_PERSONAL, /* 6 3/4 Envelope, 3 5/8 by 6 1/2 inches */
2595 wxPAPER_FANFOLD_US, /* US Std Fanfold, 14 7/8 by 11 inches */
2596 wxPAPER_FANFOLD_STD_GERMAN, /* German Std Fanfold, 8 1/2 by 12 inches */
2597 wxPAPER_FANFOLD_LGL_GERMAN, /* German Legal Fanfold, 8 1/2 by 13 inches */
2598
2599 wxPAPER_ISO_B4, /* B4 (ISO) 250 x 353 mm */
2600 wxPAPER_JAPANESE_POSTCARD, /* Japanese Postcard 100 x 148 mm */
2601 wxPAPER_9X11, /* 9 x 11 in */
2602 wxPAPER_10X11, /* 10 x 11 in */
2603 wxPAPER_15X11, /* 15 x 11 in */
2604 wxPAPER_ENV_INVITE, /* Envelope Invite 220 x 220 mm */
2605 wxPAPER_LETTER_EXTRA, /* Letter Extra 9 \275 x 12 in */
2606 wxPAPER_LEGAL_EXTRA, /* Legal Extra 9 \275 x 15 in */
2607 wxPAPER_TABLOID_EXTRA, /* Tabloid Extra 11.69 x 18 in */
2608 wxPAPER_A4_EXTRA, /* A4 Extra 9.27 x 12.69 in */
2609 wxPAPER_LETTER_TRANSVERSE, /* Letter Transverse 8 \275 x 11 in */
2610 wxPAPER_A4_TRANSVERSE, /* A4 Transverse 210 x 297 mm */
2611 wxPAPER_LETTER_EXTRA_TRANSVERSE, /* Letter Extra Transverse 9\275 x 12 in */
2612 wxPAPER_A_PLUS, /* SuperA/SuperA/A4 227 x 356 mm */
2613 wxPAPER_B_PLUS, /* SuperB/SuperB/A3 305 x 487 mm */
2614 wxPAPER_LETTER_PLUS, /* Letter Plus 8.5 x 12.69 in */
2615 wxPAPER_A4_PLUS, /* A4 Plus 210 x 330 mm */
2616 wxPAPER_A5_TRANSVERSE, /* A5 Transverse 148 x 210 mm */
2617 wxPAPER_B5_TRANSVERSE, /* B5 (JIS) Transverse 182 x 257 mm */
2618 wxPAPER_A3_EXTRA, /* A3 Extra 322 x 445 mm */
2619 wxPAPER_A5_EXTRA, /* A5 Extra 174 x 235 mm */
2620 wxPAPER_B5_EXTRA, /* B5 (ISO) Extra 201 x 276 mm */
2621 wxPAPER_A2, /* A2 420 x 594 mm */
2622 wxPAPER_A3_TRANSVERSE, /* A3 Transverse 297 x 420 mm */
21c358b2
JS		 2623 wxPAPER_A3_EXTRA_TRANSVERSE, /* A3 Extra Transverse 322 x 445 mm */
2624
2625 wxPAPER_DBL_JAPANESE_POSTCARD,/* Japanese Double Postcard 200 x 148 mm */
2626 wxPAPER_A6, /* A6 105 x 148 mm */
2627 wxPAPER_JENV_KAKU2, /* Japanese Envelope Kaku #2 */
2628 wxPAPER_JENV_KAKU3, /* Japanese Envelope Kaku #3 */
2629 wxPAPER_JENV_CHOU3, /* Japanese Envelope Chou #3 */
2630 wxPAPER_JENV_CHOU4, /* Japanese Envelope Chou #4 */
2631 wxPAPER_LETTER_ROTATED, /* Letter Rotated 11 x 8 1/2 in */
2632 wxPAPER_A3_ROTATED, /* A3 Rotated 420 x 297 mm */
2633 wxPAPER_A4_ROTATED, /* A4 Rotated 297 x 210 mm */
2634 wxPAPER_A5_ROTATED, /* A5 Rotated 210 x 148 mm */
2635 wxPAPER_B4_JIS_ROTATED, /* B4 (JIS) Rotated 364 x 257 mm */
2636 wxPAPER_B5_JIS_ROTATED, /* B5 (JIS) Rotated 257 x 182 mm */
2637 wxPAPER_JAPANESE_POSTCARD_ROTATED,/* Japanese Postcard Rotated 148 x 100 mm */
2638 wxPAPER_DBL_JAPANESE_POSTCARD_ROTATED,/* Double Japanese Postcard Rotated 148 x 200 mm */
2639 wxPAPER_A6_ROTATED, /* A6 Rotated 148 x 105 mm */
2640 wxPAPER_JENV_KAKU2_ROTATED, /* Japanese Envelope Kaku #2 Rotated */
2641 wxPAPER_JENV_KAKU3_ROTATED, /* Japanese Envelope Kaku #3 Rotated */
2642 wxPAPER_JENV_CHOU3_ROTATED, /* Japanese Envelope Chou #3 Rotated */
2643 wxPAPER_JENV_CHOU4_ROTATED, /* Japanese Envelope Chou #4 Rotated */
2644 wxPAPER_B6_JIS, /* B6 (JIS) 128 x 182 mm */
2645 wxPAPER_B6_JIS_ROTATED, /* B6 (JIS) Rotated 182 x 128 mm */
2646 wxPAPER_12X11, /* 12 x 11 in */
2647 wxPAPER_JENV_YOU4, /* Japanese Envelope You #4 */
2648 wxPAPER_JENV_YOU4_ROTATED, /* Japanese Envelope You #4 Rotated */
2649 wxPAPER_P16K, /* PRC 16K 146 x 215 mm */
2650 wxPAPER_P32K, /* PRC 32K 97 x 151 mm */
2651 wxPAPER_P32KBIG, /* PRC 32K(Big) 97 x 151 mm */
2652 wxPAPER_PENV_1, /* PRC Envelope #1 102 x 165 mm */
2653 wxPAPER_PENV_2, /* PRC Envelope #2 102 x 176 mm */
2654 wxPAPER_PENV_3, /* PRC Envelope #3 125 x 176 mm */
2655 wxPAPER_PENV_4, /* PRC Envelope #4 110 x 208 mm */
2656 wxPAPER_PENV_5, /* PRC Envelope #5 110 x 220 mm */
2657 wxPAPER_PENV_6, /* PRC Envelope #6 120 x 230 mm */
2658 wxPAPER_PENV_7, /* PRC Envelope #7 160 x 230 mm */
2659 wxPAPER_PENV_8, /* PRC Envelope #8 120 x 309 mm */
2660 wxPAPER_PENV_9, /* PRC Envelope #9 229 x 324 mm */
2661 wxPAPER_PENV_10, /* PRC Envelope #10 324 x 458 mm */
2662 wxPAPER_P16K_ROTATED, /* PRC 16K Rotated */
2663 wxPAPER_P32K_ROTATED, /* PRC 32K Rotated */
2664 wxPAPER_P32KBIG_ROTATED, /* PRC 32K(Big) Rotated */
2665 wxPAPER_PENV_1_ROTATED, /* PRC Envelope #1 Rotated 165 x 102 mm */
2666 wxPAPER_PENV_2_ROTATED, /* PRC Envelope #2 Rotated 176 x 102 mm */
2667 wxPAPER_PENV_3_ROTATED, /* PRC Envelope #3 Rotated 176 x 125 mm */
2668 wxPAPER_PENV_4_ROTATED, /* PRC Envelope #4 Rotated 208 x 110 mm */
2669 wxPAPER_PENV_5_ROTATED, /* PRC Envelope #5 Rotated 220 x 110 mm */
2670 wxPAPER_PENV_6_ROTATED, /* PRC Envelope #6 Rotated 230 x 120 mm */
2671 wxPAPER_PENV_7_ROTATED, /* PRC Envelope #7 Rotated 230 x 160 mm */
2672 wxPAPER_PENV_8_ROTATED, /* PRC Envelope #8 Rotated 309 x 120 mm */
2673 wxPAPER_PENV_9_ROTATED, /* PRC Envelope #9 Rotated 324 x 229 mm */
d55906de
VZ		 2674 wxPAPER_PENV_10_ROTATED, /* PRC Envelope #10 Rotated 458 x 324 m */
2675 wxPAPER_A0, /* A0 Sheet 841 x 1189 mm */
2676 wxPAPER_A1 /* A1 Sheet 594 x 841 mm */
497dbbd3 2677} wxPaperSize;
7bcb11d3
JS		 2678
2679/* Printing orientation */
af7e24c3
VZ		 2680enum wxPrintOrientation
2681{
2682 wxPORTRAIT = 1,
2683 wxLANDSCAPE
2684};
7bcb11d3
JS		 2685
2686/* Duplex printing modes
2687 */
2688
497dbbd3
VZ		 2689enum wxDuplexMode
2690{
34cbe514 2691 wxDUPLEX_SIMPLEX, /* Non-duplex */
7bcb11d3
JS		 2692 wxDUPLEX_HORIZONTAL,
2693 wxDUPLEX_VERTICAL
497dbbd3 2694};
7bcb11d3
JS		 2695
2696/* Print quality.
2697 */
2698
2699#define wxPRINT_QUALITY_HIGH -1
2700#define wxPRINT_QUALITY_MEDIUM -2
2701#define wxPRINT_QUALITY_LOW -3
2702#define wxPRINT_QUALITY_DRAFT -4
2703
2704typedef int wxPrintQuality;
2705
2706/* Print mode (currently PostScript only)
2707 */
2708
497dbbd3
VZ		 2709enum wxPrintMode
2710{
7bcb11d3 2711 wxPRINT_MODE_NONE = 0,
34cbe514
RN		 2712 wxPRINT_MODE_PREVIEW = 1, /* Preview in external application */
2713 wxPRINT_MODE_FILE = 2, /* Print to file */
244e5e34
VZ		 2714 wxPRINT_MODE_PRINTER = 3, /* Send to printer */
2715 wxPRINT_MODE_STREAM = 4 /* Send postscript data into a stream */
497dbbd3 2716};
7bcb11d3 2717
34cbe514
RN		 2718/* ---------------------------------------------------------------------------- */
2719/* UpdateWindowUI flags */
2720/* ---------------------------------------------------------------------------- */
e39af974
JS		 2721
2722enum wxUpdateUI
2723{
2724 wxUPDATE_UI_NONE = 0x0000,
2725 wxUPDATE_UI_RECURSE = 0x0001,
34cbe514 2726 wxUPDATE_UI_FROMIDLE = 0x0002 /* Invoked from On(Internal)Idle */
e39af974
JS		 2727};
2728
4f47a8d0
RR		 2729
2730/* ---------------------------------------------------------------------------- */
2731/* wxList types */
2732/* ---------------------------------------------------------------------------- */
2733
2734/* type of compare function for list sort operation (as in 'qsort'): it should
2735 return a negative value, 0 or positive value if the first element is less
2736 than, equal or greater than the second */
2737
2738typedef int (* LINKAGEMODE wxSortCompareFunction)(const void *elem1, const void *elem2);
2739
2740/* wxList iterator function */
2741typedef int (* LINKAGEMODE wxListIterateFunction)(void *current);
2742
2743
34cbe514
RN		 2744/* ---------------------------------------------------------------------------- */
2745/* miscellaneous */
2746/* ---------------------------------------------------------------------------- */
7826e2dd 2747
34cbe514 2748/* define this macro if font handling is done using the X font names */
db16cab4 2749#if (defined(__WXGTK__) && !defined(__WXGTK20__)) || defined(__X__)
7826e2dd
VZ		 2750 #define _WX_X_FONTLIKE
2751#endif
2752
34cbe514 2753/* macro to specify "All Files" on different platforms */
60e2e6c0 2754#if defined(__WXMSW__) || defined(__WXPM__)
2b5f62a0 2755# define wxALL_FILES_PATTERN wxT("*.*")
01a46793 2756# define wxALL_FILES gettext_noop("All files (*.*)|*.*")
2c41c440 2757#else
2b5f62a0 2758# define wxALL_FILES_PATTERN wxT("*")
01a46793 2759# define wxALL_FILES gettext_noop("All files (*)|*")
2c41c440 2760#endif
7826e2dd 2761
8c02a70d 2762#if defined(__CYGWIN__) && defined(__WXMSW__)
01871bf6 2763# if wxUSE_STD_CONTAINERS || defined(wxUSE_STD_STRING)
17fce800
VZ		 2764 /*
2765 NASTY HACK because the gethostname in sys/unistd.h which the gnu
2766 stl includes and wx builds with by default clash with each other
2767 (windows version 2nd param is int, sys/unistd.h version is unsigned
532d575b 2768 int).
17fce800 2769 */
9e07d399
RN		 2770# define gethostname gethostnameHACK
2771# include <unistd.h>
2772# undef gethostname
2773# endif
1446dfdb 2774#endif
9e07d399 2775
34cbe514 2776/* --------------------------------------------------------------------------- */
77ffb593 2777/* macros that enable wxWidgets apps to be compiled in absence of the */
34cbe514
RN		 2778/* sytem headers, although some platform specific types are used in the */
2779/* platform specific (implementation) parts of the headers */
2780/* --------------------------------------------------------------------------- */
7bcb11d3 2781
da0ee16e
VZ		 2782#ifdef __DARWIN__
2783#define DECLARE_WXOSX_OPAQUE_CFREF( name ) typedef struct __##name* name##Ref;
2784#define DECLARE_WXOSX_OPAQUE_CONST_CFREF( name ) typedef const struct __##name* name##Ref;
2785#endif
2786
519cb848
SC		 2787#ifdef __WXMAC__
2788
34a336ad
SC		 2789#define WX_OPAQUE_TYPE( name ) struct wxOpaque##name
2790
f2c16a0b 2791typedef void* WXHBITMAP;
8fb37472 2792typedef void* WXHCURSOR;
8fb37472
VZ		 2793typedef void* WXRECTPTR;
2794typedef void* WXPOINTPTR;
2795typedef void* WXHWND;
2796typedef void* WXEVENTREF;
2797typedef void* WXEVENTHANDLERREF;
2798typedef void* WXEVENTHANDLERCALLREF;
2799typedef void* WXAPPLEEVENTREF;
6fe8830e 2800
f2c16a0b
SC		 2801typedef unsigned int WXUINT;
2802typedef unsigned long WXDWORD;
2803typedef unsigned short WXWORD;
2804
20b69855 2805typedef WX_OPAQUE_TYPE(PicHandle ) * WXHMETAFILE ;
ac9e3f1f 2806#if wxOSX_USE_CARBON
43c5b6e8
SC		 2807typedef struct OpaqueControlRef* WXWidget ;
2808typedef struct OpaqueWindowPtr* WXWindow ;
f4ef4722
SC		 2809typedef struct __AGLPixelFormatRec *WXGLPixelFormat;
2810typedef struct __AGLContextRec *WXGLContext;
ac9e3f1f 2811#endif
623633ee 2812
8fb37472 2813typedef void* WXDisplay;
4f5b1fc4 2814
6fe8830e
SC		 2815/*
2816 * core frameworks
2817 */
623633ee
SC		 2818
2819typedef const void * CFTypeRef;
2820
e78c47e3 2821/* typedef const struct __CFString * CFStringRef; */
5f3c0120 2822
5f3c0120 2823DECLARE_WXOSX_OPAQUE_CONST_CFREF( CFString )
623633ee
SC		 2824typedef struct __CFString * CFMutableStringRef;
2825
5f3c0120
SC		 2826DECLARE_WXOSX_OPAQUE_CFREF( CFRunLoopSource )
2827DECLARE_WXOSX_OPAQUE_CONST_CFREF( CTFont )
2828DECLARE_WXOSX_OPAQUE_CONST_CFREF( CTFontDescriptor )
623633ee 2829
5f3c0120 2830#define DECLARE_WXOSX_OPAQUE_CGREF( name ) typedef struct name* name##Ref;
8361bffa 2831
5f3c0120
SC		 2832DECLARE_WXOSX_OPAQUE_CGREF( CGColor )
2833DECLARE_WXOSX_OPAQUE_CGREF( CGImage )
2834DECLARE_WXOSX_OPAQUE_CGREF( CGContext )
2835DECLARE_WXOSX_OPAQUE_CGREF( CGFont )
62b7d2ef 2836
6fe8830e
SC		 2837typedef CGColorRef WXCOLORREF;
2838typedef CGImageRef WXCGIMAGEREF;
2839typedef CGContextRef WXHDC;
2840
2841/*
2842 * carbon
2843 */
2844
2845typedef const struct __HIShape * HIShapeRef;
2846typedef struct __HIShape * HIMutableShapeRef;
2847
623633ee
SC		 2848#define DECLARE_WXMAC_OPAQUE_REF( name ) typedef struct Opaque##name* name;
2849
d7e03434
PC		 2850DECLARE_WXMAC_OPAQUE_REF( PasteboardRef )
2851DECLARE_WXMAC_OPAQUE_REF( IconRef )
f4ef4722 2852DECLARE_WXMAC_OPAQUE_REF( MenuRef )
519cb848 2853
6fe8830e
SC		 2854typedef IconRef WXHICON ;
2855typedef HIShapeRef WXHRGN;
f4ef4722
SC		 2856#if wxOSX_USE_CARBON
2857typedef MenuRef WXHMENU;
2858#endif
6fe8830e 2859
519cb848
SC		 2860#endif
2861
3e6858cd 2862#if defined( __WXCOCOA__ ) || defined(__WXMAC__)
43225e09 2863
4799f3ba
DE		 2864/* Definitions of 32-bit/64-bit types
2865 * These are typedef'd exactly the same way in newer OS X headers so
2866 * redefinition when real headers are included should not be a problem. If
2867 * it is, the types are being defined wrongly here.
2868 * The purpose of these types is so they can be used from public wx headers.
2869 * and also because the older (pre-Leopard) headers don't define them.
2870 */
2871
2872/* NOTE: We don't pollute namespace with CGFLOAT_MIN/MAX/IS_DOUBLE macros
2873 * since they are unlikely to be needed in a public header.
2874 */
2875#if defined(__LP64__) && __LP64__
78cd9c69 2876 typedef double CGFloat;
4799f3ba 2877#else
78cd9c69 2878 typedef float CGFloat;
4799f3ba
DE		 2879#endif
2880
2881#if (defined(__LP64__) && __LP64__) || (defined(NS_BUILD_32_LIKE_64) && NS_BUILD_32_LIKE_64)
2882typedef long NSInteger;
2883typedef unsigned long NSUInteger;
2884#else
2885typedef int NSInteger;
2886typedef unsigned int NSUInteger;
2887#endif
2888
2889/* Objective-C type declarations.
2890 * These are to be used in public headers in lieu of NSSomething* because
2891 * Objective-C class names are not available in C/C++ code.
2892 */
2893
34cbe514 2894/* NOTE: This ought to work with other compilers too, but I'm being cautious */
2415cf67 2895#if (defined(__GNUC__) && defined(__APPLE__))
6444e22d
DE		 2896/* It's desirable to have type safety for Objective-C(++) code as it does
2897at least catch typos of method names among other things. However, it
2898is not possible to declare an Objective-C class from plain old C or C++
2899code. Furthermore, because of C++ name mangling, the type name must
2900be the same for both C++ and Objective-C++ code. Therefore, we define
2901what should be a pointer to an Objective-C class as a pointer to a plain
2902old C struct with the same name. Unfortunately, because the compiler
2903does not see a struct as an Objective-C class we cannot declare it
2904as a struct in Objective-C(++) mode.
2905*/
2906#if defined(__OBJC__)
2907#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2908@class klass; \
2909typedef klass *WX_##klass
34cbe514 2910#else /* not defined(__OBJC__) */
6444e22d
DE		 2911#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2912typedef struct klass *WX_##klass
34cbe514 2913#endif /* defined(__OBJC__) */
6444e22d 2914
2415cf67 2915#else /* not Apple's gcc */
6444e22d 2916#warning "Objective-C types will not be checked by the compiler."
34cbe514
RN		 2917/* NOTE: typedef struct objc_object *id; */
2918/* IOW, we're declaring these using the id type without using that name, */
77ffb593
JS		 2919/* since "id" is used extensively not only within wxWidgets itself, but */
2920/* also in wxWidgets application code. The following works fine when */
34cbe514 2921/* compiling C(++) code, and works without typesafety for Obj-C(++) code */
7875262d
DE		 2922#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2923typedef struct objc_object *WX_##klass
43225e09 2924
2415cf67 2925#endif /* (defined(__GNUC__) && defined(__APPLE__)) */
6444e22d 2926
43225e09 2927DECLARE_WXCOCOA_OBJC_CLASS(NSApplication);
c10ec9f5 2928DECLARE_WXCOCOA_OBJC_CLASS(NSBitmapImageRep);
43225e09
DE		 2929DECLARE_WXCOCOA_OBJC_CLASS(NSBox);
2930DECLARE_WXCOCOA_OBJC_CLASS(NSButton);
d9b4ddf2 2931DECLARE_WXCOCOA_OBJC_CLASS(NSColor);
dcb68102 2932DECLARE_WXCOCOA_OBJC_CLASS(NSColorPanel);
43225e09 2933DECLARE_WXCOCOA_OBJC_CLASS(NSControl);
dcb68102 2934DECLARE_WXCOCOA_OBJC_CLASS(NSCursor);
b67d3706 2935DECLARE_WXCOCOA_OBJC_CLASS(NSEvent);
5f3c0120
SC		 2936DECLARE_WXCOCOA_OBJC_CLASS(NSFont);
2937DECLARE_WXCOCOA_OBJC_CLASS(NSFontDescriptor);
dcb68102 2938DECLARE_WXCOCOA_OBJC_CLASS(NSFontPanel);
69f2115d 2939DECLARE_WXCOCOA_OBJC_CLASS(NSImage);
82de126c 2940DECLARE_WXCOCOA_OBJC_CLASS(NSLayoutManager);
43225e09 2941DECLARE_WXCOCOA_OBJC_CLASS(NSMenu);
dcb68102 2942DECLARE_WXCOCOA_OBJC_CLASS(NSMenuExtra);
43225e09 2943DECLARE_WXCOCOA_OBJC_CLASS(NSMenuItem);
03fc8e97 2944DECLARE_WXCOCOA_OBJC_CLASS(NSMutableArray);
3099646e 2945DECLARE_WXCOCOA_OBJC_CLASS(NSNotification);
dcb68102 2946DECLARE_WXCOCOA_OBJC_CLASS(NSObject);
43225e09 2947DECLARE_WXCOCOA_OBJC_CLASS(NSPanel);
d25aa543 2948DECLARE_WXCOCOA_OBJC_CLASS(NSScrollView);
dcb68102
RN		 2949DECLARE_WXCOCOA_OBJC_CLASS(NSSound);
2950DECLARE_WXCOCOA_OBJC_CLASS(NSStatusItem);
03fc8e97 2951DECLARE_WXCOCOA_OBJC_CLASS(NSTableColumn);
43225e09 2952DECLARE_WXCOCOA_OBJC_CLASS(NSTableView);
82de126c 2953DECLARE_WXCOCOA_OBJC_CLASS(NSTextContainer);
43225e09 2954DECLARE_WXCOCOA_OBJC_CLASS(NSTextField);
82de126c 2955DECLARE_WXCOCOA_OBJC_CLASS(NSTextStorage);
c818fe66 2956DECLARE_WXCOCOA_OBJC_CLASS(NSThread);
43225e09
DE		 2957DECLARE_WXCOCOA_OBJC_CLASS(NSWindow);
2958DECLARE_WXCOCOA_OBJC_CLASS(NSView);
f4ef4722
SC		 2959DECLARE_WXCOCOA_OBJC_CLASS(NSOpenGLContext);
2960DECLARE_WXCOCOA_OBJC_CLASS(NSOpenGLPixelFormat);
9330ded5 2961DECLARE_WXCOCOA_OBJC_CLASS( NSPrintInfo );
ac9e3f1f 2962#ifndef __WXMAC__
77ffb593 2963typedef WX_NSView WXWidget; /* wxWidgets BASE definition */
cc18b1c7
SC		 2964#endif
2965#endif /* __WXCOCOA__ || ( __WXMAC__ &__DARWIN__)*/
43225e09 2966
ac9e3f1f
SC		 2967#ifdef __WXMAC__
2968
2969DECLARE_WXCOCOA_OBJC_CLASS(NSString);
2970
2971#if wxOSX_USE_COCOA
2972
2973typedef WX_NSWindow WXWindow;
2974typedef WX_NSView WXWidget;
f4ef4722
SC		 2975typedef WX_NSMenu WXHMENU;
2976typedef WX_NSOpenGLPixelFormat WXGLPixelFormat;
2977typedef WX_NSOpenGLContext WXGLContext;
ac9e3f1f
SC		 2978
2979#elif wxOSX_USE_IPHONE
2980
2981DECLARE_WXCOCOA_OBJC_CLASS(UIWindow);
2982DECLARE_WXCOCOA_OBJC_CLASS(UIView);
2983DECLARE_WXCOCOA_OBJC_CLASS(UIFont);
7af25c3a
SC		 2984DECLARE_WXCOCOA_OBJC_CLASS(UIImage);
2985DECLARE_WXCOCOA_OBJC_CLASS(UIEvent);
2986DECLARE_WXCOCOA_OBJC_CLASS(NSSet);
0fd61b16 2987DECLARE_WXCOCOA_OBJC_CLASS(EAGLContext);
ac9e3f1f
SC		 2988
2989typedef WX_UIWindow WXWindow;
2990typedef WX_UIView WXWidget;
0fd61b16
SC		 2991typedef WX_EAGLContext WXGLContext;
2992typedef WX_NSString* WXGLPixelFormat;
ac9e3f1f
SC		 2993
2994#endif
2995
e78c47e3 2996#endif /* __WXMAC__ */
ac9e3f1f 2997
532d575b
WS		 2998/* ABX: check __WIN32__ instead of __WXMSW__ for the same MSWBase in any Win32 port */
2999#if defined(__WIN32__)
f6bcfd97 3000
ddefbe7f 3001/* Stand-ins for Windows types to avoid #including all of windows.h */
fe42ab1d
VS		 3002
3003#ifndef NO_STRICT
3004 #define WX_MSW_DECLARE_HANDLE(type) typedef struct type##__ * WX##type
3005#else
3006 #define WX_MSW_DECLARE_HANDLE(type) typedef void * WX##type
3007#endif
3008
3009typedef void* WXHANDLE;
3010WX_MSW_DECLARE_HANDLE(HWND);
3011WX_MSW_DECLARE_HANDLE(HICON);
3012WX_MSW_DECLARE_HANDLE(HFONT);
3013WX_MSW_DECLARE_HANDLE(HMENU);
3014WX_MSW_DECLARE_HANDLE(HPEN);
3015WX_MSW_DECLARE_HANDLE(HBRUSH);
3016WX_MSW_DECLARE_HANDLE(HPALETTE);
3017WX_MSW_DECLARE_HANDLE(HCURSOR);
3018WX_MSW_DECLARE_HANDLE(HRGN);
3019WX_MSW_DECLARE_HANDLE(RECTPTR);
3020WX_MSW_DECLARE_HANDLE(HACCEL);
3021WX_MSW_DECLARE_HANDLE(HINSTANCE);
3022WX_MSW_DECLARE_HANDLE(HBITMAP);
3023WX_MSW_DECLARE_HANDLE(HIMAGELIST);
3024WX_MSW_DECLARE_HANDLE(HGLOBAL);
3025WX_MSW_DECLARE_HANDLE(HDC);
142ae7b3 3026typedef WXHINSTANCE WXHMODULE;
fe42ab1d
VS		 3027
3028#undef WX_MSW_DECLARE_HANDLE
3029
c801d85f
KB		 3030typedef unsigned int WXUINT;
3031typedef unsigned long WXDWORD;
3032typedef unsigned short WXWORD;
4f89dbc4 3033
c801d85f 3034typedef unsigned long WXCOLORREF;
c801d85f 3035typedef void * WXRGNDATA;
2cc1424d 3036typedef struct tagMSG WXMSG;
c140b7e7
JS		 3037typedef void * WXHCONV;
3038typedef void * WXHKEY;
3039typedef void * WXHTREEITEM;
a23fd0e1 3040
c801d85f
KB		 3041typedef void * WXDRAWITEMSTRUCT;
3042typedef void * WXMEASUREITEMSTRUCT;
3043typedef void * WXLPCREATESTRUCT;
a23fd0e1 3044
fa3f1180 3045#ifdef __WXMSW__
4f89dbc4 3046typedef WXHWND WXWidget;
fa3f1180 3047#endif
4f89dbc4 3048
c140b7e7 3049#ifdef __WIN64__
dca0f651 3050typedef unsigned __int64 WXWPARAM;
c140b7e7
JS		 3051typedef __int64 WXLPARAM;
3052typedef __int64 WXLRESULT;
3053#else
dca0f651
VZ		 3054typedef wxW64 unsigned int WXWPARAM;
3055typedef wxW64 long WXLPARAM;
3056typedef wxW64 long WXLRESULT;
c140b7e7 3057#endif
4f89dbc4 3058
532d575b 3059#if defined(__GNUWIN32__) || defined(__WXMICROWIN__)
4f89dbc4
RL		 3060typedef int (*WXFARPROC)();
3061#else
3062typedef int (__stdcall *WXFARPROC)();
3063#endif
532d575b 3064#endif /* __WIN32__ */
4f89dbc4
RL		 3065
3066
55034339
WS		 3067#if defined(__OS2__)
3068typedef unsigned long DWORD;
3069typedef unsigned short WORD;
3070#endif
3071
bd3b171d 3072#if defined(__WXPM__) || defined(__EMX__)
ddefbe7f
SN		 3073#ifdef __WXPM__
3074/* Stand-ins for OS/2 types, to avoid #including all of os2.h */
3075typedef unsigned long WXHWND;
3076typedef unsigned long WXHANDLE;
3077typedef unsigned long WXHICON;
3078typedef unsigned long WXHFONT;
3079typedef unsigned long WXHMENU;
3080typedef unsigned long WXHPEN;
3081typedef unsigned long WXHBRUSH;
3082typedef unsigned long WXHPALETTE;
3083typedef unsigned long WXHCURSOR;
3084typedef unsigned long WXHRGN;
3085typedef unsigned long WXHACCEL;
142ae7b3
VS		 3086typedef unsigned long WXHINSTANCE;
3087typedef unsigned long WXHMODULE;
ddefbe7f
SN		 3088typedef unsigned long WXHBITMAP;
3089typedef unsigned long WXHDC;
3090typedef unsigned int WXUINT;
3091typedef unsigned long WXDWORD;
3092typedef unsigned short WXWORD;
3093
3094typedef unsigned long WXCOLORREF;
3095typedef void * WXMSG;
3096typedef unsigned long WXHTREEITEM;
3097
3098typedef void * WXDRAWITEMSTRUCT;
3099typedef void * WXMEASUREITEMSTRUCT;
3100typedef void * WXLPCREATESTRUCT;
3101
3102typedef WXHWND WXWidget;
3103#endif
0fe5619d
SN		 3104#ifdef __EMX__
3105/* Need a well-known type for WXFARPROC
3106 below. MPARAM is typedef'ed too late. */
3107#define WXWPARAM void *
3108#define WXLPARAM void *
3109#else
4f89dbc4
RL		 3110#define WXWPARAM MPARAM
3111#define WXLPARAM MPARAM
0fe5619d 3112#endif
4f89dbc4
RL		 3113#define RECT RECTL
3114#define LOGFONT FATTRS
3115#define LOWORD SHORT1FROMMP
3116#define HIWORD SHORT2FROMMP
3117
54da4255
DW		 3118typedef unsigned long WXMPARAM;
3119typedef unsigned long WXMSGID;
3120typedef void* WXRESULT;
34cbe514
RN		 3121/* typedef int (*WXFARPROC)(); */
3122/* some windows handles not defined by PM */
54da4255
DW		 3123typedef unsigned long HANDLE;
3124typedef unsigned long HICON;
3125typedef unsigned long HFONT;
3126typedef unsigned long HMENU;
3127typedef unsigned long HPEN;
3128typedef unsigned long HBRUSH;
3129typedef unsigned long HPALETTE;
3130typedef unsigned long HCURSOR;
3131typedef unsigned long HINSTANCE;
3132typedef unsigned long HIMAGELIST;
3133typedef unsigned long HGLOBAL;
34cbe514 3134#endif /* WXPM || EMX */
43543d98 3135
bd3b171d 3136#if defined (__WXPM__)
34cbe514 3137/* WIN32 graphics types for OS/2 GPI */
43543d98 3138
34cbe514 3139/* RGB under OS2 is more like a PALETTEENTRY struct under Windows so we need a real RGB def */
19193a2c 3140#define OS2RGB(r,g,b) ((DWORD)((unsigned char)(b) | ((unsigned char)(g) << 8)) | ((unsigned char)(r) << 16))
43543d98
DW		 3141
3142typedef unsigned long COLORREF;
28206ce8
SN		 3143#define GetRValue(rgb) ((unsigned char)((rgb) >> 16))
3144#define GetGValue(rgb) ((unsigned char)(((unsigned short)(rgb)) >> 8))
3145#define GetBValue(rgb) ((unsigned char)(rgb))
43543d98
DW		 3146#define PALETTEINDEX(i) ((COLORREF)(0x01000000 | (DWORD)(WORD)(i)))
3147#define PALETTERGB(r,g,b) (0x02000000 | OS2RGB(r,g,b))
34cbe514 3148/* OS2's RGB/RGB2 is backwards from this */
43543d98
DW		 3149typedef struct tagPALETTEENTRY
3150{
3151 char bRed;
3152 char bGreen;
3153 char bBlue;
3154 char bFlags;
3155} PALETTEENTRY;
3156typedef struct tagLOGPALETTE
3157{
3158 WORD palVersion;
3159 WORD palNumentries;
3160 WORD PALETTEENTRY[1];
3161} LOGPALETTE;
54da4255 3162
4f89dbc4 3163#if (defined(__VISAGECPP__) && (__IBMCPP__ < 400)) || defined (__WATCOMC__)
34cbe514 3164 /* VA 3.0 for some reason needs base data types when typedefing a proc proto??? */
4f89dbc4 3165typedef void* (_System *WXFARPROC)(unsigned long, unsigned long, void*, void*);
1e6d9499 3166#else
463b12b8 3167#if defined(__EMX__) && !defined(_System)
0fe5619d
SN		 3168#define _System
3169#endif
4f89dbc4 3170typedef WXRESULT (_System *WXFARPROC)(WXHWND, WXMSGID, WXWPARAM, WXLPARAM);
14b72bf5 3171#endif
c801d85f 3172
34cbe514 3173#endif /* __WXPM__ */
8fb3a512 3174
c801d85f 3175
83df96d6 3176#if defined(__WXMOTIF__) || defined(__WXX11__)
83624f79 3177/* Stand-ins for X/Xt/Motif types */
589f0e3e
JS		 3178typedef void* WXWindow;
3179typedef void* WXWidget;
3180typedef void* WXAppContext;
46ccb510 3181typedef void* WXColormap;
3cd0b8c5 3182typedef void* WXColor;
589f0e3e
JS		 3183typedef void WXDisplay;
3184typedef void WXEvent;
46ccb510 3185typedef void* WXCursor;
50414e24 3186typedef void* WXPixmap;
dfc54541
JS		 3187typedef void* WXFontStructPtr;
3188typedef void* WXGC;
3189typedef void* WXRegion;
e97f20a0 3190typedef void* WXFont;
f97c9854 3191typedef void* WXImage;
f97c9854 3192typedef void* WXFontList;
996994c7 3193typedef void* WXFontSet;
da494b40
MB		 3194typedef void* WXRendition;
3195typedef void* WXRenderTable;
3196typedef void* WXFontType; /* either a XmFontList or XmRenderTable */
3197typedef void* WXString;
da175b2c
RR		 3198
3199typedef unsigned long Atom; /* this might fail on a few architectures */
3e0071d9 3200typedef long WXPixel; /* safety catch in src/motif/colour.cpp */
da175b2c 3201
34cbe514 3202#endif /* Motif */
589f0e3e 3203
83624f79 3204#ifdef __WXGTK__
9e691f46 3205
83624f79 3206/* Stand-ins for GLIB types */
953704c1 3207typedef struct _GSList GSList;
83624f79
RR		 3208
3209/* Stand-ins for GDK types */
83624f79 3210typedef struct _GdkColor GdkColor;
83624f79 3211typedef struct _GdkCursor GdkCursor;
8a126fcc 3212typedef struct _GdkDragContext GdkDragContext;
9e691f46 3213
29e461a2
PC		 3214#if defined(__WXGTK20__)
3215 typedef struct _GdkAtom* GdkAtom;
3216#else
3217 typedef unsigned long GdkAtom;
3218#endif
3219
9dc44eff 3220#if !defined(__WXGTK3__)
29e461a2
PC		 3221 typedef struct _GdkColormap GdkColormap;
3222 typedef struct _GdkFont GdkFont;
3223 typedef struct _GdkGC GdkGC;
3224 typedef struct _GdkRegion GdkRegion;
3225#endif
3226
9dc44eff 3227#if defined(__WXGTK3__)
29e461a2
PC		 3228 typedef struct _GdkWindow GdkWindow;
3229#elif defined(__WXGTK20__)
3230 typedef struct _GdkDrawable GdkWindow;
3231 typedef struct _GdkDrawable GdkPixmap;
3232#else
3233 typedef struct _GdkWindow GdkWindow;
3234 typedef struct _GdkWindow GdkBitmap;
3235 typedef struct _GdkWindow GdkPixmap;
63081513 3236#endif
83624f79
RR		 3237
3238/* Stand-ins for GTK types */
8a126fcc 3239typedef struct _GtkWidget GtkWidget;
f40fdaa3 3240typedef struct _GtkRcStyle GtkRcStyle;
8a126fcc 3241typedef struct _GtkAdjustment GtkAdjustment;
8a126fcc 3242typedef struct _GtkToolbar GtkToolbar;
8a126fcc
RR		 3243typedef struct _GtkNotebook GtkNotebook;
3244typedef struct _GtkNotebookPage GtkNotebookPage;
3245typedef struct _GtkAccelGroup GtkAccelGroup;
f608bc67 3246typedef struct _GtkSelectionData GtkSelectionData;
41b81aed 3247typedef struct _GtkTextBuffer GtkTextBuffer;
add7cadd 3248typedef struct _GtkRange GtkRange;
ed38aa55 3249typedef struct _GtkCellRenderer GtkCellRenderer;
ad5c34f3 3250
f03fc89f 3251typedef GtkWidget *WXWidget;
e6ae7330
OK		 3252
3253#ifndef __WXGTK20__
3254#define GTK_OBJECT_GET_CLASS(object) (GTK_OBJECT(object)->klass)
ff67d586 3255#define GTK_CLASS_TYPE(klass) ((klass)->type)
e6ae7330
OK		 3256#endif
3257
34cbe514 3258#endif /* __WXGTK__ */
2b5f62a0
VZ		 3259
3260#if defined(__WXGTK20__) || (defined(__WXX11__) && wxUSE_UNICODE)
3261#define wxUSE_PANGO 1
3262#else
3263#define wxUSE_PANGO 0
3264#endif
3265
3266#if wxUSE_PANGO
e6ae7330
OK		 3267/* Stand-ins for Pango types */
3268typedef struct _PangoContext PangoContext;
3269typedef struct _PangoLayout PangoLayout;
3270typedef struct _PangoFontDescription PangoFontDescription;
2b5f62a0 3271#endif
ad5c34f3 3272
b3c86150
VS		 3273#ifdef __WXDFB__
3274/* DirectFB doesn't have the concept of non-TLW window, so use
3275 something arbitrary */
3276typedef const void* WXWidget;
3277#endif /* DFB */
3278
34cbe514 3279/* This is required because of clashing macros in windows.h, which may be */
77ffb593
JS		 3280/* included before or after wxWidgets classes, and therefore must be */
3281/* disabled here before any significant wxWidgets headers are included. */
ceceef4c 3282#ifdef __cplusplus
fa3f1180 3283#ifdef __WINDOWS__
bc1dab7e 3284#include "wx/msw/winundef.h"
fa3f1180 3285#endif /* __WINDOWS__ */
ceceef4c 3286#endif /* __cplusplus */
83624f79 3287
c3a58b24
VS		 3288
3289/* include the feature test macros */
3290#include "wx/features.h"
3291
34cbe514 3292/* --------------------------------------------------------------------------- */
c0c133e1 3293/* macros to define a class without copy ctor nor assignment operator */
34cbe514 3294/* --------------------------------------------------------------------------- */
a23fd0e1 3295
c0c133e1 3296#define wxDECLARE_NO_COPY_CLASS(classname) \
a23fd0e1
VZ		 3297 private: \
3298 classname(const classname&); \
c0c133e1 3299 classname& operator=(const classname&)
a23fd0e1 3300
c0c133e1
VZ		 3301#define wxDECLARE_NO_COPY_TEMPLATE_CLASS(classname, arg) \
3302 private: \
3303 classname(const classname<arg>&); \
3304 classname& operator=(const classname<arg>&)
375a5d3a 3305
021f9dee
VZ		 3306#define wxDECLARE_NO_COPY_TEMPLATE_CLASS_2(classname, arg1, arg2) \
3307 private: \
3308 classname(const classname<arg1, arg2>&); \
3309 classname& operator=(const classname<arg1, arg2>&)
3310
c0c133e1 3311#define wxDECLARE_NO_ASSIGN_CLASS(classname) \
a6cbc4db 3312 private: \
c0c133e1
VZ		 3313 classname& operator=(const classname&)
3314
e78c47e3 3315/* deprecated variants _not_ requiring a semicolon after them */
c0c133e1
VZ		 3316#define DECLARE_NO_COPY_CLASS(classname) \
3317 wxDECLARE_NO_COPY_CLASS(classname);
3318#define DECLARE_NO_COPY_TEMPLATE_CLASS(classname, arg) \
3319 wxDECLARE_NO_COPY_TEMPLATE_CLASS(classname, arg);
3320#define DECLARE_NO_ASSIGN_CLASS(classname) \
3321 wxDECLARE_NO_ASSIGN_CLASS(classname);
a6cbc4db 3322
c8d58531
MW		 3323/* --------------------------------------------------------------------------- */
3324/* If a manifest is being automatically generated, add common controls 6 to it */
3325/* --------------------------------------------------------------------------- */
3326
3327#if (!defined wxUSE_NO_MANIFEST || wxUSE_NO_MANIFEST == 0 ) && \
3328 ( defined _MSC_FULL_VER && _MSC_FULL_VER >= 140040130 )
3329
3330#define WX_CC_MANIFEST(cpu) \
3331 "/manifestdependency:\"type='win32' \
3332 name='Microsoft.Windows.Common-Controls' \
3333 version='6.0.0.0' \
ef5fe20c 3334 processorArchitecture='" cpu "' \
c8d58531
MW		 3335 publicKeyToken='6595b64144ccf1df' \
3336 language='*'\""
3337
3338#if defined _M_IX86
3339 #pragma comment(linker, WX_CC_MANIFEST("x86"))
3340#elif defined _M_X64
3341 #pragma comment(linker, WX_CC_MANIFEST("amd64"))
3342#elif defined _M_IA64
3343 #pragma comment(linker, WX_CC_MANIFEST("ia64"))
3344#else
3345 #pragma comment(linker, WX_CC_MANIFEST("*"))
3346#endif
3347
3348#endif /* !wxUSE_NO_MANIFEST && _MSC_FULL_VER >= 140040130 */
3349
c801d85f 3350#endif
34cbe514 3351 /* _WX_DEFS_H_ */
wxWidgets (Impactor)