summaryrefslogtreecommitdiff
path: root/docs/reference/gtk/tmpl/gtkcontainer.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/gtk/tmpl/gtkcontainer.sgml')
-rw-r--r--docs/reference/gtk/tmpl/gtkcontainer.sgml17
1 files changed, 15 insertions, 2 deletions
diff --git a/docs/reference/gtk/tmpl/gtkcontainer.sgml b/docs/reference/gtk/tmpl/gtkcontainer.sgml
index 2f078572a..ccf1d0a70 100644
--- a/docs/reference/gtk/tmpl/gtkcontainer.sgml
+++ b/docs/reference/gtk/tmpl/gtkcontainer.sgml
@@ -5,8 +5,21 @@ GtkContainer
Base class for widgets which contain other widgets
<!-- ##### SECTION Long_Description ##### -->
-<para>
-
+<para id="child-properties">
+<structname>GtkContainer</structname> introduces <firstterm>child
+properties</firstterm> - these are object properties that are not specific
+to either the container or the contained widget, but rather to their relation.
+Typical examples of child properties are the position or pack-type of a widget
+which is contained in a #GtkBox.</para>
+<para>
+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().
</para>
<!-- ##### SECTION See_Also ##### -->