include/wx/dlimpexp.h

   1 /*
   2  * Name:        wx/dlimpexp.h
   3  * Purpose:     Macros for declaring DLL-imported/exported functions
   4  * Author:      Vadim Zeitlin
   5  * Modified by:
   6  * Created:     16.10.2003 (extracted from wx/defs.h)
   7  * RCS-ID:      $Id$
   8  * Copyright:   (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
   9  * Licence:     wxWindows licence
  10  */
  11
  12 /*
  13     This is a C file, not C++ one, do not use C++ comments here!
  14  */
  15
  16 #ifndef _WX_DLIMPEXP_H_
  17 #define _WX_DLIMPEXP_H_
  18
  19 #if defined(HAVE_VISIBILITY)
  20 #    define WXEXPORT __attribute__ ((visibility("default")))
  21 #    define WXIMPORT __attribute__ ((visibility("default")))
  22 #elif defined(__WINDOWS__)
  23     /*
  24        __declspec works in BC++ 5 and later, Watcom C++ 11.0 and later as well
  25        as VC++ and gcc
  26      */
  27 #    if defined(__VISUALC__) || defined(__BORLANDC__) || defined(__GNUC__) || defined(__WATCOMC__)
  28 #        define WXEXPORT __declspec(dllexport)
  29 #        define WXIMPORT __declspec(dllimport)
  30 #    else /* compiler doesn't support __declspec() */
  31 #        define WXEXPORT
  32 #        define WXIMPORT
  33 #    endif
  34 #elif defined(__WXPM__)
  35 #    if defined (__WATCOMC__)
  36 #        define WXEXPORT __declspec(dllexport)
  37         /*
  38            __declspec(dllimport) prepends __imp to imported symbols. We do NOT
  39            want that!
  40          */
  41 #        define WXIMPORT
  42 #    elif defined(__EMX__)
  43 #        define WXEXPORT
  44 #        define WXIMPORT
  45 #    elif (!(defined(__VISAGECPP__) && (__IBMCPP__ < 400 || __IBMC__ < 400 )))
  46 #        define WXEXPORT _Export
  47 #        define WXIMPORT _Export
  48 #    endif
  49 #elif defined(__WXMAC__) || defined(__WXCOCOA__)
  50 #    ifdef __MWERKS__
  51 #        define WXEXPORT __declspec(export)
  52 #        define WXIMPORT __declspec(import)
  53 #    endif
  54 #elif defined(__CYGWIN__)
  55 #    define WXEXPORT __declspec(dllexport)
  56 #    define WXIMPORT __declspec(dllimport)
  57 #endif
  58
  59 /* for other platforms/compilers we don't anything */
  60 #ifndef WXEXPORT
  61 #    define WXEXPORT
  62 #    define WXIMPORT
  63 #endif
  64
  65 /*
  66    We support building wxWidgets as a set of several libraries but we don't
  67    support arbitrary combinations of libs/DLLs: either we build all of them as
  68    DLLs (in which case WXMAKINGDLL is defined) or none (it isn't).
  69
  70    However we have a problem because we need separate WXDLLIMPEXP versions for
  71    different libraries as, for example, wxString class should be dllexported
  72    when compiled in wxBase and dllimported otherwise, so we do define separate
  73    WXMAKING/USINGDLL_XYZ constants for each component XYZ.
  74  */
  75 #ifdef WXMAKINGDLL
  76 #    if wxUSE_BASE
  77 #        define WXMAKINGDLL_BASE
  78 #    endif
  79
  80 #    define WXMAKINGDLL_NET
  81 #    define WXMAKINGDLL_CORE
  82 #    define WXMAKINGDLL_ADV
  83 #    define WXMAKINGDLL_QA
  84 #    define WXMAKINGDLL_HTML
  85 #    define WXMAKINGDLL_GL
  86 #    define WXMAKINGDLL_XML
  87 #    define WXMAKINGDLL_XRC
  88 #    define WXMAKINGDLL_AUI
  89 #    define WXMAKINGDLL_PROPGRID
  90 #    define WXMAKINGDLL_RICHTEXT
  91 #    define WXMAKINGDLL_MEDIA
  92 #    define WXMAKINGDLL_STC
  93 #endif /* WXMAKINGDLL */
  94
  95 /*
  96    WXDLLIMPEXP_CORE maps to export declaration when building the DLL, to import
  97    declaration if using it or to nothing at all if we don't use wxWin as DLL
  98  */
  99 #ifdef WXMAKINGDLL_BASE
 100 #    define WXDLLIMPEXP_BASE WXEXPORT
 101 #    define WXDLLIMPEXP_DATA_BASE(type) WXEXPORT type
 102 #    if defined(HAVE_VISIBILITY)
 103 #        define WXDLLIMPEXP_INLINE_BASE WXEXPORT
 104 #    else
 105 #        define WXDLLIMPEXP_INLINE_BASE
 106 #    endif
 107 #elif defined(WXUSINGDLL)
 108 #    define WXDLLIMPEXP_BASE WXIMPORT
 109 #    define WXDLLIMPEXP_DATA_BASE(type) WXIMPORT type
 110 #    if defined(HAVE_VISIBILITY)
 111 #        define WXDLLIMPEXP_INLINE_BASE WXIMPORT
 112 #    else
 113 #        define WXDLLIMPEXP_INLINE_BASE
 114 #    endif
 115 #else /* not making nor using DLL */
 116 #    define WXDLLIMPEXP_BASE
 117 #    define WXDLLIMPEXP_DATA_BASE(type) type
 118 #    define WXDLLIMPEXP_INLINE_BASE
 119 #endif
 120
 121 #ifdef WXMAKINGDLL_NET
 122 #    define WXDLLIMPEXP_NET WXEXPORT
 123 #    define WXDLLIMPEXP_DATA_NET(type) WXEXPORT type
 124 #elif defined(WXUSINGDLL)
 125 #    define WXDLLIMPEXP_NET WXIMPORT
 126 #    define WXDLLIMPEXP_DATA_NET(type) WXIMPORT type
 127 #else /* not making nor using DLL */
 128 #    define WXDLLIMPEXP_NET
 129 #    define WXDLLIMPEXP_DATA_NET(type) type
 130 #endif
 131
 132 #ifdef WXMAKINGDLL_CORE
 133 #    define WXDLLIMPEXP_CORE WXEXPORT
 134 #    define WXDLLIMPEXP_DATA_CORE(type) WXEXPORT type
 135 #elif defined(WXUSINGDLL)
 136 #    define WXDLLIMPEXP_CORE WXIMPORT
 137 #    define WXDLLIMPEXP_DATA_CORE(type) WXIMPORT type
 138 #else /* not making nor using DLL */
 139 #    define WXDLLIMPEXP_CORE
 140 #    define WXDLLIMPEXP_DATA_CORE(type) type
 141 #endif
 142
 143 #ifdef WXMAKINGDLL_ADV
 144 #    define WXDLLIMPEXP_ADV WXEXPORT
 145 #    define WXDLLIMPEXP_DATA_ADV(type) WXEXPORT type
 146 #elif defined(WXUSINGDLL)
 147 #    define WXDLLIMPEXP_ADV WXIMPORT
 148 #    define WXDLLIMPEXP_DATA_ADV(type) WXIMPORT type
 149 #else /* not making nor using DLL */
 150 #    define WXDLLIMPEXP_ADV
 151 #    define WXDLLIMPEXP_DATA_ADV(type) type
 152 #endif
 153
 154 #ifdef WXMAKINGDLL_QA
 155 #    define WXDLLIMPEXP_QA WXEXPORT
 156 #    define WXDLLIMPEXP_DATA_QA(type) WXEXPORT type
 157 #elif defined(WXUSINGDLL)
 158 #    define WXDLLIMPEXP_QA WXIMPORT
 159 #    define WXDLLIMPEXP_DATA_QA(type) WXIMPORT type
 160 #else /* not making nor using DLL */
 161 #    define WXDLLIMPEXP_QA
 162 #    define WXDLLIMPEXP_DATA_QA(type) type
 163 #endif
 164
 165 #ifdef WXMAKINGDLL_HTML
 166 #    define WXDLLIMPEXP_HTML WXEXPORT
 167 #    define WXDLLIMPEXP_DATA_HTML(type) WXEXPORT type
 168 #elif defined(WXUSINGDLL)
 169 #    define WXDLLIMPEXP_HTML WXIMPORT
 170 #    define WXDLLIMPEXP_DATA_HTML(type) WXIMPORT type
 171 #else /* not making nor using DLL */
 172 #    define WXDLLIMPEXP_HTML
 173 #    define WXDLLIMPEXP_DATA_HTML(type) type
 174 #endif
 175
 176 #ifdef WXMAKINGDLL_GL
 177 #    define WXDLLIMPEXP_GL WXEXPORT
 178 #elif defined(WXUSINGDLL)
 179 #    define WXDLLIMPEXP_GL WXIMPORT
 180 #else /* not making nor using DLL */
 181 #    define WXDLLIMPEXP_GL
 182 #endif
 183
 184 #ifdef WXMAKINGDLL_XML
 185 #    define WXDLLIMPEXP_XML WXEXPORT
 186 #elif defined(WXUSINGDLL)
 187 #    define WXDLLIMPEXP_XML WXIMPORT
 188 #else /* not making nor using DLL */
 189 #    define WXDLLIMPEXP_XML
 190 #endif
 191
 192 #ifdef WXMAKINGDLL_XRC
 193 #    define WXDLLIMPEXP_XRC WXEXPORT
 194 #elif defined(WXUSINGDLL)
 195 #    define WXDLLIMPEXP_XRC WXIMPORT
 196 #else /* not making nor using DLL */
 197 #    define WXDLLIMPEXP_XRC
 198 #endif
 199
 200 #ifdef WXMAKINGDLL_AUI
 201 #    define WXDLLIMPEXP_AUI WXEXPORT
 202 #elif defined(WXUSINGDLL)
 203 #    define WXDLLIMPEXP_AUI WXIMPORT
 204 #else /* not making nor using DLL */
 205 #    define WXDLLIMPEXP_AUI
 206 #endif
 207
 208 #ifdef WXMAKINGDLL_PROPGRID
 209 #    define WXDLLIMPEXP_PROPGRID WXEXPORT
 210 #elif defined(WXUSINGDLL)
 211 #    define WXDLLIMPEXP_PROPGRID WXIMPORT
 212 #else /* not making nor using DLL */
 213 #    define WXDLLIMPEXP_PROPGRID
 214 #endif
 215
 216 #ifdef WXMAKINGDLL_RICHTEXT
 217 #    define WXDLLIMPEXP_RICHTEXT WXEXPORT
 218 #elif defined(WXUSINGDLL)
 219 #    define WXDLLIMPEXP_RICHTEXT WXIMPORT
 220 #else /* not making nor using DLL */
 221 #    define WXDLLIMPEXP_RICHTEXT
 222 #endif
 223
 224 #ifdef WXMAKINGDLL_MEDIA
 225 #    define WXDLLIMPEXP_MEDIA WXEXPORT
 226 #elif defined(WXUSINGDLL)
 227 #    define WXDLLIMPEXP_MEDIA WXIMPORT
 228 #else /* not making nor using DLL */
 229 #    define WXDLLIMPEXP_MEDIA
 230 #endif
 231
 232 #ifdef WXMAKINGDLL_STC
 233     #define WXDLLIMPEXP_STC WXEXPORT
 234 #elif defined(WXUSINGDLL)
 235     #define WXDLLIMPEXP_STC WXIMPORT
 236 #else /* not making nor using DLL */
 237     #define WXDLLIMPEXP_STC
 238 #endif
 239
 240 /*
 241    GCC warns about using __attribute__ (and also __declspec in mingw32 case) on
 242    forward declarations while MSVC complains about forward declarations without
 243    __declspec for the classes later declared with it, so we need a separate set
 244    of macros for forward declarations to hide this difference:
 245  */
 246 #if defined(HAVE_VISIBILITY) || (defined(__WINDOWS__) && defined(__GNUC__))
 247     #define WXDLLIMPEXP_FWD_BASE
 248     #define WXDLLIMPEXP_FWD_NET
 249     #define WXDLLIMPEXP_FWD_CORE
 250     #define WXDLLIMPEXP_FWD_ADV
 251     #define WXDLLIMPEXP_FWD_QA
 252     #define WXDLLIMPEXP_FWD_HTML
 253     #define WXDLLIMPEXP_FWD_GL
 254     #define WXDLLIMPEXP_FWD_XML
 255     #define WXDLLIMPEXP_FWD_XRC
 256     #define WXDLLIMPEXP_FWD_AUI
 257     #define WXDLLIMPEXP_FWD_PROPGRID
 258     #define WXDLLIMPEXP_FWD_RICHTEXT
 259     #define WXDLLIMPEXP_FWD_MEDIA
 260     #define WXDLLIMPEXP_FWD_STC
 261 #else
 262     #define WXDLLIMPEXP_FWD_BASE      WXDLLIMPEXP_BASE
 263     #define WXDLLIMPEXP_FWD_NET       WXDLLIMPEXP_NET
 264     #define WXDLLIMPEXP_FWD_CORE      WXDLLIMPEXP_CORE
 265     #define WXDLLIMPEXP_FWD_ADV       WXDLLIMPEXP_ADV
 266     #define WXDLLIMPEXP_FWD_QA        WXDLLIMPEXP_QA
 267     #define WXDLLIMPEXP_FWD_HTML      WXDLLIMPEXP_HTML
 268     #define WXDLLIMPEXP_FWD_GL        WXDLLIMPEXP_GL
 269     #define WXDLLIMPEXP_FWD_XML       WXDLLIMPEXP_XML
 270     #define WXDLLIMPEXP_FWD_XRC       WXDLLIMPEXP_XRC
 271     #define WXDLLIMPEXP_FWD_AUI       WXDLLIMPEXP_AUI
 272     #define WXDLLIMPEXP_FWD_PROPGRID  WXDLLIMPEXP_PROPGRID
 273     #define WXDLLIMPEXP_FWD_RICHTEXT  WXDLLIMPEXP_RICHTEXT
 274     #define WXDLLIMPEXP_FWD_MEDIA     WXDLLIMPEXP_MEDIA
 275     #define WXDLLIMPEXP_FWD_STC       WXDLLIMPEXP_STC
 276 #endif
 277
 278 /* for backwards compatibility, define suffix-less versions too */
 279 #define WXDLLEXPORT WXDLLIMPEXP_CORE
 280 #define WXDLLEXPORT_DATA WXDLLIMPEXP_DATA_CORE
 281
 282 /*
 283    MSVC up to 6.0 needs to be explicitly told to export template instantiations
 284    used by the DLL clients, use this macro to do it like this:
 285
 286        template <typename T> class Foo { ... };
 287        WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE( Foo<int> )
 288
 289    (notice that currently we only need this for wxBase and wxCore libraries)
 290  */
 291 #if defined(__VISUALC__) && (__VISUALC__ <= 1200)
 292     #ifdef WXMAKINGDLL_BASE
 293         #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
 294             template class WXDLLIMPEXP_BASE decl;
 295         #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl) \
 296             template class WXDLLIMPEXP_CORE decl;
 297     #else
 298         /*
 299            We need to disable this warning when using this macro, as
 300            recommended by Microsoft itself:
 301
 302            http://support.microsoft.com/default.aspx?scid=kb%3ben-us%3b168958
 303          */
 304         #pragma warning(disable:4231)
 305
 306         #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
 307             extern template class WXDLLIMPEXP_BASE decl;
 308         #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl) \
 309             extern template class WXDLLIMPEXP_CORE decl;
 310     #endif
 311 #else /* not VC <= 6 */
 312     #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl)
 313     #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl)
 314 #endif /* VC6/others */
 315
 316 #endif /* _WX_DLIMPEXP_H_ */
 317