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