]> git.saurik.com Git - wxWidgets.git/blob - include/wx/platform.h
For wxMSW capture and release the mouse as the cursor moves out or
[wxWidgets.git] / include / wx / platform.h
1 /**
2 * Name: wx/platform.h
3 * Purpose: define the OS and compiler identification macros
4 * Author: Vadim Zeitlin
5 * Modified by:
6 * Created: 29.10.01 (extracted from wx/defs.h)
7 * RCS-ID: $Id$
8 * Copyright: (c) 1997-2001 wxWidgets team
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_PLATFORM_H_
15 #define _WX_PLATFORM_H_
16
17
18 /*
19 Codewarrior doesn't define any Windows symbols until some headers
20 are included
21 */
22 #if __MWERKS__
23 # include <stddef.h>
24 #endif
25
26 /*
27 WXMAC variants
28 __WXMAC_CLASSIC__ means ppc non-carbon builds, __WXMAC_CARBON__ means
29 carbon API available (mach or cfm builds) , __WXMAC_OSX__ means mach-o
30 builds, running under 10.2 + only
31 */
32 #ifdef __WXMAC__
33 # if defined(__MACH__)
34 # define __WXMAC_OSX__
35 # define __WXMAC_CARBON__
36 # ifdef __WXMAC_XCODE__
37 # include <unistd.h>
38 # include "wx/mac/carbon/config_xcode.h"
39 # endif
40 # else
41 # if TARGET_CARBON
42 # define __WXMAC_CARBON__
43 # else
44 # define __WXMAC_CLASSIC__
45 # endif
46 # endif
47 #endif
48
49 /*
50 __WXOSX__ is a common define to wxMac (Carbon) and wxCocoa ports under OS X.
51 */
52 #if defined(__WXMAC_OSX__) || defined(__WXCOCOA__)
53 # define __WXOSX__
54 #endif
55
56 /*
57 first define Windows symbols if they're not defined on the command line: we
58 can autodetect everything we need if _WIN32 is defined
59 */
60 #if defined(__CYGWIN32__) && !defined(__WXMOTIF__) && !defined(__WXGTK__) \
61 && !defined(__WXX11__)
62 /* for Cygwin, default to wxMSW unless otherwise specified */
63 # ifndef __WXMSW__
64 # define __WXMSW__
65 # endif
66
67 # ifndef _WIN32
68 # define _WIN32
69 # endif
70
71 # ifndef WIN32
72 # define WIN32
73 # endif
74 #endif
75
76 #if defined(__PALMOS__)
77 # ifndef __WXPALMOS__
78 # define __WXPALMOS__
79 # endif
80 # ifdef __WXMSW__
81 # undef __WXMSW__
82 # endif
83 # ifdef __WINDOWS__
84 # undef __WINDOWS__
85 # endif
86 # ifdef __WIN32__
87 # undef __WIN32__
88 # endif
89 # ifdef WIN32
90 # undef WIN32
91 # endif
92 # ifdef _WIN32
93 # undef _WIN32
94 # endif
95 #endif
96
97 #if defined(_WIN64)
98 # ifndef _WIN32
99 /*
100 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
101 Windows or to test for !__WIN16__, so we must define _WIN32 for
102 Win64 as well to ensure that the existing code continues to work.
103 */
104 # define _WIN32
105 # endif /* !_WIN32 */
106
107 # ifndef __WIN64__
108 # define __WIN64__
109 # endif /* !__WIN64__ */
110 #endif /* _WIN64 */
111
112 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
113 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
114 # ifndef __WXMSW__
115 # define __WXMSW__
116 # endif
117
118 # ifndef __WIN32__
119 # define __WIN32__
120 # endif
121
122 /*
123 The library user may override the default setting of WINVER by defining
124 it in his own makefile or project file -- if it is defined, we don't
125 touch it at all.
126
127 It makes sense to define WINVER as:
128 - either some lowish value (e.g. 0x0302) to not even compile in the
129 features not available in Windows version lower than some given
130 one
131 - or to a higher value than the one used by default for the given
132 compiler if you updated its headers to newer version of Platform
133 SDK, e.g. VC6 ships with 0x0400 headers by default but may also
134 work with 0x0500 headers and beyond
135 */
136 # ifndef WINVER
137 # if defined(_MSC_VER) && _MSC_VER < 1300
138 /*
139 VC6 defines some stuff in its default headers which is normally
140 only present if WINVER >= 0x0500 (FLASHW_XXX constants) which
141 means that our usual tests not involving WINVER sometimes fail
142 with it, hence explicitly define a lower WINVER value for it.
143 */
144 # define WINVER 0x0400
145 # elif defined(__DMC__)
146 /*
147 Digital Mars is distributed with a little outdated headers.
148 */
149 # define WINVER 0x0400
150 # else /* !VC++ 6 */
151 /*
152 see MSDN for the description of possible WINVER values, this one
153 is the highest one defined right now (Windows Server 2003) and
154 we use it unless it was explicitly overridden by the user to
155 disable recent features support as we check for all of the
156 features we use which could be not available on earlier Windows
157 systems during run-time anyhow, so there is almost no
158 disadvantage in using it.
159 */
160 # define WINVER 0x0502
161 # endif /* VC++ 6/!VC++6 */
162 # endif
163
164 /* Win95 means Win95-style UI, i.e. Win9x/NT 4+ */
165 # if !defined(__WIN95__) && (WINVER >= 0x0400)
166 # define __WIN95__
167 # endif
168 #endif /* Win32 */
169
170 #if defined(__WXMSW__) || defined(__WIN32__)
171 # if !defined(__WINDOWS__)
172 # define __WINDOWS__
173 # endif
174 #endif
175
176 #ifdef __WINE__
177 # ifndef __WIN95__
178 # define __WIN95__
179 # endif
180 #endif /* WINE */
181
182 /* detect MS SmartPhone */
183 #if defined( WIN32_PLATFORM_WFSP )
184 # ifndef __SMARTPHONE__
185 # define __SMARTPHONE__
186 # endif
187 # ifndef __WXWINCE__
188 # define __WXWINCE__
189 # endif
190 #endif
191
192 /* detect PocketPC */
193 #if defined( WIN32_PLATFORM_PSPC )
194 # ifndef __POCKETPC__
195 # define __POCKETPC__
196 # endif
197 # ifndef __WXWINCE__
198 # define __WXWINCE__
199 # endif
200 #endif
201
202 /* detect Standard WinCE SDK */
203 #if defined( WCE_PLATFORM_STANDARDSDK )
204 # ifndef __WINCE_STANDARDSDK__
205 # define __WINCE_STANDARDSDK__
206 # endif
207 # ifndef __WXWINCE__
208 # define __WXWINCE__
209 # endif
210 #endif
211
212 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
213 # if (_WIN32_WCE >= 400)
214 # ifndef __WINCE_NET__
215 # define __WINCE_NET__
216 # endif
217 # elif (_WIN32_WCE >= 200)
218 # ifndef __HANDHELDPC__
219 # define __HANDHELDPC__
220 # endif
221 # endif
222 # ifndef __WXWINCE__
223 # define __WXWINCE__
224 # endif
225 #endif
226
227 /*
228 Hardware platform detection.
229
230 VC++ defines _M_xxx symbols.
231 */
232 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
233 #ifndef __INTEL__
234 #define __INTEL__
235 #endif
236 #endif /* x86 */
237
238 #if defined(_M_IA64)
239 #ifndef __IA64__
240 #define __IA64__
241 #endif
242 #endif /* ia64 */
243
244 #if defined(_M_MPPC) || defined(__PPC__)
245 #ifndef __POWERPC__
246 #define __POWERPC__
247 #endif
248 #endif /* alpha */
249
250 #if defined(_M_ALPHA) || defined(__AXP__)
251 #ifndef __ALPHA__
252 #define __ALPHA__
253 #endif
254 #endif /* alpha */
255
256 /*
257 Include wx/setup.h for the Unix platform defines generated by configure and
258 the library compilation options
259 */
260 #include "wx/setup.h"
261
262 /* check the consistency of the settings in setup.h */
263 #include "wx/chkconf.h"
264
265 /*
266 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
267 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
268 the system headers so bring these settings in sync
269 */
270
271 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
272 #if defined(_UNICODE) || defined(UNICODE)
273 # undef wxUSE_UNICODE
274 # define wxUSE_UNICODE 1
275 #else /* !UNICODE */
276 # ifndef wxUSE_UNICODE
277 # define wxUSE_UNICODE 0
278 # endif
279 #endif /* UNICODE/!UNICODE */
280
281 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
282 #if wxUSE_UNICODE
283 # ifndef _UNICODE
284 # define _UNICODE
285 # endif
286 # ifndef UNICODE
287 # define UNICODE
288 # endif
289 #endif /* wxUSE_UNICODE */
290
291 #if defined( __MWERKS__ ) && !defined(__INTEL__)
292 // otherwise MSL headers bring in WIN32 dependant APIs
293 #undef UNICODE
294 #endif
295 /*
296 some compilers don't support iostream.h any longer, while some of theme
297 are not updated with <iostream> yet, so override the users setting here
298 in such case.
299 */
300 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
301 # undef wxUSE_IOSTREAMH
302 # define wxUSE_IOSTREAMH 0
303 #elif defined(__DMC__) || defined(__WATCOMC__)
304 # undef wxUSE_IOSTREAMH
305 # define wxUSE_IOSTREAMH 1
306 #elif defined(__MINGW32__)
307 # undef wxUSE_IOSTREAMH
308 # define wxUSE_IOSTREAMH 0
309 #endif /* compilers with/without iostream.h */
310
311 /*
312 old C++ headers (like <iostream.h>) declare classes in the global namespace
313 while the new, standard ones (like <iostream>) do it in std:: namespace
314
315 using this macro allows constuctions like "wxSTD iostream" to work in
316 either case
317 */
318 #if !wxUSE_IOSTREAMH
319 # define wxSTD std::
320 #else
321 # define wxSTD
322 #endif
323
324 /*
325 OS: first of all, test for MS-DOS platform. We must do this before testing
326 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
327 */
328 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
329 # ifndef __DOS__
330 # define __DOS__
331 # endif
332 /* size_t is the same as unsigned int for Watcom 11 compiler, */
333 /* so define it if it hadn't been done by configure yet */
334 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
335 # ifdef __WATCOMC__
336 # define wxSIZE_T_IS_UINT
337 # endif
338 # ifdef __DJGPP__
339 # define wxSIZE_T_IS_ULONG
340 # endif
341 # endif
342
343 /*
344 OS: then test for generic Unix defines, then for particular flavours and
345 finally for Unix-like systems
346 */
347 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
348 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
349 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
350 defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
351
352 # define __UNIX_LIKE__
353
354 /* Helps SGI compilation, apparently */
355 # ifdef __SGI__
356 # ifdef __GNUG__
357 # define __need_wchar_t
358 # else /* !gcc */
359 /*
360 Note I use the term __SGI_CC__ for both cc and CC, its not a good
361 idea to mix gcc and cc/CC, the name mangling is different
362 */
363 # define __SGI_CC__
364 # endif /* gcc/!gcc */
365 # endif /* SGI */
366
367 # if defined(sun) || defined(__SUN__)
368 # ifndef __GNUG__
369 # ifndef __SUNCC__
370 # define __SUNCC__
371 # endif /* Sun CC */
372 # endif
373 # endif /* Sun */
374
375 # ifdef __EMX__
376 # define OS2EMX_PLAIN_CHAR
377 # endif
378
379 /* define __HPUX__ for HP-UX where standard macro is __hpux */
380 # if defined(__hpux) && !defined(__HPUX__)
381 # define __HPUX__
382 # endif /* HP-UX */
383
384 # if defined(__CYGWIN__) || defined(__WINE__)
385 # if !defined(wxSIZE_T_IS_UINT)
386 # define wxSIZE_T_IS_UINT
387 # endif
388 # endif
389 #elif defined(applec) || \
390 defined(THINK_C) || \
391 (defined(__MWERKS__) && !defined(__INTEL__))
392 /* MacOS */
393 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
394 # define wxSIZE_T_IS_ULONG
395 # endif
396 #elif defined(__WXMAC__) && defined(__APPLE__)
397 /* Mac OS X */
398 # define __UNIX_LIKE__
399
400 /*
401 These defines are needed when compiling using Project Builder
402 with a non generated setup0.h
403 */
404 # ifndef __UNIX__
405 # define __UNIX__ 1
406 # endif
407 # ifndef __BSD__
408 # define __BSD__ 1
409 # endif
410 # ifndef __DARWIN__
411 # define __DARWIN__ 1
412 # endif
413 # ifndef __POWERPC__
414 # define __POWERPC__ 1
415 # endif
416 # ifndef TARGET_CARBON
417 # define TARGET_CARBON 1
418 # endif
419
420 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
421 # define wxSIZE_T_IS_ULONG
422 # endif
423 /*
424 Some code has been added to workaround defects(?) in the
425 bundled gcc compiler. These corrections are identified by
426 __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
427 */
428 #elif defined(__OS2__)
429 # if defined(__IBMCPP__)
430 # define __VISAGEAVER__ __IBMCPP__
431 # endif
432 # ifndef __WXOS2__
433 # define __WXOS2__
434 # endif
435 # ifndef __WXPM__
436 # define __WXPM__
437 # endif
438
439 /* Place other OS/2 compiler environment defines here */
440 # if defined(__VISAGECPP__)
441 /* VisualAge is the only thing that understands _Optlink */
442 # define LINKAGEMODE _Optlink
443 # endif
444 # define wxSIZE_T_IS_UINT
445
446 #elif defined(__PALMOS__)
447 # ifdef __WIN32__
448 # error "__WIN32__ should not be defined for PalmOS"
449 # endif
450 # ifdef __WINDOWS__
451 # error "__WINDOWS__ should not be defined for PalmOS"
452 # endif
453 # ifdef __WXMSW__
454 # error "__WXMSW__ should not be defined for PalmOS"
455 # endif
456
457 #else /* Windows */
458 # ifndef __WINDOWS__
459 # define __WINDOWS__
460 # endif /* Windows */
461
462 /* to be changed for Win64! */
463 # ifndef __WIN32__
464 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
465 # endif
466
467 /*
468 define another standard symbol for Microsoft Visual C++: the standard
469 one (_MSC_VER) is also defined by Metrowerks compiler
470 */
471 # if defined(_MSC_VER) && !defined(__MWERKS__)
472 # define __VISUALC__ _MSC_VER
473 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
474 # define __BORLANDC__
475 # elif defined(__WATCOMC__)
476 # elif defined(__SC__)
477 # define __SYMANTECC__
478 # endif /* compiler */
479
480 /* size_t is the same as unsigned int for all Windows compilers we know, */
481 /* so define it if it hadn't been done by configure yet */
482 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
483 # define wxSIZE_T_IS_UINT
484 # endif
485 #endif /* OS */
486
487 /*
488 if we're on a Unix system but didn't use configure (so that setup.h didn't
489 define __UNIX__), do define __UNIX__ now
490 */
491 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
492 # define __UNIX__
493 #endif /* Unix */
494
495 #if defined(__WXMOTIF__) || defined(__WXX11__)
496 # define __X__
497 #endif
498
499 #ifdef __SC__
500 # ifdef __DMC__
501 # define __DIGITALMARS__
502 # else
503 # define __SYMANTEC__
504 # endif
505 #endif
506
507 /* Force linking against required libraries under Windows CE: */
508 #ifdef __WXWINCE__
509 # include "wx/msw/wince/libraries.h"
510 #endif
511
512 /* Force inclusion of main PalmOS header: */
513 #ifdef __WXPALMOS__
514 # include <PalmOS.h>
515 # undef Abs
516 #endif
517
518 /*
519 This macro can be used to test the gcc version and can be used like this:
520
521 # if wxCHECK_GCC_VERSION(3, 1)
522 ... we have gcc 3.1 or later ...
523 # else
524 ... no gcc at all or gcc < 3.1 ...
525 # endif
526 */
527 #define wxCHECK_GCC_VERSION( major, minor ) \
528 ( defined(__GNUC__) && defined(__GNUC_MINOR__) \
529 && ( ( __GNUC__ > (major) ) \
530 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) ) )
531
532 /*
533 This macro can be used to check that the version of mingw32 compiler is
534 at least maj.min
535 */
536 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
537 defined( __CYGWIN__ ) || \
538 (defined(__WATCOMC__) && __WATCOMC__ >= 1200) ) && \
539 !defined(__DOS__) && \
540 !defined(__WXMOTIF__) && \
541 !defined(__WXGTK__) && \
542 !defined(__WXX11__) && \
543 !defined(__WXPALMOS__)
544 # include "wx/msw/gccpriv.h"
545 #else
546 # undef wxCHECK_W32API_VERSION
547 # define wxCHECK_W32API_VERSION(maj, min) (0)
548 #endif
549
550 #if defined (__WXMSW__)
551 # if !defined(__WATCOMC__)
552 # define wxHAVE_RAW_BITMAP
553 # endif
554 #endif
555
556 #if defined (__WXMAC__)
557 # ifndef WORDS_BIGENDIAN
558 # define WORDS_BIGENDIAN 1
559 # endif
560 #endif
561
562 /* Choose which method we will use for updating menus
563 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
564 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
565 */
566 #ifndef wxUSE_IDLEMENUUPDATES
567 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
568 # define wxUSE_IDLEMENUUPDATES 0
569 # else
570 # define wxUSE_IDLEMENUUPDATES 1
571 # endif
572 #endif
573
574 /*
575 * Define symbols that are not yet in
576 * configure or possibly some setup.h files.
577 * They will need to be added.
578 */
579
580 #ifndef wxUSE_FILECONFIG
581 # if wxUSE_CONFIG
582 # define wxUSE_FILECONFIG 1
583 # else
584 # define wxUSE_FILECONFIG 0
585 # endif
586 #endif
587
588 #ifndef wxUSE_HOTKEY
589 # define wxUSE_HOTKEY 0
590 #endif
591
592 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
593 # define wxUSE_WXDIB 1
594 #endif
595
596 /*
597 We need AvailabilityMacros.h for ifdefing out things that don't exist on
598 OSX 10.2 and lower
599 FIXME: We need a better way to detect for 10.3 then including a system header
600 */
601 #ifdef __DARWIN__
602 #include <AvailabilityMacros.h>
603 #endif
604
605 #endif /* _WX_PLATFORM_H_ */
606