GTK+ Reference Manual |
||||
---|---|---|---|---|
Информация о версииVersion Information Переменные и функции для контроля версии GTK+ |
#include <gtk/gtk.h>
extern const guint gtk_major_version;
extern const guint gtk_minor_version;
extern const guint gtk_micro_version;
extern const guint gtk_binary_age;
extern const guint gtk_interface_age;
gchar* gtk_check_version (guint required_major,
guint required_minor,
guint required_micro);
#define GTK_MAJOR_VERSION
#define GTK_MINOR_VERSION
#define GTK_MICRO_VERSION
#define GTK_BINARY_AGE
#define GTK_INTERFACE_AGE
#define GTK_CHECK_VERSION (major,minor,micro)
GTK+ обеспечивает информацию о версии, прежде всего полезную в проверочной конфигурации для сборки имеющей конфигурационные скрипты. Приложения обычно не используют особенности изложенные в этом разделе.
extern const guint gtk_major_version;Главный номер библиотеки GTK+. (например в GTK+ версии 1.2.5 это 1.)
Эта переменная находится в библиотеке, так представляется библиотека GTK+ с которой вы связываетесь. По сравнению с GTK_MAJOR_VERSION макросом, который представляет главную версию заголовочных файлов GTK+ которые вы включили.
gtk_minor_version
extern const guint gtk_minor_version;Младший номер версии библиотеки GTK+. (например в GTK+ версии 1.2.5 это 2.)
Эта переменная находится в библиотеке, так представляется библиотека GTK+ с которой вы связываетесь. По сравнению с GTK_MINOR_VERSION макросом, который представляет главную версию заголовочных файлов GTK+ которые вы включили.
gtk_micro_version
extern const guint gtk_micro_version;Наименьший номер версии библиотеки GTK+. (например в GTK+ версии 1.2.5 это 5.)
Эта переменная находится в библиотеке, так представляется библиотека GTK+ с которой вы связываетесь. По сравнению с GTK_MICRO_VERSION макросом, который представляет главную версию заголовочных файлов GTK+ которые вы включили.
gtk_binary_age
extern const guint gtk_binary_age;Это бинарный возраст помещаемый в libtool. Если libtool для вас не о чём не говорит, не волнуйтесь об этом. ;-)
gtk_interface_age
extern const guint gtk_interface_age;Это возраст интерфейса помещаемый в libtool. Если libtool для вас не о чём не говорит, не волнуйтесь об этом. ;-)
gtk_check_version ()
gchar* gtk_check_version (guint required_major, guint required_minor, guint required_micro);
Проверяет что используемая библиотека GTK+ совместима с данной версией. В основном вы должны помещать в константы GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION как три аргумента этой функции; эта процедура проверяет совместимость используемой версии библиотеки GTK+ с той версией, с которой были скомпилированы приложения или модули.
Совместимость определяется двумя вещами: сначала версия выполняемой библиотеки должна быть новее версии required_major.required_minor.required_micro. Потом выполняемая версия библиотеки должна быть совместима на уровне двоичного кода с версией required_major.required_minor.required_micro (таже самая главная версия.)
Эта функция в первую очередь для GTK+ модулей; модуль может вызвать эту функцию для проверки чтобы не загрузиться в не совместимую версию библиотеки GTK+. Однако такая проверка не совсем надёжна, например модуль может быть связан со старой версией GTK+ и вызвать старую версию gtk_check_version(), но спокойно загружаться в приложения использующие новую версию GTK+.
required_major : |
Требуемый главный номер версии. |
required_minor : |
Требуемый младший номер версии. |
required_micro : |
Требуемый наименьший номер версии. |
Returns : |
NULL если библиотека GTK+ совместима с данной версией, или строка содержащая несоответствия версий. Возвращаемая строка принадлежит библиотеке GTK+ и не должна изменяться или освобождаться. |
#define GTK_MAJOR_VERSION (2)Как gtk_major_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.
GTK_MINOR_VERSION
#define GTK_MINOR_VERSION (8)Как gtk_minor_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.
GTK_MICRO_VERSION
#define GTK_MICRO_VERSION (11)Как gtk_micro_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.
GTK_BINARY_AGE
#define GTK_BINARY_AGE (811)Как gtk_binary_age, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.
GTK_INTERFACE_AGE
#define GTK_INTERFACE_AGE (11)Как gtk_interface_age, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.
GTK_CHECK_VERSION()
#define GTK_CHECK_VERSION(major,minor,micro)Возвращает TRUE если версия заголовочных файлов GTK+ таже самая или более новая чем помещённая в версию.
major : |
Главный номер версии (например 1 для версии 1.2.5) |
minor : |
Младший номер версии (например 2 для версии 1.2.5) |
micro : |
Наименьший номер версии (например 5 для версии 1.2.5) |