GtkBuilder

gtk_builder_new ()

GtkBuilder *
gtk_builder_new (void);

Создаёт новый пустой объект билдера.

Эта функция полезна только если вы планируете совершать несколько вызовов gtk_builder_add_from_file(), gtk_builder_add_from_resource() или gtk_builder_add_from_string() для объединения нескольких описаний пользовательского интерфейса в один билдер.

gtk_builder_new_from_file ()

GtkBuilder *
gtk_builder_new_from_file (const char *filename);

Создаёт объект GtkBuilder из определения пользовательского интерфейса в файле filename.

Если возникает ошибка при открытии файла или разборе описания, программа аварийно завершится. Вы должны парсить только описания пользовательских интерфейсов, поставляемые вместе с вашей программой.

gtk_builder_new_from_resource ()

GtkBuilder *
gtk_builder_new_from_resource (const char *resource_path);

Создаёт объект GtkBuilder из определения пользовательского интерфейса в ресурсе по адресу resource_path.

Если возникает ошибка при поиске ресурса или разборе описания, программа аварийно завершится.

gtk_builder_new_from_string ()

GtkBuilder *
gtk_builder_new_from_string (const char *string,
                             gssize length);

Создаёт объект GtkBuilder из описания пользовательского интерфейса, представленного строкой string (в формате GtkBuilder UI).

Если string завершается символом NULL, то length должно быть равно -1. Если length не равно -1, то это длина string.

Если при разборе string возникает ошибка, программа аварийно завершится. Не следует парсить описания пользовательского интерфейса из ненадежных источников.

gtk_builder_create_closure ()

GClosure *
gtk_builder_create_closure (GtkBuilder *builder,
                            const char *function_name,
                            GtkBuilderClosureFlags flags,
                            GObject *object,
                            GError **error);

Создаёт замыкание для вызова функции, названной function_name, используя реализацию builder в GtkBuilderScope.

Если замыкание создать не удалось, возвращается NULL, и error будет установлено.

gtk_builder_add_from_file ()

gboolean
gtk_builder_add_from_file (GtkBuilder *builder,
                           const char *filename,
                           GError **error);

Парсит файл с определением пользовательского интерфейса GtkBuilder и объединяет его с текущим содержимым builder.

Эта функция полезна, если вам нужно вызвать gtk_builder_set_current_object() для добавления пользовательских данных в обратные вызовы до загрузки интерфейса GtkBuilder. В противном случае, скорее всего, вам нужна функция gtk_builder_new_from_file().

При возникновении ошибки возвращается 0, и error получит ошибку из области GTK_BUILDER_ERROR, G_MARKUP_ERROR или G_FILE_ERROR.

Вряд ли стоит пытаться обрабатывать ошибки этого вызова. Не следует использовать эту функцию с ненадежными файлами (т.е. файлами, которые не являются частью вашего приложения). Повреждённые файлы GtkBuilder могут легко привести к аварийному завершению программы, и возможно, произошла утечка памяти, которая привела к сообщению об ошибке. Единственный разумный способ действия при обнаружении ошибки — вызвать g_error().

gtk_builder_add_from_resource ()

gboolean
gtk_builder_add_from_resource (GtkBuilder *builder,
                               const char *resource_path,
                               GError **error);

Парсит файл ресурса с определением пользовательского интерфейса GtkBuilder и объединяет его с текущим содержимым builder.

Эта функция полезна, если вам нужно вызвать gtk_builder_set_current_object() для добавления пользовательских данных в обратные вызовы до загрузки интерфейса GtkBuilder. В противном случае, скорее всего, вам нужна функция gtk_builder_new_from_resource().

При возникновении ошибки возвращается 0, и error получит ошибку из области GTK_BUILDER_ERROR, G_MARKUP_ERROR или G_RESOURCE_ERROR.

Вряд ли стоит пытаться обрабатывать ошибки этого вызова. Единственный разумный способ действия при обнаружении ошибки — вызвать g_error().

gtk_builder_add_from_string ()

gboolean
gtk_builder_add_from_string (GtkBuilder *builder,
                             const char *buffer,
                             gssize length,
                             GError **error);

Парсит строку, содержащую определение пользовательского интерфейса GtkBuilder, и объединяет её с текущим содержимым builder .

Эта функция полезна, если вам нужно вызвать gtk_builder_set_current_object() для добавления пользовательских данных в обратные вызовы перед загрузкой пользовательского интерфейса GtkBuilder. В противном случае, вероятно, вам потребуется gtk_builder_new_from_string().

При возникновении ошибок будет возвращено FALSE и error получит GError из области GTK_BUILDER_ERROR, G_MARKUP_ERROR или G_VARIANT_PARSE_ERROR.

Попытка обработать ошибки в этом вызове нецелесообразна. Единственное разумное действие при обнаружении ошибки — вызвать g_error().

gtk_builder_add_objects_from_file ()

gboolean
gtk_builder_add_objects_from_file (GtkBuilder *builder,
                                   const char *filename,
                                   const char **object_ids,
                                   GError **error);

Парсит файл, содержащий определение пользовательского интерфейса GtkBuilder, создавая только запрошенные объекты и объединяя их с текущим содержимым builder .

При ошибках возвращается 0 и error получает GError из области GTK_BUILDER_ERROR, G_MARKUP_ERROR или G_FILE_ERROR.

Если вы добавляете объект, зависящий от объекта, который не является его дочерним элементом (например, GtkTreeView, зависящий от GtkTreeModel), вы должны явно указать все такие объекты в object_ids .

gtk_builder_add_objects_from_string ()

gboolean
gtk_builder_add_objects_from_string (GtkBuilder *builder,
                                     const char *buffer,
                                     gssize length,
                                     const char **object_ids,
                                     GError **error);

Парсит строку, содержащую определение пользовательского интерфейса GtkBuilder, создавая только запрошенные объекты и объединяя их с текущим содержимым builder .

При ошибках возвращается FALSE и error получает GError из области GTK_BUILDER_ERROR или G_MARKUP_ERROR.

Если вы добавляете объект, зависящий от объекта, который не является его дочерним элементом (например, GtkTreeView, зависящий от GtkTreeModel), вы должны явно указать все такие объекты в object_ids .

gtk_builder_add_objects_from_resource ()

gboolean
gtk_builder_add_objects_from_resource (GtkBuilder *builder,
                                       const char *resource_path,
                                       const char **object_ids,
                                       GError **error);

Парсит ресурсный файл, содержащий определение пользовательского интерфейса GtkBuilder, создавая только запрошенные объекты и объединяя их с текущим содержимым builder .

При ошибках возвращается 0 и error получает GError из области GTK_BUILDER_ERROR, G_MARKUP_ERROR или G_RESOURCE_ERROR.

Если вы добавляете объект, зависящий от объекта, который не является его дочерним элементом (например, GtkTreeView, зависящий от GtkTreeModel), вы должны явно указать все такие объекты в object_ids .

gtk_builder_extend_with_template ()

gboolean
gtk_builder_extend_with_template (GtkBuilder *builder,
                                  GObject *object,
                                  GType template_type,
                                  const char *buffer,
                                  gssize length,
                                  GError **error);

Основная закрытая точка входа для построения составных контейнерных компонентов из шаблона XML.

Это экспортируется исключительно для того, чтобы gtk-builder-tool мог проверять шаблоны, приложениям нет необходимости вызывать эту функцию.

gtk_builder_get_object ()

GObject *
gtk_builder_get_object (GtkBuilder *builder,
                        const char *name);

Получает объект с именем name. Обратите внимание, что эта функция не увеличивает счетчик ссылок возвращаемого объекта.

gtk_builder_get_objects ()

GSList *
gtk_builder_get_objects (GtkBuilder *builder);

Получает все объекты, созданные с помощью builder. Обратите внимание, что эта функция не увеличивает счетчики ссылок возвращаемых объектов.

gtk_builder_expose_object ()

void
gtk_builder_expose_object (GtkBuilder *builder,
                           const char *name,
                           GObject *object);

Добавляет object в пул объектов builder, чтобы его можно было ссылаться, как и на любой другой объект, созданный с помощью builder.

gtk_builder_set_current_object ()

void
gtk_builder_set_current_object (GtkBuilder *builder,
                                GObject *current_object);

Устанавливает текущий объект для builder. Текущий объект можно рассматривать как объект, для которого builder работает, и он часто используется в качестве объекта по умолчанию, когда объект является необязательным.

Например, gtk_widget_init_template() установит текущий объект в виджет, для которого инициируется шаблон. Для функций, таких как gtk_builder_new_from_resource(), текущий объект будет NULL.

gtk_builder_get_current_object ()

GObject *
gtk_builder_get_current_object (GtkBuilder *builder);

Получает текущий объект, установленный с помощью gtk_builder_set_current_object().

gtk_builder_set_scope ()

void
gtk_builder_set_scope (GtkBuilder *builder,
                       GtkBuilderScope *scope);

Устанавливает область действия, в которой должен работать builder.

Если scope является NULL, будет создан новый GtkBuilderCScope.

См. документацию GtkBuilderScope для получения подробностей.

gtk_builder_get_scope ()

GtkBuilderScope *
gtk_builder_get_scope (GtkBuilder *builder);

Получает используемую область действия, установленную с помощью gtk_builder_set_scope().

См. документацию GtkBuilderScope для получения подробностей.

gtk_builder_set_translation-domain ()

void
gtk_builder_set_translation_domain (GtkBuilder *builder,
                                    const char *domain);

Устанавливает домен перевода для builder. См. “translation-domain”.

gtk_builder_get_translation_domain ()

const char *
gtk_builder_get_translation_domain (GtkBuilder *builder);

Получает домен перевода для builder.

gtk_builder_get_type_from_name ()

GType
gtk_builder_get_type_from_name (GtkBuilder *builder,
                                const char *type_name);

Ищет тип по имени, используя виртуальную функцию, имеющуюся у GtkBuilder для этой цели. Это используется главным образом при реализации интерфейса GtkBuildable для типа.

gtk_builder_value_from_string ()

gboolean
gtk_builder_value_from_string (GtkBuilder *builder,
                               GParamSpec *pspec,
                               const char *string,
                               GValue *value,
                               GError **error);

Эта функция извлекает значение из строки. Эта функция вызывает g_value_init() для аргумента value, поэтому его не нужно предварительно инициализировать.

Эта функция может обрабатывать значения типов char, uchar, boolean, int, uint, long, ulong, enum, flags, float, double, string, GdkRGBA и GtkAdjustment. Поддержка значений типа GtkWidget ещё предстоит.

В случае ошибок будет возвращено FALSE и error будет назначена ошибка GError из домена GTK_BUILDER_ERROR.

gtk_builder_value_from_string_type ()

gboolean
gtk_builder_value_from_string_type (GtkBuilder *builder,
                                    GType type,
                                    const char *string,
                                    GValue *value,
                                    GError **error);

Подобно gtk_builder_value_from_string(), эта функция извлекает значение из строки, но принимает GType вместо GParamSpec. Эта функция вызывает g_value_init() для аргумента value, поэтому его не нужно предварительно инициализировать.

В случае ошибок будет возвращено FALSE и error будет назначена ошибка GError из домена GTK_BUILDER_ERROR.

GTK_BUILDER_WARN_INVALID_CHILD_TYPE()

#define             GTK_BUILDER_WARN_INVALID_CHILD_TYPE(object, type)

Эта макрокоманда должна использоваться для выдачи предупреждения о неожиданном значении type в реализации add_child интерфейса GtkBuildable.