GtkApplication

gtk_application_new ()

GtkApplication *
gtk_application_new (const char *application_id,
                     GApplicationFlags flags);

Создаёт новый экземпляр GtkApplication.

При использовании GtkApplication нет необходимости вручную вызывать gtk_init(). Он вызывается, как только приложение регистрируется в качестве основного экземпляра.

Конкретно, gtk_init() вызывается в обработчике по умолчанию для сигнала “startup”. Поэтому подклассы GtkApplication должны вызывать родительский обработчик в своём обработчике “startup” перед использованием любого API GTK+.

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

Если не NULL, идентификатор приложения должен быть корректным. См. g_application_id_is_valid().

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

gtk_application_add_window ()

void
gtk_application_add_window (GtkApplication *application,
                            GtkWindow *window);

Добавляет окно в application .

Этот вызов может выполняться только после запуска application; обычно новые окна приложения добавляются в ответ на вызов сигнала “activate”.

Этот вызов эквивалентен установке свойства “application” окна window на application.

Обычно связь между приложением и окном сохраняется до уничтожения окна, но вы можете явно удалить её с помощью gtk_application_remove_window().

GTK+ будет держать application запущенным, пока в нём есть окна.

gtk_application_remove_window ()

void
gtk_application_remove_window (GtkApplication *application,
                               GtkWindow *window);

Удаляет окно из application .

Если window принадлежит application, то этот вызов эквивалентен установке свойства “application” окна window на NULL.

Приложение может завершить работу в результате вызова этой функции.

gtk_application_get_windows ()

GList *
gtk_application_get_windows (GtkApplication *application);

Возвращает список GtkWindows, связанных с application .

Список отсортирован по последнему сфокусированному окну, так что первый элемент — это текущее активное окно. (Полезно для выбора родительского окна для временного окна.)

Возвращённый список не должен изменяться. Он останется действительным только до следующего изменения фокуса или создания или удаления окна.

gtk_application_get_window_by_id ()

GtkWindow *
gtk_application_get_window_by_id (GtkApplication *application,
                                  guint id);

Возвращает GtkApplicationWindow с заданным идентификатором.

Идентификатор GtkApplicationWindow можно получить с помощью gtk_application_window_get_id().

gtk_application_get_active_window ()

GtkWindow *
gtk_application_get_active_window (GtkApplication *application);

Получает «активное» окно приложения.

Активное окно — это окно, которое было сфокусировано последним (в пределах приложения). Это окно может не иметь фокуса в данный момент, если им владеет другое приложение — это просто последнее сфокусированное окно в этом приложении.

gtk_application_inhibit ()

guint
gtk_application_inhibit (GtkApplication *application,
                         GtkWindow *window,
                         GtkApplicationInhibitFlags flags,
                         const char *reason);

Сообщите диспетчеру сеанса, что определённые типы действий должны быть запрещены. Это не гарантируется на всех платформах и для всех типов действий.

Приложения должны вызывать этот метод, когда они начинают операцию, которую не следует прерывать, например, создание CD или DVD. Типы действий, которые могут быть заблокированы, определяются параметром flags. Когда приложение завершит операцию, оно должно вызвать gtk_application_uninhibit(), чтобы снять ингибитор. Обратите внимание, что приложение может иметь несколько ингибиторов, и все они должны быть удалены индивидуально. Ингибиторы также очищаются при выходе из приложения.

Приложения не должны ожидать, что они всегда смогут заблокировать действие. В большинстве случаев пользователю будет предоставлен вариант принудительного выполнения действия.

Причины должны быть краткими и по существу.

Если указан window, диспетчер сеанса может направить пользователя к этому окну, чтобы узнать больше о том, почему действие запрещено.

gtk_application_uninhibit ()

void
gtk_application_uninhibit (GtkApplication *application,
                           guint cookie);

Удаляет ингибитор, который был установлен с помощью gtk_application_inhibit(). Ингибиторы также очищаются при выходе приложения.

gtk_application_get_menubar ()

GMenuModel *
gtk_application_get_menubar (GtkApplication *application);

Возвращает модель меню, которая была установлена с помощью gtk_application_set_menubar().

gtk_application_set_menubar ()

void
gtk_application_set_menubar (GtkApplication *application,
                             GMenuModel *menubar);

Устанавливает или сбрасывает панель меню для окон application .

Это панель меню в традиционном понимании.

Это может быть выполнено только в основном экземпляре приложения после его регистрации. “Запуск” — хорошее место для этого.

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

Используйте базовый интерфейс GActionMap для добавления действий и для реагирования на выбор пользователем этих пунктов меню.

gtk_application_get_menu_by_id ()

GMenu *
gtk_application_get_menu_by_id (GtkApplication *application,
                                const char *id);

Получает меню из автоматически загруженных ресурсов. Дополнительную информацию см. в разделе Автоматические ресурсы.

gtk_application_list_action_descriptions ()

char **
gtk_application_list_action_descriptions
                               (GtkApplication *application);

Выводит подробные имена действий, у которых есть связанные ускорители. См. gtk_application_set_accels_for_action().

gtk_application_get_accels_for_action ()

char **
gtk_application_get_accels_for_action (GtkApplication *application,
                                       const char *detailed_action_name);

Получает ускорители, которые в настоящее время связаны с заданным действием.

gtk_application_set_accels_for_action ()

void
gtk_application_set_accels_for_action (GtkApplication *application,
                                       const char *detailed_action_name,
                                       const char * const *accels);

Устанавливает один или несколько сочетаний клавиш, которые будут вызывать указанное действие. Первый элемент в accels будет являться основным сочетанием, которое может отображаться в пользовательском интерфейсе.

Чтобы удалить все сочетания клавиш для действия, используйте пустой, завершающийся нулём массив для accels .

Для detailed_action_name, см. g_action_parse_detailed_name() и g_action_print_detailed_name().

gtk_application_get_actions_for_accel ()

char **
gtk_application_get_actions_for_accel (GtkApplication *application,
                                       const char *accel);

Возвращает список действий (возможно, пустой), которым соответствует accel. Каждый элемент в списке — это подробное имя действия в обычном формате.

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

В случае отсутствия действий для данного сочетания клавиш возвращается пустой массив. NULL никогда не возвращается.

Ошибка программиста — передача недопустимой строки сочетания клавиш. Если вы не уверены, сначала проверьте её с помощью gtk_accelerator_parse().