GtkBuilder

GtkBuilderConnectFunc ()

void
(*GtkBuilderConnectFunc) (GtkBuilder *builder,
                          GObject *object,
                          const gchar *signal_name,
                          const gchar *handler_name,
                          GObject *connect_object,
                          GConnectFlags flags,
                          gpointer user_data);

Это сигнатура функции, используемой для подключения сигналов. Она используется методами gtk_builder_connect_signals() и gtk_builder_connect_signals_full(). Она предназначена в основном для привязки интерпретируемых языков, но может быть полезна, когда программист хочет больше контроля над процессом подключения сигнала. Обратите внимание, что эту функцию можно вызвать только один раз, последующие вызовы ничего не сделают.

С: 2.12

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(), gtk_builder_new_from_resource() или gtk_builder_new_from_string().

С: 2.12

gtk_builder_new_from_file ()

GtkBuilder *
gtk_builder_new_from_file (const gchar *filename);

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

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

С: 3.10

gtk_builder_new_from_resource ()

GtkBuilder *
gtk_builder_new_from_resource (const gchar *resource_path);

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

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

С: 3.10

gtk_builder_new_from_string ()

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

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

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

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

С: 3.10

gtk_builder_add_callback_symbol ()

void
gtk_builder_add_callback_symbol (GtkBuilder *builder,
                                 const gchar *callback_name,
                                 GCallback callback_symbol);

Добавляет callback_symbol в область видимости builder под заданным callback_name .

Использование этой функции переопределяет поведение gtk_builder_connect_signals() для любых символов обратного вызова, которые добавляются. Это позволяет лучше изолировать код, так как не требует объявления символов обратного вызова в глобальном пространстве имён.

С: 3.10

gtk_builder_add_callback_symbols ()

void
gtk_builder_add_callback_symbols (GtkBuilder *builder,
                                  const gchar *first_callback_name,
                                  GCallback first_callback_symbol,
                                  ...);

Функция-обёртка для добавления нескольких обратных вызовов вместо вызова gtk_builder_add_callback_symbol() для каждого символа.

С: 3.10

gtk_builder_lookup_callback_symbol ()

GCallback
gtk_builder_lookup_callback_symbol (GtkBuilder *builder,
                                    const gchar *callback_name);

Извлекает символ, ранее добавленный в builder с помощью gtk_builder_add_callback_symbols()

Эта функция предназначена для возможного использования в привязках языка или для любых случаев, когда пользователь может настраивать подключения сигналов с помощью gtk_builder_connect_signals_full()

[skip]

С: 3.10

gtk_builder_add_from_file ()

guint
gtk_builder_add_from_file (GtkBuilder *builder,
                           const gchar *filename,
                           GError **error);

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

Большинству пользователей, вероятно, захочется использовать gtk_builder_new_from_file().

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

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

С: 2.12

gtk_builder_add_from_resource ()

guint
gtk_builder_add_from_resource (GtkBuilder *builder,
                               const gchar *resource_path,
                               GError **error);

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

Большинству пользователей, вероятно, захочется использовать gtk_builder_new_from_resource().

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

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

С: 3.4

gtk_builder_add_from_string ()

guint
gtk_builder_add_from_string (GtkBuilder *builder,
                             const gchar *buffer,
                             gsize length,
                             GError **error);

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

Большинству пользователей, вероятно, захочется использовать gtk_builder_new_from_string().

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

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

С: 2.12

gtk_builder_add_objects_from_file ()

guint
gtk_builder_add_objects_from_file (GtkBuilder *builder,
                                   const gchar *filename,
                                   gchar **object_ids,
                                   GError **error);

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

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

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

С: 2.14

gtk_builder_add_objects_from_string ()

guint
gtk_builder_add_objects_from_string (GtkBuilder *builder,
                                     const gchar *buffer,
                                     gsize length,
                                     gchar **object_ids,
                                     GError **error);

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

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

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

С: 2.14

gtk_builder_add_objects_from_resource ()

guint
gtk_builder_add_objects_from_resource (GtkBuilder *builder,
                                       const gchar *resource_path,
                                       gchar **object_ids,
                                       GError **error);

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

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

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

С: 3.4

gtk_builder_extend_with_template ()

guint
gtk_builder_extend_with_template (GtkBuilder *builder,
                                  GtkWidget *widget,
                                  GType template_type,
                                  const gchar *buffer,
                                  gsize length,
                                  GError **error);

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

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

gtk_builder_get_object ()

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

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

С: 2.12

gtk_builder_get_objects ()

GSList *
gtk_builder_get_objects (GtkBuilder *builder);

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

С: 2.12

gtk_builder_expose_object ()

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

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

С: 3.8

gtk_builder_connect_signals ()

void
gtk_builder_connect_signals (GtkBuilder *builder,
                             gpointer user_data);

Этот метод является более простым вариантом метода gtk_builder_connect_signals_full(). Он использует символы, явно добавленные в builder с помощью предыдущих вызовов gtk_builder_add_callback_symbol(). В случае, если символы не были явно добавлены, он использует возможности интроспекции GModule (открывая модуль NULL) для поиска символов в таблице символов приложения. Затем он пытается сопоставить имена обработчиков сигналов, указанные в описании интерфейса, с символами в приложении и подключает сигналы. Обратите внимание, что этот метод можно вызвать только один раз, последующие вызовы ничего не сделают.

Обратите внимание, что если для всех обработчиков сигналов, на которые ссылается загруженный XML, не был вызван gtk_builder_add_callback_symbol(), этот метод потребует поддержки GModule на платформе.

Если вы полагаетесь на поддержку GModule для поиска обратных вызовов в таблице символов, необходимо учитывать следующие моменты:

При компиляции приложений для Windows, вы должны объявлять обратные вызовы сигналов с помощью G_MODULE_EXPORT, иначе они не будут добавлены в таблицу символов. В Linux и других Unix-подобных системах это не требуется; приложения следует компилировать с флагом -Wl,--export-dynamic CFLAGS и связывать их с gmodule-export-2.0.

С версии: 2.12

gtk_builder_connect_signals_full ()

void
gtk_builder_connect_signals_full (GtkBuilder *builder,
                                  GtkBuilderConnectFunc func,
                                  gpointer user_data);

Этот метод можно рассматривать как интерпретируемую версию метода gtk_builder_connect_signals(), за исключением того, что он не требует GModule для корректной работы.

С версии: 2.12

gtk_builder_set_translation_domain ()

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

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

С версии: 2.12

gtk_builder_get_translation_domain ()

const gchar *
gtk_builder_get_translation_domain (GtkBuilder *builder);

Возвращает домен перевода для builder.

С версии: 2.12

gtk_builder_set_application ()

void
gtk_builder_set_application (GtkBuilder *builder,
                             GtkApplication *application);

Устанавливает приложение, связанное с builder.

Этот метод необходим только если в вашем процессе более одного приложения GApplication. application не может быть NULL.

С версии: 3.10

gtk_builder_get_application ()

GtkApplication *
gtk_builder_get_application (GtkBuilder *builder);

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

Приложение GtkApplication используется для создания прокси-объектов действий, как указано в XML, загружаемом строителем.

По умолчанию строитель использует приложение по умолчанию: то, которое задано g_application_get_default(). Если необходимо использовать другое приложение для создания прокси-объектов, используйте gtk_builder_set_application().

С версии: 3.10

gtk_builder_get_type_from_name ()

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

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

С версии: 2.12

gtk_builder_value_from_string ()

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

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

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

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

С: 2.12

gtk_builder_value_from_string_type ()

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

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

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

С: 2.12

GTK_BUILDER_WARN_INVALID_CHILD_TYPE()

#define             GTK_BUILDER_WARN_INVALID_CHILD_TYPE(object, type)

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