Class
GtkPicture
Description [src]
final class Gtk.Picture : Gtk.Widget
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget {
/* No available fields */
}Displays a GdkPaintable.
picture>
Many convenience functions are provided to make pictures simple to use. For example, if you want to load an image from a file, and then display it, there’s a convenience function to do this:
GtkWidget *widget = gtk_picture_new_for_filename ("myfile.png");
If the file isn’t loaded successfully, the picture will contain a
“broken image” icon similar to that used in many web browsers.
If you want to handle errors in loading the file yourself,
for example by displaying an error message, then load the image with
gdk_texture_new_from_file(), then create the GtkPicture with
gtk_picture_new_for_paintable().
Sometimes an application will want to avoid depending on external data
files, such as image files. See the documentation of GResource for details.
In this case, gtk_picture_new_for_resource() and
gtk_picture_set_resource() should be used.
GtkPicture displays an image at its natural size. See GtkImage
if you want to display a fixed-size image, such as an icon.
Sizing the paintable
You can influence how the paintable is displayed inside the GtkPicture
by changing GtkPicture:content-fit. See GtkContentFit
for details. GtkPicture:can-shrink can be unset to make sure
that paintables are never made smaller than their ideal size - but
be careful if you do not know the size of the paintable in use (like
when displaying user-loaded images). This can easily cause the picture to
grow larger than the screen. And GtkWidget:halign and
GtkWidget:valign can be used to make sure the paintable doesn’t
fill all available space but is instead displayed at its original size.
CSS nodes
GtkPicture has a single CSS node with the name picture.
Accessibility
GtkPicture uses the GTK_ACCESSIBLE_ROLE_IMG role.
Instance methods
gtk_picture_get_keep_aspect_ratio
Returns whether the GtkPicture preserves its contents aspect ratio.
deprecated: 4.8
gtk_picture_set_content_fit
Sets how the content should be resized to fit the GtkPicture.
since: 4.8
gtk_picture_set_keep_aspect_ratio
If set to TRUE, the self will render its contents according to
their aspect ratio.
deprecated: 4.8
Methods inherited from GtkAccessible (20)
Methods inherited from GtkBuildable (1)
Properties
Gtk.Picture:keep-aspect-ratio
Whether the GtkPicture will render its contents trying to preserve the aspect ratio.
deprecated: 4.8