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