From 74a692914645f308c0943e75066b5b95d48f7f46 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 5 Jan 2002 15:46:46 +0000 Subject: [PATCH] Documentation additions. * gtk/gtkwidget.c: Documentation additions. * gtk/tmpl/gtkwidget.sgml: Additions. --- ChangeLog | 4 +++ ChangeLog.pre-2-0 | 4 +++ ChangeLog.pre-2-10 | 4 +++ ChangeLog.pre-2-2 | 4 +++ ChangeLog.pre-2-4 | 4 +++ ChangeLog.pre-2-6 | 4 +++ ChangeLog.pre-2-8 | 4 +++ docs/reference/ChangeLog | 4 +++ docs/reference/gtk/tmpl/gtkwidget.sgml | 12 +++---- gtk/gtkwidget.c | 43 ++++++++++++++++++++++++++ 10 files changed, 81 insertions(+), 6 deletions(-) diff --git a/ChangeLog b/ChangeLog index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 316d83ae42..e43b72cacd 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +2001-01-04 Matthias Clasen + + * gtk/gtkwidget.c: Documentation additions. + 2001-01-04 Matthias Clasen * gtk/gtkobject.c (gtk_object_dispose): Fix a comment. diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index d8463a8e30..398ad79748 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2002-01-04 Matthias Clasen + + * gtk/tmpl/gtkwidget.sgml: Additions. + 2002-01-04 Matthias Clasen * gtk/changes-1.2.sgml, gtk/changes-2.0.sgml: SGML fixes. diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml index 92cac33bb3..06617d5e95 100644 --- a/docs/reference/gtk/tmpl/gtkwidget.sgml +++ b/docs/reference/gtk/tmpl/gtkwidget.sgml @@ -883,10 +883,10 @@ Turns off certain widget flags. - +Equivalent to gtk_widget_set_style (widget, NULL). -@widget: +@widget: a #GtkWidget. @@ -908,18 +908,18 @@ Turns off certain widget flags. - +Equivalent to gtk_widget_set_style (widget, NULL). -@widget: +@widget: a #GtkWidget. - +Calls gtk_widget_set_rc_style() recursively on all descendants. -@widget: +@widget: a #GtkWidget. diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 49e1205a84..7f8a4fb658 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1338,6 +1338,12 @@ gtk_widget_child_notify (GtkWidget *widget, g_object_unref (widget); } +/** + * gtk_widget_thaw_child_notify: + * @widget: a #GtkWidget + * + * Reverts the effect of a previous call to gtk_widget_freeze_child_notify(). + */ void gtk_widget_thaw_child_notify (GtkWidget *widget) { @@ -4249,6 +4255,14 @@ gtk_widget_reset_rc_styles (GtkWidget *widget) gtk_widget_set_style_recurse (widget, NULL); } +/** + * gtk_widget_get_default_style: + * + * Returns the default style used by all widgets initially. + * + * Returns: the default style. This #GtkStyle object is owned by GTK+ and + * should not be modified or freed. + */ GtkStyle* gtk_widget_get_default_style (void) { @@ -6044,6 +6058,14 @@ gtk_widget_class_install_style_property (GtkWidgetClass *class, gtk_widget_class_install_style_property_parser (class, pspec, parser); } +/** + * gtk_widget_style_get_property: + * @widget: a #GtkWidget + * @property_name: the name of a style property + * @value: location to return the property value + * + * Gets the value of a style property of @widget. + */ void gtk_widget_style_get_property (GtkWidget *widget, const gchar *property_name, @@ -6089,6 +6111,17 @@ gtk_widget_style_get_property (GtkWidget *widget, g_object_unref (widget); } +/** + * gtk_widget_style_get_valist: + * @widget: a #GtkWidget + * @first_property_name: the name of the first property to get + * @var_args: a va_list of pairs of property names and + * locations to return the property values, starting with the location + * for @first_property_name. + * + * Non-vararg variant of gtk_widget_style_get(). Used primarily by language + * bindings. + */ void gtk_widget_style_get_valist (GtkWidget *widget, const gchar *first_property_name, @@ -6139,6 +6172,16 @@ gtk_widget_style_get_valist (GtkWidget *widget, g_object_unref (widget); } +/** + * gtk_widget_style_get: + * @widget: a #GtkWidget + * @first_property_name: the name of the first property to get + * @Varargs: pairs of property names and locations to + * return the property values, starting with the location for + * @first_property_name, terminated by %NULL. + * + * Gets the values of a multiple style properties of @widget. + */ void gtk_widget_style_get (GtkWidget *widget, const gchar *first_property_name,