Commit af5ef152 authored by Sébastien Wilmet's avatar Sébastien Wilmet Committed by Matthias Clasen
Browse files

docs: GtkWidget::style-updated vs GtkStyleContext::changed

Explain the difference between those two signals.

Add "Since: 3.0" for GtkStyleContext::changed, since that signal has
been added in commit 9f84e101, present
since 2.91.6.

https://bugzilla.gnome.org/show_bug.cgi?id=769047
parent 3432587f
......@@ -201,6 +201,19 @@ gtk_style_context_class_init (GtkStyleContextClass *klass)
klass->changed = gtk_style_context_real_changed;
/**
* GtkStyleContext::changed:
*
* The ::changed signal is emitted when there is a change in the
* #GtkStyleContext.
*
* For a #GtkStyleContext returned by gtk_widget_get_style_context(), the
* #GtkWidget::style-updated signal/vfunc might be more convenient to use.
*
* This signal is useful when using the theming layer standalone.
*
* Since: 3.0
*/
signals[CHANGED] =
g_signal_new (I_("changed"),
G_TYPE_FROM_CLASS (object_class),
......
......@@ -1903,9 +1903,12 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* GtkWidget::style-updated:
* @widget: the object on which the signal is emitted
*
* The ::style-updated signal is emitted when the #GtkStyleContext
* of a widget is changed. Note that style-modifying functions like
* gtk_widget_override_color() also cause this signal to be emitted.
* The ::style-updated signal is a convenience signal that is emitted when the
* #GtkStyleContext::changed signal is emitted on the @widget's associated
* #GtkStyleContext as returned by gtk_widget_get_style_context().
*
* Note that style-modifying functions like gtk_widget_override_color() also
* cause this signal to be emitted.
*
* Since: 3.0
*/
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment