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