1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 Base class for widgets which contain other widgets
7 <!-- ##### SECTION Long_Description ##### -->
8 <para id="child-properties">
9 <structname>GtkContainer</structname> introduces <firstterm>child
10 properties</firstterm> - these are object properties that are not specific
11 to either the container or the contained widget, but rather to their relation.
12 Typical examples of child properties are the position or pack-type of a widget
13 which is contained in a #GtkBox.</para>
15 Use gtk_container_class_install_child_property() to install child properties
16 for a container class and gtk_container_class_find_child_property() or
17 gtk_container_class_list_child_properties() to get information about existing
21 To set the value of a child property, use gtk_container_child_set_property(),
22 gtk_container_child_set() or gtk_container_child_set_valist().
23 To obtain the value of a child property, use
24 gtk_container_child_get_property(), gtk_container_child_get() or
25 gtk_container_child_get_valist(). To emit notification about child property
26 changes, use gtk_widget_child_notify().
28 <!-- ##### SECTION See_Also ##### -->
33 <!-- ##### STRUCT GtkContainer ##### -->
39 <!-- ##### MACRO GTK_IS_RESIZE_CONTAINER ##### -->
47 <!-- ##### MACRO GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID ##### -->
57 <!-- ##### MACRO gtk_container_border_width ##### -->
59 Does the same as gtk_container_get_border_width().
62 @Deprecated: Use gtk_container_get_border_width() instead.
65 <!-- ##### FUNCTION gtk_container_add ##### -->
74 <!-- ##### FUNCTION gtk_container_remove ##### -->
83 <!-- ##### FUNCTION gtk_container_add_with_properties ##### -->
94 <!-- ##### FUNCTION gtk_container_get_resize_mode ##### -->
103 <!-- ##### FUNCTION gtk_container_set_resize_mode ##### -->
112 <!-- ##### FUNCTION gtk_container_check_resize ##### -->
120 <!-- ##### FUNCTION gtk_container_foreach ##### -->
130 <!-- ##### FUNCTION gtk_container_foreach_full ##### -->
140 @Deprecated: Use gtk_container_foreach() instead.
143 <!-- ##### MACRO gtk_container_children ##### -->
145 Does the same as gtk_container_get_children().
149 @Deprecated: Use gtk_container_get_children() instead.
152 <!-- ##### FUNCTION gtk_container_get_children ##### -->
161 <!-- ##### FUNCTION gtk_container_set_reallocate_redraws ##### -->
170 <!-- ##### FUNCTION gtk_container_set_focus_child ##### -->
179 <!-- ##### FUNCTION gtk_container_get_focus_vadjustment ##### -->
188 <!-- ##### FUNCTION gtk_container_set_focus_vadjustment ##### -->
197 <!-- ##### FUNCTION gtk_container_get_focus_hadjustment ##### -->
206 <!-- ##### FUNCTION gtk_container_set_focus_hadjustment ##### -->
215 <!-- ##### FUNCTION gtk_container_resize_children ##### -->
223 <!-- ##### FUNCTION gtk_container_child_type ##### -->
232 <!-- ##### FUNCTION gtk_container_child_get ##### -->
243 <!-- ##### FUNCTION gtk_container_child_set ##### -->
252 <!-- # Unused Parameters # -->
256 <!-- ##### FUNCTION gtk_container_child_get_property ##### -->
267 <!-- ##### FUNCTION gtk_container_child_set_property ##### -->
278 <!-- ##### FUNCTION gtk_container_child_get_valist ##### -->
285 @first_property_name:
289 <!-- ##### FUNCTION gtk_container_child_set_valist ##### -->
296 @first_property_name:
300 <!-- ##### FUNCTION gtk_container_forall ##### -->
310 <!-- ##### FUNCTION gtk_container_get_border_width ##### -->
319 <!-- ##### FUNCTION gtk_container_set_border_width ##### -->
328 <!-- ##### FUNCTION gtk_container_propagate_expose ##### -->
338 <!-- ##### FUNCTION gtk_container_get_focus_chain ##### -->
348 <!-- ##### FUNCTION gtk_container_set_focus_chain ##### -->
357 <!-- ##### FUNCTION gtk_container_unset_focus_chain ##### -->
365 <!-- ##### FUNCTION gtk_container_class_find_child_property ##### -->
373 <!-- # Unused Parameters # -->
377 <!-- ##### FUNCTION gtk_container_class_install_child_property ##### -->
385 <!-- # Unused Parameters # -->
389 <!-- ##### FUNCTION gtk_container_class_list_child_properties ##### -->
397 <!-- # Unused Parameters # -->
401 <!-- ##### SIGNAL GtkContainer::add ##### -->
406 @container: the object which received the signal.
409 <!-- ##### SIGNAL GtkContainer::check-resize ##### -->
414 @container: the object which received the signal.
416 <!-- ##### SIGNAL GtkContainer::remove ##### -->
421 @container: the object which received the signal.
424 <!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
429 @container: the object which received the signal.
432 <!-- ##### ARG GtkContainer:border-width ##### -->
437 <!-- ##### ARG GtkContainer:child ##### -->
442 <!-- ##### ARG GtkContainer:resize-mode ##### -->