Файлы ресурсов

Файлы по умолчанию

Приложение может заставить GTK+ проанализировать определённый файл RC, вызвав gtk_rc_parse(). Кроме того, некоторые файлы будут прочитаны в конце gtk_init(). Если не изменены, ищутся файлы SYSCONFDIR/gtk-2.0/gtkrc и .gtkrc-3.0 в домашнем каталоге пользователя. (SYSCONFDIR по умолчанию равен /usr/local/etc. Его можно изменить с помощью опций --prefix или --sysconfdir при конфигурировании GTK+.)

Набор этих файлов «по умолчанию» можно получить с помощью gtk_rc_get_default_files() и изменить с помощью gtk_rc_add_default_file() и gtk_rc_set_default_files(). Кроме того, переменная окружения GTK2_RC_FILES может быть установлена в список файлов, разделённых G_SEARCHPATH_SEPARATOR_S, для переопределения набора файлов по умолчанию во время выполнения.

Локализованные файлы

Для каждого файла RC, помимо самого файла, GTK+ будет искать локально специфичный файл, который будет проанализирован после основного файла. Например, если LANG установлено как ja_JP.ujis, при загрузке файла по умолчанию ~/.gtkrc, GTK+ ищет файлы ~/.gtkrc.ja_JP и ~/.gtkrc.ja и анализирует первый из них, если он существует.

Имена путей и шаблоны

Файл ресурсов определяет ряд стилей и сочетаний клавиш и привязывает их к определённым виджетам. Привязка выполняется с помощью объявлений widget, widget_class и class. Например:

привязывает стиль "my-entry-class" ко всем виджетам, чья «путь к виджету» соответствует «шаблону» "mywindow.*.GtkEntry". То есть все виджеты GtkEntry, которые являются частью окна GtkWindow с именем "mywindow".

Здесь шаблоны заданы в стандартном синтаксисе оболочки glob. Символ "?" соответствует любому символу, а "*" соответствует нулю или более любых символов. Три типа сопоставления выполняются относительно пути к виджету, «пути к классу» и иерархии классов. И путь к виджету, и путь к классу состоят из списка всех родителей виджета и самого виджета, разделенных символом ".", от внешнего к внутреннему. Разница в том, что в пути к виджету, если присутствует, используется имя, заданное функцией gtk_widget_set_name(), в противном случае используется имя класса виджета, а для пути к классу всегда используется имя класса.

Начиная с GTK+ 2.10, пути widget_class также могут содержать подстроки <classname>, которые соответствуют классу с указанным именем и всем производным классам. Например,

будет соответствовать виджетам GtkLabel, которые находятся в любой строке меню.

Таким образом, если у вас есть виджет GtkEntry с именем "myentry", внутри горизонтальной панели в окне с именем "mywindow", то путь к виджету: "mywindow.GtkHBox.myentry", а путь к классу: "GtkWindow.GtkHBox.GtkEntry".

Сопоставление с классом немного отличается. Проверка шаблона выполняется для всех имён классов в иерархии классов виджета (а не в иерархии компоновки) последовательно, поэтому шаблон:

будет соответствовать не только виджетам GtkButton, но также виджетам GtkToggleButton и GtkCheckButton, так как эти классы наследуются от GtkButton.

Кроме того, для каждого шаблона можно указать приоритет, и стили переопределяют другие стили сначала по приоритету, затем по типу шаблона и затем по порядку указания (позже переопределяет ранее).

rc является значением по умолчанию для стилей, считываемых из файла RC, theme является значением по умолчанию для стилей, считываемых из файлов темы RC, application следует использовать для стилей, которые устанавливает приложение, и gtk используется для стилей, созданных GTK+ внутри.

Файлы темы gtkrc

Файлы темы RC сначала загружаются из ~/.themes/, затем из каталога, заданного gtk_rc_get_theme_dir(). Просматриваемые файлы будут gtk-3.0/gtkrc.

Когда приложение предпочитает тёмные темы (см. свойство “gtk-application-prefer-dark-theme” для подробностей), gtk-3.0/gtkrc-dark загружается первым, и если он отсутствует, загружается gtk-3.0/gtkrc.

Оптимизация сопоставления стилей RC

Каждый раз, когда виджет создаётся и добавляется в иерархию компоновки GtkWindow («закреплён»), составляется список соответствующих стилей RC из всех прочитанных стилей RC. Для этого каждый стиль RC сопоставляется с путём к классу виджета, путём к имени виджета и иерархией наследования виджета. Вследствие этого значительное замедление может быть вызвано использованием большого числа стилей RC и использованием шаблонов стилей RC, которые медленно или сложно сопоставляются с данным виджетом. В следующем упорядоченном списке приведены несколько советов (упорядоченных по эффективности) для уменьшения накладных расходов на сопоставление стилей RC:

Декларации верхнего уровня

Файл RC — это текстовый файл, состоящий из последовательности деклараций. Символы “#” обозначают комментарии, а часть строки после “#” игнорируется при парсинге файла RC.

Возможные декларации верхнего уровня:

Стили

Стиль RC задаётся декларацией style в файле RC, а затем связывается с виджетами с помощью деклараций widget, widget_class или class. Все стили, применяемые к конкретному виджету, комбинируются вместе, причём декларации widget переопределяют декларации widget_class, которые, в свою очередь, переопределяют декларации class. Внутри каждого типа деклараций последующие декларации переопределяют предыдущие.

Внутри декларации style возможные элементы:

Цвета и фоновые пиксельные рисунки задаются как функция состояния виджета. Состояния:

Связывания клавиш

Связывания клавиш позволяют пользователю задавать действия, которые должны выполняться при нажатии определённых клавиш. Формат объявления набора связываний:

key — это строка, состоящая из набора модификаторов, за которыми следует имя клавиши. Модификаторы могут быть:

<shft> — это псевдоним для <shift>, <ctl> — это псевдоним для <control>, а <alt> — это псевдоним для <mod1>.

Действие, привязанное к клавише, представляет собой последовательность имён сигналов (строки) и параметров для каждого сигнала. Сигналы должны быть сигналами действий. (См. g_signal_new()). Каждый параметр может быть числом с плавающей точкой, целым числом, строкой или необрамлённой строкой, представляющей значение перечисления. Типы указанных параметров должны соответствовать типам параметров сигнала.

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

gtk_rc_scanner_new ()

GScanner *
gtk_rc_scanner_new (void);

[skip]

gtk_rc_get_style ()

GtkStyle *
gtk_rc_get_style (GtkWidget *widget);

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

gtk_rc_get_style_by_paths ()

GtkStyle *
gtk_rc_get_style_by_paths (GtkSettings *settings,
                           const char *widget_path,
                           const char *class_path,
                           GType type);

Создаёт GtkStyle из стилей, определённых в файле RC, предоставляя исходные компоненты, используемые для соответствия. Эта функция может быть полезной при создании псевдо-виджетов, которые должны быть оформлены как виджеты, но фактически не имеют соответствующих виджетов GTK+. Примером этого являются элементы внутри виджета GNOME canvas.

Действие gtk_rc_get_style() аналогично:

widget "mywindow.*.GtkEntry" style "my-entry-class"

gtk_rc_parse ()

void
gtk_rc_parse (const gchar *filename);

Парсит указанный файл ресурсов.

gtk_rc_parse_string ()

void
gtk_rc_parse_string (const gchar *rc_string);

Парсит информацию о ресурсах непосредственно из строки.

gtk_rc_reparse_all ()

gboolean
gtk_rc_reparse_all (void);

Если время изменения любого ранее прочитанного файла для по умолчанию GtkSettings изменилось, то отбросьте всю информацию о стиле и перечитайте все ранее прочитанные файлы RC.

gtk_rc_reparse_all_for_settings ()

gboolean
gtk_rc_reparse_all_for_settings (GtkSettings *settings,
                                 gboolean force_load);

Если время изменения любого ранее прочитанного файла для заданного GtkSettings изменилось, отбросьте всю информацию о стиле и перечитайте все ранее прочитанные файлы RC.

gtk_rc_reset_styles ()

void
gtk_rc_reset_styles (GtkSettings *settings);

Эта функция пересчитывает стили для всех виджетов, использующих определённый объект GtkSettings. (Существует один объект GtkSettings на GdkScreen, см. gtk_settings_get_for_screen()); она полезна, когда изменился какой-либо глобальный параметр, влияющий на внешний вид всех виджетов, так как при получении виджетом нового стиля происходит как перерисовка, так и пересчёт любой кэшированной информации о его внешнем виде. Пример: используется при изменении размера шрифта по умолчанию, заданного операционной системой. Обратите внимание, что эта функция не влияет на виджеты, у которых стиль задан явно с помощью gtk_widget_set_style().

С: 2.4

gtk_rc_add_default_file ()

void
gtk_rc_add_default_file (const gchar *filename);

Добавляет файл в список файлов, которые будут обработаны в конце gtk_init().

gtk_rc_get_default_files ()

gchar **
gtk_rc_get_default_files (void);

Возвращает текущий список файлов RC, которые будут обработаны в конце gtk_init().

gtk_rc_set-default-files ()

void
gtk_rc_set_default_files (gchar **filenames);

Устанавливает список файлов, которые GTK+ будет читать в конце gtk_init().

gtk_rc_parse_color ()

guint
gtk_rc_parse_color (GScanner *scanner,
                    GdkColor *color);

Парсит цвет в формате, ожидаемом в файле RC.

Обратите внимание, что движки тем должны использовать gtk_rc_parse_color_full(), чтобы поддерживать символические цвета.

gtk_rc_parse_color_full ()

guint
gtk_rc_parse_color_full (GScanner *scanner,
                         GtkRcStyle *style,
                         GdkColor *color);

Парсит цвет в формате, ожидаемом в файле RC. Если style не NULL, он будет использован для разрешения ссылок на символические цвета.

С версии 2.12

gtk_rc_parse_state ()

guint
gtk_rc_parse_state (GScanner *scanner,
                    GtkStateType *state);

Парсит переменную GtkStateType в формате, ожидаемом в файле RC.

gtk_rc_parse_priority ()

guint
gtk_rc_parse_priority (GScanner *scanner,
                       GtkPathPriorityType *priority);

Парсит переменную GtkPathPriorityType в формате, ожидаемом в файле RC.

gtk_rc_find_module_in_path ()

gchar *
gtk_rc_find_module_in_path (const gchar *module_file);

Ищет движок темы в пути поиска GTK+. Эта функция не полезна для приложений и не должна использоваться.

gtk_rc_find_pixmap_in_path ()

gchar *
gtk_rc_find_pixmap_in_path (GtkSettings *settings,
                            GScanner *scanner,
                            const gchar *pixmap_file);

Ищет файл в пути к пиктограммам для указанных GtkSettings. Если файл не найден, выводится сообщение об ошибке с помощью g_warning() и возвращается NULL.

gtk_rc_get_module_dir ()

gchar *
gtk_rc_get_module_dir (void);

Возвращает каталог, в котором GTK+ ищет движки тем. Полную информацию о поиске движков тем см. в документации для GTK_PATH в Запуске приложений GTK+.

gtk_rc_get_im-module-path ()

gchar *
gtk_rc_get_im_module_path (void);

Получает путь, в котором искать модули IM. Дополнительную информацию о поиске модулей см. в документации переменной среды GTK_PATH. Эта функция полезна только для утилит, поставляемых с GTK+, и обычно не должна использоваться приложениями.

gtk_rc_get_im_module_file ()

gchar *
gtk_rc_get_im_module_file (void);

Получает путь к файлу модулей IM. Дополнительную информацию см. в документации переменной среды GTK_IM_MODULE_FILE.

gtk_rc_get_theme_dir ()

gchar *
gtk_rc_get_theme_dir (void);

Возвращает стандартный каталог, в котором должны быть установлены темы. (GTK+ фактически не использует этот каталог.)

gtk_rc_style_new ()

GtkRcStyle *
gtk_rc_style_new (void);

Создаёт новый GtkRcStyle без установленных полей и счётчиком ссылок 1.

gtk_rc_style_copy ()

GtkRcStyle *
gtk_rc_style_copy (GtkRcStyle *orig);

Создаёт копию указанного GtkRcStyle. Эта функция корректно скопирует стиль RC, который является членом класса, производного от GtkRcStyle.

GtkRcStyle

typedef struct {
  gchar *name;
  gchar *bg_pixmap_name[5];
  PangoFontDescription *font_desc;

  GtkRcFlags color_flags[5];
  GdkColor   fg[5];
  GdkColor   bg[5];
  GdkColor   text[5];
  GdkColor   base[5];

  gint xthickness;
  gint ythickness;
} GtkRcStyle;

Структура GtkRcStyle используется для представления набора информации о внешнем виде виджета. Позже её можно комбинировать с другими структурами GtkRcStyle<!-- --> для формирования структуры GtkStyle.

struct GtkRcStyleClass

struct GtkRcStyleClass {
  GObjectClass parent_class;


  /* Create an empty RC style of the same type as this RC style.
   * The default implementation, which does
   * g_object_new (G_OBJECT_TYPE (style), NULL);
   * should work in most cases.
   */
  GtkRcStyle * (*create_rc_style) (GtkRcStyle *rc_style);

  /* Fill in engine specific parts of GtkRcStyle by parsing contents
   * of brackets. Returns G_TOKEN_NONE if successful, otherwise returns
   * the token it expected but didn't get.
   */
  guint     (*parse)  (GtkRcStyle   *rc_style,
                       GtkSettings  *settings,
                       GScanner     *scanner);

  /* Combine RC style data from src into dest. If overridden, this
   * function should chain to the parent.
   */
  void      (*merge)  (GtkRcStyle *dest,
                       GtkRcStyle *src);

  /* Create an empty style suitable to this RC style
   */
  GtkStyle * (*create_style) (GtkRcStyle *rc_style);
};

enum GtkRcFlags

Устарело

enum GtkRcTokenType

Перечисление GtkRcTokenType представляет токены в RC-файле. Оно предоставляется для того, чтобы движки тем могли повторно использовать эти токены при разборе частей RC-файла, специфичных для движка тем.

Перечисление GtkPathType

Типы путей виджетов. См. также gtk_binding_set_add_path().