]>
Commit | Line | Data |
---|---|---|
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 |