AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

docs: Explain the symbolic icon paintable situation

Browse Source 
Add a paragraph to the migration guide that explains
how to properly render symbolic GtkIconPaintables.

Also mention this in the GtkIconPaintable docs.

There's a reason you can't spell 'paintable' without
'pain'...
This commit is contained in:
Matthias Clasen 2020-10-15 10:08:03 -04:00
parent 9c28ecb0da
commit 6d1dcaa92a
2 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/reference/gtk/migrating-3to4.md
View File

@ -1037,6 +1037,14 @@ of a #GtkIconInfo. It always returns a paintable in the requested size, and
never fails. A number of no-longer-relevant lookup flags and API variants
have been removed.
Note that while GTK 4 is moving towards #GdkPaintable as a primary API
for paintable content, it is meant to be a 'pure' content producer, therefore
a #GtkIconPaintable for a symbolic icon will *not* get recolored depending
on the context it is rendered it. To properly render a symbolic icon that
is provided in the form of a #GtkIconPaintable (this can be checked with
gtk_icon_paintable_is_symbolic()), you have to call
gtk_icon_paintable_get_icon_name() and set the icon name on a #GtkImage.
### Update to GtkFileChooser API changes
GtkFileChooser moved to a GFile-based API. If you need to convert a

3
gtk/gtkicontheme.c
View File

@ -3670,6 +3670,9 @@ gtk_icon_paintable_get_icon_name (GtkIconPaintable *icon)
* the file name and not the file contents for determining this.
* This behaviour may change in the future.
*
* Note that to render a symbolic #GtkIconPaintable properly (with
* recoloring), you have to set its icon name on a #GtkImage.
*
* Returns: %TRUE if the icon is symbolic, %FALSE otherwise
*/
gboolean