1 /* ATK - Accessibility Toolkit
3 * Copyright (C) 2012 Igalia, S.L.
4 * Copyright (C) 2014 Chun-wei Fan
6 * Author: Alejandro PiƱeiro Iglesias <apinheiro@igalia.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the
20 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 * Boston, MA 02111-1307, USA.
24 #if defined(ATK_DISABLE_SINGLE_INCLUDES) && !defined (__ATK_H_INSIDE__) && !defined (ATK_COMPILATION)
25 #error "Only <atk/atk.h> can be included directly."
28 #ifndef __ATK_VERSION_H__
29 #define __ATK_VERSION_H__
36 * Like atk_get_major_version(), but from the headers used at
37 * application compile time, rather than from the library linked
38 * against at application run time.
42 #define ATK_MAJOR_VERSION (@ATK_MAJOR_VERSION@)
47 * Like atk_get_minor_version(), but from the headers used at
48 * application compile time, rather than from the library linked
49 * against at application run time.
53 #define ATK_MINOR_VERSION (@ATK_MINOR_VERSION@)
58 * Like atk_get_micro_version(), but from the headers used at
59 * application compile time, rather than from the library linked
60 * against at application run time.
64 #define ATK_MICRO_VERSION (@ATK_MICRO_VERSION@)
69 * Like atk_get_binary_age(), but from the headers used at
70 * application compile time, rather than from the library linked
71 * against at application run time.
75 #define ATK_BINARY_AGE (@ATK_BINARY_AGE@)
80 * Like atk_get_interface_age(), but from the headers used at
81 * application compile time, rather than from the library linked
82 * against at application run time.
86 #define ATK_INTERFACE_AGE (@ATK_INTERFACE_AGE@)
90 * @major: major version (e.g. 1 for version 1.2.5)
91 * @minor: minor version (e.g. 2 for version 1.2.5)
92 * @micro: micro version (e.g. 5 for version 1.2.5)
94 * Returns %TRUE if the version of the ATK header files is the same as
95 * or newer than the passed-in version.
99 #define ATK_CHECK_VERSION(major,minor,micro) \
100 (ATK_MAJOR_VERSION > (major) || \
101 (ATK_MAJOR_VERSION == (major) && ATK_MINOR_VERSION > (minor)) || \
102 (ATK_MAJOR_VERSION == (major) && ATK_MINOR_VERSION == (minor) && \
103 ATK_MICRO_VERSION >= (micro)))
106 #define _ATK_EXTERN extern
112 * A macro that evaluates to the 2.2 version of ATK, in a format
113 * that can be used by the C pre-processor.
117 #define ATK_VERSION_2_2 (G_ENCODE_VERSION (2, 2))
122 * A macro that evaluates to the 2.4 version of ATK, in a format
123 * that can be used by the C pre-processor.
127 #define ATK_VERSION_2_4 (G_ENCODE_VERSION (2, 4))
132 * A macro that evaluates to the 2.6 version of ATK, in a format
133 * that can be used by the C pre-processor.
137 #define ATK_VERSION_2_6 (G_ENCODE_VERSION (2, 6))
142 * A macro that evaluates to the 2.8 version of ATK, in a format
143 * that can be used by the C pre-processor.
147 #define ATK_VERSION_2_8 (G_ENCODE_VERSION (2, 8))
152 * A macro that evaluates to the 2.10 version of ATK, in a format
153 * that can be used by the C pre-processor.
158 #define ATK_VERSION_2_10 (G_ENCODE_VERSION (2, 10))
162 * A macro that evaluates to the 2.12 version of ATK, in a format
163 * that can be used by the C pre-processor.
167 #define ATK_VERSION_2_12 (G_ENCODE_VERSION (2, 12))
172 * A macro that evaluates to the 2.14 version of ATK, in a format
173 * that can be used by the C pre-processor.
177 #define ATK_VERSION_2_14 (G_ENCODE_VERSION (2, 14))
179 /* evaluates to the current stable version; for development cycles,
180 * this means the next stable target
182 #if (ATK_MINOR_VERSION % 2)
183 #define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION + 1))
185 #define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION))
188 /* evaluates to the previous stable version */
189 #if (ATK_MINOR_VERSION % 2)
190 #define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 1))
192 #define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 2))
196 * ATK_VERSION_MIN_REQUIRED:
198 * A macro that should be defined by the user prior to including
199 * the atk/atk.h header.
200 * The definition should be one of the predefined ATK version
201 * macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
203 * This macro defines the earliest version of ATK that the package is
204 * required to be able to compile against.
206 * If the compiler is configured to warn about the use of deprecated
207 * functions, then using functions that were deprecated in version
208 * %ATK_VERSION_MIN_REQUIRED or earlier will cause warnings (but
209 * using functions deprecated in later releases will not).
213 /* If the package sets ATK_VERSION_MIN_REQUIRED to some future
214 * ATK_VERSION_X_Y value that we don't know about, it will compare as
215 * 0 in preprocessor tests.
217 #ifndef ATK_VERSION_MIN_REQUIRED
218 # define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE)
219 #elif ATK_VERSION_MIN_REQUIRED == 0
220 # undef ATK_VERSION_MIN_REQUIRED
221 # define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE + 2)
225 * ATK_VERSION_MAX_ALLOWED:
227 * A macro that should be defined by the user prior to including
228 * the atk/atk.h header.
229 * The definition should be one of the predefined ATK version
230 * macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
232 * This macro defines the latest version of the ATK API that the
233 * package is allowed to make use of.
235 * If the compiler is configured to warn about the use of deprecated
236 * functions, then using functions added after version
237 * %ATK_VERSION_MAX_ALLOWED will cause warnings.
239 * Unless you are using ATK_CHECK_VERSION() or the like to compile
240 * different code depending on the ATK version, then this should be
241 * set to the same value as %ATK_VERSION_MIN_REQUIRED.
245 #if !defined (ATK_VERSION_MAX_ALLOWED) || (ATK_VERSION_MAX_ALLOWED == 0)
246 # undef ATK_VERSION_MAX_ALLOWED
247 # define ATK_VERSION_MAX_ALLOWED (ATK_VERSION_CUR_STABLE)
251 #if ATK_VERSION_MIN_REQUIRED > ATK_VERSION_CUR_STABLE
252 #error "ATK_VERSION_MIN_REQUIRED must be <= ATK_VERSION_CUR_STABLE"
254 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_MIN_REQUIRED
255 #error "ATK_VERSION_MAX_ALLOWED must be >= ATK_VERSION_MIN_REQUIRED"
257 #if ATK_VERSION_MIN_REQUIRED < ATK_VERSION_2_2
258 #error "ATK_VERSION_MIN_REQUIRED must be >= ATK_VERSION_2_2"
261 /* these macros are used to mark deprecated functions, and thus have to be
262 * exposed in a public header.
264 * do *not* use them in other libraries depending on Atk: use G_DEPRECATED
265 * and G_DEPRECATED_FOR, or use your own wrappers around them.
267 #ifdef ATK_DISABLE_DEPRECATION_WARNINGS
268 #define ATK_DEPRECATED _ATK_EXTERN
269 #define ATK_DEPRECATED_FOR(f) _ATK_EXTERN
271 #define ATK_DEPRECATED G_DEPRECATED _ATK_EXTERN
272 #define ATK_DEPRECATED_FOR(f) G_DEPRECATED_FOR(f) _ATK_EXTERN
275 #define ATK_AVAILABLE_IN_ALL _ATK_EXTERN
277 /* XXX: Every new stable minor release should add a set of macros here */
279 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_2
280 # define ATK_DEPRECATED_IN_2_2 ATK_DEPRECATED
281 # define ATK_DEPRECATED_IN_2_2_FOR(f) ATK_DEPRECATED_FOR(f)
283 # define ATK_DEPRECATED_IN_2_2 _ATK_EXTERN
284 # define ATK_DEPRECATED_IN_2_2_FOR(f) _ATK_EXTERN
287 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_2
288 # define ATK_AVAILABLE_IN_2_2 ATK_UNAVAILABLE(2, 2)
290 # define ATK_AVAILABLE_IN_2_2 _ATK_EXTERN
293 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_4
294 # define ATK_DEPRECATED_IN_2_4 ATK_DEPRECATED
295 # define ATK_DEPRECATED_IN_2_4_FOR(f) ATK_DEPRECATED_FOR(f)
297 # define ATK_DEPRECATED_IN_2_4 _ATK_EXTERN
298 # define ATK_DEPRECATED_IN_2_4_FOR(f) _ATK_EXTERN
301 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_4
302 # define ATK_AVAILABLE_IN_2_4 ATK_UNAVAILABLE(2, 4)
304 # define ATK_AVAILABLE_IN_2_4 _ATK_EXTERN
307 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_6
308 # define ATK_DEPRECATED_IN_2_6 ATK_DEPRECATED
309 # define ATK_DEPRECATED_IN_2_6_FOR(f) ATK_DEPRECATED_FOR(f)
311 # define ATK_DEPRECATED_IN_2_6 _ATK_EXTERN
312 # define ATK_DEPRECATED_IN_2_6_FOR(f) _ATK_EXTERN
315 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_6
316 # define ATK_AVAILABLE_IN_2_6 ATK_UNAVAILABLE(2, 6)
318 # define ATK_AVAILABLE_IN_2_6 _ATK_EXTERN
321 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_8
322 # define ATK_DEPRECATED_IN_2_8 ATK_DEPRECATED
323 # define ATK_DEPRECATED_IN_2_8_FOR(f) ATK_DEPRECATED_FOR(f)
325 # define ATK_DEPRECATED_IN_2_8 _ATK_EXTERN
326 # define ATK_DEPRECATED_IN_2_8_FOR(f) _ATK_EXTERN
329 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_8
330 # define ATK_AVAILABLE_IN_2_8 ATK_UNAVAILABLE(2, 8)
332 # define ATK_AVAILABLE_IN_2_8 _ATK_EXTERN
335 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_10
336 # define ATK_DEPRECATED_IN_2_10 ATK_DEPRECATED
337 # define ATK_DEPRECATED_IN_2_10_FOR(f) ATK_DEPRECATED_FOR(f)
339 # define ATK_DEPRECATED_IN_2_10 _ATK_EXTERN
340 # define ATK_DEPRECATED_IN_2_10_FOR(f) _ATK_EXTERN
343 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_10
344 # define ATK_AVAILABLE_IN_2_10 ATK_UNAVAILABLE(2, 10)
346 # define ATK_AVAILABLE_IN_2_10 _ATK_EXTERN
349 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_12
350 # define ATK_DEPRECATED_IN_2_12 ATK_DEPRECATED
351 # define ATK_DEPRECATED_IN_2_12_FOR(f) ATK_DEPRECATED_FOR(f)
353 # define ATK_DEPRECATED_IN_2_12 _ATK_EXTERN
354 # define ATK_DEPRECATED_IN_2_12_FOR(f) _ATK_EXTERN
357 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_12
358 # define ATK_AVAILABLE_IN_2_12 ATK_UNAVAILABLE(2, 12)
360 # define ATK_AVAILABLE_IN_2_12 _ATK_EXTERN
363 #if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_14
364 # define ATK_DEPRECATED_IN_2_14 ATK_DEPRECATED
365 # define ATK_DEPRECATED_IN_2_14_FOR(f) ATK_DEPRECATED_FOR(f)
367 # define ATK_DEPRECATED_IN_2_14 _ATK_EXTERN
368 # define ATK_DEPRECATED_IN_2_14_FOR(f) _ATK_EXTERN
371 #if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_14
372 # define ATK_AVAILABLE_IN_2_14 ATK_UNAVAILABLE(2, 14)
374 # define ATK_AVAILABLE_IN_2_14 _ATK_EXTERN
378 guint atk_get_major_version (void) G_GNUC_CONST;
380 guint atk_get_minor_version (void) G_GNUC_CONST;
382 guint atk_get_micro_version (void) G_GNUC_CONST;
384 guint atk_get_binary_age (void) G_GNUC_CONST;
386 guint atk_get_interface_age (void) G_GNUC_CONST;
388 #define atk_major_version atk_get_major_version ()
389 #define atk_minor_version atk_get_minor_version ()
390 #define atk_micro_version atk_get_micro_version ()
391 #define atk_binary_age atk_get_binary_age ()
392 #define atk_interface_age atk_get_interface_age ()
394 #endif /* __ATK_VERSION_H__ */