]> Pileus Git - ~andy/gtk/blobdiff - docs/reference/gtk/tmpl/gtkcontainer.sgml
=== Released 2.2.0 ===
[~andy/gtk] / docs / reference / gtk / tmpl / gtkcontainer.sgml
index a56681856d570015e413edfab31fe9194c3d5188..78cafc932368fb8ac607794d7957108189be9372 100644 (file)
@@ -2,11 +2,28 @@
 GtkContainer
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Base class for widgets which contain other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
+<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.
+</para>
+<para>
+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().
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -28,11 +45,22 @@ GtkContainer
 @widget: 
 
 
-<!-- ##### MACRO gtk_container_border_width ##### -->
+<!-- ##### MACRO GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID ##### -->
 <para>
 
 </para>
 
+@object: 
+@property_id: 
+@pspec: 
+
+
+<!-- ##### MACRO gtk_container_border_width ##### -->
+<para>
+Does the same as gtk_container_get_border_width().
+</para>
+
+@Deprecated: Use gtk_container_get_border_width() instead.
 
 
 <!-- ##### FUNCTION gtk_container_add ##### -->
@@ -53,6 +81,26 @@ GtkContainer
 @widget: 
 
 
+<!-- ##### FUNCTION gtk_container_add_with_properties ##### -->
+<para>
+
+</para>
+
+@container: 
+@widget: 
+@first_prop_name: 
+@Varargs: 
+
+
+<!-- ##### FUNCTION gtk_container_get_resize_mode ##### -->
+<para>
+
+</para>
+
+@container: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_container_set_resize_mode ##### -->
 <para>
 
@@ -90,24 +138,24 @@ GtkContainer
 @marshal: 
 @callback_data: 
 @notify: 
+@Deprecated: Use gtk_container_foreach() instead.
 
 
-<!-- ##### FUNCTION gtk_container_children ##### -->
+<!-- ##### MACRO gtk_container_children ##### -->
 <para>
-
+Does the same as gtk_container_get_children().
 </para>
 
-@container: 
 @Returns: 
+@Deprecated: Use gtk_container_get_children() instead.
 
 
-<!-- ##### FUNCTION gtk_container_focus ##### -->
+<!-- ##### FUNCTION gtk_container_get_children ##### -->
 <para>
 
 </para>
 
 @container: 
-@direction: 
 @Returns: 
 
 
@@ -129,16 +177,16 @@ GtkContainer
 @child: 
 
 
-<!-- ##### FUNCTION gtk_container_set_focus_vadjustment ##### -->
+<!-- ##### FUNCTION gtk_container_get_focus_vadjustment ##### -->
 <para>
 
 </para>
 
 @container: 
-@adjustment
+@Returns
 
 
-<!-- ##### FUNCTION gtk_container_set_focus_hadjustment ##### -->
+<!-- ##### FUNCTION gtk_container_set_focus_vadjustment ##### -->
 <para>
 
 </para>
@@ -147,208 +195,211 @@ GtkContainer
 @adjustment: 
 
 
-<!-- ##### FUNCTION gtk_container_resize_children ##### -->
+<!-- ##### FUNCTION gtk_container_get_focus_hadjustment ##### -->
 <para>
 
 </para>
 
 @container: 
+@Returns: 
 
 
-<!-- ##### FUNCTION gtk_container_child_type ##### -->
+<!-- ##### FUNCTION gtk_container_set_focus_hadjustment ##### -->
 <para>
 
 </para>
 
 @container: 
-@Returns
+@adjustment
 
 
-<!-- ##### FUNCTION gtk_container_add_child_arg_type ##### -->
+<!-- ##### FUNCTION gtk_container_resize_children ##### -->
 <para>
 
 </para>
 
-@arg_name: 
-@arg_type: 
-@arg_flags: 
-@arg_id: 
+@container: 
 
 
-<!-- ##### FUNCTION gtk_container_query_child_args ##### -->
+<!-- ##### FUNCTION gtk_container_child_type ##### -->
 <para>
 
 </para>
 
-@class_type: 
-@arg_flags: 
-@nargs: 
+@container: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_container_child_getv ##### -->
+<!-- ##### FUNCTION gtk_container_child_get ##### -->
 <para>
 
 </para>
 
 @container: 
 @child: 
-@n_args
-@args: 
+@first_prop_name
+@Varargs: 
 
 
-<!-- ##### FUNCTION gtk_container_child_setv ##### -->
+<!-- ##### FUNCTION gtk_container_child_set ##### -->
 <para>
 
 </para>
 
 @container: 
 @child: 
-@n_args: 
-@args: 
+@first_prop_name: 
+@Varargs: 
+<!-- # Unused Parameters # -->
+@first_arg_name: 
 
 
-<!-- ##### FUNCTION gtk_container_add_with_args ##### -->
+<!-- ##### FUNCTION gtk_container_child_get_property ##### -->
 <para>
 
 </para>
 
 @container: 
-@widget
-@first_arg_name: 
-@Varargs
+@child
+@property_name: 
+@value
 
 
-<!-- ##### FUNCTION gtk_container_addv ##### -->
+<!-- ##### FUNCTION gtk_container_child_set_property ##### -->
 <para>
 
 </para>
 
 @container: 
-@widget
-@n_args
-@args
+@child
+@property_name
+@value
 
 
-<!-- ##### FUNCTION gtk_container_child_set ##### -->
+<!-- ##### FUNCTION gtk_container_child_get_valist ##### -->
 <para>
 
 </para>
 
 @container: 
 @child: 
-@first_arg_name: 
-@Varargs: 
+@first_property_name: 
+@var_args: 
 
 
-<!-- ##### FUNCTION gtk_container_queue_resize ##### -->
+<!-- ##### FUNCTION gtk_container_child_set_valist ##### -->
 <para>
 
 </para>
 
 @container: 
+@child: 
+@first_property_name: 
+@var_args: 
 
 
-<!-- ##### FUNCTION gtk_container_clear_resize_widgets ##### -->
+<!-- ##### FUNCTION gtk_container_forall ##### -->
 <para>
 
 </para>
 
 @container: 
+@callback: 
+@callback_data: 
 
 
-<!-- ##### FUNCTION gtk_container_arg_set ##### -->
+<!-- ##### FUNCTION gtk_container_get_border_width ##### -->
 <para>
 
 </para>
 
 @container: 
-@child: 
-@arg: 
-@info: 
+@Returns: 
 
 
-<!-- ##### FUNCTION gtk_container_arg_get ##### -->
+<!-- ##### FUNCTION gtk_container_set_border_width ##### -->
 <para>
 
 </para>
 
 @container: 
-@child: 
-@arg: 
-@info: 
+@border_width: 
 
 
-<!-- ##### FUNCTION gtk_container_child_args_collect ##### -->
+<!-- ##### FUNCTION gtk_container_propagate_expose ##### -->
 <para>
 
 </para>
 
-@object_type: 
-@arg_list_p: 
-@info_list_p: 
-@first_arg_name: 
-@args: 
-@Returns: 
+@container: 
+@child: 
+@event: 
 
 
-<!-- ##### FUNCTION gtk_container_child_arg_get_info ##### -->
+<!-- ##### FUNCTION gtk_container_get_focus_chain ##### -->
 <para>
 
 </para>
 
-@object_type: 
-@arg_name: 
-@info_p: 
+@container: 
+@focusable_widgets: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_container_forall ##### -->
+<!-- ##### FUNCTION gtk_container_set_focus_chain ##### -->
 <para>
 
 </para>
 
 @container: 
-@callback: 
-@callback_data: 
+@focusable_widgets: 
 
 
-<!-- ##### FUNCTION gtk_container_child_composite_name ##### -->
+<!-- ##### FUNCTION gtk_container_unset_focus_chain ##### -->
 <para>
 
 </para>
 
 @container: 
-@child: 
-@Returns: 
 
 
-<!-- ##### FUNCTION gtk_container_set_border_width ##### -->
+<!-- ##### FUNCTION gtk_container_class_find_child_property ##### -->
 <para>
 
 </para>
 
-@container: 
-@border_width: 
+@cclass: 
+@property_name: 
+@Returns: 
+<!-- # Unused Parameters # -->
+@class: 
 
 
-<!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
+<!-- ##### FUNCTION gtk_container_class_install_child_property ##### -->
 <para>
 
 </para>
 
-@container: 
+@cclass: 
+@property_id: 
+@pspec: 
+<!-- # Unused Parameters # -->
+@class: 
 
 
-<!-- ##### SIGNAL GtkContainer::add ##### -->
+<!-- ##### FUNCTION gtk_container_class_list_child_properties ##### -->
 <para>
 
 </para>
 
-@container: the object which received the signal.
-@widget: 
+@cclass: 
+@n_properties: 
+@Returns: 
+<!-- # Unused Parameters # -->
+@class: 
 
-<!-- ##### SIGNAL GtkContainer::remove ##### -->
+
+<!-- ##### SIGNAL GtkContainer::add ##### -->
 <para>
 
 </para>
@@ -363,14 +414,13 @@ GtkContainer
 
 @container: the object which received the signal.
 
-<!-- ##### SIGNAL GtkContainer::focus ##### -->
+<!-- ##### SIGNAL GtkContainer::remove ##### -->
 <para>
 
 </para>
 
 @container: the object which received the signal.
-@direction: 
-@Returns: 
+@widget: 
 
 <!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
 <para>
@@ -380,12 +430,7 @@ GtkContainer
 @container: the object which received the signal.
 @widget: 
 
-<!-- ##### ARG GtkContainer:border_width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkContainer:resize_mode ##### -->
+<!-- ##### ARG GtkContainer:border-width ##### -->
 <para>
 
 </para>
@@ -395,7 +440,7 @@ GtkContainer
 
 </para>
 
-<!-- ##### ARG GtkContainer:reallocate_redraws ##### -->
+<!-- ##### ARG GtkContainer:resize-mode ##### -->
 <para>
 
 </para>