From 69f37db80f2473e420f560e5247b92d9ddea1c02 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 18 Dec 2002 23:45:53 +0000 Subject: [PATCH] Add docs. --- ChangeLog | 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 | 6 +++++- docs/reference/gtk/tmpl/gtkcontainer.sgml | 15 +++++++++------ gtk/gtkwidget.c | 22 ++++++++++++++++++++++ 9 files changed, 60 insertions(+), 7 deletions(-) diff --git a/ChangeLog b/ChangeLog index 990ac62130..5591918525 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 990ac62130..5591918525 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 990ac62130..5591918525 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 990ac62130..5591918525 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 990ac62130..5591918525 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 990ac62130..5591918525 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +2002-12-18 Matthias Clasen + + * gtk/gtkwidget.c: Add docs. + Wed Dec 18 12:05:33 2002 Owen Taylor * NEWS: Various name fixes. diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 598864fe03..531ab5badf 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,6 +1,10 @@ +2002-12-18 Matthias Clasen + + * gtk/tmpl/gtkcontainer.sgml: Add docs. + 2002-12-17 Matthias Clasen - * gtk/tmpl/gtkrc.sgml: Link to style properties. + * gtk/tmpl/gtkrc.sgml: Link to style properties. * gtk/tmpl/gtkcontainer.sgml: Add bits about child properties. diff --git a/docs/reference/gtk/tmpl/gtkcontainer.sgml b/docs/reference/gtk/tmpl/gtkcontainer.sgml index ccf1d0a705..c0ac78af81 100644 --- a/docs/reference/gtk/tmpl/gtkcontainer.sgml +++ b/docs/reference/gtk/tmpl/gtkcontainer.sgml @@ -15,13 +15,16 @@ which is contained in a #GtkBox. Use gtk_container_class_install_child_property() to install child properties for a container class and gtk_container_class_find_child_property() or gtk_container_class_list_child_properties() to get information about existing -child properties. To set the value of a child property, use -gtk_container_child_set_property(), gtk_container_child_set() or -gtk_container_child_set_valist(). To obtain the value of a child property, -use gtk_container_child_get_property(), gtk_container_child_get() or -gtk_container_child_get_valist(). +child properties. + + +To set the value of a child property, use gtk_container_child_set_property(), +gtk_container_child_set() or gtk_container_child_set_valist(). +To obtain the value of a child property, use +gtk_container_child_get_property(), gtk_container_child_get() or +gtk_container_child_get_valist(). To emit notification about child property +changes, use gtk_widget_child_notify(). - diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 87940e2c7c..71bf80ef78 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1361,6 +1361,15 @@ gtk_widget_dispatch_child_properties_changed (GtkWidget *widget, g_signal_emit (widget, widget_signals[CHILD_NOTIFY], g_quark_from_string (pspecs[i]->name), pspecs[i]); } +/** + * gtk_widget_freeze_child_notify: + * @widget: a #GtkWidget + * + * Stops emission of "child-notify" signals on @widget. The signals are + * queued until gtk_widget_thaw_child_notify() is called on @widget. + * + * This is the analogue of g_object_freeze_notify() for child properties. + **/ void gtk_widget_freeze_child_notify (GtkWidget *widget) { @@ -1374,6 +1383,18 @@ gtk_widget_freeze_child_notify (GtkWidget *widget) g_object_unref (widget); } +/** + * gtk_widget_child_notify: + * @widget: a #GtkWidget + * @child_property: the name of a child property installed on the + * class of @widget's parent. + * + * Emits a "child-notify" signal for the + * child property @child_property + * on @widget. + * + * This is the analogue of g_object_notify() for child properties. + **/ void gtk_widget_child_notify (GtkWidget *widget, const gchar *child_property) @@ -1410,6 +1431,7 @@ gtk_widget_child_notify (GtkWidget *widget, * @widget: a #GtkWidget * * Reverts the effect of a previous call to gtk_widget_freeze_child_notify(). + * This causes all queued "child-notify" signals on @widget to be emitted. */ void gtk_widget_thaw_child_notify (GtkWidget *widget)