краткое описание

#include <gtk/gtk.h>


typedef     gtktype;
typedef     gtkfundamentaltype;
#define     gtk_class_name                  (class)
#define     gtk_class_type                  (class)
#define     gtk_type_is_object              (type)
#define     gtk_type_fundamental_last
#define     gtk_type_fundamental_max
#define     gtk_struct_offset
#define     gtk_check_cast
#define     gtk_check_class_cast
#define     gtk_check_type
#define     gtk_check_class_type
#define     gtk_check_get_class
#define     gtk_fundamental_type
#define     gtk_signal_func                 (f)
typedef     gtkclassinitfunc;
typedef     gtkobjectinitfunc;
void        (*gtksignalfunc)                (void);
gboolean    (*gtkfunction)                  (gpointer data);
void        (*gtkdestroynotify)             (gpointer data);
void        (*gtkcallbackmarshal)           (gtkobject *object,
                                             gpointer data,
                                             guint n_args,
                                             gtkarg *args);
typedef     gtksignalmarshaller;
typedef     gtktypeobject;
            gtkarg;
#define     gtk_value_char                  (a)
#define     gtk_value_uchar                 (a)
#define     gtk_value_bool                  (a)
#define     gtk_value_int                   (a)
#define     gtk_value_uint                  (a)
#define     gtk_value_long                  (a)
#define     gtk_value_ulong                 (a)
#define     gtk_value_float                 (a)
#define     gtk_value_double                (a)
#define     gtk_value_string                (a)
#define     gtk_value_enum                  (a)
#define     gtk_value_flags                 (a)
#define     gtk_value_boxed                 (a)
#define     gtk_value_pointer               (a)
#define     gtk_value_object                (a)
#define     gtk_value_signal                (a)
#define     gtk_retloc_char                 (a)
#define     gtk_retloc_uchar                (a)
#define     gtk_retloc_bool                 (a)
#define     gtk_retloc_int                  (a)
#define     gtk_retloc_uint                 (a)
#define     gtk_retloc_long                 (a)
#define     gtk_retloc_ulong                (a)
#define     gtk_retloc_float                (a)
#define     gtk_retloc_double               (a)
#define     gtk_retloc_string               (a)
#define     gtk_retloc_enum                 (a)
#define     gtk_retloc_flags                (a)
#define     gtk_retloc_boxed                (a)
#define     gtk_retloc_pointer              (a)
#define     gtk_retloc_object               (a)
            gtktypeinfo;
typedef     gtktypeclass;
typedef     gtkenumvalue;
typedef     gtkflagvalue;
void        gtk_type_init                   (gtypedebugflags debug_flags);
gtktype     gtk_type_unique                 (gtktype parent_type,
                                             const gtktypeinfo *gtkinfo);
#define     gtk_type_name                   (type)
#define     gtk_type_from_name              (name)
#define     gtk_type_parent                 (type)
gpointer    gtk_type_class                  (gtktype type);
gpointer    gtk_type_new                    (gtktype type);
#define     gtk_type_is_a                   (type, is_a_type)
gtkenumvalue* gtk_type_enum_get_values      (gtktype enum_type);
gtkflagvalue* gtk_type_flags_get_values     (gtktype flags_type);
gtkenumvalue* gtk_type_enum_find_value      (gtktype enum_type,
                                             const gchar *value_name);
gtkflagvalue* gtk_type_flags_find_value     (gtktype flags_type,
                                             const gchar *value_name);

описание

система типов gtk+ расширяема. поэтому, типы должны управляться во время выполнения.

детали

gtktype

typedef gtype                   gtktype;

gtktype – уникальное целое идентифицирующее тип. внутренняя информация о типе содержится в закрытой структуре именуемой gtktypenode.

gtkfundamentaltype

typedef gtype gtkfundamentaltype;

внимание

gtkfundamentaltype устарел и не должен использоваться во вновь создаваемом коде.

gtkfundamentaltype перечислимый тип со списком всех возможных фундаментальных типов (например char, uchar, int, long, float, и т.д.).

gtk_class_name()

#define gtk_class_name(class)           (g_type_name (g_type_from_class (class)))

внимание

gtk_class_name устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_type_name() и g_type_from_class().

возвращает имя типа classа.

gtk_class_type()

#define gtk_class_type(class)           (g_type_from_class (class))

внимание

gtk_class_type устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_type_from_class().

возвращает тип classа.

gtk_type_is_object()

#define gtk_type_is_object(type)        (g_type_is_a ((type), gtk_type_object))

внимание

gtk_type_is_object устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_type_is_object().

возвращает true если type - gtk_type_object.

gtk_type_fundamental_last

#define gtk_type_fundamental_last        (g_type_last_reserved_fundamental - 1)

внимание

gtk_type_fundamental_last устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_type_last_reserved_fundamental - 1 .

высшее по номеру в структуре или окончательное значение перечислимого типа.

gtk_type_fundamental_max

#define gtk_type_fundamental_max         (g_type_fundamental_max)

внимание

gtk_type_fundamental_max устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_type_fundamental_max .

максимальное значение фундаментального перечислимого типа.

gtk_struct_offset

#define gtk_struct_offset       g_struct_offset

внимание

gtk_struct_offset устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте g_struct_offset().

используется вместо offsetof(), которая используется если она существует.

gtk_check_cast

#define gtk_check_cast          g_type_check_instance_cast

приводит объект из tobj к типу cast. если g_disable_cast_checks определён, преобразование происходит без проверки. иначе, проверяет возможно ли приведение tobj к типу cast.

gtk_check_class_cast

#define gtk_check_class_cast    g_type_check_class_cast

приводит объект из tobj к типу cast. если g_disable_cast_checks определён, преобразование происходит без проверки. иначе, проверяет возможно ли приведение tobj к типу cast.

gtk_check_type

#define gtk_check_type          g_type_check_instance_type

определяет, является лиtype_object типом otype.

gtk_check_class_type

#define gtk_check_class_type    g_type_check_class_type

определяет, является лиtype_class типом otype.

gtk_check_get_class

#define gtk_check_get_class     g_type_instance_get_class

получает класс tobj.

gtk_fundamental_type

#define gtk_fundamental_type    g_type_fundamental

внимание

gtk_fundamental_type устарела и не должна использоваться во вновь создаваемом коде.

преобразует gtk+ тип в фундаментальный тип.

gtk_signal_func()

#define gtk_signal_func(f)          ((gtksignalfunc) (f))

просто макрокоманда распределяемая в gtksignalfunc.

gtkclassinitfunc

typedef gbaseinitfunc           gtkclassinitfunc;

внимание

gtkclassinitfunc устарела и не должна использоваться во вновь создаваемом коде.

определяет указатель функции.

gtkobjectinitfunc

typedef ginstanceinitfunc       gtkobjectinitfunc;

внимание

gtkobjectinitfunc устарела и не должна использоваться во вновь создаваемом коде.

определяет указатель функции.

gtksignalfunc ()

void        (*gtksignalfunc)                (void);

определяет указатель функции.

gtkfunction ()

gboolean    (*gtkfunction)                  (gpointer data);

определяет указатель функции.

gtkdestroynotify ()

void        (*gtkdestroynotify)             (gpointer data);

определяет указатель функции.

gtkcallbackmarshal ()

void        (*gtkcallbackmarshal)           (gtkobject *object,
                                             gpointer data,
                                             guint n_args,
                                             gtkarg *args);

определяет указатель функции.

gtksignalmarshaller

typedef gsignalcmarshaller          gtksignalmarshaller;

внимание

gtksignalmarshaller устарела и не должна использоваться во вновь создаваемом коде.

определяет указатель функции.

gtktypeobject

typedef gtypeinstance           gtktypeobject;

внимание

gtktypeobject устарел и не должен использоваться во вновь создаваемом коде.

gtktypeobject определяет минимальные структурные требования для образца типа. образец типа возвращённый из gtk_type_new() и инициализированный через gtkobjectinitfunc должен непосредственно унаследовать эту структуру или по крайней мере скопировать её поля одно за другим.

gtkarg

typedef struct {
  gtktype type;
  gchar *name;
  
  /* это объединение только определяет необходимые типы хранения для
   * возможных значений, поэтому там нет поля gint enum_data,
   * потому что это было бы просто псевдоним для gint int_data.
   * используйте gtk_value_*() и gtk_retloc_*() макросы для доступа
   * к отдельным членам структуры.
   */
  union {
    /* окончательные значения */
    gchar char_data;
    guchar uchar_data;
    gboolean bool_data;
    gint int_data;
    guint uint_data;
    glong long_data;
    gulong ulong_data;
    gfloat float_data;
    gdouble double_data;
    gchar *string_data;
    gtkobject *object_data;
    gpointer pointer_data;
    
    /* структурные значения */
    struct {
      gtksignalfunc f;
      gpointer d;
    } signal_data;
  } d;
} gtkarg;

внимание

gtkarg устарела и не должна использоваться во вновь создаваемом коде.

эта структура используется для размещения значений типов (и имён).

gtk_value_char()

#define gtk_value_char(a)       ((a).d.char_data)

внимание

gtk_value_char устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_char.

gtk_value_uchar()

#define gtk_value_uchar(a)      ((a).d.uchar_data)

внимание

gtk_value_uchar устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_uchar.

gtk_value_bool()

#define gtk_value_bool(a)       ((a).d.bool_data)

внимание

gtk_value_bool устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_bool.

gtk_value_int()

#define gtk_value_int(a)        ((a).d.int_data)

внимание

gtk_value_int устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_int.

gtk_value_uint()

#define gtk_value_uint(a)       ((a).d.uint_data)

внимание

gtk_value_uint устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_uint.

gtk_value_long()

#define gtk_value_long(a)       ((a).d.long_data)

внимание

gtk_value_long устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_long.

gtk_value_ulong()

#define gtk_value_ulong(a)      ((a).d.ulong_data)

внимание

gtk_value_ulong устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_ulong.

gtk_value_float()

#define gtk_value_float(a)      ((a).d.float_data)

внимание

gtk_value_float устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_float.

gtk_value_double()

#define gtk_value_double(a)     ((a).d.double_data)

внимание

gtk_value_double устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_double.

gtk_value_string()

#define gtk_value_string(a)     ((a).d.string_data)

внимание

gtk_value_string устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_string.

gtk_value_enum()

#define gtk_value_enum(a)       ((a).d.int_data)

внимание

gtk_value_enum устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_enum.

gtk_value_flags()

#define gtk_value_flags(a)      ((a).d.uint_data)

внимание

gtk_value_flags устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_flags.

gtk_value_boxed()

#define gtk_value_boxed(a)      ((a).d.pointer_data)

внимание

gtk_value_boxed устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_boxed.

gtk_value_pointer()

#define gtk_value_pointer(a)    ((a).d.pointer_data)

внимание

gtk_value_pointer устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_pointer.

gtk_value_object()

#define gtk_value_object(a)     ((a).d.object_data)

внимание

gtk_value_object устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_object.

gtk_value_signal()

#define gtk_value_signal(a)     ((a).d.signal_data)

внимание

gtk_value_signal устарела и не должна использоваться во вновь создаваемом коде.

получает значение gtkarg, чей gtktype равен gtk_type_signal.

gtk_retloc_char()

#define gtk_retloc_char(a)      ((gchar*)       (a).d.pointer_data)

внимание

gtk_retloc_char устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_char.

gtk_retloc_uchar()

#define gtk_retloc_uchar(a)     ((guchar*)      (a).d.pointer_data)

внимание

gtk_retloc_uchar устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_uchar.

gtk_retloc_bool()

#define gtk_retloc_bool(a)      ((gboolean*)    (a).d.pointer_data)

внимание

gtk_retloc_bool устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_bool.

gtk_retloc_int()

#define gtk_retloc_int(a)       ((gint*)        (a).d.pointer_data)

внимание

gtk_retloc_int устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_int.

gtk_retloc_uint()

#define gtk_retloc_uint(a)      ((guint*)       (a).d.pointer_data)

внимание

gtk_retloc_uint устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_uint.

gtk_retloc_long()

#define gtk_retloc_long(a)      ((glong*)       (a).d.pointer_data)

внимание

gtk_retloc_long устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_long.

gtk_retloc_ulong()

#define gtk_retloc_ulong(a)     ((gulong*)      (a).d.pointer_data)

внимание

gtk_retloc_ulong устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_ulong.

gtk_retloc_float()

#define gtk_retloc_float(a)     ((gfloat*)      (a).d.pointer_data)

внимание

gtk_retloc_float устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_float.

gtk_retloc_double()

#define gtk_retloc_double(a)    ((gdouble*)     (a).d.pointer_data)

внимание

gtk_retloc_double устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_double.

gtk_retloc_string()

#define gtk_retloc_string(a)    ((gchar**)      (a).d.pointer_data)

внимание

gtk_retloc_string устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_string.

gtk_retloc_enum()

#define gtk_retloc_enum(a)      ((gint*)        (a).d.pointer_data)

внимание

gtk_retloc_enum устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_enum.

gtk_retloc_flags()

#define gtk_retloc_flags(a)     ((guint*)       (a).d.pointer_data)

внимание

gtk_retloc_flags устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_flags.

gtk_retloc_boxed()

#define gtk_retloc_boxed(a)     ((gpointer*)    (a).d.pointer_data)

внимание

gtk_retloc_boxed устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_boxed.

gtk_retloc_pointer()

#define gtk_retloc_pointer(a)   ((gpointer*)    (a).d.pointer_data)

внимание

gtk_retloc_pointer устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_pointer.

gtk_retloc_object()

#define gtk_retloc_object(a)    ((gtkobject**)  (a).d.pointer_data)

внимание

gtk_retloc_object устарела и не должна использоваться во вновь создаваемом коде.

если gtkarg содержит указатель на значение, этот макрос будет указателем на gtk_type_object.

gtktypeinfo

typedef struct {
  gchar                 *type_name;
  guint                  object_size;
  guint                  class_size;
  gtkclassinitfunc       class_init_func;
  gtkobjectinitfunc      object_init_func;
  gpointer               reserved_1;
  gpointer               reserved_2;
  gtkclassinitfunc       base_class_init_func;
} gtktypeinfo;

внимание

gtktypeinfo устарела и не должна использоваться во вновь создаваемом коде.

holds information about the type. gtk_type_name() returns the name. object_size is somehow set to the number of bytes that an instance of the object will occupy. class_init_func holds the type's initialization function. object_init_func holds the initialization function for an instance of the object. reserved_1 is used for gtkenumvalue to hold the enumerated values.

gtktypeclass

typedef gtypeclass              gtktypeclass;

внимание

gtktypeclass устарела и не должна использоваться во вновь создаваемом коде.

основная структура для gtk+ типа. каждый тип наследует её, как базовую структуру.

gtkenumvalue

typedef genumvalue  gtkenumvalue;

внимание

gtkenumvalue устарела и не должна использоваться во вновь создаваемом коде.

структура которая содержит единственное перечислимое значение, имя и псевдоним.

gtkflagvalue

typedef gflagsvalue gtkflagvalue;

внимание

gtkflagvalue устарела и не должна использоваться во вновь создаваемом коде.

gtk_type_init ()

void        gtk_type_init                   (gtypedebugflags debug_flags);

внимание

gtk_type_init устарела и не должна использоваться во вновь создаваемом коде.

инициализирует данные структуры связанные с gtk+ типами.

gtk_type_unique ()

gtktype     gtk_type_unique                 (gtktype parent_type,
                                             const gtktypeinfo *gtkinfo);

внимание

gtk_type_unique устарела и не должна использоваться во вновь создаваемом коде.

создаёт новый уникальный тип.

gtk_type_name()

#define gtk_type_name(type)              g_type_name (type)

внимание

gtk_type_name устарела и не должна использоваться во вновь создаваемом коде.

возвращает указатель на имя типа, или null если оно не существует.

gtk_type_from_name()

#define gtk_type_from_name(name)         g_type_from_name (name)

внимание

gtk_type_from_name устарела и не должна использоваться во вновь создаваемом коде.

получает внутреннее представление типа, учитывая его имя.

gtk_type_parent()

#define gtk_type_parent(type)            g_type_parent (type)

внимание

gtk_type_parent устарела и не должна использоваться во вновь создаваемом коде.

возвращает родительский тип gtktype.

gtk_type_class ()

gpointer    gtk_type_class                  (gtktype type);

возвращает указатель, указывающий на класс type или null если были какие нибудь неприятности с идентификацией type. инициализирует класс если необходимо.

gtk_type_new ()

gpointer    gtk_type_new                    (gtktype type);

внимание

gtk_type_new устарела и не должна использоваться во вновь создаваемом коде.

создаёт новый объект данного типа и возвращает указатель на него. возвращает null если вы задали неправильный тип. она размещает объект из части памяти типов если есть часть памяти. объект имеет всё присущее вызываемым инициализаторам.

gtk_type_is_a()

#define gtk_type_is_a(type, is_a_type)   g_type_is_a ((type), (is_a_type))

внимание

gtk_type_is_a устарела и не должна использоваться во вновь создаваемом коде.

осматривает иерархию типов для поиска type как is_a_type среди предков. делает простой поиск, не цикличный.

gtk_type_enum_get_values ()

gtkenumvalue* gtk_type_enum_get_values      (gtktype enum_type);

внимание

gtk_type_enum_get_values устарела и не должна использоваться во вновь создаваемом коде.

если enum_type имеет значения, то возвращает указатель на них.

gtk_type_flags_get_values ()

gtkflagvalue* gtk_type_flags_get_values     (gtktype flags_type);

внимание

gtk_type_flags_get_values устарела и не должна использоваться во вновь создаваемом коде.

если flags_type имеет значения, то возвращает указатель на них.

gtk_type_enum_find_value ()

gtkenumvalue* gtk_type_enum_find_value      (gtktype enum_type,
                                             const gchar *value_name);

внимание

gtk_type_enum_find_value устарела и не должна использоваться во вновь создаваемом коде.

возвращает указатель на один из enum_type's gtkenumvalues's имя которого (или псевдоним) соответствует value_name.

gtk_type_flags_find_value ()

gtkflagvalue* gtk_type_flags_find_value     (gtktype flags_type,
                                             const gchar *value_name);

внимание

gtk_type_flags_find_value устарела и не должна использоваться во вновь создаваемом коде.

возвращает указатель на один из flag_type's gtkflagvalue's имя которого (или псевдоним) соответствует value_name.