]> git.saurik.com Git - wxWidgets.git/blame - include/wx/defs.h
* Added GetAppMenuBar
[wxWidgets.git] / include / wx / defs.h
CommitLineData
c801d85f
KB
1/////////////////////////////////////////////////////////////////////////////
2// Name: defs.h
3// Purpose: Declarations/definitions common to all wx source files
4// Author: Julian Smart and others
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c)
3f4a0c5b 9// Licence: wxWindows licence
c801d85f
KB
10/////////////////////////////////////////////////////////////////////////////
11
34138703
JS
12#ifndef _WX_DEFS_H_
13#define _WX_DEFS_H_
c801d85f 14
12028905 15#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
4f89dbc4 16#pragma interface "defs.h"
c801d85f
KB
17#endif
18
3f4a0c5b
VZ
19// ----------------------------------------------------------------------------
20// compiler and OS identification
21// ----------------------------------------------------------------------------
c801d85f 22
78340847 23#include "wx/platform.h"
bb48ed2c 24
78340847
VZ
25// Make sure the environment is set correctly
26#if defined(__WXMSW__) && defined(__X__)
886dd7d2 27 #error "Target can't be both X and Windows"
78340847 28#elif !defined(__WXMOTIF__) && !defined(__WXMSW__) && !defined(__WXGTK__) && \
43225e09
DE
29 !defined(__WXPM__) && !defined(__WXMAC__) && !defined(__WXCOCOA__) && \
30 !defined(__X__) && !defined(__WXMGL__) && !defined(__WXX11__) && \
31 wxUSE_GUI
886dd7d2
VZ
32 #ifdef __UNIX__
33 #error "No Target! You should use wx-config program for compilation flags!"
34 #else // !Unix
35 #error "No Target! You should use supplied makefiles for compilation!"
36 #endif // Unix/!Unix
37#endif
38
39#ifndef __WXWINDOWS__
40 #define __WXWINDOWS__ 1
41#endif
42
43#ifndef wxUSE_BASE
44 // by default consider that this is a monolithic build
45 #define wxUSE_BASE 1
aaa63f66
VZ
46#endif
47
a6ab05be
VZ
48#if !wxUSE_GUI && !defined(__WXBASE__)
49 #define __WXBASE__
50#endif
51
d65c269b
VZ
52// include the feature test macros
53#include "wx/features.h"
54
fd3f686c 55// suppress some Visual C++ warnings
3f4a0c5b 56#ifdef __VISUALC__
fc7a2a60
VZ
57 // the only "real" warning here is 4244 but there arej ust too many of them
58 // in our code... one day someone should go and fix them but until then...
197dd9af 59# pragma warning(disable:4201) // nonstandard extension used: nameless struct/union
539dae52 60# pragma warning(disable:4244) // conversion from double to float
3ca6a5f0 61# pragma warning(disable:4710) // function not inlined
d33f1a1a 62# pragma warning(disable:4097) // typedef used as class
a9d3371a
JS
63# pragma warning(disable:4511) // copy ctor couldn't be generated
64# pragma warning(disable:4512) // operator=() couldn't be generated
197dd9af 65#ifndef WIN32
27a9bd48
PA
66# pragma warning(disable:4135) // conversion between different integral types
67# pragma warning(disable:4769) // assignment of near pointer to long integer
197dd9af
PA
68// This one is really annoying, since it occurs for each cast to (HANDLE)...
69# pragma warning(disable:4305) // truncation of long to near ptr
27a9bd48 70#endif
539dae52 71#endif // __VISUALC__
c801d85f 72
33ac7e6f
KB
73// suppress some Watcom C++ warnings
74#ifdef __WATCOMC__
19193a2c
KB
75# pragma warning 849 9 // Disable 'virtual function hidden'
76# pragma warning 549 9 // Disable 'operand contains compiler generated information'
33ac7e6f
KB
77#endif // __VISUALC__
78
a3ef5bf5
JS
79// suppress some Salford C++ warnings
80#ifdef __SALFORDC__
81# pragma suppress 353 // Possible nested comments
82# pragma suppress 593 // Define not used
83# pragma suppress 61 // enum has no name (doesn't suppress!)
84# pragma suppress 106 // unnamed, unused parameter
85# pragma suppress 571 // Virtual function hiding
539dae52
VZ
86#endif // __SALFORDC__
87
4f6e963c
VZ
88// suppress some Borland C++ warnings
89#ifdef __BORLANDC__
90# pragma warn -inl // Functions containing reserved words and certain constructs are not expanded inline
91#endif // __BORLANDC__
92
e90c1d2a 93// ----------------------------------------------------------------------------
78340847 94// wxWindows version and compatibility defines
e90c1d2a
VZ
95// ----------------------------------------------------------------------------
96
78340847
VZ
97#include "wx/version.h"
98
57493f9f
VZ
99// ============================================================================
100// non portable C++ features
101// ============================================================================
102
78340847
VZ
103// ----------------------------------------------------------------------------
104// compiler defects workarounds
105// ----------------------------------------------------------------------------
106
0e0126c2 107#if defined(__VISUALC__) && !defined(WIN32) && !defined(__WXWINCE__)
78340847 108 // VC1.5 does not have LPTSTR type
4f89dbc4
RL
109#define LPTSTR LPSTR
110#define LPCTSTR LPCSTR
111#elif defined(__BORLANDC__) && !defined(__WIN32__)
112#ifndef LPTSTR
113#define LPTSTR LPSTR
114#endif
115#ifndef LPCTSTR
116#define LPCTSTR LPSTR
117#endif
118#endif
119
78340847
VZ
120
121/*
122 Digital Unix C++ compiler only defines this symbol for .cxx and .hxx files,
123 so define it ourselves (newer versions do it for all files, though, and
124 don't allow it to be redefined)
125 */
4f89dbc4
RL
126#if defined(__DECCXX) && !defined(__VMS) && !defined(__cplusplus)
127#define __cplusplus
78340847
VZ
128#endif /* __DECCXX */
129
130// Resolves linking problems under HP-UX when compiling with gcc/g++
131#if defined(__HPUX__) && defined(__GNUG__)
4f89dbc4 132#define va_list __gnuc_va_list
78340847
VZ
133#endif // HP-UX
134
57493f9f
VZ
135// ----------------------------------------------------------------------------
136// check for native bool type and TRUE/FALSE constants
137// ----------------------------------------------------------------------------
138
57493f9f
VZ
139// Add more tests here for Windows compilers that already define bool
140// (under Unix, configure tests for this)
141#ifndef HAVE_BOOL
142 #if defined( __MWERKS__ )
585ae8cb 143 #if (__MWERKS__ >= 0x1000) && __option(bool)
57493f9f
VZ
144 #define HAVE_BOOL
145 #endif
67087ab4
GD
146 #elif defined(__APPLE__) && defined(__APPLE_CC__)
147 // Apple bundled gcc supports bool
148 #define HAVE_BOOL
57493f9f
VZ
149 #elif defined(__VISUALC__) && (__VISUALC__ == 1020)
150 // in VC++ 4.2 the bool keyword is reserved (hence can't be typedefed)
151 // but not implemented, so we must #define it
152 #define bool unsigned int
794005c0
JS
153 #elif defined(__VISUALC__) && (__VISUALC__ == 1010)
154 // For VisualC++ 4.1, we need to define
155 // bool as something between 4.0 & 5.0...
156 typedef unsigned int wxbool;
157 #define bool wxbool
158 #define HAVE_BOOL
57493f9f
VZ
159 #elif defined(__VISUALC__) && (__VISUALC__ > 1020)
160 // VC++ supports bool since 4.2
161 #define HAVE_BOOL
162 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x500)
163 // Borland 5.0+ supports bool
164 #define HAVE_BOOL
165 #elif defined(__WATCOMC__) && (__WATCOMC__ >= 1100)
166 // Watcom 11+ supports bool
167 #define HAVE_BOOL
4f6e963c 168 #elif defined(__DIGITALMARS__)
4ce1efe1
CE
169 // DigitalMars supports bool
170 #define HAVE_BOOL
d66dcb60 171 #elif defined(__GNUWIN32__) || defined(__MINGW32__) || defined(__CYGWIN__)
6776a0b2
JS
172 // Cygwin supports bool
173 #define HAVE_BOOL
1777b9bb 174 #elif defined(__VISAGECPP__)
51d7e4e7
DW
175 #if __IBMCPP__ < 400
176 typedef unsigned long bool;
b823f462
DW
177 #define true ((bool)1)
178 #define false ((bool)0)
51d7e4e7 179 #endif
1777b9bb 180 #define HAVE_BOOL
57493f9f
VZ
181 #endif // compilers
182#endif // HAVE_BOOL
183
41b0a113 184#if !defined(HAVE_BOOL) && !defined(bool) && !defined(VMS)
57493f9f
VZ
185 // NB: of course, this doesn't replace the standard type, because, for
186 // example, overloading based on bool/int parameter doesn't work and
187 // so should be avoided in portable programs
a2d541ca 188 typedef unsigned int bool;
57493f9f 189#endif // bool
c801d85f 190
90b1d65f
VZ
191// deal with TRUE/true stuff: we assume that if the compiler supports bool, it
192// supports true/false as well and that, OTOH, if it does _not_ support bool,
193// it doesn't support these keywords (this is less sure, in particular VC++
194// 4.x could be a problem here)
195#ifndef HAVE_BOOL
196 #define true ((bool)1)
197 #define false ((bool)0)
198#endif
199
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
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
VZ
213
214// special care should be taken with this type under Windows where the real
215// window id is unsigned, so we must always do the cast before comparing them
216// (or else they would be always different!). Usign wxGetWindowId() which does
217// the cast itself is recommended. Note that this type can't be unsigned
986ecc86 218// because wxID_ANY == -1 is a valid (and largely used) value for window id.
c801d85f
KB
219typedef int wxWindowID;
220
0b9ab0bd
RL
221// ----------------------------------------------------------------------------
222// other feature tests
223// ----------------------------------------------------------------------------
224
a2d541ca
VZ
225// Every ride down a slippery slope begins with a single step..
226//
227// Yes, using nested classes is indeed against our coding standards in
228// general, but there are places where you can use them to advantage
229// without totally breaking ports that cannot use them. If you do, then
230// wrap it in this guard, but such cases should still be relatively rare.
0b9ab0bd 231#ifndef __WIN16__
a2d541ca 232 #define wxUSE_NESTED_CLASSES 1
0b9ab0bd 233#else
a2d541ca 234 #define wxUSE_NESTED_CLASSES 0
0b9ab0bd
RL
235#endif
236
986ecc86
VZ
237// check for explicit keyword support
238#ifndef HAVE_EXPLICIT
521196a2 239 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
e87b7833 240 // VC++ 6.0 and 5.0 have explicit (what about earlier versions?)
521196a2
MB
241 #define HAVE_EXPLICIT
242 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
243 && wxCHECK_GCC_VERSION(2, 95)
244 // GCC 2.95 has explicit, what about earlier versions?
cabf185c
VZ
245 #define HAVE_EXPLICIT
246 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x0520)
247 // BC++ 4.52 doesn't support explicit, CBuilder 1 does
74bdbc46 248 #define HAVE_EXPLICIT
74bdbc46 249 #elif defined(__MWERKS__) && (__MWERKS__ >= 0x2400)
cabf185c 250 // Metrowerks CW6 or higher has explicit
986ecc86 251 #define HAVE_EXPLICIT
0b3f29b3 252 #elif defined(__DIGITALMARS__)
76c71809 253 #define HAVE_EXPLICIT
986ecc86
VZ
254 #endif
255#endif // !HAVE_EXPLICIT
256
257#ifdef HAVE_EXPLICIT
258 #define wxEXPLICIT explicit
259#else // !HAVE_EXPLICIT
260 #define wxEXPLICIT
261#endif // HAVE_EXPLICIT/!HAVE_EXPLICIT
262
521196a2
MB
263// check for static/const/reinterpret_cast<>()
264#ifndef HAVE_STATIC_CAST
265 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
e87b7833 266 // VC++ 6.0 and 5.0 have C++ casts (what about earlier versions?)
521196a2
MB
267 #define HAVE_CXX_CASTS
268 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
269 && wxCHECK_GCC_VERSION(2, 95)
270 // GCC 2.95 has C++ casts, what about earlier versions?
271 #define HAVE_CXX_CASTS
272 #endif
273#endif // HAVE_STATIC_CAST
274
275#ifdef HAVE_CXX_CASTS
276 #ifndef HAVE_CONST_CAST
277 #define HAVE_CONST_CAST
278 #endif
279#endif // HAVE_CXX_CASTS
280
e87b7833
MB
281#ifndef HAVE_STD_WSTRING
282 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
283 // VC++ 6.0 and 5.0 have std::wstring (what about earlier versions?)
284 #define HAVE_STD_WSTRING
285 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
286 && wxCHECK_GCC_VERSION(3, 1)
287 // GCC 3.1 has std::wstring; 3.0 never was in MinGW, 2.95 hasn't it
288 #define HAVE_STD_WSTRING
289 #endif
290#endif
291
292#ifndef HAVE_STD_STRING_COMPARE
293 #if defined(__VISUALC__) && (__VISUALC__ >= 1100)
294 // VC++ 6.0 and 5.0 have std::string::compare
295 // (what about earlier versions?)
296 #define HAVE_STD_STRING_COMPARE
297 #elif ( defined(__MINGW32__) || defined(__CYGWIN32__) ) \
298 && wxCHECK_GCC_VERSION(3, 1)
4f6e963c 299 // GCC 3.1 has std::string::compare;
e87b7833
MB
300 // 3.0 never was in MinGW, 2.95 hasn't it
301 #define HAVE_STD_STRING_COMPARE
302 #endif
303#endif
304
0661ec39
VZ
305// ----------------------------------------------------------------------------
306// portable calling conventions macros
307// ----------------------------------------------------------------------------
308
1222db72 309// stdcall is used for all functions called by Windows under Windows
b4da152e 310#if defined(__WINDOWS__)
1222db72 311 #if defined(__GNUWIN32__)
ba2d8605 312 #define wxSTDCALL __attribute__((stdcall))
0661ec39
VZ
313 #else
314 // both VC++ and Borland understand this
ba2d8605 315 #define wxSTDCALL _stdcall
0661ec39 316 #endif
ba2d8605 317
1222db72
VZ
318#else // Win
319 // no such stupidness under Unix
320 #define wxSTDCALL
321#endif // platform
322
78340847
VZ
323// LINKAGEMODE mode is empty for everyting except OS/2
324#ifndef LINKAGEMODE
325 #define LINKAGEMODE
326#endif // LINKAGEMODE
327
1222db72
VZ
328// wxCALLBACK should be used for the functions which are called back by
329// Windows (such as compare function for wxListCtrl)
04ef50df 330#if defined(__WIN32__) && !defined(__WXMICROWIN__)
1222db72 331 #define wxCALLBACK wxSTDCALL
0661ec39 332#else
8f177c8e 333 // no stdcall under Unix nor Win16
0661ec39
VZ
334 #define wxCALLBACK
335#endif // platform
336
90350682 337// generic calling convention for the extern "C" functions
0661ec39
VZ
338
339#if defined(__VISUALC__)
90350682 340 #define wxC_CALLING_CONV _cdecl
0661ec39 341#elif defined(__VISAGECPP__)
90350682 342 #define wxC_CALLING_CONV _Optlink
0661ec39 343#else // !Visual C++
90350682 344 #define wxC_CALLING_CONV
0661ec39
VZ
345#endif // compiler
346
90350682
VZ
347// callling convention for the qsort(3) callback
348#define wxCMPFUNC_CONV wxC_CALLING_CONV
349
0661ec39
VZ
350// compatibility :-(
351#define CMPFUNC_CONV wxCMPFUNC_CONV
352
353// ----------------------------------------------------------------------------
354// Making or using wxWindows as a Windows DLL
355// ----------------------------------------------------------------------------
c801d85f 356
1777b9bb 357#if defined(__WXMSW__)
5d2878fb
VZ
358 // __declspec works in BC++ 5 and later, Watcom C++ 11.0 and later as well
359 // as VC++ and gcc
360 #if defined(__VISUALC__) || defined(__BORLANDC__) || defined(__GNUC__) || defined(__WATCOMC__)
361 #define WXEXPORT __declspec(dllexport)
362 #define WXIMPORT __declspec(dllimport)
363 #else // compiler doesn't support __declspec()
364 #define WXEXPORT
365 #define WXIMPORT
366 #endif
1777b9bb 367#elif defined(__WXPM__)
5d2878fb
VZ
368 #if defined (__WATCOMC__)
369 #define WXEXPORT __declspec(dllexport)
370 // __declspec(dllimport) prepends __imp to imported symbols. We do NOT
371 // want that!
372 #define WXIMPORT
373 #elif (!(defined(__VISAGECPP__) && (__IBMCPP__ < 400 || __IBMC__ < 400 )))
374 #define WXEXPORT _Export
375 #define WXIMPORT _Export
376 #endif
43225e09 377#elif defined(__WXMAC__) || defined(__WXCOCOA__)
724f720f
SC
378 #ifdef __MWERKS__
379 #define WXEXPORT __declspec(export)
380 #define WXIMPORT __declspec(import)
381 #endif
5d2878fb 382#endif
1777b9bb 383
5d2878fb
VZ
384// for other platforms/compilers we don't anything
385#ifndef WXEXPORT
386 #define WXEXPORT
387 #define WXIMPORT
c801d85f
KB
388#endif
389
886dd7d2
VZ
390/*
391 We support building wxWindows as a set of several libraries but we don't
392 support arbitrary combinations of libs/DLLs: either we build all of them as
393 DLLs (in which case WXMAKINGDLL is defined) or none (it isn't).
394
395 However we have a problem because we need separate WXDLLEXPORT versions for
396 different libraries as, for example, wxString class should be dllexported
397 when compiled in wxBase and dllimported otherwise, so we do define separate
398 WXMAKING/USINGDLL_XYZ constants for each component XYZ.
399 */
5d2878fb 400#ifdef WXMAKINGDLL
886dd7d2
VZ
401 #if wxUSE_BASE
402 #define WXMAKINGDLL_BASE
886dd7d2
VZ
403 #endif
404
7c4728f6 405 #define WXMAKINGDLL_NET
886dd7d2 406 #define WXMAKINGDLL_CORE
12f190b0 407 #define WXMAKINGDLL_ADV
bb41dcbe 408 #define WXMAKINGDLL_ODBC
83b9886f 409 #define WXMAKINGDLL_DBGRID
42bf837c 410 #define WXMAKINGDLL_HTML
27b0c286 411 #define WXMAKINGDLL_XML
886dd7d2
VZ
412#endif // WXMAKINGDLL
413
886dd7d2
VZ
414// WXDLLEXPORT maps to export declaration when building the DLL, to import
415// declaration if using it or to nothing at all if we don't use wxWin as DLL
416#ifdef WXMAKINGDLL_BASE
bddd7a8d
VZ
417 #define WXDLLIMPEXP_BASE WXEXPORT
418 #define WXDLLIMPEXP_DATA_BASE(type) WXEXPORT type
a7140600 419#elif defined(WXUSINGDLL)
bddd7a8d
VZ
420 #define WXDLLIMPEXP_BASE WXIMPORT
421 #define WXDLLIMPEXP_DATA_BASE(type) WXIMPORT type
5d2878fb 422#else // not making nor using DLL
bddd7a8d
VZ
423 #define WXDLLIMPEXP_BASE
424 #define WXDLLIMPEXP_DATA_BASE(type) type
5d2878fb 425#endif
c801d85f 426
7c4728f6
VS
427#ifdef WXMAKINGDLL_NET
428 #define WXDLLIMPEXP_NET WXEXPORT
429 #define WXDLLIMPEXP_DATA_NET(type) WXEXPORT type
430#elif defined(WXUSINGDLL)
431 #define WXDLLIMPEXP_NET WXIMPORT
432 #define WXDLLIMPEXP_DATA_NET(type) WXIMPORT type
433#else // not making nor using DLL
434 #define WXDLLIMPEXP_NET
435 #define WXDLLIMPEXP_DATA_NET(type) type
436#endif
437
886dd7d2 438#ifdef WXMAKINGDLL_CORE
bddd7a8d
VZ
439 #define WXDLLIMPEXP_CORE WXEXPORT
440 #define WXDLLIMPEXP_DATA_CORE(type) WXEXPORT type
a7140600 441#elif defined(WXUSINGDLL)
bddd7a8d
VZ
442 #define WXDLLIMPEXP_CORE WXIMPORT
443 #define WXDLLIMPEXP_DATA_CORE(type) WXIMPORT type
886dd7d2 444#else // not making nor using DLL
bddd7a8d
VZ
445 #define WXDLLIMPEXP_CORE
446 #define WXDLLIMPEXP_DATA_CORE(type) type
886dd7d2
VZ
447#endif
448
12f190b0
VS
449#ifdef WXMAKINGDLL_ADV
450 #define WXDLLIMPEXP_ADV WXEXPORT
451 #define WXDLLIMPEXP_DATA_ADV(type) WXEXPORT type
452#elif defined(WXUSINGDLL)
453 #define WXDLLIMPEXP_ADV WXIMPORT
454 #define WXDLLIMPEXP_DATA_ADV(type) WXIMPORT type
455#else // not making nor using DLL
456 #define WXDLLIMPEXP_ADV
457 #define WXDLLIMPEXP_DATA_ADV(type) type
458#endif
459
bb41dcbe
VS
460#ifdef WXMAKINGDLL_ODBC
461 #define WXDLLIMPEXP_ODBC WXEXPORT
462 #define WXDLLIMPEXP_DATA_ODBC(type) WXEXPORT type
463#elif defined(WXUSINGDLL)
464 #define WXDLLIMPEXP_ODBC WXIMPORT
465 #define WXDLLIMPEXP_DATA_ODBC(type) WXIMPORT type
466#else // not making nor using DLL
467 #define WXDLLIMPEXP_ODBC
468 #define WXDLLIMPEXP_DATA_ODBC(type) type
469#endif
470
83b9886f
VS
471#ifdef WXMAKINGDLL_DBGRID
472 #define WXDLLIMPEXP_DBGRID WXEXPORT
473 #define WXDLLIMPEXP_DATA_DBGRID(type) WXEXPORT type
474#elif defined(WXUSINGDLL)
475 #define WXDLLIMPEXP_DBGRID WXIMPORT
476 #define WXDLLIMPEXP_DATA_DBGRID(type) WXIMPORT type
477#else // not making nor using DLL
478 #define WXDLLIMPEXP_DBGRID
479 #define WXDLLIMPEXP_DATA_DBGRID(type) type
480#endif
481
ff641162
VS
482#ifdef WXMAKINGDLL_HTML
483 #define WXDLLIMPEXP_HTML WXEXPORT
484 #define WXDLLIMPEXP_DATA_HTML(type) WXEXPORT type
485#elif defined(WXUSINGDLL)
486 #define WXDLLIMPEXP_HTML WXIMPORT
487 #define WXDLLIMPEXP_DATA_HTML(type) WXIMPORT type
488#else // not making nor using DLL
489 #define WXDLLIMPEXP_HTML
490 #define WXDLLIMPEXP_DATA_HTML(type) type
491#endif
492
eac90854
VS
493#ifdef WXMAKINGDLL_GL
494 #define WXDLLIMPEXP_GL WXEXPORT
a7140600 495#elif defined(WXUSINGDLL)
eac90854 496 #define WXDLLIMPEXP_GL WXIMPORT
6acba9a7 497#else // not making nor using DLL
eac90854 498 #define WXDLLIMPEXP_GL
6acba9a7
VS
499#endif
500
27b0c286
VS
501#ifdef WXMAKINGDLL_XML
502 #define WXDLLIMPEXP_XML WXEXPORT
503#elif defined(WXUSINGDLL)
504 #define WXDLLIMPEXP_XML WXIMPORT
505#else // not making nor using DLL
506 #define WXDLLIMPEXP_XML
507#endif
508
886dd7d2 509// for backwards compatibility, define suffix-less versions too
bddd7a8d
VZ
510#define WXDLLEXPORT WXDLLIMPEXP_CORE
511#define WXDLLEXPORT_DATA WXDLLIMPEXP_DATA_CORE
c801d85f 512
c801d85f 513// ----------------------------------------------------------------------------
f6bcfd97 514// Very common macros
c801d85f 515// ----------------------------------------------------------------------------
f6bcfd97 516
54afeafe
RR
517// Printf-like attribute definitions to obtain warnings with GNU C/C++
518#if defined(__GNUC__) && !wxUSE_UNICODE
519# ifndef ATTRIBUTE_PRINTF
520# define ATTRIBUTE_PRINTF(m, n) __attribute__ ((__format__ (__printf__, m, n)))
521# define ATTRIBUTE_PRINTF_1 ATTRIBUTE_PRINTF(1, 2)
522# define ATTRIBUTE_PRINTF_2 ATTRIBUTE_PRINTF(2, 3)
523# define ATTRIBUTE_PRINTF_3 ATTRIBUTE_PRINTF(3, 4)
524# define ATTRIBUTE_PRINTF_4 ATTRIBUTE_PRINTF(4, 5)
525# define ATTRIBUTE_PRINTF_5 ATTRIBUTE_PRINTF(5, 6)
526# endif /* ATTRIBUTE_PRINTF */
527#else
528# ifndef ATTRIBUTE_PRINTF
529# define ATTRIBUTE_PRINTF
530# define ATTRIBUTE_PRINTF_1
531# define ATTRIBUTE_PRINTF_2
532# define ATTRIBUTE_PRINTF_3
533# define ATTRIBUTE_PRINTF_4
534# define ATTRIBUTE_PRINTF_5
535# endif /* ATTRIBUTE_PRINTF */
536#endif
537
6c99908c 538// Macro to issue warning when using deprecated functions with gcc3 or MSVC7:
7071c928 539#if wxCHECK_GCC_VERSION(3, 1)
c75274f9
VS
540 #define wxDEPRECATED(x) x __attribute__ ((deprecated))
541#elif defined(__VISUALC__) && (__VISUALC__ >= 1300)
542 #define wxDEPRECATED(x) __declspec(deprecated) x
543#else
544 #define wxDEPRECATED(x) x
545#endif
546
f6bcfd97 547// everybody gets the assert and other debug macros
33ac7e6f 548#ifdef __cplusplus
f6bcfd97 549#include "wx/debug.h"
33ac7e6f 550#endif
f6bcfd97 551
752b40b1
VZ
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)
aaa63f66
VZ
555#include <stddef.h>
556
752b40b1
VZ
557// Macro to cut down on compiler warnings.
558#if REMOVE_UNUSED_ARG
559 #define WXUNUSED(identifier) /* identifier */
560#else // stupid, broken compiler
561 #define WXUNUSED(identifier) identifier
562#endif
563
564// some arguments are only used in debug mode, but unused in release one
565#ifdef __WXDEBUG__
566 #define WXUNUSED_UNLESS_DEBUG(param) param
567#else
568 #define WXUNUSED_UNLESS_DEBUG(param) WXUNUSED(param)
569#endif
570
571// delete pointer if it is not NULL and NULL it afterwards
a3622daa
VZ
572// (checking that it's !NULL before passing it to delete is just a
573// a question of style, because delete will do it itself anyhow, but it might
574// be considered as an error by some overzealous debugging implementations of
575// the library, so we do it ourselves)
d8260b2f 576#define wxDELETE(p) if ( (p) != NULL ) { delete p; p = NULL; }
a3622daa
VZ
577
578// delete an array and NULL it (see comments above)
752b40b1 579#define wxDELETEA(p) if ( (p) ) { delete [] (p); p = NULL; }
c801d85f 580
752b40b1 581// size of statically declared array
c801d85f
KB
582#define WXSIZEOF(array) (sizeof(array)/sizeof(array[0]))
583
9bf41e06
VZ
584// helper macros to be able to define unique/anonymous objects: this works by
585// appending the current line number to the given identifier to reduce the
586// probability of the conflict (it may still happen if this is used in the
587// headers, hence you should avoid doing it or provide unique prefixes then)
588#define wxCONCAT(text, line) text ## line
589#define wxCONCAT_LINE2(text, line) wxCONCAT(text, line)
590#define wxCONCAT_LINE(text) wxCONCAT_LINE2(text, __LINE__)
591#define wxMAKE_UNIQUE_NAME(text) wxCONCAT_LINE(text)
592
886dd7d2
VZ
593// symbolic constant used by all Find()-like functions returning positive
594// integer on success as failure indicator
595#define wxNOT_FOUND (-1)
596
c801d85f
KB
597// ----------------------------------------------------------------------------
598// compiler specific settings
599// ----------------------------------------------------------------------------
600
601// to allow compiling with warning level 4 under Microsoft Visual C++ some
602// warnings just must be disabled
603#ifdef __VISUALC__
604 #pragma warning(disable: 4514) // unreferenced inline func has been removed
d4b67f95 605/*
c801d85f 606 you might be tempted to disable this one also: triggered by CHECK and FAIL
3f4a0c5b
VZ
607 macros in debug.h, but it's, overall, a rather useful one, so I leave it and
608 will try to find some way to disable this warning just for CHECK/FAIL. Anyone?
c801d85f
KB
609*/
610 #pragma warning(disable: 4127) // conditional expression is constant
c801d85f
KB
611#endif // VC++
612
3f4a0c5b
VZ
613#if defined(__MWERKS__)
614 #undef try
615 #undef except
616 #undef finally
617 #define except(x) catch(...)
618#endif // Metrowerks
8a60ae88 619
85ee3474
UU
620// where should i put this? we need to make sure of this as it breaks
621// the <iostream> code.
ea57084d 622#if !wxUSE_IOSTREAMH && defined(__WXDEBUG__)
f6bcfd97
BP
623# ifndef __MWERKS__
624// #undef __WXDEBUG__
625# ifdef wxUSE_DEBUG_NEW_ALWAYS
626# undef wxUSE_DEBUG_NEW_ALWAYS
627# define wxUSE_DEBUG_NEW_ALWAYS 0
628# endif
629# endif
518f33a4 630#endif
85ee3474 631
329e86bf
RR
632// ----------------------------------------------------------------------------
633// OS mnemonics -- Identify the running OS (useful for Windows)
634// ----------------------------------------------------------------------------
635
636// Not all platforms are currently available or supported
637enum
638{
b12915c1
VZ
639 wxUNKNOWN_PLATFORM,
640 wxCURSES, // Text-only CURSES
641 wxXVIEW_X, // Sun's XView OpenLOOK toolkit
642 wxMOTIF_X, // OSF Motif 1.x.x
643 wxCOSE_X, // OSF Common Desktop Environment
644 wxNEXTSTEP, // NeXTStep
ff8fda36
GD
645 wxMAC, // Apple Mac OS 8/9/X with Mac paths
646 wxMAC_DARWIN, // Apple Mac OS X with Unix paths
b12915c1
VZ
647 wxBEOS, // BeOS
648 wxGTK, // GTK on X
649 wxGTK_WIN32, // GTK on Win32
650 wxGTK_OS2, // GTK on OS/2
651 wxGTK_BEOS, // GTK on BeOS
b12915c1
VZ
652 wxGEOS, // GEOS
653 wxOS2_PM, // OS/2 Workplace
654 wxWINDOWS, // Windows or WfW
83df96d6 655 wxMICROWINDOWS, // MicroWindows
b12915c1
VZ
656 wxPENWINDOWS, // Windows for Pen Computing
657 wxWINDOWS_NT, // Windows NT
658 wxWIN32S, // Windows 32S API
659 wxWIN95, // Windows 95
660 wxWIN386, // Watcom 32-bit supervisor modus
f07dc2e2 661 wxWINDOWS_CE, // Windows CE
b12915c1
VZ
662 wxMGL_UNIX, // MGL with direct hardware access
663 wxMGL_X, // MGL on X
664 wxMGL_WIN32, // MGL on Win32
665 wxMGL_OS2, // MGL on OS/2
b32a1ead 666 wxMGL_DOS, // MGL on MS-DOS
bd3277fe 667 wxWINDOWS_OS2, // Native OS/2 PM
83df96d6
JS
668 wxUNIX, // wxBase under Unix
669 wxX11 // Plain X11 and Universal widgets
329e86bf
RR
670};
671
d716d967 672// ----------------------------------------------------------------------------
72cdf4c9 673// standard wxWindows types
d716d967
RR
674// ----------------------------------------------------------------------------
675
72cdf4c9
VZ
676// the type for screen and DC coordinates
677
678#if wxUSE_COMPATIBLE_COORD_TYPES
679 // to ensure compatibility with 2.0, we must use long
680 #define wxCoord long
681#else // !wxUSE_COMPATIBLE_COORD_TYPES
682 #ifdef __WIN16__
683 // under Win16, int is too small, so use long to allow for bigger
684 // virtual canvases
685 typedef long wxCoord;
686 #else // !Win16
687 // other platforms we support have at least 32bit int - quite enough
688 typedef int wxCoord;
689 #endif // Win16/!Win16
690#endif // wxUSE_COMPATIBLE_COORD_TYPES/!wxUSE_COMPATIBLE_COORD_TYPES
691
d716d967
RR
692// fixed length types
693
56d7679d 694#define wxInt8 char signed
bac507e0 695#define wxUint8 char unsigned
d716d967 696
988a8d44
VS
697#ifdef __WINDOWS__
698 #if defined(__WIN16__)
699 #define wxInt16 int signed
700 #define wxUint16 int unsigned
701 #define wxInt32 long signed
702 #define wxUint32 long unsigned
703 #elif defined(__WIN32__)
704 #define wxInt16 short signed
705 #define wxUint16 short unsigned
706 #define wxInt32 int signed
707 #define wxUint32 int unsigned
708 #else
709 // Win64 will have different type sizes
710 #error "Please define a 32 bit type"
711 #endif
712#else // !Windows
713 // SIZEOF_XXX are defined by configure
714 #if defined(SIZEOF_INT) && (SIZEOF_INT == 4)
715 #define wxInt16 short signed
716 #define wxUint16 short unsigned
717 #define wxInt32 int signed
718 #define wxUint32 int unsigned
719 #elif defined(SIZEOF_INT) && (SIZEOF_INT == 2)
720 #define wxInt16 int signed
721 #define wxUint16 int unsigned
722 #define wxInt32 long signed
723 #define wxUint32 long unsigned
724 #else
725 // assume sizeof(int) == 4 - what else can we do
726 wxCOMPILE_TIME_ASSERT( sizeof(int) == 4, IntMustBeExactly4Bytes);
727
728 #define wxInt16 short signed
729 #define wxUint16 short unsigned
730 #define wxInt32 int signed
731 #define wxUint32 int unsigned
732 #endif
733#endif // Win/!Win
d716d967 734
41b0a113
RL
735#if defined(SIZEOF_LONG) && (SIZEOF_LONG == 8)
736#define wxInt64 long signed
737#define wxUint64 long unsigned
738#elif defined(SIZEOF_LONG_LONG) && (SIZEOF_LONG_LONG == 8)
739#define wxInt64 long long signed
740#define wxUint64 long long unsigned
741#else // FIXME: what else can we do here aside from implementing wxULongLong
742#define wxInt64 wxLongLong
8e38fd1f 743#define wxUint64 wxULongLong
d716d967
RR
744#endif
745
56d7679d 746#define wxByte wxUint8
bac507e0 747#define wxWord wxUint16
d716d967 748
43543d98 749// base floating point types
7c74e7fe
SC
750// wxFloat32 : 32 bit IEEE float ( 1 sign , 8 exponent bits , 23 fraction bits
751// wxFloat64 : 64 bit IEEE float ( 1 sign , 11 exponent bits , 52 fraction bits
752// wxDouble : native fastest representation that has at least wxFloat64
753// precision, so use the IEEE types for storage , and this for calculations
754
43543d98 755typedef float wxFloat32 ;
43225e09 756#if (defined( __WXMAC__ ) || defined(__WXCOCOA__)) && defined (__MWERKS__)
f608bc67 757 typedef short double wxFloat64;
7c74e7fe 758#else
f608bc67 759 typedef double wxFloat64;
7c74e7fe
SC
760#endif
761
43543d98 762#if defined( __WXMAC__ ) && !defined( __POWERPC__ )
20d9661c 763 typedef long double wxDouble;
7c74e7fe 764#else
20d9661c 765 typedef double wxDouble ;
7c74e7fe
SC
766#endif
767
72cdf4c9
VZ
768// ----------------------------------------------------------------------------
769// byte ordering related definition and macros
770// ----------------------------------------------------------------------------
771
d716d967
RR
772// byte sex
773
774#define wxBIG_ENDIAN 4321
775#define wxLITTLE_ENDIAN 1234
776#define wxPDP_ENDIAN 3412
777
778#ifdef WORDS_BIGENDIAN
779#define wxBYTE_ORDER wxBIG_ENDIAN
780#else
781#define wxBYTE_ORDER wxLITTLE_ENDIAN
782#endif
783
784// byte swapping
785
7c74e7fe
SC
786#if defined (__MWERKS__) && ( (__MWERKS__ < 0x0900) || macintosh )
787// assembler versions for these
788#ifdef __POWERPC__
f608bc67
VZ
789 inline wxUint16 wxUINT16_SWAP_ALWAYS( wxUint16 i )
790 {return (__lhbrx( &i , 0 ) ) ;}
791 inline wxInt16 wxINT16_SWAP_ALWAYS( wxInt16 i )
792 {return (__lhbrx( &i , 0 ) ) ;}
793 inline wxUint32 wxUINT32_SWAP_ALWAYS( wxUint32 i )
794 {return (__lwbrx( &i , 0 ) ) ;}
795 inline wxInt32 wxINT32_SWAP_ALWAYS( wxInt32 i )
796 {return (__lwbrx( &i , 0 ) ) ;}
7c74e7fe 797#else
f608bc67
VZ
798 #pragma parameter __D0 wxUINT16_SWAP_ALWAYS(__D0)
799 pascal wxUint16 wxUINT16_SWAP_ALWAYS(wxUint16 value)
800 = { 0xE158 };
801
802 #pragma parameter __D0 wxINT16_SWAP_ALWAYS(__D0)
a02bb143 803 pascal wxInt16 wxINT16_SWAP_ALWAYS(wxInt16 value)
f608bc67
VZ
804 = { 0xE158 };
805
806 #pragma parameter __D0 wxUINT32_SWAP_ALWAYS (__D0)
807 pascal wxUint32 wxUINT32_SWAP_ALWAYS(wxUint32 value)
808 = { 0xE158, 0x4840, 0xE158 };
809
810 #pragma parameter __D0 wxINT32_SWAP_ALWAYS (__D0)
a02bb143 811 pascal wxInt32 wxINT32_SWAP_ALWAYS(wxInt32 value)
f608bc67 812 = { 0xE158, 0x4840, 0xE158 };
7c74e7fe
SC
813
814#endif
815#else // !MWERKS
d716d967
RR
816#define wxUINT16_SWAP_ALWAYS(val) \
817 ((wxUint16) ( \
818 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
819 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
bac507e0 820
d716d967
RR
821#define wxINT16_SWAP_ALWAYS(val) \
822 ((wxInt16) ( \
7e2c43b8
RR
823 (((wxUint16) (val) & (wxUint16) 0x00ffU) << 8) | \
824 (((wxUint16) (val) & (wxUint16) 0xff00U) >> 8)))
bac507e0 825
d716d967
RR
826#define wxUINT32_SWAP_ALWAYS(val) \
827 ((wxUint32) ( \
828 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
829 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
830 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
831 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
832
833#define wxINT32_SWAP_ALWAYS(val) \
834 ((wxInt32) ( \
7e2c43b8
RR
835 (((wxUint32) (val) & (wxUint32) 0x000000ffU) << 24) | \
836 (((wxUint32) (val) & (wxUint32) 0x0000ff00U) << 8) | \
837 (((wxUint32) (val) & (wxUint32) 0x00ff0000U) >> 8) | \
838 (((wxUint32) (val) & (wxUint32) 0xff000000U) >> 24)))
7c74e7fe 839#endif
d716d967
RR
840// machine specific byte swapping
841
8e38fd1f
RL
842#if defined(SIZEOF_LONG) && (SIZEOF_LONG == 8)
843#define wxUINT64_SWAP_ALWAYS(val) \
844 ((wxUint64) ( \
845 (((wxUint64) (val) & (wxUint64) 0x00000000000000ffUL) << 56) | \
846 (((wxUint64) (val) & (wxUint64) 0x000000000000ff00UL) << 40) | \
847 (((wxUint64) (val) & (wxUint64) 0x0000000000ff0000UL) << 24) | \
848 (((wxUint64) (val) & (wxUint64) 0x00000000ff000000UL) << 8) | \
849 (((wxUint64) (val) & (wxUint64) 0x000000ff00000000UL) >> 8) | \
850 (((wxUint64) (val) & (wxUint64) 0x0000ff0000000000UL) >> 24) | \
851 (((wxUint64) (val) & (wxUint64) 0x00ff000000000000UL) >> 40) | \
852 (((wxUint64) (val) & (wxUint64) 0xff00000000000000UL) >> 56)))
853
854#define wxINT64_SWAP_ALWAYS(val) \
855 ((wxInt64) ( \
856 (((wxUint64) (val) & (wxUint64) 0x00000000000000ffUL) << 56) | \
857 (((wxUint64) (val) & (wxUint64) 0x000000000000ff00UL) << 40) | \
858 (((wxUint64) (val) & (wxUint64) 0x0000000000ff0000UL) << 24) | \
859 (((wxUint64) (val) & (wxUint64) 0x00000000ff000000UL) << 8) | \
860 (((wxUint64) (val) & (wxUint64) 0x000000ff00000000UL) >> 8) | \
861 (((wxUint64) (val) & (wxUint64) 0x0000ff0000000000UL) >> 24) | \
862 (((wxUint64) (val) & (wxUint64) 0x00ff000000000000UL) >> 40) | \
863 (((wxUint64) (val) & (wxUint64) 0xff00000000000000UL) >> 56)))
864
865#elif defined(SIZEOF_LONG_LONG) && (SIZEOF_LONG_LONG == 8)
866#define wxUINT64_SWAP_ALWAYS(val) \
867 ((wxUint64) ( \
868 (((wxUint64) (val) & (wxUint64) 0x00000000000000ffULL) << 56) | \
869 (((wxUint64) (val) & (wxUint64) 0x000000000000ff00ULL) << 40) | \
870 (((wxUint64) (val) & (wxUint64) 0x0000000000ff0000ULL) << 24) | \
871 (((wxUint64) (val) & (wxUint64) 0x00000000ff000000ULL) << 8) | \
872 (((wxUint64) (val) & (wxUint64) 0x000000ff00000000ULL) >> 8) | \
873 (((wxUint64) (val) & (wxUint64) 0x0000ff0000000000ULL) >> 24) | \
874 (((wxUint64) (val) & (wxUint64) 0x00ff000000000000ULL) >> 40) | \
875 (((wxUint64) (val) & (wxUint64) 0xff00000000000000ULL) >> 56)))
876
877#define wxINT64_SWAP_ALWAYS(val) \
878 ((wxInt64) ( \
879 (((wxUint64) (val) & (wxUint64) 0x00000000000000ffULL) << 56) | \
880 (((wxUint64) (val) & (wxUint64) 0x000000000000ff00ULL) << 40) | \
881 (((wxUint64) (val) & (wxUint64) 0x0000000000ff0000ULL) << 24) | \
882 (((wxUint64) (val) & (wxUint64) 0x00000000ff000000ULL) << 8) | \
883 (((wxUint64) (val) & (wxUint64) 0x000000ff00000000ULL) >> 8) | \
884 (((wxUint64) (val) & (wxUint64) 0x0000ff0000000000ULL) >> 24) | \
885 (((wxUint64) (val) & (wxUint64) 0x00ff000000000000ULL) >> 40) | \
886 (((wxUint64) (val) & (wxUint64) 0xff00000000000000ULL) >> 56)))
887
888#else
41b0a113
RL
889#define wxUINT64_SWAP_ALWAYS(val) \
890 ((wxUint64) ( \
4f716609
RL
891 ((wxULongLong(val) & wxULongLong(0L, 0x000000ffU)) << 56) | \
892 ((wxULongLong(val) & wxULongLong(0L, 0x0000ff00U)) << 40) | \
893 ((wxULongLong(val) & wxULongLong(0L, 0x00ff0000U)) << 24) | \
894 ((wxULongLong(val) & wxULongLong(0L, 0xff000000U)) << 8) | \
895 ((wxULongLong(val) & wxULongLong(0x000000ffL, 0U)) >> 8) | \
896 ((wxULongLong(val) & wxULongLong(0x0000ff00L, 0U)) >> 24) | \
897 ((wxULongLong(val) & wxULongLong(0x00ff0000L, 0U)) >> 40) | \
898 ((wxULongLong(val) & wxULongLong(0xff000000L, 0U)) >> 56)))
41b0a113
RL
899
900#define wxINT64_SWAP_ALWAYS(val) \
901 ((wxInt64) ( \
902 ((wxLongLong(val) & wxLongLong(0L, 0x000000ffU)) << 56) | \
903 ((wxLongLong(val) & wxLongLong(0L, 0x0000ff00U)) << 40) | \
904 ((wxLongLong(val) & wxLongLong(0L, 0x00ff0000U)) << 24) | \
905 ((wxLongLong(val) & wxLongLong(0L, 0xff000000U)) << 8) | \
906 ((wxLongLong(val) & wxLongLong(0x000000ffL, 0U)) >> 8) | \
907 ((wxLongLong(val) & wxLongLong(0x0000ff00L, 0U)) >> 24) | \
908 ((wxLongLong(val) & wxLongLong(0x00ff0000L, 0U)) >> 40) | \
8e38fd1f
RL
909 ((wxLongLong(val) & wxLongLong(0xff000000L, 0U)) >> 56)))
910#endif
41b0a113 911
d716d967 912#ifdef WORDS_BIGENDIAN
7e2c43b8
RR
913 #define wxUINT16_SWAP_ON_BE(val) wxUINT16_SWAP_ALWAYS(val)
914 #define wxINT16_SWAP_ON_BE(val) wxINT16_SWAP_ALWAYS(val)
915 #define wxUINT16_SWAP_ON_LE(val) (val)
916 #define wxINT16_SWAP_ON_LE(val) (val)
917 #define wxUINT32_SWAP_ON_BE(val) wxUINT32_SWAP_ALWAYS(val)
918 #define wxINT32_SWAP_ON_BE(val) wxINT32_SWAP_ALWAYS(val)
919 #define wxUINT32_SWAP_ON_LE(val) (val)
920 #define wxINT32_SWAP_ON_LE(val) (val)
41b0a113
RL
921 #define wxUINT64_SWAP_ON_BE(val) wxUINT64_SWAP_ALWAYS(val)
922 #define wxUINT64_SWAP_ON_LE(val) (val)
d716d967 923#else
7e2c43b8
RR
924 #define wxUINT16_SWAP_ON_LE(val) wxUINT16_SWAP_ALWAYS(val)
925 #define wxINT16_SWAP_ON_LE(val) wxINT16_SWAP_ALWAYS(val)
926 #define wxUINT16_SWAP_ON_BE(val) (val)
927 #define wxINT16_SWAP_ON_BE(val) (val)
928 #define wxUINT32_SWAP_ON_LE(val) wxUINT32_SWAP_ALWAYS(val)
929 #define wxINT32_SWAP_ON_LE(val) wxINT32_SWAP_ALWAYS(val)
930 #define wxUINT32_SWAP_ON_BE(val) (val)
931 #define wxINT32_SWAP_ON_BE(val) (val)
41b0a113
RL
932 #define wxUINT64_SWAP_ON_LE(val) wxUINT64_SWAP_ALWAYS(val)
933 #define wxUINT64_SWAP_ON_BE(val) (val)
d716d967
RR
934#endif
935
083f7497
JS
936// Macros to convert from unsigned long to void pointer.
937// High order truncation occurs if the respective type is not large enough.
938#define WXPTRULONGSLICE (((wxBYTE_ORDER==wxBIG_ENDIAN)&&(sizeof(void*)==8)&&(sizeof(unsigned long)<8))?1:0)
939#define wxPtrToULong(p) (((unsigned long*)(&(p)))[WXPTRULONGSLICE])
940#define wxULongToPtr(p,n) (p=NULL,wxPtrToULong(p)=(unsigned long)(n),p)
941
d597fcb7
RR
942// ----------------------------------------------------------------------------
943// Geometric flags
944// ----------------------------------------------------------------------------
945
946enum wxGeometryCentre
947{
948 wxCENTRE = 0x0001,
949 wxCENTER = wxCENTRE
950};
951
952// centering into frame rather than screen (obsolete)
953#define wxCENTER_FRAME 0x0000
954// centre on screen rather than parent
955#define wxCENTRE_ON_SCREEN 0x0002
956#define wxCENTER_ON_SCREEN wxCENTRE_ON_SCREEN
957
958enum wxOrientation
959{
960 wxHORIZONTAL = 0x0004,
961 wxVERTICAL = 0x0008,
2f78bd2c 962
d597fcb7
RR
963 wxBOTH = (wxVERTICAL | wxHORIZONTAL)
964};
965
966enum wxDirection
967{
968 wxLEFT = 0x0010,
969 wxRIGHT = 0x0020,
970 wxUP = 0x0040,
971 wxDOWN = 0x0080,
2f78bd2c 972
d597fcb7
RR
973 wxTOP = wxUP,
974 wxBOTTOM = wxDOWN,
2f78bd2c 975
d597fcb7
RR
976 wxNORTH = wxUP,
977 wxSOUTH = wxDOWN,
978 wxWEST = wxLEFT,
979 wxEAST = wxRIGHT,
2f78bd2c 980
d597fcb7
RR
981 wxALL = (wxUP | wxDOWN | wxRIGHT | wxLEFT)
982};
983
984enum wxAlignment
985{
986 wxALIGN_NOT = 0x0000,
be2577e4
RD
987 wxALIGN_CENTER_HORIZONTAL = 0x0100,
988 wxALIGN_CENTRE_HORIZONTAL = wxALIGN_CENTER_HORIZONTAL,
d597fcb7
RR
989 wxALIGN_LEFT = wxALIGN_NOT,
990 wxALIGN_TOP = wxALIGN_NOT,
991 wxALIGN_RIGHT = 0x0200,
be2577e4
RD
992 wxALIGN_BOTTOM = 0x0400,
993 wxALIGN_CENTER_VERTICAL = 0x0800,
994 wxALIGN_CENTRE_VERTICAL = wxALIGN_CENTER_VERTICAL,
995
996 wxALIGN_CENTER = (wxALIGN_CENTER_HORIZONTAL | wxALIGN_CENTER_VERTICAL),
1e6feb95
VZ
997 wxALIGN_CENTRE = wxALIGN_CENTER,
998
999 // a mask to extract alignment from the combination of flags
1000 wxALIGN_MASK = 0x0f00
d597fcb7
RR
1001};
1002
1003enum wxStretch
1004{
1005 wxSTRETCH_NOT = 0x0000,
1006 wxSHRINK = 0x1000,
1007 wxGROW = 0x2000,
be2577e4 1008 wxEXPAND = wxGROW,
15ba5c27 1009 wxSHAPED = 0x4000,
1e6feb95
VZ
1010 wxADJUST_MINSIZE = 0x8000,
1011 wxTILE = 0xc000
1012};
1013
1014// border flags: the values are chosen for backwards compatibility
1015enum wxBorder
1016{
1017 // this is different from wxBORDER_NONE as by default the controls do have
1018 // border
1019 wxBORDER_DEFAULT = 0,
1020
1021 wxBORDER_NONE = 0x00200000,
1022 wxBORDER_STATIC = 0x01000000,
1023 wxBORDER_SIMPLE = 0x02000000,
1024 wxBORDER_RAISED = 0x04000000,
1025 wxBORDER_SUNKEN = 0x08000000,
1026 wxBORDER_DOUBLE = 0x10000000,
1027
1028 // a mask to extract border style from the combination of flags
1029 wxBORDER_MASK = 0x1f200000
d597fcb7
RR
1030};
1031
d716d967
RR
1032// ----------------------------------------------------------------------------
1033// Window style flags
1034// ----------------------------------------------------------------------------
1035
c801d85f 1036/*
c801d85f
KB
1037 * Values are chosen so they can be |'ed in a bit list.
1038 * Some styles are used across more than one group,
1039 * so the values mustn't clash with others in the group.
1040 * Otherwise, numbers can be reused across groups.
1041 *
1042 * From version 1.66:
1043 * Window (cross-group) styles now take up the first half
1044 * of the flag, and control-specific styles the
1045 * second half.
d4b67f95 1046 *
c801d85f
KB
1047 */
1048
1049/*
1050 * Window (Frame/dialog/subwindow/panel item) style flags
1051 */
329e86bf
RR
1052#define wxVSCROLL 0x80000000
1053#define wxHSCROLL 0x40000000
1054#define wxCAPTION 0x20000000
c801d85f 1055
1e6feb95
VZ
1056// New styles (border styles are now in their own enum)
1057#define wxDOUBLE_BORDER wxBORDER_DOUBLE
1058#define wxSUNKEN_BORDER wxBORDER_SUNKEN
1059#define wxRAISED_BORDER wxBORDER_RAISED
1060#define wxBORDER wxBORDER_SIMPLE
1061#define wxSIMPLE_BORDER wxBORDER_SIMPLE
1062#define wxSTATIC_BORDER wxBORDER_STATIC
1063#define wxNO_BORDER wxBORDER_NONE
329e86bf 1064
1e6feb95
VZ
1065// wxALWAYS_SHOW_SB: instead of hiding the scrollbar when it is not needed,
1066// disable it - but still show (see also wxLB_ALWAYS_SB style)
1067//
44383ef7 1068// NB: as this style is only supported by wxUniversal and wxMSW so far
1e6feb95
VZ
1069#define wxALWAYS_SHOW_SB 0x00800000
1070
d80cd92a
VZ
1071// Clip children when painting, which reduces flicker in e.g. frames and
1072// splitter windows, but can't be used in a panel where a static box must be
1073// 'transparent' (panel paints the background for it)
329e86bf 1074#define wxCLIP_CHILDREN 0x00400000
1e6feb95 1075
d11bb14f
JS
1076// Note we're reusing the wxCAPTION style because we won't need captions
1077// for subwindows/controls
1078#define wxCLIP_SIBLINGS 0x20000000
c801d85f 1079
1e6feb95
VZ
1080#define wxTRANSPARENT_WINDOW 0x00100000
1081
d80cd92a
VZ
1082// Add this style to a panel to get tab traversal working outside of dialogs
1083// (on by default for wxPanel, wxDialog, wxScrolledWindow)
329e86bf 1084#define wxTAB_TRAVERSAL 0x00080000
c801d85f 1085
9bf84618
VZ
1086// Add this style if the control wants to get all keyboard messages (under
1087// Windows, it won't normally get the dialog navigation key events)
329e86bf 1088#define wxWANTS_CHARS 0x00040000
9bf84618 1089
1e6feb95 1090// Make window retained (mostly Motif, I think) -- obsolete (VZ)?
d9ea011f 1091#define wxRETAINED 0x00020000
329e86bf 1092#define wxBACKINGSTORE wxRETAINED
c801d85f 1093
1e6feb95
VZ
1094// set this flag to create a special popup window: it will be always shown on
1095// top of other windows, will capture the mouse and will be dismissed when the
1096// mouse is clicked outside of it or if it loses focus in any other way
1097#define wxPOPUP_WINDOW 0x00020000
1098
d9ea011f
VZ
1099// don't invalidate the whole window (resulting in a PAINT event) when the
1100// window is resized (currently, makes sense for wxMSW only)
193fe989 1101#define wxNO_FULL_REPAINT_ON_RESIZE 0x00010000
d80cd92a
VZ
1102
1103/*
1104 * Extra window style flags (use wxWS_EX prefix to make it clear that they
1105 * should be passed to wxWindow::SetExtraStyle(), not SetWindowStyle())
1106 */
1107
1108// by default, TransferDataTo/FromWindow() only work on direct children of the
1109// window (compatible behaviour), set this flag to make them recursively
1110// descend into all subwindows
1111#define wxWS_EX_VALIDATE_RECURSIVELY 0x00000001
1112
e4b713a2
VZ
1113// wxCommandEvents and the objects of the derived classes are forwarded to the
1114// parent window and so on recursively by default. Using this flag for the
1115// given window allows to block this propagation at this window, i.e. prevent
1116// the events from being propagated further upwards. The dialogs have this
1117// flag on by default.
1118#define wxWS_EX_BLOCK_EVENTS 0x00000002
1119
39cc7a0b
VZ
1120// don't use this window as an implicit parent for the other windows: this must
1121// be used with transient windows as otherwise there is the risk of creating a
1122// dialog/frame with this window as a parent which would lead to a crash if the
1123// parent is destroyed before the child
1124#define wxWS_EX_TRANSIENT 0x00000004
1125
85b43fbf
JS
1126// don't paint the window background, we'll assume it will
1127// be done by a theming engine. This is not yet used but could
1128// possibly be made to work in the future, at least on Windows
1129#define wxWS_EX_THEMED_BACKGROUND 0x00000008
1130
e39af974
JS
1131// this window should always process idle events
1132#define wxWS_EX_PROCESS_IDLE 0x00000010
1133
1134// this window should always process UI update events
1135#define wxWS_EX_PROCESS_UI_UPDATES 0x00000020
1136
3a3ef0bf
VZ
1137// Use this style to add a context-sensitive help to the window (currently for
1138// Win32 only and it doesn't work if wxMINIMIZE_BOX or wxMAXIMIZE_BOX are used)
1139#define wxFRAME_EX_CONTEXTHELP 0x00000004
1140#define wxDIALOG_EX_CONTEXTHELP 0x00000004
1141
c801d85f 1142/*
329e86bf 1143 * wxFrame/wxDialog style flags
c801d85f 1144 */
3f4a0c5b
VZ
1145#define wxSTAY_ON_TOP 0x8000
1146#define wxICONIZE 0x4000
1147#define wxMINIMIZE wxICONIZE
1148#define wxMAXIMIZE 0x2000
850c6ed4 1149#define wxCLOSE_BOX 0x1000
f1a19f14 1150
3f480da3 1151#define wxSYSTEM_MENU 0x0800
3f4a0c5b
VZ
1152#define wxMINIMIZE_BOX 0x0400
1153#define wxMAXIMIZE_BOX 0x0200
1154#define wxTINY_CAPTION_HORIZ 0x0100
1155#define wxTINY_CAPTION_VERT 0x0080
3f4a0c5b 1156#define wxRESIZE_BORDER 0x0040
f6bcfd97 1157
b3daa5a3
VZ
1158#define wxDIALOG_NO_PARENT 0x0001 // Don't make owned by apps top window
1159#define wxFRAME_NO_TASKBAR 0x0002 // No taskbar button (MSW only)
1160#define wxFRAME_TOOL_WINDOW 0x0004 // No taskbar button, no system menu
9dfef5ac 1161#define wxFRAME_FLOAT_ON_PARENT 0x0008 // Always above its parent
6a7e6411 1162#define wxFRAME_SHAPED 0x0010 // Create a window that is able to be shaped
b3daa5a3 1163
f6bcfd97
BP
1164// deprecated versions defined for compatibility reasons
1165#define wxRESIZE_BOX wxMAXIMIZE_BOX
1166#define wxTHICK_FRAME wxRESIZE_BORDER
1167
b3daa5a3 1168// obsolete styles, unused any more
a12ffe1a 1169#define wxDIALOG_MODAL 0x0020 // free flag value 0x0020
44383ef7
VZ
1170#define wxDIALOG_MODELESS 0
1171#define wxNO_3D 0
1172#define wxUSER_COLOURS 0
1173
f6bcfd97 1174
df61c009
JS
1175/*
1176 * MDI parent frame style flags
1177 * Can overlap with some of the above.
1178 */
1179
1180#define wxFRAME_NO_WINDOW_MENU 0x0100
c801d85f 1181
329e86bf 1182#define wxDEFAULT_FRAME_STYLE \
f6bcfd97 1183 (wxSYSTEM_MENU | wxRESIZE_BORDER | \
850c6ed4 1184 wxMINIMIZE_BOX | wxMAXIMIZE_BOX | wxCLOSE_BOX | \
f6bcfd97 1185 wxCAPTION | wxCLIP_CHILDREN)
aa64626e 1186
850c6ed4 1187#define wxDEFAULT_DIALOG_STYLE (wxSYSTEM_MENU | wxCAPTION | wxCLOSE_BOX)
aa64626e 1188
c801d85f 1189/*
329e86bf 1190 * wxExtDialog style flags
c801d85f 1191 */
329e86bf
RR
1192#define wxED_CLIENT_MARGIN 0x0004
1193#define wxED_BUTTONS_BOTTOM 0x0000 // has no effect
1194#define wxED_BUTTONS_RIGHT 0x0002
1195#define wxED_STATIC_LINE 0x0001
1196
1197#if defined(__WXMSW__) || defined(__WXMAC__)
1198# define wxEXT_DIALOG_STYLE (wxDEFAULT_DIALOG_STYLE|wxED_CLIENT_MARGIN)
1199#else
1200# define wxEXT_DIALOG_STYLE (wxDEFAULT_DIALOG_STYLE|wxED_CLIENT_MARGIN|wxED_STATIC_LINE)
1201#endif
c801d85f 1202
c801d85f 1203/*
3502e687 1204 * wxMenuBar style flags
c801d85f 1205 */
3502e687
RR
1206// use native docking
1207#define wxMB_DOCKABLE 0x0001
1208
ae53c98c
KB
1209/*
1210 * wxMenu style flags
1211 */
1212#define wxMENU_TEAROFF 0x0001
d4b67f95 1213
3502e687
RR
1214/*
1215 * Apply to all panel items
1216 */
c801d85f 1217#define wxCOLOURED 0x0800
c801d85f 1218#define wxFIXED_LENGTH 0x0400
c801d85f
KB
1219
1220/*
1221 * Styles for wxListBox
1222 */
c801d85f 1223#define wxLB_SORT 0x0010
9c331ded 1224#define wxLB_SINGLE 0x0020
c801d85f
KB
1225#define wxLB_MULTIPLE 0x0040
1226#define wxLB_EXTENDED 0x0080
1227// wxLB_OWNERDRAW is Windows-only
1228#define wxLB_OWNERDRAW 0x0100
9c331ded
JS
1229#define wxLB_NEEDED_SB 0x0200
1230#define wxLB_ALWAYS_SB 0x0400
c801d85f 1231#define wxLB_HSCROLL wxHSCROLL
1e6feb95
VZ
1232// always show an entire number of rows
1233#define wxLB_INT_HEIGHT 0x0800
1e6feb95 1234
1e6feb95 1235// deprecated synonyms
a8141d3f
VZ
1236#define wxPROCESS_ENTER 0x0400 // wxTE_PROCESS_ENTER
1237#define wxPASSWORD 0x0800 // wxTE_PASSWORD
c801d85f
KB
1238
1239/*
1240 * wxComboBox style flags
1241 */
1242#define wxCB_SIMPLE 0x0004
c801d85f 1243#define wxCB_SORT 0x0008
9c331ded
JS
1244#define wxCB_READONLY 0x0010
1245#define wxCB_DROPDOWN 0x0020
c801d85f
KB
1246
1247/*
0544bc0a 1248 * wxRadioBox style flags
c801d85f 1249 */
1e6feb95
VZ
1250// should we number the items from left to right or from top to bottom in a 2d
1251// radiobox?
1252#define wxRA_LEFTTORIGHT 0x0001
1253#define wxRA_TOPTOBOTTOM 0x0002
1254
fa18b757 1255// New, more intuitive names to specify majorDim argument
0544bc0a
RR
1256#define wxRA_SPECIFY_COLS wxHORIZONTAL
1257#define wxRA_SPECIFY_ROWS wxVERTICAL
1e6feb95 1258
fa18b757 1259// Old names for compatibility
c801d85f
KB
1260#define wxRA_HORIZONTAL wxHORIZONTAL
1261#define wxRA_VERTICAL wxVERTICAL
0544bc0a
RR
1262
1263/*
1264 * wxRadioButton style flag
1265 */
c801d85f 1266#define wxRB_GROUP 0x0004
2b5f62a0 1267#define wxRB_SINGLE 0x0008
c801d85f
KB
1268
1269/*
1270 * wxGauge flags
1271 */
c801d85f
KB
1272#define wxGA_HORIZONTAL wxHORIZONTAL
1273#define wxGA_VERTICAL wxVERTICAL
e115e771 1274#define wxGA_PROGRESSBAR 0x0010
329e86bf 1275// Windows only
e115e771 1276#define wxGA_SMOOTH 0x0020
c801d85f
KB
1277
1278/*
1279 * wxSlider flags
1280 */
2f78bd2c
RD
1281#define wxSL_HORIZONTAL wxHORIZONTAL // 4
1282#define wxSL_VERTICAL wxVERTICAL // 8
c801d85f
KB
1283// The next one is obsolete - use scroll events instead
1284#define wxSL_NOTIFY_DRAG 0x0000
1e6feb95
VZ
1285#define wxSL_TICKS 0x0010
1286#define wxSL_AUTOTICKS wxSL_TICKS // we don't support manual ticks
c801d85f
KB
1287#define wxSL_LABELS 0x0020
1288#define wxSL_LEFT 0x0040
1289#define wxSL_TOP 0x0080
1290#define wxSL_RIGHT 0x0100
1291#define wxSL_BOTTOM 0x0200
1292#define wxSL_BOTH 0x0400
1293#define wxSL_SELRANGE 0x0800
1294
1295/*
1296 * wxScrollBar flags
1297 */
c801d85f
KB
1298#define wxSB_HORIZONTAL wxHORIZONTAL
1299#define wxSB_VERTICAL wxVERTICAL
1300
c801d85f 1301/*
dc1efb1d
JS
1302 * wxSpinButton flags.
1303 * Note that a wxSpinCtrl is sometimes defined as
1304 * a wxTextCtrl, and so the flags must be different
1305 * from wxTextCtrl's.
c801d85f 1306 */
a3e7d24d
RR
1307#define wxSP_HORIZONTAL wxHORIZONTAL // 4
1308#define wxSP_VERTICAL wxVERTICAL // 8
dc1efb1d
JS
1309#define wxSP_ARROW_KEYS 0x1000
1310#define wxSP_WRAP 0x2000
c801d85f 1311
58a8ab88
JS
1312/*
1313 * wxNotebook flags
1314 */
a3e7d24d 1315#define wxNB_FIXEDWIDTH 0x0010
1e6feb95 1316#define wxNB_TOP 0x0000 // default
4a0253b8
RS
1317#define wxNB_LEFT 0x0020
1318#define wxNB_RIGHT 0x0040
1319#define wxNB_BOTTOM 0x0080
1e6feb95 1320#define wxNB_MULTILINE 0x0100
58a8ab88 1321
b54e41c5
VZ
1322/*
1323 * wxTabCtrl flags
1324 */
1325#define wxTC_RIGHTJUSTIFY 0x0010
1326#define wxTC_FIXEDWIDTH 0x0020
2b5f62a0
VZ
1327#define wxTC_TOP 0x0000 // default
1328#define wxTC_LEFT 0x0020
1329#define wxTC_RIGHT 0x0040
1330#define wxTC_BOTTOM 0x0080
b54e41c5 1331#define wxTC_MULTILINE wxNB_MULTILINE
2b5f62a0 1332#define wxTC_OWNERDRAW 0x0200
b54e41c5 1333
c801d85f
KB
1334/*
1335 * wxStatusBar95 flags
1336 */
a3e7d24d 1337#define wxST_SIZEGRIP 0x0010
c801d85f 1338
185fa6bf
VZ
1339/*
1340 * wxStaticText flags
1341 */
1342#define wxST_NO_AUTORESIZE 0x0001
1343
1e6feb95
VZ
1344/*
1345 * wxStaticBitmap flags
1346 */
1347#define wxBI_EXPAND wxEXPAND
1348
b0351fc9
RR
1349/*
1350 * wxStaticLine flags
1351 */
329e86bf
RR
1352#define wxLI_HORIZONTAL wxHORIZONTAL
1353#define wxLI_VERTICAL wxVERTICAL
b0351fc9 1354
9726da4f
VZ
1355/*
1356 * wxProgressDialog flags
1357 */
329e86bf
RR
1358#define wxPD_CAN_ABORT 0x0001
1359#define wxPD_APP_MODAL 0x0002
1360#define wxPD_AUTO_HIDE 0x0004
1361#define wxPD_ELAPSED_TIME 0x0008
1362#define wxPD_ESTIMATED_TIME 0x0010
d0cf4846 1363// wxGA_SMOOTH = 0x0020 may also be used with wxProgressDialog
7b28757f
JS
1364// NO!!! This is wxDIALOG_MODAL and will cause the progress dialog to
1365// be modal. No progress will then be made at all.
d0cf4846 1366#define wxPD_REMAINING_TIME 0x0040
b0351fc9 1367
dabd1377
JS
1368/*
1369 * wxDirDialog styles
1370 */
1371
1372#define wxDD_NEW_DIR_BUTTON 0x0080
1373
c801d85f 1374/*
bac507e0 1375 * extended dialog specifiers. these values are stored in a different
329e86bf
RR
1376 * flag and thus do not overlap with other style flags. note that these
1377 * values do not correspond to the return values of the dialogs (for
bac507e0 1378 * those values, look at the wxID_XXX defines).
c801d85f 1379 */
d597fcb7
RR
1380
1381// wxCENTRE already defined as 0x00000001
a8141d3f 1382#define wxYES 0x00000002
d597fcb7 1383#define wxOK 0x00000004
a8141d3f
VZ
1384#define wxNO 0x00000008
1385#define wxYES_NO (wxYES | wxNO)
d597fcb7 1386#define wxCANCEL 0x00000010
a8141d3f
VZ
1387
1388#define wxYES_DEFAULT 0x00000000 // has no effect (default)
d597fcb7 1389#define wxNO_DEFAULT 0x00000080
329e86bf 1390
d597fcb7
RR
1391#define wxICON_EXCLAMATION 0x00000100
1392#define wxICON_HAND 0x00000200
ebea0891
KB
1393#define wxICON_WARNING wxICON_EXCLAMATION
1394#define wxICON_ERROR wxICON_HAND
d597fcb7
RR
1395#define wxICON_QUESTION 0x00000400
1396#define wxICON_INFORMATION 0x00000800
329e86bf
RR
1397#define wxICON_STOP wxICON_HAND
1398#define wxICON_ASTERISK wxICON_INFORMATION
d597fcb7 1399#define wxICON_MASK (0x00000100|0x00000200|0x00000400|0x00000800)
329e86bf 1400
d597fcb7
RR
1401#define wxFORWARD 0x00001000
1402#define wxBACKWARD 0x00002000
1403#define wxRESET 0x00004000
1404#define wxHELP 0x00008000
1405#define wxMORE 0x00010000
1406#define wxSETUP 0x00020000
329e86bf
RR
1407
1408// ----------------------------------------------------------------------------
1409// standard IDs
1410// ----------------------------------------------------------------------------
1411
497dbbd3
VZ
1412// any id: means that we don't care about the id, whether when installing an
1413// event handler or when creating a new window
1414enum
1415{
1416 wxID_ANY = -1
1417};
1418
20d9661c 1419// id for a separator line in the menu (invalid for normal item)
497dbbd3
VZ
1420enum
1421{
1422 wxID_SEPARATOR = -1
1423};
20d9661c 1424
329e86bf 1425// Standard menu IDs
497dbbd3
VZ
1426enum
1427{
1428 wxID_LOWEST = 4999,
1429
1430 wxID_OPEN,
1431 wxID_CLOSE,
1432 wxID_NEW,
1433 wxID_SAVE,
1434 wxID_SAVEAS,
1435 wxID_REVERT,
1436 wxID_EXIT,
1437 wxID_UNDO,
1438 wxID_REDO,
1439 wxID_HELP,
1440 wxID_PRINT,
1441 wxID_PRINT_SETUP,
1442 wxID_PREVIEW,
1443 wxID_ABOUT,
1444 wxID_HELP_CONTENTS,
1445 wxID_HELP_COMMANDS,
1446 wxID_HELP_PROCEDURES,
1447 wxID_HELP_CONTEXT,
1448 wxID_CLOSE_ALL,
1449
1450 wxID_CUT = 5030,
1451 wxID_COPY,
1452 wxID_PASTE,
1453 wxID_CLEAR,
1454 wxID_FIND,
1455 wxID_DUPLICATE,
1456 wxID_SELECTALL,
bf95a04f
JS
1457 wxID_DELETE,
1458 wxID_REPLACE,
1459 wxID_REPLACE_ALL,
1460 wxID_PROPERTIES,
1461
1462 wxID_VIEW_DETAILS,
1463 wxID_VIEW_LARGEICONS,
1464 wxID_VIEW_SMALLICONS,
1465 wxID_VIEW_LIST,
1466 wxID_VIEW_SORTDATE,
1467 wxID_VIEW_SORTNAME,
1468 wxID_VIEW_SORTSIZE,
1469 wxID_VIEW_SORTTYPE,
497dbbd3
VZ
1470
1471 wxID_FILE1 = 5050,
1472 wxID_FILE2,
1473 wxID_FILE3,
1474 wxID_FILE4,
1475 wxID_FILE5,
1476 wxID_FILE6,
1477 wxID_FILE7,
1478 wxID_FILE8,
1479 wxID_FILE9,
1480
1481 // Standard button IDs
1482 wxID_OK = 5100,
1483 wxID_CANCEL,
1484 wxID_APPLY,
1485 wxID_YES,
1486 wxID_NO,
1487 wxID_STATIC,
1488 wxID_FORWARD,
1489 wxID_BACKWARD,
1490 wxID_DEFAULT,
1491 wxID_MORE,
1492 wxID_SETUP,
1493 wxID_RESET,
1494 wxID_CONTEXT_HELP,
1495 wxID_YESTOALL,
1496 wxID_NOTOALL,
1497 wxID_ABORT,
1498 wxID_RETRY,
1499 wxID_IGNORE,
1500
1501 // System menu IDs (used by wxUniv):
1502 wxID_SYSTEM_MENU = 5200,
1503 wxID_CLOSE_FRAME,
1504 wxID_MOVE_FRAME,
1505 wxID_RESIZE_FRAME,
1506 wxID_MAXIMIZE_FRAME,
1507 wxID_ICONIZE_FRAME,
1508 wxID_RESTORE_FRAME,
1509
1510 // IDs used by generic file dialog (13 consecutive starting from this value)
1511 wxID_FILEDLGG = 5900,
1512
1513 wxID_HIGHEST = 5999
1514};
329e86bf 1515
1e6feb95 1516// ----------------------------------------------------------------------------
497dbbd3 1517// other constants
1e6feb95
VZ
1518// ----------------------------------------------------------------------------
1519
d65c269b
VZ
1520// menu and toolbar item kinds
1521enum wxItemKind
1522{
546bfbea
VS
1523 wxITEM_SEPARATOR = -1,
1524 wxITEM_NORMAL,
1525 wxITEM_CHECK,
1526 wxITEM_RADIO,
1527 wxITEM_MAX
d65c269b
VZ
1528};
1529
1e6feb95
VZ
1530// hit test results
1531enum wxHitTest
1532{
1533 wxHT_NOWHERE,
1534
1535 // scrollbar
1536 wxHT_SCROLLBAR_FIRST = wxHT_NOWHERE,
1537 wxHT_SCROLLBAR_ARROW_LINE_1, // left or upper arrow to scroll by line
1538 wxHT_SCROLLBAR_ARROW_LINE_2, // right or down
1539 wxHT_SCROLLBAR_ARROW_PAGE_1, // left or upper arrow to scroll by page
1540 wxHT_SCROLLBAR_ARROW_PAGE_2, // right or down
1541 wxHT_SCROLLBAR_THUMB, // on the thumb
1542 wxHT_SCROLLBAR_BAR_1, // bar to the left/above the thumb
1543 wxHT_SCROLLBAR_BAR_2, // bar to the right/below the thumb
1544 wxHT_SCROLLBAR_LAST,
1545
1546 // window
1547 wxHT_WINDOW_OUTSIDE, // not in this window at all
1548 wxHT_WINDOW_INSIDE, // in the client area
1549 wxHT_WINDOW_VERT_SCROLLBAR, // on the vertical scrollbar
1550 wxHT_WINDOW_HORZ_SCROLLBAR, // on the horizontal scrollbar
1551 wxHT_WINDOW_CORNER, // on the corner between 2 scrollbars
1552
1553 wxHT_MAX
1554};
1555
329e86bf
RR
1556// ----------------------------------------------------------------------------
1557// Possible SetSize flags
1558// ----------------------------------------------------------------------------
1559
1560// Use internally-calculated width if -1
1561#define wxSIZE_AUTO_WIDTH 0x0001
1562// Use internally-calculated height if -1
1563#define wxSIZE_AUTO_HEIGHT 0x0002
1564// Use internally-calculated width and height if each is -1
1565#define wxSIZE_AUTO (wxSIZE_AUTO_WIDTH|wxSIZE_AUTO_HEIGHT)
1566// Ignore missing (-1) dimensions (use existing).
1567// For readability only: test for wxSIZE_AUTO_WIDTH/HEIGHT in code.
1568#define wxSIZE_USE_EXISTING 0x0000
1569// Allow -1 as a valid position
1570#define wxSIZE_ALLOW_MINUS_ONE 0x0004
1571// Don't do parent client adjustments (for implementation only)
1572#define wxSIZE_NO_ADJUSTMENTS 0x0008
1573
1574// ----------------------------------------------------------------------------
1575// GDI descriptions
1576// ----------------------------------------------------------------------------
c801d85f 1577
497dbbd3
VZ
1578enum
1579{
1580 // Text font families
1581 wxDEFAULT = 70,
1582 wxDECORATIVE,
1583 wxROMAN,
1584 wxSCRIPT,
1585 wxSWISS,
1586 wxMODERN,
1587 wxTELETYPE, /* @@@@ */
1588
1589 // Proportional or Fixed width fonts (not yet used)
1590 wxVARIABLE = 80,
1591 wxFIXED,
1592
1593 wxNORMAL = 90,
1594 wxLIGHT,
1595 wxBOLD,
1596 // Also wxNORMAL for normal (non-italic text)
1597 wxITALIC,
1598 wxSLANT,
1599
1600 // Pen styles
1601 wxSOLID = 100,
1602 wxDOT,
1603 wxLONG_DASH,
1604 wxSHORT_DASH,
1605 wxDOT_DASH,
1606 wxUSER_DASH,
1607
1608 wxTRANSPARENT,
1609
1610 // Brush & Pen Stippling. Note that a stippled pen cannot be dashed!!
1611 // Note also that stippling a Pen IS meaningfull, because a Line is
1612 wxSTIPPLE_MASK_OPAQUE, //mask is used for blitting monochrome using text fore and back ground colors
1613 wxSTIPPLE_MASK, //mask is used for masking areas in the stipple bitmap (TO DO)
1614 // drawn with a Pen, and without any Brush -- and it can be stippled.
1615 wxSTIPPLE = 110,
1616 wxBDIAGONAL_HATCH,
1617 wxCROSSDIAG_HATCH,
1618 wxFDIAGONAL_HATCH,
1619 wxCROSS_HATCH,
1620 wxHORIZONTAL_HATCH,
1621 wxVERTICAL_HATCH,
1622
1623 wxJOIN_BEVEL = 120,
1624 wxJOIN_MITER,
1625 wxJOIN_ROUND,
1626
1627 wxCAP_ROUND = 130,
1628 wxCAP_PROJECTING,
1629 wxCAP_BUTT
c801d85f
KB
1630};
1631
497dbbd3
VZ
1632// VZ: why doesn't it start with "wx"? FIXME
1633#define IS_HATCH(s) ((s)>=wxBDIAGONAL_HATCH && (s)<=wxVERTICAL_HATCH)
c801d85f
KB
1634
1635// Logical ops
3f4a0c5b 1636typedef enum
83624f79 1637{
71fe5c01
RR
1638 wxCLEAR, wxROP_BLACK = wxCLEAR, wxBLIT_BLACKNESS = wxCLEAR, // 0
1639 wxXOR, wxROP_XORPEN = wxXOR, wxBLIT_SRCINVERT = wxXOR, // src XOR dst
1640 wxINVERT, wxROP_NOT = wxINVERT, wxBLIT_DSTINVERT = wxINVERT, // NOT dst
1641 wxOR_REVERSE, wxROP_MERGEPENNOT = wxOR_REVERSE, wxBLIT_00DD0228 = wxOR_REVERSE, // src OR (NOT dst)
1642 wxAND_REVERSE, wxROP_MASKPENNOT = wxAND_REVERSE, wxBLIT_SRCERASE = wxAND_REVERSE, // src AND (NOT dst)
1643 wxCOPY, wxROP_COPYPEN = wxCOPY, wxBLIT_SRCCOPY = wxCOPY, // src
1644 wxAND, wxROP_MASKPEN = wxAND, wxBLIT_SRCAND = wxAND, // src AND dst
1645 wxAND_INVERT, wxROP_MASKNOTPEN = wxAND_INVERT, wxBLIT_00220326 = wxAND_INVERT, // (NOT src) AND dst
1646 wxNO_OP, wxROP_NOP = wxNO_OP, wxBLIT_00AA0029 = wxNO_OP, // dst
1647 wxNOR, wxROP_NOTMERGEPEN = wxNOR, wxBLIT_NOTSRCERASE = wxNOR, // (NOT src) AND (NOT dst)
1648 wxEQUIV, wxROP_NOTXORPEN = wxEQUIV, wxBLIT_00990066 = wxEQUIV, // (NOT src) XOR dst
1649 wxSRC_INVERT, wxROP_NOTCOPYPEN = wxSRC_INVERT, wxBLIT_NOTSCRCOPY = wxSRC_INVERT, // (NOT src)
1650 wxOR_INVERT, wxROP_MERGENOTPEN = wxOR_INVERT, wxBLIT_MERGEPAINT = wxOR_INVERT, // (NOT src) OR dst
1651 wxNAND, wxROP_NOTMASKPEN = wxNAND, wxBLIT_007700E6 = wxNAND, // (NOT src) OR (NOT dst)
1652 wxOR, wxROP_MERGEPEN = wxOR, wxBLIT_SRCPAINT = wxOR, // src OR dst
1653 wxSET, wxROP_WHITE = wxSET, wxBLIT_WHITENESS = wxSET // 1
c801d85f
KB
1654} form_ops_t;
1655
497dbbd3
VZ
1656// Flood styles
1657enum
1658{
1659 wxFLOOD_SURFACE = 1,
1660 wxFLOOD_BORDER
1661};
c801d85f 1662
497dbbd3
VZ
1663// Polygon filling mode
1664enum
1665{
1666 wxODDEVEN_RULE = 1,
1667 wxWINDING_RULE
1668};
c801d85f 1669
497dbbd3
VZ
1670// ToolPanel in wxFrame (VZ: unused?)
1671enum
1672{
1673 wxTOOL_TOP = 1,
1674 wxTOOL_BOTTOM,
1675 wxTOOL_LEFT,
1676 wxTOOL_RIGHT
1677};
c801d85f 1678
9e2896e5
VZ
1679// the values of the format constants should be the same as correspondign
1680// CF_XXX constants in Windows API
3f480da3 1681enum wxDataFormatId
e3e65dac 1682{
9e2896e5
VZ
1683 wxDF_INVALID = 0,
1684 wxDF_TEXT = 1, /* CF_TEXT */
1685 wxDF_BITMAP = 2, /* CF_BITMAP */
1686 wxDF_METAFILE = 3, /* CF_METAFILEPICT */
1687 wxDF_SYLK = 4,
1688 wxDF_DIF = 5,
1689 wxDF_TIFF = 6,
1690 wxDF_OEMTEXT = 7, /* CF_OEMTEXT */
1691 wxDF_DIB = 8, /* CF_DIB */
1692 wxDF_PALETTE = 9,
1693 wxDF_PENDATA = 10,
1694 wxDF_RIFF = 11,
1695 wxDF_WAVE = 12,
1696 wxDF_UNICODETEXT = 13,
1697 wxDF_ENHMETAFILE = 14,
1698 wxDF_FILENAME = 15, /* CF_HDROP */
1699 wxDF_LOCALE = 16,
1700 wxDF_PRIVATE = 20,
387ebd3e 1701 wxDF_HTML = 30, /* Note: does not correspond to CF_ constant */
9e2896e5 1702 wxDF_MAX
e3e65dac 1703};
c801d85f 1704
497dbbd3 1705// Virtual keycodes
3f4a0c5b 1706enum wxKeyCode
83624f79 1707{
497dbbd3
VZ
1708 WXK_BACK = 8,
1709 WXK_TAB = 9,
1710 WXK_RETURN = 13,
1711 WXK_ESCAPE = 27,
1712 WXK_SPACE = 32,
1713 WXK_DELETE = 127,
1714
1715 WXK_START = 300,
1716 WXK_LBUTTON,
1717 WXK_RBUTTON,
1718 WXK_CANCEL,
1719 WXK_MBUTTON,
1720 WXK_CLEAR,
1721 WXK_SHIFT,
1722 WXK_ALT,
1723 WXK_CONTROL,
1724 WXK_MENU,
1725 WXK_PAUSE,
1726 WXK_CAPITAL,
1727 WXK_PRIOR, // Page up
1728 WXK_NEXT, // Page down
1729 WXK_END,
1730 WXK_HOME,
1731 WXK_LEFT,
1732 WXK_UP,
1733 WXK_RIGHT,
1734 WXK_DOWN,
1735 WXK_SELECT,
1736 WXK_PRINT,
1737 WXK_EXECUTE,
1738 WXK_SNAPSHOT,
1739 WXK_INSERT,
1740 WXK_HELP,
1741 WXK_NUMPAD0,
1742 WXK_NUMPAD1,
1743 WXK_NUMPAD2,
1744 WXK_NUMPAD3,
1745 WXK_NUMPAD4,
1746 WXK_NUMPAD5,
1747 WXK_NUMPAD6,
1748 WXK_NUMPAD7,
1749 WXK_NUMPAD8,
1750 WXK_NUMPAD9,
1751 WXK_MULTIPLY,
1752 WXK_ADD,
1753 WXK_SEPARATOR,
1754 WXK_SUBTRACT,
1755 WXK_DECIMAL,
1756 WXK_DIVIDE,
1757 WXK_F1,
1758 WXK_F2,
1759 WXK_F3,
1760 WXK_F4,
1761 WXK_F5,
1762 WXK_F6,
1763 WXK_F7,
1764 WXK_F8,
1765 WXK_F9,
1766 WXK_F10,
1767 WXK_F11,
1768 WXK_F12,
1769 WXK_F13,
1770 WXK_F14,
1771 WXK_F15,
1772 WXK_F16,
1773 WXK_F17,
1774 WXK_F18,
1775 WXK_F19,
1776 WXK_F20,
1777 WXK_F21,
1778 WXK_F22,
1779 WXK_F23,
1780 WXK_F24,
1781 WXK_NUMLOCK,
1782 WXK_SCROLL,
1783 WXK_PAGEUP,
1784 WXK_PAGEDOWN,
1785
1786 WXK_NUMPAD_SPACE,
1787 WXK_NUMPAD_TAB,
1788 WXK_NUMPAD_ENTER,
1789 WXK_NUMPAD_F1,
1790 WXK_NUMPAD_F2,
1791 WXK_NUMPAD_F3,
1792 WXK_NUMPAD_F4,
1793 WXK_NUMPAD_HOME,
1794 WXK_NUMPAD_LEFT,
1795 WXK_NUMPAD_UP,
1796 WXK_NUMPAD_RIGHT,
1797 WXK_NUMPAD_DOWN,
1798 WXK_NUMPAD_PRIOR,
1799 WXK_NUMPAD_PAGEUP,
1800 WXK_NUMPAD_NEXT,
1801 WXK_NUMPAD_PAGEDOWN,
1802 WXK_NUMPAD_END,
1803 WXK_NUMPAD_BEGIN,
1804 WXK_NUMPAD_INSERT,
1805 WXK_NUMPAD_DELETE,
1806 WXK_NUMPAD_EQUAL,
1807 WXK_NUMPAD_MULTIPLY,
1808 WXK_NUMPAD_ADD,
1809 WXK_NUMPAD_SEPARATOR,
1810 WXK_NUMPAD_SUBTRACT,
1811 WXK_NUMPAD_DECIMAL,
702c4208
VZ
1812 WXK_NUMPAD_DIVIDE,
1813
1814 WXK_WINDOWS_LEFT,
1815 WXK_WINDOWS_RIGHT,
43cfe46c
SC
1816 WXK_WINDOWS_MENU ,
1817 WXK_COMMAND
c801d85f
KB
1818};
1819
5048c832
JS
1820#if wxUSE_HOTKEY
1821enum wxHotkeyModifier
1822{
1823 wxMOD_NONE = 0,
1824 wxMOD_ALT = 1,
1825 wxMOD_CONTROL = 2,
1826 wxMOD_SHIFT = 4,
1827 wxMOD_WIN = 8
1828};
1829#endif
1830
497dbbd3
VZ
1831// Mapping modes (same values as used by Windows, don't change)
1832enum
1833{
1834 wxMM_TEXT = 1,
1835 wxMM_LOMETRIC,
1836 wxMM_HIMETRIC,
1837 wxMM_LOENGLISH,
1838 wxMM_HIENGLISH,
1839 wxMM_TWIPS,
1840 wxMM_ISOTROPIC,
1841 wxMM_ANISOTROPIC,
1842 wxMM_POINTS,
e4221628 1843 wxMM_METRIC
497dbbd3 1844};
e3065973 1845
83624f79 1846/* Shortcut for easier dialog-unit-to-pixel conversion */
387a3b02 1847#define wxDLG_UNIT(parent, pt) parent->ConvertDialogToPixels(pt)
fd71308f 1848
7bcb11d3 1849/* Paper types */
497dbbd3
VZ
1850typedef enum
1851{
7bcb11d3
JS
1852 wxPAPER_NONE, // Use specific dimensions
1853 wxPAPER_LETTER, // Letter, 8 1/2 by 11 inches
1854 wxPAPER_LEGAL, // Legal, 8 1/2 by 14 inches
1855 wxPAPER_A4, // A4 Sheet, 210 by 297 millimeters
1856 wxPAPER_CSHEET, // C Sheet, 17 by 22 inches
1857 wxPAPER_DSHEET, // D Sheet, 22 by 34 inches
1858 wxPAPER_ESHEET, // E Sheet, 34 by 44 inches
1859 wxPAPER_LETTERSMALL, // Letter Small, 8 1/2 by 11 inches
1860 wxPAPER_TABLOID, // Tabloid, 11 by 17 inches
1861 wxPAPER_LEDGER, // Ledger, 17 by 11 inches
1862 wxPAPER_STATEMENT, // Statement, 5 1/2 by 8 1/2 inches
1863 wxPAPER_EXECUTIVE, // Executive, 7 1/4 by 10 1/2 inches
1864 wxPAPER_A3, // A3 sheet, 297 by 420 millimeters
1865 wxPAPER_A4SMALL, // A4 small sheet, 210 by 297 millimeters
1866 wxPAPER_A5, // A5 sheet, 148 by 210 millimeters
1867 wxPAPER_B4, // B4 sheet, 250 by 354 millimeters
1868 wxPAPER_B5, // B5 sheet, 182-by-257-millimeter paper
1869 wxPAPER_FOLIO, // Folio, 8-1/2-by-13-inch paper
1870 wxPAPER_QUARTO, // Quarto, 215-by-275-millimeter paper
1871 wxPAPER_10X14, // 10-by-14-inch sheet
1872 wxPAPER_11X17, // 11-by-17-inch sheet
1873 wxPAPER_NOTE, // Note, 8 1/2 by 11 inches
1874 wxPAPER_ENV_9, // #9 Envelope, 3 7/8 by 8 7/8 inches
1875 wxPAPER_ENV_10, // #10 Envelope, 4 1/8 by 9 1/2 inches
1876 wxPAPER_ENV_11, // #11 Envelope, 4 1/2 by 10 3/8 inches
1877 wxPAPER_ENV_12, // #12 Envelope, 4 3/4 by 11 inches
1878 wxPAPER_ENV_14, // #14 Envelope, 5 by 11 1/2 inches
1879 wxPAPER_ENV_DL, // DL Envelope, 110 by 220 millimeters
1880 wxPAPER_ENV_C5, // C5 Envelope, 162 by 229 millimeters
1881 wxPAPER_ENV_C3, // C3 Envelope, 324 by 458 millimeters
1882 wxPAPER_ENV_C4, // C4 Envelope, 229 by 324 millimeters
1883 wxPAPER_ENV_C6, // C6 Envelope, 114 by 162 millimeters
1884 wxPAPER_ENV_C65, // C65 Envelope, 114 by 229 millimeters
1885 wxPAPER_ENV_B4, // B4 Envelope, 250 by 353 millimeters
1886 wxPAPER_ENV_B5, // B5 Envelope, 176 by 250 millimeters
1887 wxPAPER_ENV_B6, // B6 Envelope, 176 by 125 millimeters
1888 wxPAPER_ENV_ITALY, // Italy Envelope, 110 by 230 millimeters
1889 wxPAPER_ENV_MONARCH, // Monarch Envelope, 3 7/8 by 7 1/2 inches
1890 wxPAPER_ENV_PERSONAL, // 6 3/4 Envelope, 3 5/8 by 6 1/2 inches
1891 wxPAPER_FANFOLD_US, // US Std Fanfold, 14 7/8 by 11 inches
1892 wxPAPER_FANFOLD_STD_GERMAN, // German Std Fanfold, 8 1/2 by 12 inches
1893 wxPAPER_FANFOLD_LGL_GERMAN, // German Legal Fanfold, 8 1/2 by 13 inches
1894
1895 wxPAPER_ISO_B4, // B4 (ISO) 250 x 353 mm
1896 wxPAPER_JAPANESE_POSTCARD, // Japanese Postcard 100 x 148 mm
1897 wxPAPER_9X11, // 9 x 11 in
1898 wxPAPER_10X11, // 10 x 11 in
1899 wxPAPER_15X11, // 15 x 11 in
1900 wxPAPER_ENV_INVITE, // Envelope Invite 220 x 220 mm
1901 wxPAPER_LETTER_EXTRA, // Letter Extra 9 \275 x 12 in
1902 wxPAPER_LEGAL_EXTRA, // Legal Extra 9 \275 x 15 in
1903 wxPAPER_TABLOID_EXTRA, // Tabloid Extra 11.69 x 18 in
1904 wxPAPER_A4_EXTRA, // A4 Extra 9.27 x 12.69 in
1905 wxPAPER_LETTER_TRANSVERSE, // Letter Transverse 8 \275 x 11 in
1906 wxPAPER_A4_TRANSVERSE, // A4 Transverse 210 x 297 mm
1907 wxPAPER_LETTER_EXTRA_TRANSVERSE, // Letter Extra Transverse 9\275 x 12 in
1908 wxPAPER_A_PLUS, // SuperA/SuperA/A4 227 x 356 mm
1909 wxPAPER_B_PLUS, // SuperB/SuperB/A3 305 x 487 mm
1910 wxPAPER_LETTER_PLUS, // Letter Plus 8.5 x 12.69 in
1911 wxPAPER_A4_PLUS, // A4 Plus 210 x 330 mm
1912 wxPAPER_A5_TRANSVERSE, // A5 Transverse 148 x 210 mm
1913 wxPAPER_B5_TRANSVERSE, // B5 (JIS) Transverse 182 x 257 mm
1914 wxPAPER_A3_EXTRA, // A3 Extra 322 x 445 mm
1915 wxPAPER_A5_EXTRA, // A5 Extra 174 x 235 mm
1916 wxPAPER_B5_EXTRA, // B5 (ISO) Extra 201 x 276 mm
1917 wxPAPER_A2, // A2 420 x 594 mm
1918 wxPAPER_A3_TRANSVERSE, // A3 Transverse 297 x 420 mm
1919 wxPAPER_A3_EXTRA_TRANSVERSE // A3 Extra Transverse 322 x 445 mm
1920
497dbbd3 1921} wxPaperSize;
7bcb11d3
JS
1922
1923/* Printing orientation */
1924#ifndef wxPORTRAIT
1925#define wxPORTRAIT 1
1926#define wxLANDSCAPE 2
1927#endif
1928
1929/* Duplex printing modes
1930 */
1931
497dbbd3
VZ
1932enum wxDuplexMode
1933{
7bcb11d3
JS
1934 wxDUPLEX_SIMPLEX, // Non-duplex
1935 wxDUPLEX_HORIZONTAL,
1936 wxDUPLEX_VERTICAL
497dbbd3 1937};
7bcb11d3
JS
1938
1939/* Print quality.
1940 */
1941
1942#define wxPRINT_QUALITY_HIGH -1
1943#define wxPRINT_QUALITY_MEDIUM -2
1944#define wxPRINT_QUALITY_LOW -3
1945#define wxPRINT_QUALITY_DRAFT -4
1946
1947typedef int wxPrintQuality;
1948
1949/* Print mode (currently PostScript only)
1950 */
1951
497dbbd3
VZ
1952enum wxPrintMode
1953{
7bcb11d3
JS
1954 wxPRINT_MODE_NONE = 0,
1955 wxPRINT_MODE_PREVIEW = 1, // Preview in external application
1956 wxPRINT_MODE_FILE = 2, // Print to file
1957 wxPRINT_MODE_PRINTER = 3 // Send to printer
497dbbd3 1958};
7bcb11d3 1959
e39af974
JS
1960// ----------------------------------------------------------------------------
1961// UpdateWindowUI flags
1962// ----------------------------------------------------------------------------
1963
1964enum wxUpdateUI
1965{
1966 wxUPDATE_UI_NONE = 0x0000,
1967 wxUPDATE_UI_RECURSE = 0x0001,
1968 wxUPDATE_UI_FROMIDLE = 0x0002 // Invoked from On(Internal)Idle
1969};
1970
7826e2dd
VZ
1971// ----------------------------------------------------------------------------
1972// miscellaneous
1973// ----------------------------------------------------------------------------
1974
1975// define this macro if font handling is done using the X font names
db16cab4 1976#if (defined(__WXGTK__) && !defined(__WXGTK20__)) || defined(__X__)
7826e2dd
VZ
1977 #define _WX_X_FONTLIKE
1978#endif
1979
1980// macro to specify "All Files" on different platforms
60e2e6c0 1981#if defined(__WXMSW__) || defined(__WXPM__)
2b5f62a0 1982# define wxALL_FILES_PATTERN wxT("*.*")
01a46793 1983# define wxALL_FILES gettext_noop("All files (*.*)|*.*")
2c41c440 1984#else
2b5f62a0 1985# define wxALL_FILES_PATTERN wxT("*")
01a46793 1986# define wxALL_FILES gettext_noop("All files (*)|*")
2c41c440 1987#endif
7826e2dd 1988
329e86bf
RR
1989// ---------------------------------------------------------------------------
1990// macros that enable wxWindows apps to be compiled in absence of the
1991// sytem headers, although some platform specific types are used in the
1992// platform specific (implementation) parts of the headers
1993// ---------------------------------------------------------------------------
7bcb11d3 1994
519cb848
SC
1995#ifdef __WXMAC__
1996
f2c16a0b
SC
1997typedef unsigned char WXCOLORREF[6];
1998typedef void* WXHBITMAP;
1999typedef void* WXHMETAFILE ;
2000typedef void* WXHICON ;
2001typedef void* WXHCURSOR ;
2002typedef void* WXHRGN ;
2003typedef void* WXRECTPTR ;
2004typedef void* WXPOINTPTR ;
2005typedef void* WXHWND ;
2006typedef void* WXEVENTREF ;
6357cb9d 2007typedef void* WXEVENTHANDLERREF ;
b823f462 2008typedef void* WXEVENTHANDLERCALLREF ;
f2c16a0b
SC
2009typedef void* WXAPPLEEVENTREF ;
2010typedef void* WXHDC ;
2011typedef void* WXHMENU ;
2012typedef unsigned int WXUINT;
2013typedef unsigned long WXDWORD;
2014typedef unsigned short WXWORD;
2015
2016typedef void* WXWidget ;
2017typedef void* WXWindow ;
0304b437 2018typedef void* WXDisplay ;
f2c16a0b 2019/*
f608bc67 2020typedef WindowPtr WXHWND;
f6bcfd97
BP
2021typedef Handle WXHANDLE;
2022typedef CIconHandle WXHICON;
519cb848 2023//typedef unsigned long WXHFONT;
f6bcfd97 2024typedef MenuHandle WXHMENU;
519cb848
SC
2025//typedef unsigned long WXHPEN;
2026//typedef unsigned long WXHBRUSH;
2027//typedef unsigned long WXHPALETTE;
f6bcfd97 2028typedef CursHandle WXHCURSOR;
f608bc67 2029typedef RgnHandle WXHRGN;
519cb848
SC
2030//typedef unsigned long WXHACCEL;
2031//typedef unsigned long WXHINSTANCE;
519cb848
SC
2032//typedef unsigned long WXHIMAGELIST;
2033//typedef unsigned long WXHGLOBAL;
f6bcfd97 2034typedef GrafPtr WXHDC;
519cb848
SC
2035//typedef unsigned int WXWPARAM;
2036//typedef long WXLPARAM;
519cb848
SC
2037//typedef void * WXRGNDATA;
2038//typedef void * WXMSG;
2039//typedef unsigned long WXHCONV;
2040//typedef unsigned long WXHKEY;
2041//typedef void * WXDRAWITEMSTRUCT;
2042//typedef void * WXMEASUREITEMSTRUCT;
2043//typedef void * WXLPCREATESTRUCT;
2044typedef int (*WXFARPROC)();
2045
f6bcfd97
BP
2046typedef WindowPtr WXWindow;
2047typedef ControlHandle WXWidget;
f2c16a0b 2048*/
519cb848
SC
2049#endif
2050
43225e09
DE
2051#ifdef __WXCOCOA__
2052
6444e22d
DE
2053// NOTE: This ought to work with other compilers too, but I'm being cautious
2054#if defined(__GNUC__) && defined(__APPLE__)
2055/* It's desirable to have type safety for Objective-C(++) code as it does
2056at least catch typos of method names among other things. However, it
2057is not possible to declare an Objective-C class from plain old C or C++
2058code. Furthermore, because of C++ name mangling, the type name must
2059be the same for both C++ and Objective-C++ code. Therefore, we define
2060what should be a pointer to an Objective-C class as a pointer to a plain
2061old C struct with the same name. Unfortunately, because the compiler
2062does not see a struct as an Objective-C class we cannot declare it
2063as a struct in Objective-C(++) mode.
2064*/
2065#if defined(__OBJC__)
2066#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2067@class klass; \
2068typedef klass *WX_##klass
2069#else // not defined(__OBJC__)
2070#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2071typedef struct klass *WX_##klass
2072#endif // defined(__OBJC__)
2073
2074#else // not GNU
2075#warning "Objective-C types will not be checked by the compiler."
7875262d
DE
2076// NOTE: typedef struct objc_object *id;
2077// IOW, we're declaring these using the id type without using that name,
2078// since "id" is used extensively not only within wxWindows itself, but
2079// also in wxWindows application code. The following works fine when
6444e22d 2080// compiling C(++) code, and works without typesafety for Obj-C(++) code
7875262d
DE
2081#define DECLARE_WXCOCOA_OBJC_CLASS(klass) \
2082typedef struct objc_object *WX_##klass
43225e09 2083
6444e22d
DE
2084#endif // defined(__GNUC__) && defined(__APPLE__)
2085
43225e09 2086DECLARE_WXCOCOA_OBJC_CLASS(NSApplication);
c10ec9f5 2087DECLARE_WXCOCOA_OBJC_CLASS(NSBitmapImageRep);
43225e09
DE
2088DECLARE_WXCOCOA_OBJC_CLASS(NSBox);
2089DECLARE_WXCOCOA_OBJC_CLASS(NSButton);
d9b4ddf2 2090DECLARE_WXCOCOA_OBJC_CLASS(NSColor);
43225e09 2091DECLARE_WXCOCOA_OBJC_CLASS(NSControl);
b67d3706 2092DECLARE_WXCOCOA_OBJC_CLASS(NSEvent);
69f2115d 2093DECLARE_WXCOCOA_OBJC_CLASS(NSImage);
82de126c 2094DECLARE_WXCOCOA_OBJC_CLASS(NSLayoutManager);
43225e09
DE
2095DECLARE_WXCOCOA_OBJC_CLASS(NSMenu);
2096DECLARE_WXCOCOA_OBJC_CLASS(NSMenuItem);
03fc8e97 2097DECLARE_WXCOCOA_OBJC_CLASS(NSMutableArray);
43225e09 2098DECLARE_WXCOCOA_OBJC_CLASS(NSPanel);
d25aa543 2099DECLARE_WXCOCOA_OBJC_CLASS(NSScrollView);
03fc8e97 2100DECLARE_WXCOCOA_OBJC_CLASS(NSTableColumn);
43225e09 2101DECLARE_WXCOCOA_OBJC_CLASS(NSTableView);
82de126c 2102DECLARE_WXCOCOA_OBJC_CLASS(NSTextContainer);
43225e09 2103DECLARE_WXCOCOA_OBJC_CLASS(NSTextField);
82de126c 2104DECLARE_WXCOCOA_OBJC_CLASS(NSTextStorage);
c818fe66 2105DECLARE_WXCOCOA_OBJC_CLASS(NSThread);
43225e09
DE
2106DECLARE_WXCOCOA_OBJC_CLASS(NSWindow);
2107DECLARE_WXCOCOA_OBJC_CLASS(NSView);
2108typedef WX_NSView WXWidget; // wxWindows BASE definition
2109#endif // __WXCOCOA__
2110
bac507e0 2111#if defined(__WXMSW__) || defined(__WXPM__)
f6bcfd97
BP
2112
2113// the keywords needed for WinMain() declaration
2114#ifdef __WIN16__
2115# ifdef __VISUALC__
2116# define WXFAR __far
2117# else
2118# define WXFAR _far
2119# endif
2120#else // Win32
2121# ifndef WXFAR
2122# define WXFAR
2123# endif
2124#endif // Win16/32
2125
bac507e0 2126// Stand-ins for Windows types or OS/2, to avoid #including all of windows.h or os2.h
c801d85f
KB
2127typedef unsigned long WXHWND;
2128typedef unsigned long WXHANDLE;
2129typedef unsigned long WXHICON;
2130typedef unsigned long WXHFONT;
2131typedef unsigned long WXHMENU;
2132typedef unsigned long WXHPEN;
2133typedef unsigned long WXHBRUSH;
2134typedef unsigned long WXHPALETTE;
2135typedef unsigned long WXHCURSOR;
2136typedef unsigned long WXHRGN;
57a7b7c1 2137typedef unsigned long WXHACCEL;
f6bcfd97 2138typedef void WXFAR * WXHINSTANCE;
c801d85f
KB
2139typedef unsigned long WXHBITMAP;
2140typedef unsigned long WXHIMAGELIST;
2141typedef unsigned long WXHGLOBAL;
2142typedef unsigned long WXHDC;
2143typedef unsigned int WXUINT;
2144typedef unsigned long WXDWORD;
2145typedef unsigned short WXWORD;
4f89dbc4 2146
c801d85f 2147typedef unsigned long WXCOLORREF;
c801d85f
KB
2148typedef void * WXRGNDATA;
2149typedef void * WXMSG;
2150typedef unsigned long WXHCONV;
0d8d91a9 2151typedef unsigned long WXHKEY;
ef366d32 2152typedef unsigned long WXHTREEITEM;
a23fd0e1 2153
c801d85f
KB
2154typedef void * WXDRAWITEMSTRUCT;
2155typedef void * WXMEASUREITEMSTRUCT;
2156typedef void * WXLPCREATESTRUCT;
a23fd0e1 2157
4f89dbc4
RL
2158typedef WXHWND WXWidget;
2159
2160#endif // MSW or OS2
2161
2162
2163#ifdef __WXMSW__
2164typedef unsigned int WXWPARAM;
2165typedef long WXLPARAM;
2166
b4da152e 2167#if !defined(__WIN32__) || defined(__GNUWIN32__) || defined(__WXMICROWIN__)
4f89dbc4
RL
2168typedef int (*WXFARPROC)();
2169#else
2170typedef int (__stdcall *WXFARPROC)();
2171#endif
2172#endif // __WXMSW__
2173
2174
bd3b171d 2175#if defined(__WXPM__) || defined(__EMX__)
0fe5619d
SN
2176#ifdef __EMX__
2177/* Need a well-known type for WXFARPROC
2178 below. MPARAM is typedef'ed too late. */
2179#define WXWPARAM void *
2180#define WXLPARAM void *
2181#else
4f89dbc4
RL
2182#define WXWPARAM MPARAM
2183#define WXLPARAM MPARAM
0fe5619d 2184#endif
4f89dbc4
RL
2185#define RECT RECTL
2186#define LOGFONT FATTRS
2187#define LOWORD SHORT1FROMMP
2188#define HIWORD SHORT2FROMMP
2189
54da4255
DW
2190typedef unsigned long WXMPARAM;
2191typedef unsigned long WXMSGID;
2192typedef void* WXRESULT;
659d096c 2193//typedef int (*WXFARPROC)();
54da4255
DW
2194// some windows handles not defined by PM
2195typedef unsigned long HANDLE;
2196typedef unsigned long HICON;
2197typedef unsigned long HFONT;
2198typedef unsigned long HMENU;
2199typedef unsigned long HPEN;
2200typedef unsigned long HBRUSH;
2201typedef unsigned long HPALETTE;
2202typedef unsigned long HCURSOR;
2203typedef unsigned long HINSTANCE;
2204typedef unsigned long HIMAGELIST;
2205typedef unsigned long HGLOBAL;
2206typedef unsigned long DWORD;
2207typedef unsigned short WORD;
bd3b171d 2208#endif // WXPM || EMX
43543d98 2209
bd3b171d 2210#if defined (__WXPM__)
43543d98
DW
2211// WIN32 graphics types for OS/2 GPI
2212
2213// RGB under OS2 is more like a PALETTEENTRY struct under Windows so we need a real RGB def
19193a2c
KB
2214// WARNING: The OS/2 headers typedef BYTE simply as 'char'; if the default is signed, all
2215// hell will break loose!
2216//#define OS2RGB(r,g,b) ((DWORD ((BYTE) (b) | ((WORD) (g) << 8)) | (((DWORD)(BYTE)(r)) << 16)))
2217#define OS2RGB(r,g,b) ((DWORD)((unsigned char)(b) | ((unsigned char)(g) << 8)) | ((unsigned char)(r) << 16))
43543d98
DW
2218
2219typedef unsigned long COLORREF;
2220#define GetBValue(rgb) ((BYTE)((rgb) >> 16))
2221#define GetGValue(rgb) ((BYTE)(((WORD)(rgb)) >> 8))
2222#define GetRValue(rgb) ((BYTE)(rgb))
2223#define PALETTEINDEX(i) ((COLORREF)(0x01000000 | (DWORD)(WORD)(i)))
2224#define PALETTERGB(r,g,b) (0x02000000 | OS2RGB(r,g,b))
2225// OS2's RGB/RGB2 is backwards from this
2226typedef struct tagPALETTEENTRY
2227{
2228 char bRed;
2229 char bGreen;
2230 char bBlue;
2231 char bFlags;
2232} PALETTEENTRY;
2233typedef struct tagLOGPALETTE
2234{
2235 WORD palVersion;
2236 WORD palNumentries;
2237 WORD PALETTEENTRY[1];
2238} LOGPALETTE;
54da4255 2239
4f89dbc4 2240#if (defined(__VISAGECPP__) && (__IBMCPP__ < 400)) || defined (__WATCOMC__)
37123da4 2241 // VA 3.0 for some reason needs base data types when typedefing a proc proto???
4f89dbc4 2242typedef void* (_System *WXFARPROC)(unsigned long, unsigned long, void*, void*);
1e6d9499 2243#else
0fe5619d
SN
2244#ifdef __EMX__
2245#define _System
2246#endif
4f89dbc4 2247typedef WXRESULT (_System *WXFARPROC)(WXHWND, WXMSGID, WXWPARAM, WXLPARAM);
14b72bf5 2248#endif
c801d85f 2249
4f89dbc4 2250#endif //__WXPM__
8fb3a512 2251
c801d85f 2252
83df96d6 2253#if defined(__WXMOTIF__) || defined(__WXX11__)
83624f79 2254/* Stand-ins for X/Xt/Motif types */
589f0e3e
JS
2255typedef void* WXWindow;
2256typedef void* WXWidget;
2257typedef void* WXAppContext;
46ccb510 2258typedef void* WXColormap;
3cd0b8c5 2259typedef void* WXColor;
589f0e3e
JS
2260typedef void WXDisplay;
2261typedef void WXEvent;
46ccb510 2262typedef void* WXCursor;
50414e24 2263typedef void* WXPixmap;
dfc54541
JS
2264typedef void* WXFontStructPtr;
2265typedef void* WXGC;
2266typedef void* WXRegion;
e97f20a0 2267typedef void* WXFont;
f97c9854 2268typedef void* WXImage;
f97c9854 2269typedef void* WXFontList;
da494b40
MB
2270typedef void* WXRendition;
2271typedef void* WXRenderTable;
2272typedef void* WXFontType; /* either a XmFontList or XmRenderTable */
2273typedef void* WXString;
da175b2c
RR
2274
2275typedef unsigned long Atom; /* this might fail on a few architectures */
2276
f03fc89f 2277#endif // Motif
589f0e3e 2278
83624f79 2279#ifdef __WXGTK__
9e691f46 2280
83624f79 2281/* Stand-ins for GLIB types */
f6bcfd97
BP
2282typedef char gchar;
2283typedef signed char gint8;
83624f79
RR
2284typedef int gint;
2285typedef unsigned guint;
2286typedef unsigned long gulong;
2287typedef void* gpointer;
953704c1 2288typedef struct _GSList GSList;
83624f79
RR
2289
2290/* Stand-ins for GDK types */
83624f79
RR
2291typedef struct _GdkColor GdkColor;
2292typedef struct _GdkColormap GdkColormap;
2293typedef struct _GdkFont GdkFont;
2294typedef struct _GdkGC GdkGC;
005f5d18 2295typedef struct _GdkVisual GdkVisual;
9e691f46 2296
10ca1c14 2297#ifdef __WXGTK20__
9e691f46 2298typedef struct _GdkAtom *GdkAtom;
4f89dbc4
RL
2299typedef struct _GdkDrawable GdkWindow;
2300typedef struct _GdkDrawable GdkBitmap;
2301typedef struct _GdkDrawable GdkPixmap;
9e691f46
VZ
2302#else // GTK+ 1.2
2303typedef gulong GdkAtom;
4f89dbc4
RL
2304typedef struct _GdkWindow GdkWindow;
2305typedef struct _GdkWindow GdkBitmap;
2306typedef struct _GdkWindow GdkPixmap;
9e691f46
VZ
2307#endif // GTK+ 1.2/2.0
2308
83624f79
RR
2309typedef struct _GdkCursor GdkCursor;
2310typedef struct _GdkRegion GdkRegion;
8a126fcc 2311typedef struct _GdkDragContext GdkDragContext;
9e691f46 2312
63081513
RR
2313#ifdef HAVE_XIM
2314typedef struct _GdkIC GdkIC;
2315typedef struct _GdkICAttr GdkICAttr;
2316#endif
83624f79
RR
2317
2318/* Stand-ins for GTK types */
8a126fcc
RR
2319typedef struct _GtkWidget GtkWidget;
2320typedef struct _GtkStyle GtkStyle;
2321typedef struct _GtkAdjustment GtkAdjustment;
2322typedef struct _GtkList GtkList;
2323typedef struct _GtkToolbar GtkToolbar;
2324typedef struct _GtkTooltips GtkTooltips;
2325typedef struct _GtkNotebook GtkNotebook;
2326typedef struct _GtkNotebookPage GtkNotebookPage;
2327typedef struct _GtkAccelGroup GtkAccelGroup;
f608bc67
VZ
2328typedef struct _GtkItemFactory GtkItemFactory;
2329typedef struct _GtkSelectionData GtkSelectionData;
ad5c34f3 2330
f03fc89f 2331typedef GtkWidget *WXWidget;
e6ae7330
OK
2332
2333#ifndef __WXGTK20__
2334#define GTK_OBJECT_GET_CLASS(object) (GTK_OBJECT(object)->klass)
ff67d586 2335#define GTK_CLASS_TYPE(klass) ((klass)->type)
e6ae7330
OK
2336#endif
2337
2338#ifdef __WXGTK20__
2b5f62a0
VZ
2339/* Input method thing */
2340typedef struct _GtkIMMulticontext GtkIMMulticontext;
2341#endif // __WXGTK20__
2342
2343#endif // __WXGTK__
2344
2345#if defined(__WXGTK20__) || (defined(__WXX11__) && wxUSE_UNICODE)
2346#define wxUSE_PANGO 1
2347#else
2348#define wxUSE_PANGO 0
2349#endif
2350
2351#if wxUSE_PANGO
e6ae7330
OK
2352/* Stand-ins for Pango types */
2353typedef struct _PangoContext PangoContext;
2354typedef struct _PangoLayout PangoLayout;
2355typedef struct _PangoFontDescription PangoFontDescription;
2b5f62a0 2356#endif
ad5c34f3 2357
1e6feb95 2358#ifdef __WXMGL__
a9a8c02f 2359typedef struct window_t *WXWidget;
1e6feb95
VZ
2360#endif // MGL
2361
ad5c34f3
JS
2362// This is required because of clashing macros in windows.h, which may be
2363// included before or after wxWindows classes, and therefore must be
2364// disabled here before any significant wxWindows headers are included.
2365#ifdef __WXMSW__
2366#ifdef GetClassInfo
2367#undef GetClassInfo
2368#endif
2369
2370#ifdef GetClassName
2371#undef GetClassName
2372#endif
2373
2374#ifdef DrawText
2375#undef DrawText
2376#endif
2377
2378#ifdef GetCharWidth
2379#undef GetCharWidth
2380#endif
2381
2382#ifdef StartDoc
2383#undef StartDoc
2384#endif
2385
2386#ifdef FindWindow
2387#undef FindWindow
2388#endif
2389
2390#ifdef FindResource
2391#undef FindResource
2392#endif
83624f79 2393#endif
ad5c34f3 2394 // __WXMSW__
83624f79 2395
a23fd0e1
VZ
2396// ---------------------------------------------------------------------------
2397// macro to define a class without copy ctor nor assignment operator
2398// ---------------------------------------------------------------------------
2399
2400#define DECLARE_NO_COPY_CLASS(classname) \
2401 private: \
2402 classname(const classname&); \
1e6feb95 2403 classname& operator=(const classname&);
a23fd0e1 2404
a6cbc4db
VS
2405#define DECLARE_NO_ASSIGN_CLASS(classname) \
2406 private: \
2407 classname& operator=(const classname&);
2408
c801d85f 2409#endif
34138703 2410 // _WX_DEFS_H_