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