docs: Add details

Explain the difference between GtkPicture and GtkImage,
and when you might want to use which.
This commit is contained in:
Matthias Clasen 2021-01-16 14:45:20 -05:00
parent 29868b2a05
commit a5e929ce36
2 changed files with 8 additions and 1 deletions

View File

@ -44,7 +44,7 @@
* SECTION:gtkimage
* @Short_description: A widget displaying an image
* @Title: GtkImage
* @SeeAlso: #GdkTexture
* @SeeAlso: #GdkTexture, #GtkPicture
*
* The #GtkImage widget displays an image. Various kinds of object
* can be displayed as an image; most typically, you would load a
@ -67,6 +67,10 @@
* In this case, the #GtkImage:resource, gtk_image_new_from_resource() and
* gtk_image_set_from_resource() should be used.
*
* GtkImage displays its image as an icon, with a size that is determined
* by the application. See #GtkPicture if you want to show an image at is
* actual size.
*
* # CSS nodes
*
* GtkImage has a single CSS node with the name image. The style classes

View File

@ -56,6 +56,9 @@
* 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.