GtkUIManager

Определения пользовательского интерфейса

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

Существуют некоторые дополнительные ограничения, помимо тех, что указаны в DTD, например, каждый элемент панели инструментов должен иметь панель инструментов в своём предке, а каждый элемент меню должен иметь строку меню или всплывающее меню в своём предке. Поскольку для анализа описания пользовательского интерфейса используется GMarkupParser, оно должно быть не только корректным XML, но и корректной разметкой.

Если имя не указано, оно по умолчанию равно действию. Если действие также не указано, используется имя элемента. Атрибуты name и action не должны содержать символов «/» после разбора (так как это нарушило бы поиск пути) и должны быть применимы в качестве атрибутов XML, когда заключены в двойные кавычки, поэтому они не должны содержать символов «"» или ссылки на сущность ".

Определение пользовательского интерфейса

Построенная иерархия виджетов очень похожа на дерево элементов XML, за исключением того, что заполнители объединяются с их родителями. Соответствие элементов XML виджетам должно быть почти очевидным:

Атрибут «position» определяет, где построенный виджет размещается относительно своих соседей в частично построенном дереве. Если он равен «top», виджет добавляется в начало, в противном случае он добавляется в конец.

Объединение пользовательских интерфейсов

Наиболее примечательная особенность GtkUIManager заключается в том, что он может наложить набор элементов меню и элементов инструментов поверх другого и затем разъединить их.

Объединение выполняется на основе имён элементов XML. Каждый элемент идентифицируется путём, состоящим из имён его предков, разделённых косыми чертами. Например, элемент меню с именем «Left» в приведённом выше примере имеет путь /ui/menubar/JustifyMenu/Left и элемент панели инструментов с тем же именем имеет путь /ui/toolbar1/JustifyToolItems/Left.

Ускорители

Каждое действие имеет путь ускорителя. Ускорители устанавливаются вместе с прокси элементами меню, но их также можно явно добавить с помощью элементов <accelerator> в определении пользовательского интерфейса. Это позволяет иметь ускорители для действий, даже если у них нет видимых прокси.

Умные разделители

Разделители, созданные GtkUIManager, являются «умными», т. е. они не отображаются в пользовательском интерфейсе, если они не оказываются между двумя видимыми элементами меню или панели инструментов. Разделители, которые расположены в самом начале или конце меню или панели инструментов, содержащих их, или несколько разделителей рядом друг с другом, скрываются. Это полезная функция, так как объединение элементов пользовательского интерфейса из нескольких источников может затруднить или сделать невозможным предварительное определение того, окажется ли разделитель в таком неудачном положении.

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

Пустые меню

Всплывающие меню создают аналогичные проблемы с разделителями в связи с объединением. Невозможно заранее узнать, окажутся ли они пустыми после объединения. GtkUIManager предлагает два способа обработки пустых всплывающих меню:

Поведение выбирается на основе свойства «hide_if_empty» действия, к которому относится всплывающее меню.

GtkUIManager в качестве GtkBuildable

Реализация GtkUIManager интерфейса GtkBuildable принимает объекты GtkActionGroup в качестве элементов <child> в определениях пользовательского интерфейса.

Определение пользовательского интерфейса GtkUIManager, описанное выше, может быть встроено в элемент <object> GtkUIManager в определении пользовательского интерфейса GtkBuilder.

Виджеты, которые строятся GtkUIManager, могут быть встроены в другие части построенного пользовательского интерфейса с помощью атрибута «constructor». См. пример ниже.

struct GtkUIManager

struct GtkUIManager;

перечисление GtkUIManagerItemType

Эти значения перечисления используются функцией gtk_ui_manager_add_ui() для определения элемента UI, который нужно создать.

Свойство “add-tearoffs”

  “add-tearoffs”             gboolean

Свойство "add-tearoffs" управляет отображением пунктов меню разрыва в сгенерированных меню.

Обратите внимание, что это влияет только на обычные меню. В сгенерированных всплывающих меню пунктов меню разрыва нет.

Владелец: GtkUIManager

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С: 2.4

Свойство “ui”

  “ui”                       char *

Строка XML, описывающая объединённый UI.

Владелец: GtkUIManager

Флаги: Чтение

Значение по умолчанию: "<ui>\n</ui>\n"

Сигнал “actions-changed”

void
user_function (GtkUIManager *manager,
               gpointer      user_data)

Сигнал ::actions-changed генерируется всякий раз, когда изменяется набор действий.

Флаги: Без рекурсии

С версии: 2.4

Сигнал “add-widget”

void
user_function (GtkUIManager *manager,
               GtkWidget    *widget,
               gpointer      user_data)

Сигнал ::add-widget генерируется для каждого сгенерированного меню и панели инструментов. Он не генерируется для сгенерированных всплывающих меню, которые можно получить с помощью gtk_ui_manager_get_widget().

Флаги: Без рекурсии

С версии: 2.4

Сигнал “connect-proxy”

void
user_function (GtkUIManager *manager,
               GtkAction    *action,
               GtkWidget    *proxy,
               gpointer      user_data)

Сигнал ::connect-proxy генерируется после подключения прокси к действию в группе.

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

Флаги: Без рекурсии

С версии: 2.4

Сигнал “disconnect-proxy”

void
user_function (GtkUIManager *manager,
               GtkAction    *action,
               GtkWidget    *proxy,
               gpointer      user_data)

Сигнал ::disconnect-proxy генерируется после отключения прокси от действия в группе.

Флаги: Без рекурсии

С версии: 2.4

Сигнал “post-activate”

void
user_function (GtkUIManager *manager,
               GtkAction    *action,
               gpointer      user_data)

Сигнал ::post-activate генерируется сразу после активации action.

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

Флаги: Без рекурсии

С версии: 2.4

Сигнал “pre-activate”

void
user_function (GtkUIManager *manager,
               GtkAction    *action,
               gpointer      user_data)

Сигнал ::pre-activate генерируется непосредственно перед активацией action.

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

Флаги: Без рекурсии

С версии: 2.4