GtkImage

gtk_image_get_icon_set ()

void
gtk_image_get_icon_set (GtkImage *image,
                        GtkIconSet **icon_set,
                        GtkIconSize *size);

Получает набор иконок и размер, отображаемые GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_ICON_SET (см. gtk_image_get_storage_type()).

gtk_image_get_pixbuf ()

GdkPixbuf *
gtk_image_get_pixbuf (GtkImage *image);

Получает GdkPixbuf, отображаемый GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_PIXBUF (см. gtk_image_get_storage_type()). Вызывающий функцию не владеет ссылкой на возвращённый pixbuf.

gtk_image_get_stock ()

void
gtk_image_get_stock (GtkImage *image,
                     gchar **stock_id,
                     GtkIconSize *size);

Получает имя и размер значка по умолчанию, отображаемые GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_STOCK (см. gtk_image_get_storage_type()). Возвращённая строка принадлежит GtkImage и не должна освобождаться.

gtk_image_get_animation ()

GdkPixbufAnimation *
gtk_image_get_animation (GtkImage *image);

Получает GdkPixbufAnimation, отображаемый GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_ANIMATION (см. gtk_image_get_storage_type()). Вызывающий функцию не владеет ссылкой на возвращённую анимацию.

gtk_image_get_icon_name ()

void
gtk_image_get_icon_name (GtkImage *image,
                         const gchar **icon_name,
                         GtkIconSize *size);

Получает имя и размер значка, отображаемые GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_ICON_NAME (см. gtk_image_get_storage_type()). Возвращённая строка принадлежит GtkImage и не должна освобождаться.

С: 2.6

gtk_image_get_gicon ()

void
gtk_image_get_gicon (GtkImage *image,
                     GIcon **gicon,
                     GtkIconSize *size);

Получает GIcon и размер, отображаемые виджетом GtkImage. Тип хранения изображения должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_GICON (см. gtk_image_get_storage_type()). Вызывающий функцию не владеет ссылкой на возвращаемый GIcon.

С: 2.14

gtk_image_get_storage_type ()

GtkImageType
gtk_image_get_storage_type (GtkImage *image);

Получает тип представления, используемого виджетом GtkImage для хранения данных изображения. Если у GtkImage нет данных изображения, возвращаемое значение будет GTK_IMAGE_EMPTY.

gtk_image_new_from_file ()

GtkWidget *
gtk_image_new_from_file (const gchar *filename);

Создаёт новый виджет GtkImage, отображающий файл filename . Если файла нет или его не удаётся загрузить, созданный GtkImage отобразит значок «разбитого изображения». Данная функция никогда не возвращает NULL, всегда возвращая валидный виджет GtkImage.

Если файл содержит анимацию, изображение будет содержать анимацию.

Если вам нужно обнаруживать ошибки загрузки файла, используйте gdk_pixbuf_new_from_file() для самостоятельной загрузки файла, а затем создайте GtkImage из pixbuf. (Или для анимаций, используйте gdk_pixbuf_animation_new_from_file()).

Тип хранения (gtk_image_get_storage_type()) возвращаемого изображения не определён, он будет соответствующим для отображения файла.

gtk_image_new_from_icon_set ()

GtkWidget *
gtk_image_new_from_icon_set (GtkIconSet *icon_set,
                             GtkIconSize size);

Создаёт виджет GtkImage, отображающий набор значков. Примеры стандартных размеров: GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_SMALL_TOOLBAR. Вместо этой функции, как правило, лучше создать GtkIconFactory, поместить в него наборы значков, добавить фабрику в список стандартных фабрик с помощью gtk_icon_factory_add_default(), и затем использовать gtk_image_new_from_stock(). Это позволит темам переопределять значок, поставляемый с вашим приложением.

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

gtk_image_new_from_pixbuf ()

GtkWidget *
gtk_image_new_from_pixbuf (GdkPixbuf *pixbuf);

Создаёт новый виджет GtkImage, отображающий pixbuf . GtkImage не предполагает ссылки на pixbuf; вам всё ещё нужно освободить его, если вы владеете ссылками. GtkImage добавит свою собственную ссылку вместо принятия вашей.

Обратите внимание, что эта функция просто создаёт GtkImage из pixbuf. Созданный GtkImage не будет реагировать на изменения состояния. Если вам это нужно, используйте gtk_image_new_from_icon_name().

gtk_image_new_from_stock ()

GtkWidget *
gtk_image_new_from_stock (const gchar *stock_id,
                          GtkIconSize size);

Создаёт GtkImage, отображающий значок из стандартной библиотеки. Примеры имён значков: GTK_STOCK_OPEN, GTK_STOCK_QUIT. Примеры размеров значков: GTK_ICON_SIZE_MENU, GTK_ICON_SIZE_SMALL_TOOLBAR. Если имя значка не найдено, изображение будет пустым. Вы можете зарегистрировать свои собственные имена значков, см. gtk_icon_factory_add_default() и gtk_icon_factory_add().

gtk_image_new_from_animation ()

GtkWidget *
gtk_image_new_from_animation (GdkPixbufAnimation *animation);

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

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

gtk_image_new_from_icon_name ()

GtkWidget *
gtk_image_new_from_icon_name (const gchar *icon_name,
                              GtkIconSize size);

Создаёт GtkImage, отображающий значок из текущей темы значков. Если имя значка не найдено, будет отображён значок «изображение не найдено». Если текущая тема значков изменена, значок будет соответствующим образом обновлён.

С версии: 2.6

gtk_image_new_from_gicon ()

GtkWidget *
gtk_image_new_from_gicon (GIcon *icon,
                          GtkIconSize size);

Создаёт GtkImage, отображающий значок из текущей темы значков. Если имя значка не найдено, будет отображён значок «изображение не найдено». Если текущая тема значков изменена, значок будет соответствующим образом обновлён.

С версии: 2.14

gtk_image_new_from_resource ()

GtkWidget *
gtk_image_new_from_resource (const gchar *resource_path);

Создаёт новый GtkImage, отображающий ресурсный файл resource_path. Если файл не найден или не может быть загружен, полученный GtkImage отобразит значок «изображение не найдено». Эта функция никогда не возвращает NULL, всегда возвращая корректный виджет GtkImage.

Если файл содержит анимацию, изображение будет содержать анимацию.

Если вам необходимо обнаруживать ошибки загрузки файла, используйте gdk_pixbuf_new_from_file() для самостоятельной загрузки файла, а затем создайте GtkImage из pixbuf. (Или для анимаций используйте gdk_pixbuf_animation_new_from_file()).

Тип хранения (gtk_image_get_storage_type()) возвращённого изображения не определён, это будет то, что подходит для отображения файла.

С версии: 3.4

gtk_image_new_from_surface ()

GtkWidget *
gtk_image_new_from_surface (cairo_surface_t *surface);

Создаёт новый GtkImage, отображающий surface. GtkImage не использует ссылку на поверхность; вам всё ещё необходимо её освободить, если вы владеете ссылками. GtkImage добавит свою собственную ссылку вместо использования вашей.

С версии: 3.10

gtk_image_set_from_file ()

void
gtk_image_set_from_file (GtkImage *image,
                         const gchar *filename);

См. gtk_image_new_from_file() для подробностей.

gtk_image_set_from_icon_set ()

void
gtk_image_set_from_icon_set (GtkImage *image,
                             GtkIconSet *icon_set,
                             GtkIconSize size);

См. gtk_image_new_from_icon_set() для подробностей.

gtk_image_set_from_pixbuf ()

void
gtk_image_set_from_pixbuf (GtkImage *image,
                           GdkPixbuf *pixbuf);

См. gtk_image_new_from_pixbuf() для подробностей.

gtk_image_set_from_stock ()

void
gtk_image_set_from_stock (GtkImage *image,
                          const gchar *stock_id,
                          GtkIconSize size);

См. gtk_image_new_from_stock() для подробностей.

gtk_image_set_from_animation ()

void
gtk_image_set_from_animation (GtkImage *image,
                              GdkPixbufAnimation *animation);

Принудительно отображает заданную анимацию в GtkImage (или ничего, если анимация задана как NULL).

gtk_image_set_from_icon_name ()

void
gtk_image_set_from_icon_name (GtkImage *image,
                              const gchar *icon_name,
                              GtkIconSize size);

См. gtk_image_new_from_icon_name() для подробностей.

С: 2.6

gtk_image_set_from_gicon ()

void
gtk_image_set_from_gicon (GtkImage *image,
                          GIcon *icon,
                          GtkIconSize size);

См. gtk_image_new_from_gicon() для подробностей.

С: 2.14

gtk_image_set-from-resource ()

void
gtk_image_set_from_resource (GtkImage *image,
                             const gchar *resource_path);

См. gtk_image_new_from_resource() для подробностей.

gtk_image_set_from_surface ()

void
gtk_image_set_from_surface (GtkImage *image,
                            cairo_surface_t *surface);

См. gtk_image_new_from_surface() для подробностей.

С: 3.10

gtk_image_clear ()

void
gtk_image_clear (GtkImage *image);

Сбрасывает изображение на пустое состояние.

С: 2.8

gtk_image_new ()

GtkWidget *
gtk_image_new (void);

Создаёт новый пустой виджет GtkImage.

gtk_image_set_pixel_size ()

void
gtk_image_set_pixel_size (GtkImage *image,
                          gint pixel_size);

Устанавливает размер пикселей для использования с именованными значками. Если размер пикселей установлен ≠ -1, он используется вместо размера значка, установленного с помощью gtk_image_set_from_icon_name().

С: 2.6

gtk_image_get_pixel_size ()

gint
gtk_image_get_pixel_size (GtkImage *image);

Получает размер пикселей, используемых для именованных значков.

С: 2.6