Add docs about sizing pictures

Suggested by Christopher Davis.
This commit is contained in:
Benjamin Otte 2020-12-04 02:04:19 +00:00
parent f1ff8f9aad
commit 66c3a43e96

View File

@ -56,6 +56,18 @@
* In this case, gtk_picture_new_for_resource() and gtk_picture_set_resource() * In this case, gtk_picture_new_for_resource() and gtk_picture_set_resource()
* should be used. * should be used.
* *
* # Sizing the paintable
*
* You can influence how the paintable is displayed inside the #GtkPicture.
* By turning off GtkPicture::keep-aspect-ratio you can allow the paintable
* to get stretched. 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 * # CSS nodes
* *
* GtkPicture has a single CSS node with the name picture. * GtkPicture has a single CSS node with the name picture.