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