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

docs: Reword the deprecation notice for gtk_widget_override_*

Browse Source 
They are a bit terse, and they should point to the preferred way of
overriding the theme, i.e. using a GtkStyleProvider for your
application, and custom style classes.
This commit is contained in:
Emmanuele Bassi
2015-03-08 14:39:18 +00:00
parent 247e62390b
commit 6950116678
1 changed files with 18 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
gtk/gtkwidget.c
View File

@ -9685,7 +9685,12 @@ gtk_widget_override_color (GtkWidget *widget,
*
* Since: 3.0
*
* Deprecated:3.16: Use a custom style provider and style classes instead
* Deprecated: 3.16: This function is not useful in the context of CSS-based
* rendering. If you wish to change the way a widget renders its background
* you should use a custom CSS style, through an application-specific
* #GtkStyleProvider and a CSS style class. You can also override the default
* drawing of a widget through the #GtkWidget::draw signal, and use Cairo to
* draw a specific color, regardless of the CSS style.
*/
void
gtk_widget_override_background_color (GtkWidget *widget,
@ -9711,7 +9716,10 @@ gtk_widget_override_background_color (GtkWidget *widget,
*
* Since: 3.0
*
* Deprecated:3.16: Use a custom style provider and style classes instead
* Deprecated: 3.16: This function is not useful in the context of CSS-based
* rendering. If you wish to change the font a widget uses to render its text
* you should use a custom CSS style, through an application-specific
* #GtkStyleProvider and a CSS style class.
*/
void
gtk_widget_override_font (GtkWidget *widget,
@ -9741,7 +9749,10 @@ gtk_widget_override_font (GtkWidget *widget,
*
* Since: 3.0
*
* Deprecated:3.16: Use a custom style provider and style classes instead
* Deprecated: 3.16: This function is not useful in the context of CSS-based
* rendering. If you wish to change the color used to render symbolic icons
* you should use a custom CSS style, through an application-specific
* #GtkStyleProvider and a CSS style class.
*/
void
gtk_widget_override_symbolic_color (GtkWidget *widget,
@ -9776,7 +9787,10 @@ gtk_widget_override_symbolic_color (GtkWidget *widget,
*
* Since: 3.0
*
* Deprecated:3.16: Use a custom style provider and style classes instead
* Deprecated: 3.16: This function is not useful in the context of CSS-based
* rendering. If you wish to change the color used to render the primary
* and seconday cursors you should use a custom CSS style, through an
* application-specific #GtkStyleProvider and a CSS style class.
*/
void
gtk_widget_override_cursor (GtkWidget *widget,