Howto use types in Gtk+

Как древние люди представляли себе, что земля держится на китах, так и С/GObject основывается на API GType, которые обеспечивают регистрацию и манипулирование типами данных, определенных пользователем объектов и интерфейсных типов.

В настоящее время, API GType позволяют программисту создавать и манипулировать двумя видами типов — статическими и фундаментальными. Остальные виды типизации, используемой в С/GObject являются лишь ветлением данных двух типов.


typedef struct _GTypeInfo     GTypeInfo; /* информация о вновь создаваемом типе */
 
struct _GTypeInfo
{
/* Типы интерфейсов, классифицируемые типы, экземпляры типов */
guint16              class_size; /* размер класса */  
   
GBaseInitFunc        base_init; /* Функция инициализации ( как конструктор в С++) */
  GBaseFinalizeFunc    base_finalize; /* Функция завершения  ( как деструктор в С++) */
/* Типы интерфейсов,классифицируемые типы, экземпляры типов */
GClassInitFunc       class_init; /* конструктор класса */
GClassFinalizeFunc   class_finalize; /* деструктор класса */
gconstpointer        class_data; * приватные данные класса */
   
/* экземпляры типов */
guint16              instance_size; /* размер экземпляра */
 guint16              n_preallocs; /* количество созданных экземпляров  c 
выделением памяти (оператор new() в С++ ) */
GInstanceInitFunc    instance_init;      /* Инциализация экземпляра*/ 
   
/*Таблица функций, встроенных обработчиков GValues */
const GTypeValueTable  *value_table;
};

/* регистрация статического типа */


GType g_type_register_static ( GType parent_type,  /* Родительский тип */
const gchar      *type_name, /* текстовое имя типа */
const GTypeInfo  *info,          /* GTypeInfo */
GTypeFlags        flags);          /* Флаги */
 
/* регистрация фундаментального типа  */
GType g_type_register_fundamental (GType                       type_id,
const gchar                *type_name,
const GTypeInfo            *info,
const GTypeFundamentalInfo *finfo,
GTypeFlags                  flags);

Соответственно, во время выполнение программы, для динамической регистрации в С/GObject нового статического типа следует использовать g_type_register_static(), а фундаментального типа — g_type_register_fundamental(). Обе функции создают новый GType на основе предаставленной информации о создаваемом типе в GTypeInfo. Как бы не казались оба типа с виду одинаковами, но они имеют существенное различие.

Так в статье Как создать главное окно программы в Gtk+ мы регистрировали в С/GObject статический тип UGtkMainWindow, потому что нам нужно было наследовать свойства такого же статического типа GtkWindow. В тоже время при регистрации фундаментального типа такая возможность отсутствует, так данный тип относится к так называемому типу ТОП-уровня и не может быть производным от кого-либо другого типа.

Сама регистрация статических и фундаметальных типов так же различается и довольно существенно, как видно из ниже приведенного фрагмента кода из регистрации статического типа UGtkMainWindow.

Файл libugtk-widgets/ugtkmainwindow.c


 . . .
 
/* Функция создания статистического типа UGtkMainwindow */
 
GType ugtk_mainwindow_get_type (void)
{
static GType g_type = 0;
 
if (!g_type) {
static const GTypeInfo type_info = 
{
sizeof (UGtkMainwindowClass),
NULL, /* base_init */
NULL, /* base_finalize */
(GClassInitFunc) ugtk_mainwindow_class_init,
NULL, /* class_finalize */
NULL, /* class_data */
sizeof (UGtkMainwindow),
0,
(GInstanceInitFunc) ugtk_mainwindow_init,
};
 
g_type = g_type_register_static ( GTK_TYPE_WINDOW, 
"UGtkMainwindow", &type_info, 0 );
}
 
return g_type;
}  
 
 . . .

Как видно из текста кода в GTypeInfo нужно предоставить следующую информацию:

в поле class_size — сведения о размере структурного типа класса объекта;
в поле class_init — функцию, инициализирующая данный структурный тип класса объекта;
в поле instance_size — сведения о размере структурного типа экземпляра класса объекта с обнулением количества созданных в памяти экземпляров объектов в поле n_preallocs;
в поле instance_init — функцию, инициализирующую структурный экземпляр данного типа класса объекта;

Остальные поля GTypeInfo, такие как base_init, base_finalize и class_finalize при регистрации типа UGtkMainWindow обычно не задействуются явно и обнуляются с использованием NULL-указателей.

При регистрации фундаментальных типов по-мимо GTypeInfo, отвечающей за манипуляции с создаваемым фундаментальным типом, ещё используется GTypeFundamentalInfo для определение поведения создаваемого типа.

Как можно заметить в GTypeInfo используются на первый взгляд нетрадиционные для Си типы данных, но это не так. Квалификаторы типов полей GTypeInfo на самом деле являются идентификаторами фундаментальных и базовых типов Си, представляющие собой в С/GOBJECT набор базовых типов Си и призванные облегчить программисту жизнь при их использовании и дальнейшей портируемости.

Наименование типа Си

Идентификатор типа С/GOBJECT

Максимальное значение

Минимальное значение

Логический тип (образован от gint)

gboolean

TRUE(значение обратное FALSE)

FALSE(значение 0)

Указатель типа void*

gpointer

Не используется

Указатель типа void* на неизменяемые данные

gconstpointer

Не используется

Символьный тип с учетом знака

gchar

G_MAXINT8

G_MININT8

Символьный тип без учета знака

guchar

G_MAXUINT8

G_MINUINT8

Целочисленный тип int c учетом знака

gint

G_MAXINT

G_MININT

Целочисленный тип int без учета знака

guint

G_MAXUINT

G_MINUINT

Короткий целочисленный тип short c учетом знака

gshort

G_MAXSHORT

G_MINSHORT

Короткий целочисленный тип short без учета знака

gushort

G_MAXUSHORT

G_MINUSHORT

Длинный целочисленный тип long c учетом знака

glong

G_MAXLONG

G_MINLONG

Длинный целочисленный тип long без учета знака

gulong

G_MAXULONG

G_MINULONG

Целочисленный тип размерность 8 разрядов c учетом знака

gint8

G_MAXINT8

G_MININT8

Целочисленный тип размерностью 8 разрядов без учета знака

guint8

G_MAXUINT8

G_MINUINT8

Целочисленный тип размерностью 16 разрядов c учетом знака

gint16

G_MAXINT16

G_MININT16

Целочисленный тип размерностью 16 разрядов без учета знака

guint16

G_MAXUINT16

G_MINUINT16

Целочисленный тип размерностью 32 разряда c учетом знака

gint32

G_MAXINT32

G_MININT32

Целочисленный тип размерностью 32 разряда без учета знака

guint32

G_MAXUINT32

G_MINUINT32

Целочисленный тип размерностью 64 разряда c учетом знака

gint64

G_MAXINT64

G_MININT64

Целочисленный тип размерностью 64 разряда без учета знака

guint64

G_MAXUINT64

G_MINUINT64

Тип с плавающей точкой одинарной точности float

gfloat

G_MAXFLOAT

G_MINFLOAT

Тип с плавающей точкой двойной точности double

gdouble

G_MAXDOUBLE

G_MINDOUBLE

Размерность данных в байтах (определена в С99 как тип size_t)

gsize

G_MAXSIZE

0UL

Размерность данных в байтах c учетом знака ( в некторых стандартах определена как тип ssize_t)

gssize

G_MAXSSIZE

G_MINSSIZE

Целочесленный тип с учетом знака, используемый при операция смещения внутри файла и области данных ( определен в С99 как тип off64_t)

goffset

G_MAXOFFSET

G_MINOFFSET

Длинный целочисленный тип с учетом знака, содержащий адрес указателя ( определен в С99 как тип intptr_t)

gintptr

G_MAXLONG

G_MINLONG

Длинный целочисленный тип без учета знака, содержащий адрес указателя ( определен в С99 как тип uintptr_t)

guintptr

G_MAXULONG

G_MINULONG

1.Введение

2. Идентификация и управление типами в С/GObject

2.1. Статические и фундаментальные типы

2.2. Набор базовых типов в С/GOBJECT

4. Библиография