GtkApplicationWindow

Функции

Свойства

Типы и значения

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkWindow
                ╰── GtkApplicationWindow

Реализованные интерфейсы

GtkApplicationWindow реализует GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkNative, GtkShortcutManager, GtkRoot, GActionGroup и GActionMap.

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkApplicationWindow — это подкласс GtkWindow, предоставляющий дополнительные возможности для лучшей интеграции с функциями GtkApplication. В частности, он может обрабатывать системное меню приложения. См. gtk_application_set_menubar().

Этот класс реализует интерфейсы GActionGroup и GActionMap, чтобы позволить вам добавлять действия, специфичные для окна, которые будут экспортироваться связанным GtkApplication вместе со своими действиями для всего приложения. Действия, специфичные для окна, имеют префикс «win.», а действия для всего приложения — префикс «app.». Действия должны быть адресованы с префиксами при ссылке на них из GMenuModel.

Обратите внимание, что виджеты, размещенные внутри GtkApplicationWindow, также могут активировать эти действия, если они реализуют интерфейс GtkActionable.

Как и в случае с GtkApplication, блокировка GDK будет приобретена при обработке действий, поступающих из других процессов, и поэтому должна удерживаться при активации действий локально (если включены потоки GDK).

Настройки “gtk-shell-shows-app-menu” и “gtk-shell-shows-menubar” сообщают GTK+, отображает ли среда рабочего стола меню приложения и модели системного меню за пределами приложения в качестве части оболочки рабочего стола. Например, в OS X оба меню будут отображаться удаленно; в Windows ни одно из них не будет. gnome-shell (начиная с версии 3.4) будет отображать меню приложения, но не системное меню.

Если среда рабочего стола не отображает системное меню, то GtkApplicationWindow автоматически отобразит системное меню. Это поведение можно переопределить свойством “show-menubar”. Если среда рабочего стола не отображает меню приложения, то оно будет автоматически включено в системное меню или в украшения клиентской стороны окна.

См. GtkPopoverMenu для получения информации о языке XML, используемом GtkBuilder для моделей меню.

GtkApplication *app = gtk_application_new ("org.gtk.test", 0);

GtkBuilder *builder = gtk_builder_new_from_string (
    "<interface>"
    "  <menu id='menubar'>"
    "    <submenu>"
    "      <attribute name='label' translatable='yes'>_Edit</attribute>"
    "      <item>"
    "        <attribute name='label' translatable='yes'>_Copy</attribute>"
    "        <attribute name='action'>win.copy</attribute>"
    "      </item>"
    "      <item>"
    "        <attribute name='label' translatable='yes'>_Paste</attribute>"
    "        <attribute name='action'>win.paste</attribute>"
    "      </item>"
    "    </submenu>"
    "  </menu>"
    "</interface>",
    -1);

GMenuModel *menubar = G_MENU_MODEL (gtk_builder_get_object (builder,
                                                           "menubar"));
gtk_application_set_menubar (GTK_APPLICATION (app), menubar);
g_object_unref (builder);

// ...

GtkWidget *window = gtk_application_window_new (app);

Функции

GtkWidget *
gtk_application_window_new (GtkApplication *application);

void
gtk_application_window_set_show_menubar
                               (GtkApplicationWindow *window,
                                gboolean show_menubar);

gboolean
gtk_application_window_get_show_menubar
                               (GtkApplicationWindow *window);

guint
gtk_application_window_get_id (GtkApplicationWindow *window);

void
gtk_application_window_set_help_overlay
                               (GtkApplicationWindow *window,
                                GtkShortcutsWindow *help_overlay);

GtkShortcutsWindow *
gtk_application_window_get_help_overlay
                               (GtkApplicationWindow *window);

Типы и значения

struct GtkApplicationWindow;

struct GtkApplicationWindowClass {
  GtkWindowClass parent_class;
};

Подробности свойств

  “show-menubar”             gboolean