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 9f84e101bf, present
since 2.91.6.

https://bugzilla.gnome.org/show_bug.cgi?id=769047
This commit is contained in:
Sébastien Wilmet 2016-07-24 17:20:29 +02:00 committed by Matthias Clasen
parent 3432587f89
commit af5ef152b1
2 changed files with 19 additions and 3 deletions

View File

@ -201,6 +201,19 @@ gtk_style_context_class_init (GtkStyleContextClass *klass)
klass->changed = gtk_style_context_real_changed; 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] = signals[CHANGED] =
g_signal_new (I_("changed"), g_signal_new (I_("changed"),
G_TYPE_FROM_CLASS (object_class), G_TYPE_FROM_CLASS (object_class),

View File

@ -1903,9 +1903,12 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* GtkWidget::style-updated: * GtkWidget::style-updated:
* @widget: the object on which the signal is emitted * @widget: the object on which the signal is emitted
* *
* The ::style-updated signal is emitted when the #GtkStyleContext * The ::style-updated signal is a convenience signal that is emitted when the
* of a widget is changed. Note that style-modifying functions like * #GtkStyleContext::changed signal is emitted on the @widget's associated
* gtk_widget_override_color() also cause this signal to be emitted. * #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 * Since: 3.0
*/ */