[gtk+] Bug 608993 - Add gtk_widget_style_attach()

[Michael Natterer <mitch src gnome org>]

commit 9d4c8f38d813460a1796dca00f898834b9fdc0db
Author: Michael Natterer <mitch gimp org>
Date:   Thu Feb 4 16:43:54 2010 +0100

    Bug 608993 - Add gtk_widget_style_attach()
    
    As replacement for:
    widget->style = gtk_style_attach (widget->style, widget->window);

 gtk/gtk.symbols |    1 +
 gtk/gtkwidget.c |   26 ++++++++++++++++++++++++++
 gtk/gtkwidget.h |   12 +++++++-----
 3 files changed, 34 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtk.symbols b/gtk/gtk.symbols
index ab8de03..9fafefb 100644
--- a/gtk/gtk.symbols
+++ b/gtk/gtk.symbols
@@ -5230,6 +5230,7 @@ gtk_widget_show_all
 gtk_widget_show_now
 gtk_widget_size_allocate
 gtk_widget_size_request
+gtk_widget_style_attach
 gtk_widget_style_get G_GNUC_NULL_TERMINATED
 gtk_widget_style_get_property
 gtk_widget_style_get_valist
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 3a95497..027cfeb 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -6294,6 +6294,32 @@ gtk_widget_get_parent (GtkWidget *widget)
  *****************************************/
 
 /**
+ * gtk_widget_style_attach:
+ * @widget: a #GtkWidget
+ *
+ * This function attaches the widget's #GtkStyle to the widget's
+ * #GdkWindow. It is a replacement for
+ *
+ * <programlisting>
+ * widget->style = gtk_style_attach (widget->style, widget->window);
+ * </programlisting>
+ *
+ * and should only ever be called in a derived widget's "realize"
+ * implementation which does not chain up to its parent class'
+ * "realize" implementation, because one of the parent classes
+ * (finally #GtkWidget) would attach the style itself.
+ *
+ * Since: 2.20
+ **/
+void
+gtk_widget_style_attach (GtkWidget *widget)
+{
+  g_return_if_fail (GTK_IS_WIDGET (widget));
+
+  widget->style = gtk_style_attach (widget->style, widget->window);
+}
+
+/**
  * gtk_widget_has_rc_style:
  * @widget: a #GtkWidget
  *
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 02f4cea..f33484b 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -1063,11 +1063,13 @@ gboolean     gtk_widget_hide_on_delete	(GtkWidget	*widget);
 
 /* Widget styles.
  */
-gboolean    gtk_widget_has_rc_style       (GtkWidget           *widget);
-void	   gtk_widget_set_style		(GtkWidget	*widget,
-					 GtkStyle	*style);
-void	   gtk_widget_ensure_style	(GtkWidget	*widget);
-GtkStyle*  gtk_widget_get_style		(GtkWidget	*widget);
+void        gtk_widget_style_attach       (GtkWidget            *style);
+
+gboolean    gtk_widget_has_rc_style       (GtkWidget            *widget);
+void	    gtk_widget_set_style          (GtkWidget            *widget,
+                                           GtkStyle             *style);
+void        gtk_widget_ensure_style       (GtkWidget            *widget);
+GtkStyle *  gtk_widget_get_style          (GtkWidget            *widget);
 
 void        gtk_widget_modify_style       (GtkWidget            *widget,
 					   GtkRcStyle           *style);