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