]> git.saurik.com Git - wxWidgets.git/blame - include/wx/dlimpexp.h
update to 2.9.0
[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
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
fd928524
DW
42# elif defined(__EMX__)
43# define WXEXPORT
44# define WXIMPORT
0cc66b6c
VZ
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
7275146d
MW
54#elif defined(__CYGWIN__)
55# define WXEXPORT __declspec(dllexport)
56# define WXIMPORT __declspec(dllimport)
0cc66b6c
VZ
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/*
77ffb593 66 We support building wxWidgets as a set of several libraries but we don't
0cc66b6c
VZ
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 WXDLLEXPORT 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
f5a9eef7 83# define WXMAKINGDLL_QA
0cc66b6c
VZ
84# define WXMAKINGDLL_ODBC
85# define WXMAKINGDLL_DBGRID
86# define WXMAKINGDLL_HTML
0ae4d121 87# define WXMAKINGDLL_GL
0cc66b6c 88# define WXMAKINGDLL_XML
c846884b 89# define WXMAKINGDLL_XRC
5e4903f5 90# define WXMAKINGDLL_AUI
3b2cb431 91# define WXMAKINGDLL_RICHTEXT
c220a8ec 92# define WXMAKINGDLL_MEDIA
c079af66 93# define WXMAKINGDLL_STC
0cc66b6c
VZ
94#endif /* WXMAKINGDLL */
95
96/*
97 WXDLLEXPORT maps to export declaration when building the DLL, to import
98 declaration if using it or to nothing at all if we don't use wxWin as DLL
99 */
100#ifdef WXMAKINGDLL_BASE
101# define WXDLLIMPEXP_BASE WXEXPORT
102# define WXDLLIMPEXP_DATA_BASE(type) WXEXPORT type
103#elif defined(WXUSINGDLL)
104# define WXDLLIMPEXP_BASE WXIMPORT
105# define WXDLLIMPEXP_DATA_BASE(type) WXIMPORT type
106#else /* not making nor using DLL */
107# define WXDLLIMPEXP_BASE
108# define WXDLLIMPEXP_DATA_BASE(type) type
109#endif
110
111#ifdef WXMAKINGDLL_NET
112# define WXDLLIMPEXP_NET WXEXPORT
113# define WXDLLIMPEXP_DATA_NET(type) WXEXPORT type
114#elif defined(WXUSINGDLL)
115# define WXDLLIMPEXP_NET WXIMPORT
116# define WXDLLIMPEXP_DATA_NET(type) WXIMPORT type
117#else /* not making nor using DLL */
118# define WXDLLIMPEXP_NET
119# define WXDLLIMPEXP_DATA_NET(type) type
120#endif
121
122#ifdef WXMAKINGDLL_CORE
123# define WXDLLIMPEXP_CORE WXEXPORT
124# define WXDLLIMPEXP_DATA_CORE(type) WXEXPORT type
125#elif defined(WXUSINGDLL)
126# define WXDLLIMPEXP_CORE WXIMPORT
127# define WXDLLIMPEXP_DATA_CORE(type) WXIMPORT type
128#else /* not making nor using DLL */
129# define WXDLLIMPEXP_CORE
130# define WXDLLIMPEXP_DATA_CORE(type) type
131#endif
132
133#ifdef WXMAKINGDLL_ADV
134# define WXDLLIMPEXP_ADV WXEXPORT
135# define WXDLLIMPEXP_DATA_ADV(type) WXEXPORT type
136#elif defined(WXUSINGDLL)
137# define WXDLLIMPEXP_ADV WXIMPORT
138# define WXDLLIMPEXP_DATA_ADV(type) WXIMPORT type
139#else /* not making nor using DLL */
140# define WXDLLIMPEXP_ADV
141# define WXDLLIMPEXP_DATA_ADV(type) type
142#endif
143
144#ifdef WXMAKINGDLL_ODBC
145# define WXDLLIMPEXP_ODBC WXEXPORT
146# define WXDLLIMPEXP_DATA_ODBC(type) WXEXPORT type
147#elif defined(WXUSINGDLL)
148# define WXDLLIMPEXP_ODBC WXIMPORT
149# define WXDLLIMPEXP_DATA_ODBC(type) WXIMPORT type
150#else /* not making nor using DLL */
151# define WXDLLIMPEXP_ODBC
152# define WXDLLIMPEXP_DATA_ODBC(type) type
153#endif
154
61639efb
VZ
155#ifdef WXMAKINGDLL_QA
156# define WXDLLIMPEXP_QA WXEXPORT
157# define WXDLLIMPEXP_DATA_QA(type) WXEXPORT type
158#elif defined(WXUSINGDLL)
159# define WXDLLIMPEXP_QA WXIMPORT
160# define WXDLLIMPEXP_DATA_QA(type) WXIMPORT type
161#else /* not making nor using DLL */
162# define WXDLLIMPEXP_QA
163# define WXDLLIMPEXP_DATA_QA(type) type
164#endif
165
0cc66b6c
VZ
166#ifdef WXMAKINGDLL_DBGRID
167# define WXDLLIMPEXP_DBGRID WXEXPORT
168# define WXDLLIMPEXP_DATA_DBGRID(type) WXEXPORT type
169#elif defined(WXUSINGDLL)
170# define WXDLLIMPEXP_DBGRID WXIMPORT
171# define WXDLLIMPEXP_DATA_DBGRID(type) WXIMPORT type
172#else /* not making nor using DLL */
173# define WXDLLIMPEXP_DBGRID
174# define WXDLLIMPEXP_DATA_DBGRID(type) type
175#endif
176
177#ifdef WXMAKINGDLL_HTML
178# define WXDLLIMPEXP_HTML WXEXPORT
179# define WXDLLIMPEXP_DATA_HTML(type) WXEXPORT type
180#elif defined(WXUSINGDLL)
181# define WXDLLIMPEXP_HTML WXIMPORT
182# define WXDLLIMPEXP_DATA_HTML(type) WXIMPORT type
183#else /* not making nor using DLL */
184# define WXDLLIMPEXP_HTML
185# define WXDLLIMPEXP_DATA_HTML(type) type
186#endif
187
188#ifdef WXMAKINGDLL_GL
189# define WXDLLIMPEXP_GL WXEXPORT
190#elif defined(WXUSINGDLL)
191# define WXDLLIMPEXP_GL WXIMPORT
192#else /* not making nor using DLL */
193# define WXDLLIMPEXP_GL
194#endif
195
196#ifdef WXMAKINGDLL_XML
197# define WXDLLIMPEXP_XML WXEXPORT
198#elif defined(WXUSINGDLL)
199# define WXDLLIMPEXP_XML WXIMPORT
200#else /* not making nor using DLL */
201# define WXDLLIMPEXP_XML
202#endif
203
c846884b
RD
204#ifdef WXMAKINGDLL_XRC
205# define WXDLLIMPEXP_XRC WXEXPORT
206#elif defined(WXUSINGDLL)
207# define WXDLLIMPEXP_XRC WXIMPORT
208#else /* not making nor using DLL */
209# define WXDLLIMPEXP_XRC
210#endif
211
5e4903f5
JS
212#ifdef WXMAKINGDLL_AUI
213# define WXDLLIMPEXP_AUI WXEXPORT
214#elif defined(WXUSINGDLL)
215# define WXDLLIMPEXP_AUI WXIMPORT
216#else /* not making nor using DLL */
217# define WXDLLIMPEXP_AUI
218#endif
219
3b2cb431
JS
220#ifdef WXMAKINGDLL_RICHTEXT
221# define WXDLLIMPEXP_RICHTEXT WXEXPORT
222#elif defined(WXUSINGDLL)
223# define WXDLLIMPEXP_RICHTEXT WXIMPORT
224#else /* not making nor using DLL */
225# define WXDLLIMPEXP_RICHTEXT
226#endif
227
ff2b312f
RN
228#ifdef WXMAKINGDLL_MEDIA
229# define WXDLLIMPEXP_MEDIA WXEXPORT
230#elif defined(WXUSINGDLL)
231# define WXDLLIMPEXP_MEDIA WXIMPORT
232#else /* not making nor using DLL */
233# define WXDLLIMPEXP_MEDIA
234#endif
235
c079af66
VZ
236#ifdef WXMAKINGDLL_STC
237 #define WXDLLIMPEXP_STC WXEXPORT
238#elif defined(WXUSINGDLL)
239 #define WXDLLIMPEXP_STC WXIMPORT
240#else /* not making nor using DLL */
241 #define WXDLLIMPEXP_STC
242#endif
243
8ece1737
VZ
244/*
245 GCC warns about using __attribute__ (and also __declspec in mingw32 case) on
246 forward declarations while MSVC complains about forward declarations without
247 __declspec for the classes later declared with it, so we need a separate set
248 of macros for forward declarations to hide this difference:
249 */
250#if defined(HAVE_VISIBILITY) || (defined(__WINDOWS__) && defined(__GNUC__))
0ff20b9f
VS
251 #define WXDLLIMPEXP_FWD_BASE
252 #define WXDLLIMPEXP_FWD_NET
253 #define WXDLLIMPEXP_FWD_CORE
254 #define WXDLLIMPEXP_FWD_ADV
255 #define WXDLLIMPEXP_FWD_QA
256 #define WXDLLIMPEXP_FWD_ODBC
257 #define WXDLLIMPEXP_FWD_DBGRID
258 #define WXDLLIMPEXP_FWD_HTML
259 #define WXDLLIMPEXP_FWD_GL
260 #define WXDLLIMPEXP_FWD_XML
261 #define WXDLLIMPEXP_FWD_XRC
262 #define WXDLLIMPEXP_FWD_AUI
263 #define WXDLLIMPEXP_FWD_RICHTEXT
264 #define WXDLLIMPEXP_FWD_MEDIA
265 #define WXDLLIMPEXP_FWD_STC
266#else
267 #define WXDLLIMPEXP_FWD_BASE WXDLLIMPEXP_BASE
268 #define WXDLLIMPEXP_FWD_NET WXDLLIMPEXP_NET
269 #define WXDLLIMPEXP_FWD_CORE WXDLLIMPEXP_CORE
270 #define WXDLLIMPEXP_FWD_ADV WXDLLIMPEXP_ADV
271 #define WXDLLIMPEXP_FWD_QA WXDLLIMPEXP_QA
272 #define WXDLLIMPEXP_FWD_ODBC WXDLLIMPEXP_ODBC
273 #define WXDLLIMPEXP_FWD_DBGRID WXDLLIMPEXP_DBGRID
274 #define WXDLLIMPEXP_FWD_HTML WXDLLIMPEXP_HTML
275 #define WXDLLIMPEXP_FWD_GL WXDLLIMPEXP_GL
276 #define WXDLLIMPEXP_FWD_XML WXDLLIMPEXP_XML
277 #define WXDLLIMPEXP_FWD_XRC WXDLLIMPEXP_XRC
278 #define WXDLLIMPEXP_FWD_AUI WXDLLIMPEXP_AUI
279 #define WXDLLIMPEXP_FWD_RICHTEXT WXDLLIMPEXP_RICHTEXT
280 #define WXDLLIMPEXP_FWD_MEDIA WXDLLIMPEXP_MEDIA
281 #define WXDLLIMPEXP_FWD_STC WXDLLIMPEXP_STC
282#endif
b5dbe15d 283
0cc66b6c
VZ
284/* for backwards compatibility, define suffix-less versions too */
285#define WXDLLEXPORT WXDLLIMPEXP_CORE
286#define WXDLLEXPORT_DATA WXDLLIMPEXP_DATA_CORE
287
7c77f334
VZ
288/*
289 MSVC up to 6.0 needs to be explicitly told to export template instantiations
290 used by the DLL clients, use this macro to do it like this:
291
292 template <typename T> class Foo { ... };
293 WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE( Foo<int> )
294
295 (notice that currently we only need this for the wxBase library)
296 */
297#if defined(__VISUALC__) && (__VISUALC__ <= 1200)
298 #ifdef WXMAKINGDLL_BASE
299 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
300 template class WXDLLIMPEXP_BASE decl;
301 #else
302 /*
303 We need to disable this warning when using this macro, as
304 recommended by Microsoft itself:
305
306 http://support.microsoft.com/default.aspx?scid=kb%3ben-us%3b168958
307 */
308 #pragma warning(disable:4231)
309
310 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl) \
311 extern template class WXDLLIMPEXP_BASE decl;
312 #endif
313#else /* not VC <= 6 */
314 #define WXDLLIMPEXP_TEMPLATE_INSTANCE_BASE(decl)
315#endif /* VC6/others */
316
0cc66b6c
VZ
317#endif /* _WX_DLIMPEXP_H_ */
318