callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Clarify replacement for gtk_style_context_get_background_color()

Browse Source 
It seems odd that a getter function for the style context state is
replaced by a rendering call, but it makes sense in context.
This commit is contained in:
Emmanuele Bassi
2015-03-08 14:29:04 +00:00
parent ec567e5fad
commit 247e62390b
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
gtk/gtkstylecontext.c
View File

@ -3246,6 +3246,15 @@ gtk_style_context_get_color (GtkStyleContext *context,
* *
* Gets the background color for a given state. * Gets the background color for a given state.
* *
* This function is far less useful than it seems, and it should not be used in
* newly written code. CSS has no concept of "background color", as a background
* can be an image, or a gradient, or any other pattern including solid colors.
*
* The only reason why you would call gtk_style_context_get_background_color() is
* to use the returned value to draw the background with it; the correct way to
* achieve this result is to use gtk_render_background() instead, along with CSS
* style classes to modify the color to be rendered.
*
* Since: 3.0 * Since: 3.0
* *
* Deprecated: 3.16: Use gtk_render_background() instead. * Deprecated: 3.16: Use gtk_render_background() instead.