Memory-managed wrapper type.

Type class for types which can be safely cast to Picture, for instance with toPicture.

Cast to Picture, for types for which this is known to be safe. For general casts, use castTo.

Gets the alternative textual description of the picture.

The returned string will be Nothing if the picture cannot be described textually.

Returns whether the GtkPicture respects its contents size.

Returns the fit mode for the content of the GtkPicture.

See ContentFit for details.

Since: 4.8

Gets the GFile currently displayed if self is displaying a file.

If self is not displaying a file, for example when pictureSetPaintable was used, then Nothing is returned.

Returns whether the GtkPicture preserves its contents aspect ratio.

Gets the GdkPaintable being displayed by the GtkPicture.

Creates a new empty GtkPicture widget.

Creates a new GtkPicture displaying the given file.

If the file isn’t found or can’t be loaded, the resulting GtkPicture is empty.

If you need to detect failures to load the file, use textureNewFromFile to load the file yourself, then create the GtkPicture from the texture.

Creates a new GtkPicture displaying the file filename.

This is a utility function that calls pictureNewForFile. See that function for details.

Creates a new GtkPicture displaying paintable.

The GtkPicture will track changes to the paintable and update its size and contents in response to it.

Creates a new GtkPicture displaying pixbuf.

This is a utility function that calls pictureNewForPaintable, See that function for details.

The pixbuf must not be modified after passing it to this function.

Creates a new GtkPicture displaying the resource at resourcePath.

This is a utility function that calls pictureNewForFile. See that function for details.

Sets an alternative textual description for the picture contents.

It is equivalent to the "alt" attribute for images on websites.

This text will be made available to accessibility tools.

If the picture cannot be described textually, set this property to Nothing.

If set to True, the self can be made smaller than its contents.

The contents will then be scaled down when rendering.

If you want to still force a minimum size manually, consider using widgetSetSizeRequest.

Also of note is that a similar function for growing does not exist because the grow behavior can be controlled via widgetSetHalign and widgetSetValign.

Sets how the content should be resized to fit the GtkPicture.

See ContentFit for details.

Since: 4.8

Makes self load and display file.

See pictureNewForFile for details.

Makes self load and display the given filename.

This is a utility function that calls pictureSetFile.

If set to True, the self will render its contents according to their aspect ratio.

That means that empty space may show up at the top/bottom or left/right of self.

If set to False or if the contents provide no aspect ratio, the contents will be stretched over the picture's whole area.

Makes self display the given paintable.

If paintable is Nothing, nothing will be displayed.

See pictureNewForPaintable for details.

Sets a GtkPicture to show a GdkPixbuf.

See pictureNewForPixbuf for details.

This is a utility function that calls pictureSetPaintable.

Makes self load and display the resource at the given resourcePath.

This is a utility function that calls pictureSetFile.

Set the value of the “alternative-text” property to Nothing. When overloading is enabled, this is equivalent to

clear #alternativeText

Construct a GValueConstruct with valid value for the “alternative-text” property. This is rarely needed directly, but it is used by new.

Get the value of the “alternative-text” property. When overloading is enabled, this is equivalent to

get picture #alternativeText

Set the value of the “alternative-text” property. When overloading is enabled, this is equivalent to

set picture [ #alternativeText := value ]

Construct a GValueConstruct with valid value for the “can-shrink” property. This is rarely needed directly, but it is used by new.

Get the value of the “can-shrink” property. When overloading is enabled, this is equivalent to

get picture #canShrink

Set the value of the “can-shrink” property. When overloading is enabled, this is equivalent to

set picture [ #canShrink := value ]

Construct a GValueConstruct with valid value for the “content-fit” property. This is rarely needed directly, but it is used by new.

Get the value of the “content-fit” property. When overloading is enabled, this is equivalent to

get picture #contentFit

Set the value of the “content-fit” property. When overloading is enabled, this is equivalent to

set picture [ #contentFit := value ]

Set the value of the “file” property to Nothing. When overloading is enabled, this is equivalent to

clear #file

Construct a GValueConstruct with valid value for the “file” property. This is rarely needed directly, but it is used by new.

Get the value of the “file” property. When overloading is enabled, this is equivalent to

get picture #file

Set the value of the “file” property. When overloading is enabled, this is equivalent to

set picture [ #file := value ]

Construct a GValueConstruct with valid value for the “keep-aspect-ratio” property. This is rarely needed directly, but it is used by new.

Get the value of the “keep-aspect-ratio” property. When overloading is enabled, this is equivalent to

get picture #keepAspectRatio

Set the value of the “keep-aspect-ratio” property. When overloading is enabled, this is equivalent to

set picture [ #keepAspectRatio := value ]

Set the value of the “paintable” property to Nothing. When overloading is enabled, this is equivalent to

clear #paintable

Construct a GValueConstruct with valid value for the “paintable” property. This is rarely needed directly, but it is used by new.

Get the value of the “paintable” property. When overloading is enabled, this is equivalent to

get picture #paintable

Set the value of the “paintable” property. When overloading is enabled, this is equivalent to

set picture [ #paintable := value ]