X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/eb382f3e5ebe0fcf03dac83e6efb55e710383cc7..c01920998145b5248372a124fdcd53f0ba1582d5:/include/wx/platform.h

diff --git a/include/wx/platform.h b/include/wx/platform.h
index 0471d18605..03ae258679 100644
--- a/include/wx/platform.h
+++ b/include/wx/platform.h
@@ -1,13 +1,13 @@
-/*
- * Name:        wx/platform.h
- * Purpose:     define the OS and compiler identification macros
- * Author:      Vadim Zeitlin
- * Modified by:
- * Created:     29.10.01 (extracted from wx/defs.h)
- * RCS-ID:      $Id$
- * Copyright:   (c) 1997-2001 wxWindows team
- * Licence:     wxWindows licence
- */
+/**
+* Name:        wx/platform.h
+* Purpose:     define the OS and compiler identification macros
+* Author:      Vadim Zeitlin
+* Modified by:
+* Created:     29.10.01 (extracted from wx/defs.h)
+* RCS-ID:      $Id$
+* Copyright:   (c) 1997-2001 wxWidgets team
+* Licence:     wxWindows licence
+*/
 
 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
 
@@ -20,14 +20,37 @@
     are included
 */
 #if __MWERKS__
-    #include <stddef.h>
-    #if defined(WIN32) || defined(_WIN32)
-        #ifndef WINVER
-            #define WINVER  0x0400
-        #endif
-    #endif
+#    include <stddef.h>
+#endif
+
+/*
+    WXMAC variants
+    __WXMAC_CLASSIC__ means ppc non-carbon builds, __WXMAC_CARBON__ means
+    carbon API available (mach or cfm builds) , __WXMAC_OSX__ means mach-o
+    builds, running under 10.2 + only
+*/
+#ifdef __WXMAC__
+#    if defined(__MACH__)
+#        define __WXMAC_OSX__
+#        define __WXMAC_CARBON__
+#        ifdef __WXMAC_XCODE__
+#            include "wx/mac/carbon/config_xcode.h"
+#        endif
+#    else
+#        if TARGET_CARBON
+#            define __WXMAC_CARBON__
+#        else
+#            define __WXMAC_CLASSIC__
+#        endif
+#    endif
 #endif
 
+/*
+    __WXOSX__ is a common define to wxMac (Carbon) and wxCocoa ports under OS X.
+ */
+#if defined(__WXMAC_OSX__) || defined(__WXCOCOA__)
+#   define __WXOSX__
+#endif
 
 /*
    first define Windows symbols if they're not defined on the command line: we
@@ -36,46 +59,149 @@
 #if defined(__CYGWIN32__) && !defined(__WXMOTIF__) && !defined(__WXGTK__) \
     && !defined(__WXX11__)
     /* for Cygwin, default to wxMSW unless otherwise specified */
-    #ifndef __WXMSW__
-        #define __WXMSW__
-    #endif
+#    ifndef __WXMSW__
+#        define __WXMSW__
+#    endif
 
-    #ifndef _WIN32
-        #define _WIN32
-    #endif
+#    ifndef _WIN32
+#        define _WIN32
+#    endif
 
-    #ifndef WIN32
-        #define WIN32
-    #endif
+#    ifndef WIN32
+#        define WIN32
+#    endif
 #endif
 
-#if defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)
-    #ifndef __WXMSW__
-        #define __WXMSW__
-    #endif
+#if defined(_WIN64)
+#    ifndef _WIN32
+        /*
+            a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
+            Windows or to test for !__WIN16__, so we must define _WIN32 for
+            Win64 as well to ensure that the existing code continues to work.
+         */
+#       define _WIN32
+#   endif /* !_WIN32 */
+
+#   ifndef __WIN64__
+#       define __WIN64__
+#   endif /* !__WIN64__ */
+#endif /* _WIN64 */
+
+#if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
+    && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
+#    ifndef __WXMSW__
+#        define __WXMSW__
+#    endif
+
+#    ifndef __WIN32__
+#        define __WIN32__
+#    endif
 
-    #ifndef __WIN32__
-        #define __WIN32__
-    #endif
+    /*
+        The library user may override the default setting of WINVER by defining
+        it in his own makefile or project file -- if it is defined, we don't
+        touch it at all.
+
+        It makes sense to define WINVER as:
+            - either some lowish value (e.g. 0x0302) to not even compile in the
+              features not available in Windows version lower than some given
+              one
+            - or to a higher value than the one used by default for the given
+              compiler if you updated its headers to newer version of Platform
+              SDK, e.g. VC6 ships with 0x0400 headers by default but may also
+              work with 0x0500 headers and beyond
+    */
+#   ifndef WINVER
+#       if defined(_MSC_VER) && _MSC_VER < 1300
+            /*
+                VC6 defines some stuff in its default headers which is normally
+                only present if WINVER >= 0x0500 (FLASHW_XXX constants) which
+                means that our usual tests not involving WINVER sometimes fail
+                with it, hence explicitly define a lower WINVER value for it.
+             */
+#           define WINVER 0x0400
+#       elif defined(__DMC__)
+            /*
+                Digital Mars is distributed with a little outdated headers.
+             */
+#           define WINVER 0x0400
+#       else /* !VC++ 6 */
+            /*
+               see MSDN for the description of possible WINVER values, this one
+               is the highest one defined right now (Windows Server 2003) and
+               we use it unless it was explicitly overridden by the user to
+               disable recent features support as we check for all of the
+               features we use which could be not available on earlier Windows
+               systems during run-time anyhow, so there is almost no
+               disadvantage in using it.
+             */
+#           define WINVER 0x0502
+#       endif /* VC++ 6/!VC++6 */
+#   endif
 
     /* Win95 means Win95-style UI, i.e. Win9x/NT 4+ */
-    #if !defined(__WIN95__) && defined(WINVER) && (WINVER >= 0x0400)
-        #define __WIN95__
-    #endif
+#    if !defined(__WIN95__) && (WINVER >= 0x0400)
+#        define __WIN95__
+#    endif
 #endif /* Win32 */
 
 #if defined(__WXMSW__) || defined(__WIN32__)
-    #if !defined(__WINDOWS__)
-        #define __WINDOWS__
-    #endif
+#   if !defined(__WINDOWS__)
+#       define __WINDOWS__
+#   endif
 #endif
 
 #ifdef __WINE__
-    #ifndef __WIN95__
-        #define __WIN95__
-    #endif
+#   ifndef __WIN95__
+#       define __WIN95__
+#   endif
 #endif /* WINE */
 
+/* detect MS SmartPhone */
+#if defined( WIN32_PLATFORM_WFSP )
+#   ifndef __SMARTPHONE__
+#       define __SMARTPHONE__
+#   endif
+#   ifndef __WXWINCE__
+#       define __WXWINCE__
+#   endif
+#endif
+
+/* detect PocketPC */
+#if defined( WIN32_PLATFORM_PSPC )
+#   ifndef __POCKETPC__
+#       define __POCKETPC__
+#   endif
+#   ifndef __WXWINCE__
+#       define __WXWINCE__
+#   endif
+#endif
+
+/* detect Standard WinCE SDK */
+#if defined( WCE_PLATFORM_STANDARDSDK )
+#   ifndef __WINCE_STANDARDSDK__
+#       define __WINCE_STANDARDSDK__
+#   endif
+#   ifndef __WXWINCE__
+#       define __WXWINCE__
+#   endif
+#endif
+
+#if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
+#   if (_WIN32_WCE >= 400)
+#       ifndef __WINCE_NET__
+#           define __WINCE_NET__
+#       endif
+#   elif (_WIN32_WCE >= 200)
+#       ifndef __HANDHELDPC__
+#           define __HANDHELDPC__
+#       endif
+#   endif
+#   ifndef __WXWINCE__
+#       define __WXWINCE__
+#   endif
+#endif
+
 /*
    Include wx/setup.h for the Unix platform defines generated by configure and
    the library compilation options
@@ -86,13 +212,50 @@
 #include "wx/chkconf.h"
 
 /*
-   some compilers don't support iostream.h any longer, so override the users
-   setting here in such case.
+   adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
+   and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
+   the system headers so bring these settings in sync
+ */
+
+/* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
+#if defined(_UNICODE) || defined(UNICODE)
+#   undef wxUSE_UNICODE
+#   define wxUSE_UNICODE 1
+#else /* !UNICODE */
+#   ifndef wxUSE_UNICODE
+#       define wxUSE_UNICODE 0
+#   endif
+#endif /* UNICODE/!UNICODE */
+
+/* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
+#if wxUSE_UNICODE
+#   ifndef _UNICODE
+#       define _UNICODE
+#   endif
+#   ifndef UNICODE
+#       define UNICODE
+#   endif
+#endif /* wxUSE_UNICODE */
+
+#if defined( __MWERKS__ ) && !defined(__INTEL__)
+// otherwise MSL headers bring in WIN32 dependant APIs
+#undef UNICODE
+#endif
+/*
+   some compilers don't support iostream.h any longer, while some of theme
+   are not updated with <iostream> yet, so override the users setting here
+   in such case.
  */
 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
-    #undef wxUSE_IOSTREAMH
-    #define wxUSE_IOSTREAMH 0
-#endif /* compilers not supporting iostream.h */
+#    undef wxUSE_IOSTREAMH
+#    define wxUSE_IOSTREAMH 0
+#elif defined(__DMC__) || defined(__WATCOMC__)
+#    undef wxUSE_IOSTREAMH
+#    define wxUSE_IOSTREAMH 1
+#elif defined(__MINGW32__)
+#    undef wxUSE_IOSTREAMH
+#    define wxUSE_IOSTREAMH 0
+#endif /* compilers with/without iostream.h */
 
 /*
    old C++ headers (like <iostream.h>) declare classes in the global namespace
@@ -102,9 +265,9 @@
    either case
  */
 #if !wxUSE_IOSTREAMH
-    #define wxSTD std::
+#    define wxSTD std::
 #else
-    #define wxSTD
+#    define wxSTD
 #endif
 
 /*
@@ -112,19 +275,19 @@
        for Unix, because DJGPP compiler defines __unix__ under MS-DOS
  */
 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
-    #ifndef __DOS__
-        #define __DOS__
-    #endif
+#    ifndef __DOS__
+#        define __DOS__
+#    endif
     /* size_t is the same as unsigned int for Watcom 11 compiler, */
     /* so define it if it hadn't been done by configure yet */
-    #if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
-        #ifdef __WATCOMC__
-            #define wxSIZE_T_IS_UINT
-        #endif
-        #ifdef __DJGPP__
-            #define wxSIZE_T_IS_ULONG
-        #endif
-    #endif
+#    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
+#        ifdef __WATCOMC__
+#            define wxSIZE_T_IS_UINT
+#        endif
+#        ifdef __DJGPP__
+#            define wxSIZE_T_IS_ULONG
+#        endif
+#    endif
 
 /*
    OS: then test for generic Unix defines, then for particular flavours and
@@ -135,128 +298,128 @@
       defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
       defined(__EMX__) || defined(__VMS) || defined(__BEOS__)
 
-    #define __UNIX_LIKE__
+#    define __UNIX_LIKE__
 
     /* Helps SGI compilation, apparently */
-    #ifdef __SGI__
-        #ifdef __GNUG__
-            #define __need_wchar_t
-        #else /* !gcc */
+#    ifdef __SGI__
+#        ifdef __GNUG__
+#            define __need_wchar_t
+#        else /* !gcc */
             /*
                Note I use the term __SGI_CC__ for both cc and CC, its not a good
                idea to mix gcc and cc/CC, the name mangling is different
              */
-            #define __SGI_CC__
-        #endif /* gcc/!gcc */
-    #endif  /* SGI */
-
-    #if defined(sun) || defined(__SUN__)
-        #ifndef __GNUG__
-            #ifndef __SUNCC__
-                #define __SUNCC__
-            #endif /* Sun CC */
-        #endif
-    #endif /* Sun */
-
-    #ifdef __EMX__
-        #define OS2EMX_PLAIN_CHAR
-    #endif
+#            define __SGI_CC__
+#        endif /* gcc/!gcc */
+#    endif  /* SGI */
+
+#    if defined(sun) || defined(__SUN__)
+#        ifndef __GNUG__
+#            ifndef __SUNCC__
+#                define __SUNCC__
+#            endif /* Sun CC */
+#        endif
+#    endif /* Sun */
+
+#    ifdef __EMX__
+#        define OS2EMX_PLAIN_CHAR
+#    endif
 
     /* define __HPUX__ for HP-UX where standard macro is __hpux */
-    #if defined(__hpux) && !defined(__HPUX__)
-        #define __HPUX__
-    #endif /* HP-UX */
-
-    #if defined(__CYGWIN__) || defined(__WINE__)
-        #if !defined(wxSIZE_T_IS_UINT)
-            #define wxSIZE_T_IS_UINT
-        #endif
-    #endif
+#    if defined(__hpux) && !defined(__HPUX__)
+#        define __HPUX__
+#    endif /* HP-UX */
+
+#    if defined(__CYGWIN__) || defined(__WINE__)
+#        if !defined(wxSIZE_T_IS_UINT)
+#            define wxSIZE_T_IS_UINT
+#        endif
+#    endif
 #elif defined(applec) || \
       defined(THINK_C) || \
       (defined(__MWERKS__) && !defined(__INTEL__))
       /* MacOS */
-    #if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
-        #define wxSIZE_T_IS_ULONG
-    #endif
+#    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
+#        define wxSIZE_T_IS_ULONG
+#    endif
 #elif defined(__WXMAC__) && defined(__APPLE__)
     /* Mac OS X */
-    #define __UNIX_LIKE__
+#    define __UNIX_LIKE__
 
     /*
       These defines are needed when compiling using Project Builder
       with a non generated setup0.h
     */
-    #ifndef __UNIX__
-        #define __UNIX__ 1
-    #endif
-    #ifndef __BSD__
-        #define __BSD__ 1
-    #endif
-    #ifndef __DARWIN__
-        #define __DARWIN__ 1
-    #endif
-    #ifndef __POWERPC__
-        #define __POWERPC__ 1
-    #endif
-    #ifndef TARGET_CARBON
-        #define TARGET_CARBON 1
-    #endif
-
-    #if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
-        #define wxSIZE_T_IS_ULONG
-    #endif
+#    ifndef __UNIX__
+#        define __UNIX__ 1
+#    endif
+#    ifndef __BSD__
+#        define __BSD__ 1
+#    endif
+#    ifndef __DARWIN__
+#        define __DARWIN__ 1
+#    endif
+#    ifndef __POWERPC__
+#        define __POWERPC__ 1
+#    endif
+#    ifndef TARGET_CARBON
+#        define TARGET_CARBON 1
+#    endif
+
+#    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
+#        define wxSIZE_T_IS_ULONG
+#    endif
     /*
        Some code has been added to workaround defects(?) in the
        bundled gcc compiler. These corrections are identified by
        __DARWIN__ for Darwin related corrections (wxMac, wxMotif)
      */
 #elif defined(__OS2__)
-    #if defined(__IBMCPP__)
-        #define __VISAGEAVER__ __IBMCPP__
-    #endif
-    #ifndef __WXOS2__
-        #define __WXOS2__
-    #endif
-    #ifndef __WXPM__
-        #define __WXPM__
-    #endif
+#    if defined(__IBMCPP__)
+#        define __VISAGEAVER__ __IBMCPP__
+#    endif
+#    ifndef __WXOS2__
+#        define __WXOS2__
+#    endif
+#    ifndef __WXPM__
+#        define __WXPM__
+#    endif
 
     /* Place other OS/2 compiler environment defines here */
-    #if defined(__VISAGECPP__)
+#    if defined(__VISAGECPP__)
         /* VisualAge is the only thing that understands _Optlink */
-        #define LINKAGEMODE _Optlink
-    #endif
-    #define wxSIZE_T_IS_UINT
+#        define LINKAGEMODE _Optlink
+#    endif
+#    define wxSIZE_T_IS_UINT
 
 #else   /* Windows */
-    #ifndef __WINDOWS__
-        #define __WINDOWS__
-    #endif  /* Windows */
+#    ifndef __WINDOWS__
+#        define __WINDOWS__
+#    endif  /* Windows */
 
     /* to be changed for Win64! */
-    #ifndef __WIN32__
-        #define __WIN16__
-    #endif
+#    ifndef __WIN32__
+#        error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
+#    endif
 
     /*
        define another standard symbol for Microsoft Visual C++: the standard
        one (_MSC_VER) is also defined by Metrowerks compiler
      */
-    #if defined(_MSC_VER) && !defined(__MWERKS__)
-        #define __VISUALC__ _MSC_VER
-    #elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
-        #define __BORLANDC__
-      #elif defined(__WATCOMC__)
-    #elif defined(__SC__)
-        #define __SYMANTECC__
-    #endif  /* compiler */
+#    if defined(_MSC_VER) && !defined(__MWERKS__)
+#        define __VISUALC__ _MSC_VER
+#    elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
+#        define __BORLANDC__
+#      elif defined(__WATCOMC__)
+#    elif defined(__SC__)
+#        define __SYMANTECC__
+#    endif  /* compiler */
 
     /* size_t is the same as unsigned int for all Windows compilers we know, */
     /* so define it if it hadn't been done by configure yet */
-    #if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
-        #define wxSIZE_T_IS_UINT
-    #endif
+#    if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
+#        define wxSIZE_T_IS_UINT
+#    endif
 #endif  /* OS */
 
 /*
@@ -264,27 +427,34 @@
    define __UNIX__), do define __UNIX__ now
  */
 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
-    #define __UNIX__
+#    define __UNIX__
 #endif /* Unix */
 
-#if defined(__HPUX__) && !defined(__WXGTK__)
-    #ifndef __WXMOTIF__
-        #define __WXMOTIF__
-    #endif /* __WXMOTIF__ */
+#if defined(__WXMOTIF__) || defined(__WXX11__)
+#    define __X__
 #endif
 
-#if defined(__WXMOTIF__) || defined(__WXX11__)
-    #define __X__
+#ifdef __SC__
+#    ifdef __DMC__
+#         define __DIGITALMARS__
+#    else
+#         define __SYMANTEC__
+#    endif
+#endif
+
+/* Force linking against required libraries under Windows CE: */
+#ifdef __WXWINCE__
+#   include "wx/msw/wince/libraries.h"
 #endif
 
 /*
    This macro can be used to test the gcc version and can be used like this:
 
-    #if wxCHECK_GCC_VERSION(3, 1)
+#    if wxCHECK_GCC_VERSION(3, 1)
         ... we have gcc 3.1 or later ...
-    #else
+#    else
         ... no gcc at all or gcc < 3.1 ...
-    #endif
+#    endif
 */
 #define wxCHECK_GCC_VERSION( major, minor ) \
     ( defined(__GNUC__) && defined(__GNUC_MINOR__) \
@@ -295,25 +465,71 @@
    This macro can be used to check that the version of mingw32 compiler is
    at least maj.min
  */
-#if defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || defined( __CYGWIN__ )
-    #include "wx/msw/gccpriv.h"
+#if defined(__PALMOS__)
+#    include "wx/palmos/gccpriv.h"
+#elif ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
+    defined( __CYGWIN__ ) || \
+      (defined(__WATCOMC__) && __WATCOMC__ >= 1200) ) && \
+    !defined(__DOS__) && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
+#    include "wx/msw/gccpriv.h"
 #else
-    #undef wxCHECK_W32API_VERSION
-    #define wxCHECK_W32API_VERSION(maj, min) (0)
+#    undef wxCHECK_W32API_VERSION
+#    define wxCHECK_W32API_VERSION(maj, min) (0)
 #endif
 
-#ifdef __SC__
-    #ifdef __DMC__
-         #define __DIGITALMARS__
-    #else
-         #define __SYMANTEC__
-    #endif
+#if defined (__WXMSW__)
+#    if !defined(__WATCOMC__)
+#        define wxHAVE_RAW_BITMAP
+#    endif
 #endif
 
-#if defined (__WXMSW__)
-    #if !defined(__WATCOMC__)
-        #define wxHAVE_RAW_BITMAP
-    #endif
+#if defined (__WXMAC__)
+#    ifndef WORDS_BIGENDIAN
+#        define WORDS_BIGENDIAN 1
+#    endif
+#endif
+
+/* Choose which method we will use for updating menus
+ * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
+ * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
+ */
+#ifndef wxUSE_IDLEMENUUPDATES
+#    if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
+#        define wxUSE_IDLEMENUUPDATES 0
+#    else
+#        define wxUSE_IDLEMENUUPDATES 1
+#    endif
+#endif
+
+/*
+ * Define symbols that are not yet in
+ * configure or possibly some setup.h files.
+ * They will need to be added.
+ */
+
+#ifndef wxUSE_FILECONFIG
+#    if wxUSE_CONFIG
+#        define wxUSE_FILECONFIG 1
+#    else
+#        define wxUSE_FILECONFIG 0
+#    endif
+#endif
+
+#ifndef wxUSE_HOTKEY
+#    define wxUSE_HOTKEY 0
+#endif
+
+#if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
+#    define wxUSE_WXDIB 1
+#endif
+
+/*
+    We need AvailabilityMacros.h for ifdefing out things that don't exist on 
+    OSX 10.2 and lower
+    FIXME:  We need a better way to detect for 10.3 then including a system header
+*/
+#ifdef __DARWIN__
+    #include <AvailabilityMacros.h>
 #endif
 
 #endif /* _WX_PLATFORM_H_ */