GtkIconTheme

gtk_icon_theme_new ()

GtkIconTheme *
gtk_icon_theme_new (void);

Создаёт новый объект темы иконок. Объекты темы иконок используются для поиска иконки по имени в конкретной теме иконок. Обычно вы захотите использовать gtk_icon_theme_get_for_display(), а не создавать новый объект темы иконок для временного использования.

gtk_icon_theme_get_for_display ()

GtkIconTheme *
gtk_icon_theme_get_for_display (GdkDisplay *display);

Получает объект темы иконок, связанный с display; если эта функция не была ранее вызвана для данного дисплея, будет создан и связан с дисплеем новый объект темы иконок. Объекты темы иконок достаточно дорого создавать, поэтому использование этой функции обычно предпочтительнее, чем вызов gtk_icon_theme_new() и самостоятельное задание дисплея; таким образом, один объект темы иконок будет совместно использоваться между пользователями.

gtk_icon_theme_get_display ()

GdkDisplay *
gtk_icon_theme_get_display (GtkIconTheme *self);

Возвращает дисплей, для которого был создан объект GtkIconTheme.

gtk_icon_theme_set_search_path ()

void
gtk_icon_theme_set_search_path (GtkIconTheme *self,
                                const char * const *path);

Устанавливает путь поиска для объекта темы иконок. При поиске темы иконок GTK будет искать подкаталог одного или нескольких каталогов в path с тем же именем, что и тема иконок, содержащий файл index.theme. (Темы из нескольких элементов пути объединяются, чтобы разрешить расширение тем путём добавления иконок в домашний каталог пользователя.)

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

gtk_icon_theme_get_search_path ()

char **
gtk_icon_theme_get_search_path (GtkIconTheme *self);

Получает текущий путь поиска. См. gtk_icon_theme_set_search_path().

gtk_icon_theme_add_search_path ()

void
gtk_icon_theme_add_search_path (GtkIconTheme *self,
                                const char *path);

Добавляет каталог в путь поиска. См. gtk_icon_theme_set_search_path().

gtk_icon_theme_set_resource_path ()

void
gtk_icon_theme_set_resource_path (GtkIconTheme *self,
                                  const char * const *path);

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

Ресурсы рассматриваются как часть темы иконок hicolor и должны находиться в подкаталогах, определённых в теме иконок hicolor, таких как @path/16x16/actions/run.png или @path/scalable/actions/run.svg.

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

gtk_icon_theme_get_resource_path ()

char **
gtk_icon_theme_get_resource_path (GtkIconTheme *self);

Получает текущий путь к ресурсам.

См. gtk_icon_theme_set_resource_path().

gtk_icon_theme_add_resource_path ()

void
gtk_icon_theme_add_resource_path (GtkIconTheme *self,
                                  const char *path);

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

См. gtk_icon_theme_set_resource_path().

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

gtk_icon_theme_set_theme_name ()

void
gtk_icon_theme_set_theme_name (GtkIconTheme *self,
                               const char *theme_name);

Устанавливает имя темы значков, используемой объектом GtkIconTheme, перезаписывая системную конфигурацию. Вызов этой функции для объектов темы значков, возвращаемых функцией gtk_icon_theme_get_for_display(), недопустим.

gtk_icon_theme_get_theme_name ()

char *
gtk_icon_theme_get_theme_name (GtkIconTheme *self);

Возвращает текущее имя темы значков.

Возвращаемое значение (передача полного владения): текущее имя темы значков.

gtk_icon_theme_has-icon ()

gboolean
gtk_icon_theme_has_icon (GtkIconTheme *self,
                         const char *icon_name);

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

gtk_icon_theme_lookup_icon ()

GtkIconPaintable *
gtk_icon_theme_lookup_icon (GtkIconTheme *self,
                            const char *icon_name,
                            const char *fallbacks[],
                            int size,
                            int scale,
                            GtkTextDirection direction,
                            GtkIconLookupFlags flags);

Ищет значок с заданным именем для желаемого размера и масштаба окна, возвращая объект GtkIconPaintable. Значок можно отобразить, используя его как GdkPaintable, или получить информацию о файле и размере.

Если значок с заданными icon_name недоступен, и заданы fallbacks, они будут перепробованы в указанном порядке.

Если соответствующий значок не найден, возвращается объект, отображающий значок "отсутствует". Если требуется иное поведение для отсутствующих значков, необходимо использовать функцию gtk_icon_theme_has_icon().

Обратите внимание, что, вероятно, вам потребуется отслеживать изменения темы значков и обновлять значок. Это обычно выполняется путём переопределения функции GtkWidgetClass.css-changed().

gtk_icon_theme_lookup_by_gicon ()

GtkIconPaintable *
gtk_icon_theme_lookup_by_gicon (GtkIconTheme *self,
                                GIcon *icon,
                                int size,
                                int scale,
                                GtkTextDirection direction,
                                GtkIconLookupFlags flags);

Ищет значок для заданного размера и масштаба окна, возвращая объект GtkIconPaintable. Значок можно отобразить, используя его как GdkPaintable, или получить информацию о файле и размере.

gtk_icon_theme_get_icon_names ()

char **
gtk_icon_theme_get_icon_names (GtkIconTheme *self);

Выводит список имён значков в текущей теме значков.

gtk_icon_theme_get-icon-sizes ()

int *
gtk_icon_theme_get_icon_sizes (GtkIconTheme *self,
                               const char *icon_name);

Возвращает массив целых чисел, описывающих размеры, в которых значок доступен без масштабирования. Значение -1 указывает, что значок доступен в масштабируемом формате. Массив завершается нулём.

gtk_icon_paintable_new_for_file ()

GtkIconPaintable *
gtk_icon_paintable_new_for_file (GFile *file,
                                 int size,
                                 int scale);

Создаёт GtkIconPaintable для файла с заданным размером и масштабом GtkIconPaintable. Иконку затем можно отрисовать, используя её как GdkPaintable.

gtk_icon_paintable_get_file ()

GFile *
gtk_icon_paintable_get_file (GtkIconPaintable *self);

Получает GFile, который использовался для загрузки иконки, или NULL, если иконка не загружалась из файла.

gtk_icon_paintable_get_icon_name ()

const char *
gtk_icon_paintable_get_icon_name (GtkIconPaintable *self);

Получить имя иконки, используемой для этой иконки.

Когда иконка, найденная в теме иконок, недоступна, тема иконок может использовать резервные иконки — те, которые указаны для gtk_icon_theme_lookup_icon(), или всегда доступную "image-missing". Выбранная иконка возвращается этой функцией.

Если иконка создана без темы иконок, эта функция возвращает NULL.

gtk_icon_paintable_is_symbolic ()

gboolean
gtk_icon_paintable_is_symbolic (GtkIconPaintable *self);

Проверяет, является ли иконка символьной или нет. В настоящее время для определения этого используется только имя файла, а не содержимое файла. Это поведение может измениться в будущем.

Обратите внимание, что для правильной отрисовки символьной GtkIconPaintable (с перекраской) необходимо установить её имя иконки на GtkImage.