Изображения-заготовки с темами

gtk_icon_source_copy ()

GtkIconSource *
gtk_icon_source_copy (const GtkIconSource *source);

Создаёт копию source; в основном полезно для языковых привязок.

gtk_icon_source_free ()

void
gtk_icon_source_free (GtkIconSource *source);

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

gtk_icon_factory_add ()

void
gtk_icon_factory_add (GtkIconFactory *factory,
                      const gchar *stock_id,
                      GtkIconSet *icon_set);

Добавляет указанный icon_set в фабрику значков под именем stock_id. stock_id должен быть с пространством имён вашей программы, например, «myapp-whatever-icon». Обычно приложения создают GtkIconFactory, затем добавляют его в список по умолчанию с помощью gtk_icon_factory_add_default(). Затем они передают stock_id виджетам, таким как GtkImage, для отображения значка. Тематика может предоставить значок с тем же именем (например, «myapp-whatever-icon»), чтобы переопределить значки по умолчанию вашего приложения. Если значок уже существовал в factory для stock_id, он становится неиспользуемым и заменяется новым icon_set.

gtk_icon_factory_add_default ()

void
gtk_icon_factory_add_default (GtkIconFactory *factory);

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

gtk_icon_factory_lookup ()

GtkIconSet *
gtk_icon_factory_lookup (GtkIconFactory *factory,
                         const gchar *stock_id);

Ищет stock_id в фабрике значков, возвращая набор значков, если найден, иначе NULL. Для отображения пользователю вы должны использовать gtk_style_lookup_icon_set() на GtkStyle для виджета, который отобразит значок, вместо непосредственного использования этой функции, чтобы учесть темы.

gtk_icon_factory_lookup_default ()

GtkIconSet *
gtk_icon_factory_lookup_default (const gchar *stock_id);

Ищет значок в списке фабрик значков по умолчанию. Для отображения пользователю вы должны использовать gtk_style_lookup_icon_set() на GtkStyle для виджета, который отобразит значок, вместо непосредственного использования этой функции, чтобы учесть темы.

gtk_icon_factory_new ()

GtkIconFactory *
gtk_icon_factory_new (void);

Создаёт новую GtkIconFactory. Фабрика значков управляет набором GtkIconSets; GtkIconSet управляет набором вариантов конкретного значка (то есть GtkIconSet содержит варианты для разных размеров и состояний виджета). Значки в фабрике значков называются с помощью идентификатора значка, который представляет собой простую строку, идентифицирующую значок. У каждого GtkStyle есть список GtkIconFactorys, полученных из текущей темы; эти фабрики значков сначала используются при поиске значка. Если тема не задаёт конкретный значок, GTK+ ищет значок в списке фабрик значков по умолчанию, поддерживаемом gtk_icon_factory_add_default() и gtk_icon_factory_remove_default(). Приложения со значками должны добавить фабрику значков по умолчанию со своими значками, что позволит темам переопределить значки для приложения.

gtk_icon_factory_remove_default ()

void
gtk_icon_factory_remove_default (GtkIconFactory *factory);

Удаляет фабрику иконок из списка стандартных фабрик иконок. Обычно не используется; вы можете использовать её для библиотек, которые можно загружать или выгружать.

gtk_icon_set_add_source ()

void
gtk_icon_set_add_source (GtkIconSet *icon_set,
                         const GtkIconSource *source);

Наборы иконок содержат список GtkIconSource, который они используют в качестве базовых иконок для отображения иконок в различных состояниях и размерах. Иконки масштабируются, изменяют вид в неактивном состоянии и т.д. в gtk_icon_set_render_icon(), но GtkIconSet нуждается в базовых изображениях для работы. Базовые изображения и моменты их использования описываются с помощью GtkIconSource.

Эта функция копирует source, поэтому вы можете повторно использовать тот же источник сразу же, не затрагивая набор иконок.

Пример использования этой функции: иконка «Назад к предыдущей странице» в веб-браузере может указывать в другом направлении на иврите и на английском языке; она может выглядеть иначе в неактивном состоянии; и она может меняться в зависимости от режима панели инструментов (маленькие/большие иконки). Таким образом, один набор иконок будет содержать все эти варианты иконки, и вы можете добавить отдельный источник для каждого из них.

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

gtk_icon_set_new_from_pixbuf() создаёт новый набор иконок со стандартным источником иконок на основе заданного pixbuf.

gtk_icon_set_copy ()

GtkIconSet *
gtk_icon_set_copy (GtkIconSet *icon_set);

Копирует icon_set по значению.

gtk_icon_set_new ()

GtkIconSet *
gtk_icon_set_new (void);

Создаёт новый GtkIconSet. GtkIconSet представляет собой отдельную иконку в различных размерах и состояниях виджетов. Он может предоставлять GdkPixbuf для заданного размера и состояния по запросу и автоматически кеширует некоторые из отрендеренных GdkPixbuf объектов.

Обычно вы будете использовать gtk_widget_render_icon_pixbuf() вместо прямого использования GtkIconSet. Единственный случай, когда вам понадобится GtkIconSet, — это создание наборов иконок, специфичных для приложения, для размещения в GtkIconFactory.

gtk_icon_set_new_from_pixbuf ()

GtkIconSet *
gtk_icon_set_new_from_pixbuf (GdkPixbuf *pixbuf);

Создаёт новый GtkIconSet с pixbuf в качестве изображения по умолчанию/резервного варианта. Если вы не добавите никаких дополнительных GtkIconSource в набор иконок, все варианты иконок будут созданы из pixbuf с использованием масштабирования, пикселизации и т.д. для изменения размера иконки или изменения вида иконки в неактивном/подсвеченном состоянии.

gtk_icon_set_ref ()

GtkIconSet *
gtk_icon_set_ref (GtkIconSet *icon_set);

Увеличивает счётчик ссылок на icon_set.

gtk_icon_set_render_icon ()

GdkPixbuf *
gtk_icon_set_render_icon (GtkIconSet *icon_set,
                          GtkStyle *style,
                          GtkTextDirection direction,
                          GtkStateType state,
                          GtkIconSize size,
                          GtkWidget *widget,
                          const gchar *detail);

Отображает значок с помощью gtk_style_render_icon(). В большинстве случаев gtk_widget_render_icon() лучше, поскольку он автоматически предоставляет большинство аргументов из текущих настроек виджета. Эта функция никогда не возвращает NULL; если значок не может быть отображён (например, из-за ошибки загрузки файла изображения), вместо этого будет возвращён значок по умолчанию «отсутствующее изображение».

gtk_icon_set_render_icon_pixbuf ()

GdkPixbuf *
gtk_icon_set_render_icon_pixbuf (GtkIconSet *icon_set,
                                 GtkStyleContext *context,
                                 GtkIconSize size);

Отображает значок с помощью gtk_render_icon_pixbuf(). В большинстве случаев gtk_widget_render_icon_pixbuf() лучше, поскольку он автоматически предоставляет большинство аргументов из текущих настроек виджета. Эта функция никогда не возвращает NULL; если значок не может быть отображён (например, из-за ошибки загрузки файла изображения), вместо этого будет возвращён значок по умолчанию «отсутствующее изображение».

С: 3.0

gtk_icon_set_render_icon_surface ()

cairo_surface_t *
gtk_icon_set_render_icon_surface (GtkIconSet *icon_set,
                                  GtkStyleContext *context,
                                  GtkIconSize size,
                                  int scale,
                                  GdkWindow *for_window);

Отображает значок с помощью gtk_render_icon_pixbuf() и преобразует его в поверхность cairo.

Эта функция никогда не возвращает NULL; если значок не может быть отображён (например, из-за ошибки загрузки файла изображения), вместо этого будет возвращён значок по умолчанию «отсутствующее изображение».

С: 3.10

gtk_icon_set_unref ()

void
gtk_icon_set_unref (GtkIconSet *icon_set);

Уменьшает счётчик ссылок на icon_set и освобождает память, если счётчик достигает 0.

gtk_icon_size_lookup ()

gboolean
gtk_icon_size_lookup (GtkIconSize size,
                      gint *width,
                      gint *height);

Получает размер пикселей семантического размера значка size : GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_BUTTON и т. д. Эта функция обычно не требуется, gtk_icon_theme_load_icon() — это обычный способ получения значка для отрисовки, а затем просто просмотр размера отрисованного pixbuf. Отрисованный pixbuf может даже не соответствовать ширине/высоте, возвращаемой gtk_icon_size_lookup(), так как темы могут свободно отрисовывать pixbuf любым способом, в том числе, изменяя обычный размер.

gtk_icon_size_lookup_for_settings ()

gboolean
gtk_icon_size_lookup_for_settings (GtkSettings *settings,
                                   GtkIconSize size,
                                   gint *width,
                                   gint *height);

Получает размер пикселей семантического размера значка, возможно, изменённого пользовательскими настройками для конкретного GtkSettings. Обычно size будет GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_BUTTON и т. д. Эта функция обычно не требуется, gtk_widget_render_icon_pixbuf() — это обычный способ получения значка для отрисовки, а затем просто просмотр размера отрисованного pixbuf. Отрисованный pixbuf может даже не соответствовать ширине/высоте, возвращаемой gtk_icon_size_lookup(), так как темы могут свободно отрисовывать pixbuf любым способом, в том числе, изменяя обычный размер.

С: 2.2

gtk_icon_size_register ()

GtkIconSize
gtk_icon_size_register (const gchar *name,
                        gint width,
                        gint height);

Регистрирует новый размер значка, аналогично GTK_ICON_SIZE_MENU и т. д. Возвращает целое значение для размера.

gtk_icon_size_register_alias ()

void
gtk_icon_size_register_alias (const gchar *alias,
                              GtkIconSize target);

Регистрирует alias как ещё одно имя для target. Так, вызов gtk_icon_size_from_name() с alias в качестве аргумента вернёт target.

gtk_icon_size_from_name ()

GtkIconSize
gtk_icon_size_from_name (const gchar *name);

Ищет размер значка, связанный с name.

gtk_icon_size_get_name ()

const gchar *
gtk_icon_size_get_name (GtkIconSize size);

Получает каноническое имя заданного размера значка. Возвращённая строка статически выделяется и не должна освобождаться.

gtk_icon_set_get_sizes ()

void
gtk_icon_set_get_sizes (GtkIconSet *icon_set,
                        GtkIconSize **sizes,
                        gint *n_sizes);

Получает список размеров значков, которые может отобразить этот набор значков. Возвращаемый массив необходимо освободить с помощью g_free().

gtk_icon_source_get_direction ()

GtkTextDirection
gtk_icon_source_get_direction (const GtkIconSource *source);

Получает направление текста, к которому применяется этот источник значков. Значение возврата полезно/имеет смысл только если направление текста не является универсальным.

gtk_icon_source_get_direction_wildcarded ()

gboolean
gtk_icon_source_get_direction_wildcarded
                               (const GtkIconSource *source);

Получает значение, установленное функцией gtk_icon_source_set_direction_wildcarded().

gtk_icon_source_get_filename ()

const gchar *
gtk_icon_source_get_filename (const GtkIconSource *source);

Возвращает имя файла источника или NULL, если он не задан. Имя файла не является копией и не должно изменяться или ожидаться, что оно сохранится после окончания работы источника значков.

gtk_icon_source_get_pixbuf ()

GdkPixbuf *
gtk_icon_source_get_pixbuf (const GtkIconSource *source);

Возвращает pixbuf источника или NULL, если он не задан. Кроме того, если используется источник имени файла, эта функция в некоторых случаях вернёт pixbuf, загруженный из файла. Это, например, верно для GtkIconSource, переданного в виртуальную функцию GtkStyle render_icon(). Счётчик ссылок на pixbuf не увеличивается.

gtk_icon_source_get_icon_name ()

const gchar *
gtk_icon_source_get_icon_name (const GtkIconSource *source);

Возвращает имя значка источника или NULL, если он не задан. Имя значка не является копией и не должно изменяться или ожидаться, что оно сохранится после окончания работы источника значков.

gtk_icon_source_get_size ()

GtkIconSize
gtk_icon_source_get_size (const GtkIconSource *source);

Получает размер значка, к которому применяется этот источник. Значение возврата полезно/имеет смысл только если размер значка не является универсальным.

gtk_icon_source_get_size_wildcarded ()

gboolean
gtk_icon_source_get_size_wildcarded (const GtkIconSource *source);

Получает значение, установленное функцией gtk_icon_source_set_size_wildcarded().

gtk_icon_source_get_state ()

GtkStateType
gtk_icon_source_get_state (const GtkIconSource *source);

Получает состояние виджета, к которому применяется этот источник значков. Значение возврата полезно/имеет смысл только если состояние виджета не является универсальным.

gtk_icon_source_get_state_wildcarded ()

gboolean
gtk_icon_source_get_state_wildcarded (const GtkIconSource *source);

Получает значение, установленное с помощью gtk_icon_source_set_state_wildcarded().

gtk_icon_source_new ()

GtkIconSource *
gtk_icon_source_new (void);

Создаёт новый GtkIconSource. GtkIconSource содержит GdkPixbuf (или имя файла изображения), используемый в качестве базового изображения для одного или нескольких значков в GtkIconSet, наряду с указанием, какие значки в наборе значков будут основаны на этом pixbuf или файле изображения. Набор значков содержит набор значков, представляющих «один и тот же» логический объект в различных состояниях, различных направлениях текста и различных размерах.

Например, значок «Назад на предыдущую страницу» веб-браузера может быть ориентирован в другом направлении на иврите и английском языке; он может выглядеть по-другому в неактивном режиме; и он может изменять размер в зависимости от режима панели инструментов (маленькие/большие значки). Таким образом, один набор значков будет содержать все эти варианты значка. GtkIconSet содержит список GtkIconSource, из которых он может выводить конкретные варианты значков в наборе.

В простейшем случае GtkIconSet содержит один базовый pixbuf, из которого он выводит все варианты. Функция удобства gtk_icon_set_new_from_pixbuf() обрабатывает этот случай; если у вас только один базовый pixbuf, просто используйте эту функцию.

Если вы хотите использовать другой базовый pixbuf для различных вариантов значков, вы создаёте несколько источников значков, отмечаете, для создания каких вариантов они будут использоваться, и добавляете их в набор значков с помощью gtk_icon_set_add_source().

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

gtk_icon_source_set_direction ()

void
gtk_icon_source_set_direction (GtkIconSource *source,
                               GtkTextDirection direction);

Устанавливает направление текста, с которым должен использоваться этот источник значка.

Установка направления текста для источника значка не влияет, если направление текста имеет подстановочные знаки. Поэтому вам обычно следует вызвать gtk_icon_source_set_direction_wildcarded() для снятия подстановочных знаков в дополнение к вызову этой функции.

gtk_icon_source_set_direction_wildcarded ()

void
gtk_icon_source_set_direction_wildcarded
                               (GtkIconSource *source,
                                gboolean setting);

Если для направления текста установлены подстановочные знаки, этот источник может использоваться в качестве базового изображения для значка в любом GtkTextDirection. Если направление текста не имеет подстановочных знаков, то направление текста, к которому применим источник значка, должно быть установлено с помощью gtk_icon_source_set_direction(), и источник значка будет использоваться только с этим направлением текста.

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

gtk_icon_source_set_filename ()

void
gtk_icon_source_set_filename (GtkIconSource *source,
                              const gchar *filename);

Устанавливает имя файла изображения, которое будет использоваться в качестве базового изображения при создании вариантов значков для GtkIconSet. Имя файла должно быть абсолютным.

gtk_icon_source_set_pixbuf ()

void
gtk_icon_source_set_pixbuf (GtkIconSource *source,
                            GdkPixbuf *pixbuf);

Устанавливает pixbuf, который будет использоваться в качестве базового изображения при создании вариантов значков для GtkIconSet.

gtk_icon_source_set_icon_name ()

void
gtk_icon_source_set_icon_name (GtkIconSource *source,
                               const gchar *icon_name);

Устанавливает имя значка для поиска в текущей теме значков, чтобы использовать его в качестве базового изображения при создании вариантов значков для GtkIconSet.

gtk_icon_source_set_size ()

void
gtk_icon_source_set_size (GtkIconSource *source,
                          GtkIconSize size);

Устанавливает размер иконки, с которой предполагается использовать этот источник иконок.

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

gtk_icon_source_set_size_wildcarded ()

void
gtk_icon_source_set_size_wildcarded (GtkIconSource *source,
                                     gboolean setting);

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

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

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

gtk_icon_source_set_state ()

void
gtk_icon_source_set_state (GtkIconSource *source,
                           GtkStateType state);

Устанавливает состояние виджета, с которым предполагается использовать этот источник иконок.

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

gtk_icon_source_set_state_wildcarded ()

void
gtk_icon_source_set_state_wildcarded (GtkIconSource *source,
                                      gboolean setting);

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

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

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