GtkPicture

gtk_picture_new ()

GtkWidget *
gtk_picture_new (void);

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

gtk_picture_new_for_paintable ()

GtkWidget *
gtk_picture_new_for_paintable (GdkPaintable *paintable);

Создаёт новый GtkPicture, отображающий paintable .

GtkWidget GtkPicture будет отслеживать изменения paintable и обновлять свой размер и содержимое в ответ на них.

gtk_picture_new_for_pixbuf ()

GtkWidget *
gtk_picture_new_for_pixbuf (GdkPixbuf *pixbuf);

Создаёт новый GtkPicture, отображающий pixbuf .

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

После передачи pixbuf в эту функцию он не должен изменяться.

gtk_picture_new_for_file ()

GtkWidget *
gtk_picture_new_for_file (GFile *file);

Создаёт новый GtkPicture, отображающий указанный file . Если файл не найден или не может быть загружен, полученный GtkPicture будет пустым.

Если вам нужно обнаружить ошибки загрузки файла, используйте gdk_texture_new_from_file() для самостоятельной загрузки файла, а затем создайте GtkPicture из текстуры.

gtk_picture_new_for_filename ()

GtkWidget *
gtk_picture_new_for_filename (const char *filename);

Создаёт новый GtkPicture, отображающий файл filename .

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

gtk_picture_new_for_resource ()

GtkWidget *
gtk_picture_new_for_resource (const char *resource_path);

Создаёт новый GtkPicture, отображающий ресурс по адресу resource_path .

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

gtk_picture_set_paintable ()

void
gtk_picture_set_paintable (GtkPicture *self,
                           GdkPaintable *paintable);

Заставляет self отображать заданный paintable . Если paintable равен NULL, ничего не будет отображаться.

Подробнее см. gtk_picture_new_for_paintable().

gtk_picture_get_paintable ()

GdkPaintable *
gtk_picture_get_paintable (GtkPicture *self);

Получает GdkPaintable, отображаемый GtkPicture.

gtk_picture_set_pixbuf ()

void
gtk_picture_set_pixbuf (GtkPicture *self,
                        GdkPixbuf *pixbuf);

Подробнее см. gtk_picture_new_for_pixbuf().

Это вспомогательная функция, которая вызывает gtk_picture_set_paintable(),

gtk_picture_set_file ()

void
gtk_picture_set_file (GtkPicture *self,
                      GFile *file);

Заставляет self загрузить и отобразить file .

Подробнее см. gtk_picture_new_for_file().

gtk_picture_get_file ()

GFile *
gtk_picture_get_file (GtkPicture *self);

Получает GFile, отображаемый в данный момент, если self отображает файл. Если self не отображает файл, например, когда использовалась gtk_picture_set_paintable(), то возвращается NULL.

gtk_picture_set_filename ()

void
gtk_picture_set_filename (GtkPicture *self,
                          const char *filename);

Заставляет self загрузить и отобразить заданный filename .

Это вспомогательная функция, которая вызывает gtk_picture_set_file().

gtk_picture_set_resource ()

void
gtk_picture_set_resource (GtkPicture *self,
                          const char *resource_path);

Заставляет self загрузить и отобразить ресурс по заданному resource_path .

Это вспомогательная функция, которая вызывает gtk_picture_set_file().

gtk_picture_set_keep_aspect_ratio ()

void
gtk_picture_set_keep_aspect_ratio (GtkPicture *self,
                                   gboolean keep_aspect_ratio);

Если установлено TRUE, self будет отрисовывать содержимое в соответствии с его соотношением сторон. Это означает, что пустое пространство может отображаться вверху/внизу или слева/справа от self .

Если установлено FALSE или если содержимое не предоставляет соотношение сторон, содержимое будет растянуто по всей области изображения.

gtk_picture_get_keep_aspect_ratio ()

gboolean
gtk_picture_get_keep_aspect_ratio (GtkPicture *self);

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

gtk_picture_set_can_shrink ()

void
gtk_picture_set_can_shrink (GtkPicture *self,
                            gboolean can_shrink);

Если установлено TRUE, self может быть меньше, чем его содержимое. Содержимое будет уменьшено при рендеринге.

Если вы хотите принудительно установить минимальный размер, используйте gtk_widget_set_size_request().

Обратите внимание, что аналогичная функция для увеличения не существует, поскольку поведение роста может контролироваться с помощью gtk_widget_set_halign() и gtk_widget_set_valign().

gtk_picture_get_can_shrink ()

gboolean
gtk_picture_get_can_shrink (GtkPicture *self);

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

gtk_picture_set_alternative_text ()

void
gtk_picture_set_alternative_text (GtkPicture *self,
                                  const char *alternative_text);

Устанавливает альтернативное текстовое описание содержимого изображения. Эквивалентно атрибуту «alt» для изображений на веб-сайтах.

Этот текст будет доступен для средств обеспечения доступности.

Если изображение невозможно описать текстом, установите это свойство в NULL.

gtk_picture_get_alternative_text ()

const char *
gtk_picture_get_alternative_text (GtkPicture *self);

Получает альтернативное текстовое описание изображения или возвращает NULL , если изображение невозможно описать текстом.