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