]> git.saurik.com Git - wxWidgets.git/blame - include/wx/dlimpexp.h
Increase version to 2.9.5.
[wxWidgets.git] / include / wx / dlimpexp.h
CommitLineData
0cc66b6c
VZ
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$
77ffb593 8 * Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
65571936 9 * Licence: wxWindows licence
0cc66b6c
VZ
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
b9d4eff6
VS
19#if defined(HAVE_VISIBILITY)
20# define WXEXPORT __attribute__ ((visibility("default")))
21# define WXIMPORT __attribute__ ((visibility("default")))
22#elif defined(__WINDOWS__)
0cc66b6c
VZ
23 /*
24 __declspec works in BC++ 5 and later, Watcom C++ 11.0 and later as well
49d2c0ad 25 as VC++.
0cc66b6c 26 */
49d2c0ad 27# if defined(__VISUALC__) || defined(__BORLANDC__) || defined(__WATCOMC__)
0cc66b6c
VZ
28# define WXEXPORT __declspec(dllexport)
29# define WXIMPORT __declspec(dllimport)
49d2c0ad
VZ
30 /*
31 While gcc also supports __declspec(dllexport), it creates unusably huge
32 DLL files since gcc 4.5 (while taking horribly long amounts of time),
33 see http://gcc.gnu.org/bugzilla/show_bug.cgi?id=43601. Because of this
34 we rely on binutils auto export/import support which seems to work
35 quite well for 4.5+.
36 */
37# elif defined(__GNUC__) && !wxCHECK_GCC_VERSION(4, 5)
38 /*
39 __declspec could be used here too but let's use the native
40 __attribute__ instead for clarity.
41 */
42# define WXEXPORT __attribute__((dllexport))
43# define WXIMPORT __attribute__((dllimport))
0cc66b6c
VZ
44# endif
45#elif defined(__WXPM__)
46# if defined (__WATCOMC__)
47# define WXEXPORT __declspec(dllexport)
48 /*
49 __declspec(dllimport) prepends __imp to imported symbols. We do NOT
50 want that!
51 */
52# define WXIMPORT
fd928524
DW
53# elif defined(__EMX__)
54# define WXEXPORT
55# define WXIMPORT
0cc66b6c
VZ
56# elif (!(defined(__VISAGECPP__) && (__IBMCPP__ < 400 || __IBMC__ < 400 )))
57# define WXEXPORT _Export
58# define WXIMPORT _Export
59# endif
7275146d
MW
60#elif defined(__CYGWIN__)
61# define WXEXPORT __declspec(dllexport)
62# define WXIMPORT __declspec(dllimport)
0cc66b6c
VZ
63#endif
64
65/* for other platforms/compilers we don't anything */
66#ifndef WXEXPORT
67# define WXEXPORT
68# define WXIMPORT
69#endif
70
71/*
77ffb593 72 We support building wxWidgets as a set of several libraries but we don't
0cc66b6c
VZ
73 support arbitrary combinations of libs/DLLs: either we build all of them as
74 DLLs (in which case WXMAKINGDLL is defined) or none (it isn't).
75
53a2db12 76 However we have a problem because we need separate WXDLLIMPEXP versions for
0cc66b6c
VZ
77 different libraries as, for example, wxString class should be dllexported
78 when compiled in wxBase and dllimported otherwise, so we do define separate
79 WXMAKING/USINGDLL_XYZ constants for each component XYZ.
80 */
81#ifdef WXMAKINGDLL
82# if wxUSE_BASE
83# define WXMAKINGDLL_BASE
84# endif
85
86# define WXMAKINGDLL_NET
87# define WXMAKINGDLL_CORE
88# define WXMAKINGDLL_ADV
f5a9eef7 89# define WXMAKINGDLL_QA
0cc66b6c 90# define WXMAKINGDLL_HTML
0ae4d121 91# define WXMAKINGDLL_GL
0cc66b6c 92# define WXMAKINGDLL_XML
c846884b 93# define WXMAKINGDLL_XRC
5e4903f5 94# define WXMAKINGDLL_AUI
3c3ead1d 95# define WXMAKINGDLL_RIBBON
d4cd6b3e 96# define WXMAKINGDLL_PROPGRID
3b2cb431 97# define WXMAKINGDLL_RICHTEXT
c220a8ec 98# define WXMAKINGDLL_MEDIA
c079af66 99# define WXMAKINGDLL_STC
467d261e 100# define WXMAKINGDLL_WEBVIEW
0cc66b6c
VZ
101#endif /* WXMAKINGDLL */
102
103/*
53a2db12 104 WXDLLIMPEXP_CORE maps to export declaration when building the DLL, to import
0cc66b6c
VZ
105 declaration if using it or to nothing at all if we don't use wxWin as DLL
106 */
107#ifdef WXMAKINGDLL_BASE
108# define WXDLLIMPEXP_BASE WXEXPORT
109# define WXDLLIMPEXP_DATA_BASE(type) WXEXPORT type
5f9c3802
SC
110# if defined(HAVE_VISIBILITY)
111# define WXDLLIMPEXP_INLINE_BASE WXEXPORT
112# else
113# define WXDLLIMPEXP_INLINE_BASE
114# endif
0cc66b6c
VZ
115#elif defined(WXUSINGDLL)
116# define WXDLLIMPEXP_BASE WXIMPORT
117# define WXDLLIMPEXP_DATA_BASE(type) WXIMPORT type
5f9c3802
SC
118# if defined(HAVE_VISIBILITY)
119# define WXDLLIMPEXP_INLINE_BASE WXIMPORT
120# else
121# define WXDLLIMPEXP_INLINE_BASE
122# endif
0cc66b6c
VZ
123#else /* not making nor using DLL */
124# define WXDLLIMPEXP_BASE
125# define WXDLLIMPEXP_DATA_BASE(type) type
5f9c3802 126# define WXDLLIMPEXP_INLINE_BASE
0cc66b6c
VZ
127#endif
128
129#ifdef WXMAKINGDLL_NET
130# define WXDLLIMPEXP_NET WXEXPORT
131# define WXDLLIMPEXP_DATA_NET(type) WXEXPORT type
132#elif defined(WXUSINGDLL)
133# define WXDLLIMPEXP_NET WXIMPORT
134# define WXDLLIMPEXP_DATA_NET(type) WXIMPORT type
135#else /* not making nor using DLL */
136# define WXDLLIMPEXP_NET
137# define WXDLLIMPEXP_DATA_NET(type) type
138#endif
139
140#ifdef WXMAKINGDLL_CORE
141# define WXDLLIMPEXP_CORE WXEXPORT
142# define WXDLLIMPEXP_DATA_CORE(type) WXEXPORT type
74cc3ec1
SC
143# if defined(HAVE_VISIBILITY)
144# define WXDLLIMPEXP_INLINE_CORE WXEXPORT
145# else
146# define WXDLLIMPEXP_INLINE_CORE
147# endif
0cc66b6c
VZ
148#elif defined(WXUSINGDLL)
149# define WXDLLIMPEXP_CORE WXIMPORT
150# define WXDLLIMPEXP_DATA_CORE(type) WXIMPORT type
74cc3ec1
SC
151# if defined(HAVE_VISIBILITY)
152# define WXDLLIMPEXP_INLINE_CORE WXIMPORT
153# else
154# define WXDLLIMPEXP_INLINE_CORE
155# endif
0cc66b6c
VZ
156#else /* not making nor using DLL */
157# define WXDLLIMPEXP_CORE
158# define WXDLLIMPEXP_DATA_CORE(type) type
74cc3ec1 159# define WXDLLIMPEXP_INLINE_CORE
0cc66b6c
VZ
160#endif
161
162#ifdef WXMAKINGDLL_ADV
163# define WXDLLIMPEXP_ADV WXEXPORT
164# define WXDLLIMPEXP_DATA_ADV(type) WXEXPORT type
165#elif defined(WXUSINGDLL)
166# define WXDLLIMPEXP_ADV WXIMPORT
167# define WXDLLIMPEXP_DATA_ADV(type) WXIMPORT type
168#else /* not making nor using DLL */
169# define WXDLLIMPEXP_ADV
170# define WXDLLIMPEXP_DATA_ADV(type) type
171#endif
172
61639efb
VZ
173#ifdef WXMAKINGDLL_QA
174# define WXDLLIMPEXP_QA WXEXPORT
175# define WXDLLIMPEXP_DATA_QA(type) WXEXPORT type
176#elif defined(WXUSINGDLL)
177# define WXDLLIMPEXP_QA WXIMPORT
178# define WXDLLIMPEXP_DATA_QA(type) WXIMPORT type
179#else /* not making nor using DLL */
180# define WXDLLIMPEXP_QA
181# define WXDLLIMPEXP_DATA_QA(type) type
182#endif
183
0cc66b6c
VZ
184#ifdef WXMAKINGDLL_HTML
185# define WXDLLIMPEXP_HTML WXEXPORT
186# define WXDLLIMPEXP_DATA_HTML(type) WXEXPORT type
187#elif defined(WXUSINGDLL)
188# define WXDLLIMPEXP_HTML WXIMPORT
189# define WXDLLIMPEXP_DATA_HTML(type) WXIMPORT type
190#else /* not making nor using DLL */
191# define WXDLLIMPEXP_HTML
192# define WXDLLIMPEXP_DATA_HTML(type) type
193#endif
194
195#ifdef WXMAKINGDLL_GL
196# define WXDLLIMPEXP_GL WXEXPORT
197#elif defined(WXUSINGDLL)
198# define WXDLLIMPEXP_GL WXIMPORT
199#else /* not making nor using DLL */
200# define WXDLLIMPEXP_GL
201#endif
202
203#ifdef WXMAKINGDLL_XML
204# define WXDLLIMPEXP_XML WXEXPORT
205#elif defined(WXUSINGDLL)
206# define WXDLLIMPEXP_XML WXIMPORT
207#else /* not making nor using DLL */
208# define WXDLLIMPEXP_XML
209#endif
210
c846884b
RD
211#ifdef WXMAKINGDLL_XRC
212# define WXDLLIMPEXP_XRC WXEXPORT
213#elif defined(WXUSINGDLL)
214# define WXDLLIMPEXP_XRC WXIMPORT
215#else /* not making nor using DLL */
216# define WXDLLIMPEXP_XRC
217#endif
218
5e4903f5
JS
219#ifdef WXMAKINGDLL_AUI
220# define WXDLLIMPEXP_AUI WXEXPORT
221#elif defined(WXUSINGDLL)
222# define WXDLLIMPEXP_AUI WXIMPORT
223#else /* not making nor using DLL */
224# define WXDLLIMPEXP_AUI
225#endif
226
3c3ead1d
PC
227#ifdef WXMAKINGDLL_RIBBON
228# define WXDLLIMPEXP_RIBBON WXEXPORT
229#elif defined(WXUSINGDLL)
230# define WXDLLIMPEXP_RIBBON WXIMPORT
231#else /* not making nor using DLL */
232# define WXDLLIMPEXP_RIBBON
233#endif
234
1c4293cb
VZ
235#ifdef WXMAKINGDLL_PROPGRID
236# define WXDLLIMPEXP_PROPGRID WXEXPORT
23318a53 237# define WXDLLIMPEXP_DATA_PROPGRID(type) WXEXPORT type
1c4293cb
VZ
238#elif defined(WXUSINGDLL)
239# define WXDLLIMPEXP_PROPGRID WXIMPORT
23318a53 240# define WXDLLIMPEXP_DATA_PROPGRID(type) WXIMPORT type
1c4293cb
VZ
241#else /* not making nor using DLL */
242# define WXDLLIMPEXP_PROPGRID
23318a53 243# define WXDLLIMPEXP_DATA_PROPGRID(type) type
1c4293cb
VZ
244#endif
245
3b2cb431
JS
246#ifdef WXMAKINGDLL_RICHTEXT
247# define WXDLLIMPEXP_RICHTEXT WXEXPORT
248#elif defined(WXUSINGDLL)
249# define WXDLLIMPEXP_RICHTEXT WXIMPORT
250#else /* not making nor using DLL */
251# define WXDLLIMPEXP_RICHTEXT
252#endif
253
ff2b312f
RN
254#ifdef WXMAKINGDLL_MEDIA
255# define WXDLLIMPEXP_MEDIA WXEXPORT
256#elif defined(WXUSINGDLL)
257# define WXDLLIMPEXP_MEDIA WXIMPORT
258#else /* not making nor using DLL */
259# define WXDLLIMPEXP_MEDIA
260#endif
261
c079af66 262#ifdef WXMAKINGDLL_STC
23318a53
FM
263# define WXDLLIMPEXP_STC WXEXPORT
264# define WXDLLIMPEXP_DATA_STC(type) WXEXPORT type
c079af66 265#elif defined(WXUSINGDLL)
23318a53
FM
266# define WXDLLIMPEXP_STC WXIMPORT
267# define WXDLLIMPEXP_DATA_STC(type) WXIMPORT type
c079af66 268#else /* not making nor using DLL */
23318a53
FM
269# define WXDLLIMPEXP_STC
270# define WXDLLIMPEXP_DATA_STC(type) type
c079af66
VZ
271#endif
272
467d261e
SL
273#ifdef WXMAKINGDLL_WEBVIEW
274# define WXDLLIMPEXP_WEBVIEW WXEXPORT
275# define WXDLLIMPEXP_DATA_WEBVIEW(type) WXEXPORT type
384b8d9f 276#elif defined(WXUSINGDLL)
467d261e
SL
277# define WXDLLIMPEXP_WEBVIEW WXIMPORT
278# define WXDLLIMPEXP_DATA_WEBVIEW(type) WXIMPORT type
384b8d9f 279#else /* not making nor using DLL */
467d261e
SL
280# define WXDLLIMPEXP_WEBVIEW
281# define WXDLLIMPEXP_DATA_WEBVIEW(type) type
384b8d9f
SL
282#endif
283
8ece1737
VZ
284/*
285 GCC warns about using __attribute__ (and also __declspec in mingw32 case) on
286 forward declarations while MSVC complains about forward declarations without
287 __declspec for the classes later declared with it, so we need a separate set
288 of macros for forward declarations to hide this difference:
289 */
290#if defined(HAVE_VISIBILITY) || (defined(__WINDOWS__) && defined(__GNUC__))
0ff20b9f
VS
291 #define WXDLLIMPEXP_FWD_BASE
292 #define WXDLLIMPEXP_FWD_NET
293 #define WXDLLIMPEXP_FWD_CORE
294 #define WXDLLIMPEXP_FWD_ADV
295 #define WXDLLIMPEXP_FWD_QA
0ff20b9f
VS
296 #define WXDLLIMPEXP_FWD_HTML
297 #define WXDLLIMPEXP_FWD_GL
298 #define WXDLLIMPEXP_FWD_XML
299 #define WXDLLIMPEXP_FWD_XRC
300 #define WXDLLIMPEXP_FWD_AUI
d4cd6b3e 301 #define WXDLLIMPEXP_FWD_PROPGRID
0ff20b9f
VS
302 #define WXDLLIMPEXP_FWD_RICHTEXT
303 #define WXDLLIMPEXP_FWD_MEDIA
304 #define WXDLLIMPEXP_FWD_STC
467d261e 305 #define WXDLLIMPEXP_FWD_WEBVIEW
0ff20b9f
VS
306#else
307 #define WXDLLIMPEXP_FWD_BASE WXDLLIMPEXP_BASE
308 #define WXDLLIMPEXP_FWD_NET WXDLLIMPEXP_NET
309 #define WXDLLIMPEXP_FWD_CORE WXDLLIMPEXP_CORE
310 #define WXDLLIMPEXP_FWD_ADV WXDLLIMPEXP_ADV
311 #define WXDLLIMPEXP_FWD_QA WXDLLIMPEXP_QA
0ff20b9f
VS
312 #define WXDLLIMPEXP_FWD_HTML WXDLLIMPEXP_HTML
313 #define WXDLLIMPEXP_FWD_GL WXDLLIMPEXP_GL
314 #define WXDLLIMPEXP_FWD_XML WXDLLIMPEXP_XML
315 #define WXDLLIMPEXP_FWD_XRC WXDLLIMPEXP_XRC
316 #define WXDLLIMPEXP_FWD_AUI WXDLLIMPEXP_AUI
d4cd6b3e 317 #define WXDLLIMPEXP_FWD_PROPGRID WXDLLIMPEXP_PROPGRID
0ff20b9f
VS
318 #define WXDLLIMPEXP_FWD_RICHTEXT WXDLLIMPEXP_RICHTEXT
319 #define WXDLLIMPEXP_FWD_MEDIA WXDLLIMPEXP_MEDIA
320 #define WXDLLIMPEXP_FWD_STC WXDLLIMPEXP_STC
467d261e 321 #define WXDLLIMPEXP_FWD_WEBVIEW WXDLLIMPEXP_WEBVIEW
0ff20b9f 322#endif
b5dbe15d 323
0cc66b6c
VZ
324/* for backwards compatibility, define suffix-less versions too */
325#define WXDLLEXPORT WXDLLIMPEXP_CORE
326#define WXDLLEXPORT_DATA WXDLLIMPEXP_DATA_CORE
327
7c77f334
VZ
328/*
329 MSVC up to 6.0 needs to be explicitly told to export template instantiations
330 used by the DLL clients, use this macro to do it like this:
331
332 template <typename T> class Foo { ... };
333 WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE( Foo<int> )
334
16361ec9 335 (notice that currently we only need this for wxBase and wxCore libraries)
7c77f334
VZ
336 */
337#if defined(__VISUALC__) && (__VISUALC__ <= 1200)
338 #ifdef WXMAKINGDLL_BASE
339 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
340 template class WXDLLIMPEXP_BASE decl;
16361ec9
VS
341 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl) \
342 template class WXDLLIMPEXP_CORE decl;
7c77f334
VZ
343 #else
344 /*
345 We need to disable this warning when using this macro, as
53a2db12 346 recommended by Microsoft itself:
7c77f334
VZ
347
348 http://support.microsoft.com/default.aspx?scid=kb%3ben-us%3b168958
349 */
350 #pragma warning(disable:4231)
351
352 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
353 extern template class WXDLLIMPEXP_BASE decl;
16361ec9
VS
354 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl) \
355 extern template class WXDLLIMPEXP_CORE decl;
7c77f334
VZ
356 #endif
357#else /* not VC <= 6 */
358 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl)
16361ec9 359 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_CORE(decl)
7c77f334
VZ
360#endif /* VC6/others */
361
0cc66b6c
VZ
362#endif /* _WX_DLIMPEXP_H_ */
363