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