]> git.saurik.com Git - wxWidgets.git/blob - include/wx/platform.h
made it possible to associate context help to a region of a window
[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 Vadim Zeitlin
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 #ifdef __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(__CYGWIN__) && defined(__WINDOWS__)
61 # ifndef __WXMSW__
62 # define __WXMSW__
63 # endif
64
65 # ifndef _WIN32
66 # define _WIN32
67 # endif
68
69 # ifndef WIN32
70 # define WIN32
71 # endif
72 #endif
73
74 #if defined(__PALMOS__)
75 # if __PALMOS__ == 0x06000000
76 # define __WXPALMOS6__
77 # endif
78 # if __PALMOS__ == 0x05000000
79 # define __WXPALMOS5__
80 # endif
81 # ifndef __WXPALMOS__
82 # define __WXPALMOS__
83 # endif
84 # ifdef __WXMSW__
85 # undef __WXMSW__
86 # endif
87 # ifdef __WINDOWS__
88 # undef __WINDOWS__
89 # endif
90 # ifdef __WIN32__
91 # undef __WIN32__
92 # endif
93 # ifdef WIN32
94 # undef WIN32
95 # endif
96 # ifdef _WIN32
97 # undef _WIN32
98 # endif
99 #endif
100
101 #if defined(_WIN64)
102 # ifndef _WIN32
103 /*
104 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
105 Windows or to test for !__WIN16__, so we must define _WIN32 for
106 Win64 as well to ensure that the existing code continues to work.
107 */
108 # define _WIN32
109 # endif /* !_WIN32 */
110
111 # ifndef __WIN64__
112 # define __WIN64__
113 # endif /* !__WIN64__ */
114 #endif /* _WIN64 */
115
116 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
117 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
118 # ifndef __WXMSW__
119 # define __WXMSW__
120 # endif
121
122 # ifndef __WIN32__
123 # define __WIN32__
124 # endif
125 #endif /* Win32 */
126
127 #if defined(__WXMSW__) || defined(__WIN32__)
128 # if !defined(__WINDOWS__)
129 # define __WINDOWS__
130 # endif
131 #endif
132
133 /* detect MS SmartPhone */
134 #if defined( WIN32_PLATFORM_WFSP )
135 # ifndef __SMARTPHONE__
136 # define __SMARTPHONE__
137 # endif
138 # ifndef __WXWINCE__
139 # define __WXWINCE__
140 # endif
141 #endif
142
143 /* detect PocketPC */
144 #if defined( WIN32_PLATFORM_PSPC )
145 # ifndef __POCKETPC__
146 # define __POCKETPC__
147 # endif
148 # ifndef __WXWINCE__
149 # define __WXWINCE__
150 # endif
151 #endif
152
153 /* detect Standard WinCE SDK */
154 #if defined( WCE_PLATFORM_STANDARDSDK )
155 # ifndef __WINCE_STANDARDSDK__
156 # define __WINCE_STANDARDSDK__
157 # endif
158 # ifndef __WXWINCE__
159 # define __WXWINCE__
160 # endif
161 #endif
162
163 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
164 # if (_WIN32_WCE >= 400)
165 # ifndef __WINCE_NET__
166 # define __WINCE_NET__
167 # endif
168 # elif (_WIN32_WCE >= 200)
169 # ifndef __HANDHELDPC__
170 # define __HANDHELDPC__
171 # endif
172 # endif
173 # ifndef __WXWINCE__
174 # define __WXWINCE__
175 # endif
176 #endif
177
178 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
179 # define __WXHANDHELD__
180 #endif
181
182 /*
183 Include wx/setup.h for the Unix platform defines generated by configure and
184 the library compilation options
185
186 Note that it must be included before defining hardware symbols below as they
187 could be already defined by configure
188 */
189 #include "wx/setup.h"
190
191 /*
192 Hardware platform detection.
193
194 VC++ defines _M_xxx symbols.
195 */
196 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
197 #ifndef __INTEL__
198 #define __INTEL__
199 #endif
200 #endif /* x86 */
201
202 #if defined(_M_IA64)
203 #ifndef __IA64__
204 #define __IA64__
205 #endif
206 #endif /* ia64 */
207
208 #if defined(_M_MPPC) || defined(__PPC__)
209 #ifndef __POWERPC__
210 #define __POWERPC__
211 #endif
212 #endif /* alpha */
213
214 #if defined(_M_ALPHA) || defined(__AXP__)
215 #ifndef __ALPHA__
216 #define __ALPHA__
217 #endif
218 #endif /* alpha */
219
220
221 /*
222 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
223 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
224 the system headers so bring these settings in sync
225 */
226
227 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
228 #if defined(_UNICODE) || defined(UNICODE)
229 # undef wxUSE_UNICODE
230 # define wxUSE_UNICODE 1
231 #else /* !UNICODE */
232 # ifndef wxUSE_UNICODE
233 # define wxUSE_UNICODE 0
234 # endif
235 #endif /* UNICODE/!UNICODE */
236
237 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
238 #if wxUSE_UNICODE
239 # ifndef _UNICODE
240 # define _UNICODE
241 # endif
242 # ifndef UNICODE
243 # define UNICODE
244 # endif
245 #endif /* wxUSE_UNICODE */
246
247 #if defined( __MWERKS__ ) && !defined(__INTEL__)
248 /* otherwise MSL headers bring in WIN32 dependant APIs */
249 #undef UNICODE
250 #endif
251
252
253 /*
254 This macro can be used to test the Open Watcom version.
255 */
256 #ifndef __WATCOMC__
257 # define wxWATCOM_VERSION(major,minor) 0
258 # define wxCHECK_WATCOM_VERSION(major,minor) 0
259 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
260 #elif defined(__WATCOMC__) && __WATCOMC__ < 1200
261 # error "Only Open Watcom is supported in this release"
262 #else
263 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
264 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
265 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
266 #endif
267
268 /*
269 check the consistency of the settings in setup.h: note that this must be
270 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
271 */
272 #include "wx/chkconf.h"
273
274
275 /*
276 some compilers don't support iostream.h any longer, while some of theme
277 are not updated with <iostream> yet, so override the users setting here
278 in such case.
279 */
280 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
281 # undef wxUSE_IOSTREAMH
282 # define wxUSE_IOSTREAMH 0
283 #elif defined(__DMC__) || defined(__WATCOMC__)
284 # undef wxUSE_IOSTREAMH
285 # define wxUSE_IOSTREAMH 1
286 #elif defined(__MINGW32__)
287 # undef wxUSE_IOSTREAMH
288 # define wxUSE_IOSTREAMH 0
289 #endif /* compilers with/without iostream.h */
290
291 /*
292 old C++ headers (like <iostream.h>) declare classes in the global namespace
293 while the new, standard ones (like <iostream>) do it in std:: namespace,
294 unless it's an old gcc version.
295
296 using this macro allows constuctions like "wxSTD iostream" to work in
297 either case
298 */
299 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
300 # define wxSTD std::
301 #else
302 # define wxSTD
303 #endif
304
305 /*
306 OS: first of all, test for MS-DOS platform. We must do this before testing
307 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
308 */
309 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
310 # ifndef __DOS__
311 # define __DOS__
312 # endif
313 /* size_t is the same as unsigned int for Watcom 11 compiler, */
314 /* so define it if it hadn't been done by configure yet */
315 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
316 # ifdef __WATCOMC__
317 # define wxSIZE_T_IS_UINT
318 # endif
319 # ifdef __DJGPP__
320 # define wxSIZE_T_IS_ULONG
321 # endif
322 # endif
323
324 /*
325 OS: then test for generic Unix defines, then for particular flavours and
326 finally for Unix-like systems
327 */
328 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
329 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
330 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
331 defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
332
333 # define __UNIX_LIKE__
334
335 /* Helps SGI compilation, apparently */
336 # ifdef __SGI__
337 # ifdef __GNUG__
338 # define __need_wchar_t
339 # else /* !gcc */
340 /*
341 Note I use the term __SGI_CC__ for both cc and CC, its not a good
342 idea to mix gcc and cc/CC, the name mangling is different
343 */
344 # define __SGI_CC__
345 # endif /* gcc/!gcc */
346
347 /* system headers use this symbol and not __cplusplus in some places */
348 # ifndef _LANGUAGE_C_PLUS_PLUS
349 # define _LANGUAGE_C_PLUS_PLUS
350 # endif
351 # endif /* SGI */
352
353 # if defined(sun) || defined(__SUN__)
354 # ifndef __GNUG__
355 # ifndef __SUNCC__
356 # define __SUNCC__
357 # endif /* Sun CC */
358 # endif
359 # endif /* Sun */
360
361 # ifdef __EMX__
362 # define OS2EMX_PLAIN_CHAR
363 # endif
364
365 /* define __HPUX__ for HP-UX where standard macro is __hpux */
366 # if defined(__hpux) && !defined(__HPUX__)
367 # define __HPUX__
368 # endif /* HP-UX */
369
370 # if defined(__CYGWIN__) || defined(__WINE__)
371 # if !defined(wxSIZE_T_IS_UINT)
372 # define wxSIZE_T_IS_UINT
373 # endif
374 # endif
375 #elif defined(applec) || \
376 defined(THINK_C) || \
377 (defined(__MWERKS__) && !defined(__INTEL__))
378 /* MacOS */
379 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
380 # define wxSIZE_T_IS_ULONG
381 # endif
382 #elif defined(__WXMAC__) && defined(__APPLE__)
383 /* Mac OS X */
384 # define __UNIX_LIKE__
385
386 /*
387 These defines are needed when compiling using Project Builder
388 with a non generated setup0.h
389 */
390 # ifndef __UNIX__
391 # define __UNIX__ 1
392 # endif
393 # ifndef __BSD__
394 # define __BSD__ 1
395 # endif
396 # ifndef __DARWIN__
397 # define __DARWIN__ 1
398 # endif
399 # ifndef __POWERPC__
400 # define __POWERPC__ 1
401 # endif
402 # ifndef TARGET_CARBON
403 # define TARGET_CARBON 1
404 # endif
405
406 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
407 # define wxSIZE_T_IS_ULONG
408 # endif
409 /*
410 Some code has been added to workaround defects(?) in the
411 bundled gcc compiler. These corrections are identified by
412 __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
413 */
414 #elif defined(__OS2__)
415
416 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
417 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
418 # ifndef __WXPM__
419 # define __WXPM__
420 # endif
421 # endif
422
423 # if defined(__IBMCPP__)
424 # define __VISAGEAVER__ __IBMCPP__
425 # endif
426
427 /* Place other OS/2 compiler environment defines here */
428 # if defined(__VISAGECPP__)
429 /* VisualAge is the only thing that understands _Optlink */
430 # define LINKAGEMODE _Optlink
431 # endif
432 # define wxSIZE_T_IS_UINT
433
434 #elif defined(__PALMOS__)
435 # ifdef __WIN32__
436 # error "__WIN32__ should not be defined for PalmOS"
437 # endif
438 # ifdef __WINDOWS__
439 # error "__WINDOWS__ should not be defined for PalmOS"
440 # endif
441 # ifdef __WXMSW__
442 # error "__WXMSW__ should not be defined for PalmOS"
443 # endif
444
445 #else /* Windows */
446 # ifndef __WINDOWS__
447 # define __WINDOWS__
448 # endif /* Windows */
449
450 /* to be changed for Win64! */
451 # ifndef __WIN32__
452 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
453 # endif
454
455 /*
456 define another standard symbol for Microsoft Visual C++: the standard
457 one (_MSC_VER) is also defined by Metrowerks compiler
458 */
459 # if defined(_MSC_VER) && !defined(__MWERKS__)
460 # define __VISUALC__ _MSC_VER
461 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
462 # define __BORLANDC__
463 # elif defined(__WATCOMC__)
464 # elif defined(__SC__)
465 # define __SYMANTECC__
466 # endif /* compiler */
467
468 /* size_t is the same as unsigned int for all Windows compilers we know, */
469 /* so define it if it hadn't been done by configure yet */
470 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
471 # define wxSIZE_T_IS_UINT
472 # endif
473 #endif /* OS */
474
475 /*
476 if we're on a Unix system but didn't use configure (so that setup.h didn't
477 define __UNIX__), do define __UNIX__ now
478 */
479 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
480 # define __UNIX__
481 #endif /* Unix */
482
483 #if defined(__WXMOTIF__) || defined(__WXX11__)
484 # define __X__
485 #endif
486
487 #ifdef __SC__
488 # ifdef __DMC__
489 # define __DIGITALMARS__
490 # else
491 # define __SYMANTEC__
492 # endif
493 #endif
494
495 #ifdef __INTEL_COMPILER
496 # define __INTELC__
497 #endif
498
499 /*
500 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
501 from HP-UX standard headers when compiling with g++ without this:
502 */
503 #if defined(__HPUX__) && !defined(__STDC_EXT__)
504 # define __STDC_EXT__ 1
505 #endif
506
507 /* Force linking against required libraries under Windows: */
508 #ifdef __WXWINCE__
509 # include "wx/msw/wince/libraries.h"
510 #elif defined __WINDOWS__
511 # include "wx/msw/libraries.h"
512 #endif
513
514 /*
515 This macro can be used to test the gcc version and can be used like this:
516
517 # if wxCHECK_GCC_VERSION(3, 1)
518 ... we have gcc 3.1 or later ...
519 # else
520 ... no gcc at all or gcc < 3.1 ...
521 # endif
522 */
523 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
524 #define wxCHECK_GCC_VERSION( major, minor ) \
525 ( ( __GNUC__ > (major) ) \
526 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
527 #else
528 #define wxCHECK_GCC_VERSION( major, minor ) 0
529 #endif
530
531 /*
532 This macro can be used to check that the version of mingw32 compiler is
533 at least maj.min
534 */
535 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
536 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
537 wxCHECK_WATCOM_VERSION(1,0) ) && \
538 !defined(__DOS__) && \
539 !defined(__WXPM__) && \
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 # if ( !defined(__MACH__) || ( defined(__BIG_ENDIAN__) && __BIG_ENDIAN__ ) )
558 # define WORDS_BIGENDIAN 1
559 # else
560 # undef WORDS_BIGENDIAN
561 # endif
562 #endif
563
564 /* Choose which method we will use for updating menus
565 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
566 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
567 */
568 #ifndef wxUSE_IDLEMENUUPDATES
569 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
570 # define wxUSE_IDLEMENUUPDATES 0
571 # else
572 # define wxUSE_IDLEMENUUPDATES 1
573 # endif
574 #endif
575
576 /*
577 * Define symbols that are not yet in
578 * configure or possibly some setup.h files.
579 * They will need to be added.
580 */
581
582 #ifndef wxUSE_FILECONFIG
583 # if wxUSE_CONFIG
584 # define wxUSE_FILECONFIG 1
585 # else
586 # define wxUSE_FILECONFIG 0
587 # endif
588 #endif
589
590 #ifndef wxUSE_HOTKEY
591 # define wxUSE_HOTKEY 0
592 #endif
593
594 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
595 # define wxUSE_WXDIB 1
596 #endif
597
598 /*
599 We need AvailabilityMacros.h for ifdefing out things that don't exist on
600 OSX 10.2 and lower
601 FIXME: We need a better way to detect for 10.3 then including a system header
602 */
603 #ifdef __DARWIN__
604 #include <AvailabilityMacros.h>
605 #endif
606
607 #endif /* _WX_PLATFORM_H_ */