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