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

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

Приложение может заставить GTK+ разобрать определённый файл RC, вызвав gtk_rc_parse(). Кроме того, некоторые файлы будут прочитаны в конце gtk_init(). Если не изменять настройки, GTK+ будет искать файлы 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().

Since: 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);
};

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

Устаревшее

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

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

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

Приоритеты для поиска путей. Смотрите также gtk_binding_set_add_path().

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

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