gtk2/docs/reference/gtk/tmpl/gtkcontainer.sgml

448 lines
6.4 KiB
Plaintext
Raw Normal View History

1999-08-16 18:51:52 +00:00
<!-- ##### SECTION Title ##### -->
GtkContainer
<!-- ##### SECTION Short_Description ##### -->
Base class for widgets which contain other widgets
1999-08-16 18:51:52 +00:00
<!-- ##### 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>
1999-08-16 18:51:52 +00:00
<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
2002-12-18 23:45:53 +00:00
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().
1999-08-16 18:51:52 +00:00
</para>
1999-08-16 18:51:52 +00:00
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### STRUCT GtkContainer ##### -->
<para>
</para>
<!-- ##### MACRO GTK_IS_RESIZE_CONTAINER ##### -->
<para>
</para>
@widget:
<!-- ##### MACRO GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID ##### -->
<para>
</para>
@object:
@property_id:
@pspec:
1999-08-16 18:51:52 +00:00
<!-- ##### MACRO gtk_container_border_width ##### -->
<para>
Does the same as gtk_container_get_border_width().
1999-08-16 18:51:52 +00:00
</para>
2002-12-08 01:03:03 +00:00
@Deprecated: Use gtk_container_get_border_width() instead.
1999-08-16 18:51:52 +00:00
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_add ##### -->
<para>
</para>
@container:
@widget:
<!-- ##### FUNCTION gtk_container_remove ##### -->
<para>
</para>
@container:
@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:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_set_resize_mode ##### -->
<para>
</para>
@container:
@resize_mode:
<!-- ##### FUNCTION gtk_container_check_resize ##### -->
<para>
</para>
@container:
<!-- ##### FUNCTION gtk_container_foreach ##### -->
<para>
</para>
@container:
@callback:
@callback_data:
<!-- ##### FUNCTION gtk_container_foreach_full ##### -->
<para>
</para>
@container:
@callback:
@marshal:
@callback_data:
@notify:
2002-12-08 01:03:03 +00:00
@Deprecated: Use gtk_container_foreach() instead.
1999-08-16 18:51:52 +00:00
<!-- ##### MACRO gtk_container_children ##### -->
1999-08-16 18:51:52 +00:00
<para>
Does the same as gtk_container_get_children().
1999-08-16 18:51:52 +00:00
</para>
@Returns:
2002-12-08 01:03:03 +00:00
@Deprecated: Use gtk_container_get_children() instead.
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_get_children ##### -->
<para>
</para>
@container:
@Returns:
<!-- ##### FUNCTION gtk_container_set_reallocate_redraws ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container:
@needs_redraws:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_set_focus_child ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container:
@child:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_get_focus_vadjustment ##### -->
<para>
</para>
@container:
@Returns:
<!-- ##### FUNCTION gtk_container_set_focus_vadjustment ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container:
@adjustment:
<!-- ##### FUNCTION gtk_container_get_focus_hadjustment ##### -->
<para>
</para>
@container:
@Returns:
<!-- ##### FUNCTION gtk_container_set_focus_hadjustment ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container:
@adjustment:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_resize_children ##### -->
<para>
</para>
@container:
<!-- ##### FUNCTION gtk_container_child_type ##### -->
<para>
</para>
@container:
@Returns:
<!-- ##### FUNCTION gtk_container_child_get ##### -->
<para>
</para>
@container:
@child:
@first_prop_name:
@Varargs:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_child_set ##### -->
<para>
</para>
@container:
@child:
@first_prop_name:
1999-08-16 18:51:52 +00:00
@Varargs:
<!-- # Unused Parameters # -->
@first_arg_name:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_child_get_property ##### -->
<para>
</para>
@container:
@child:
@property_name:
@value:
<!-- ##### FUNCTION gtk_container_child_set_property ##### -->
<para>
</para>
@container:
@child:
@property_name:
@value:
<!-- ##### FUNCTION gtk_container_child_get_valist ##### -->
<para>
</para>
@container:
@child:
@first_property_name:
@var_args:
<!-- ##### FUNCTION gtk_container_child_set_valist ##### -->
<para>
</para>
@container:
@child:
@first_property_name:
@var_args:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_forall ##### -->
<para>
</para>
@container:
@callback:
@callback_data:
<!-- ##### FUNCTION gtk_container_get_border_width ##### -->
<para>
</para>
@container:
@Returns:
<!-- ##### FUNCTION gtk_container_set_border_width ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container:
@border_width:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gtk_container_propagate_expose ##### -->
<para>
</para>
@container:
@child:
@event:
<!-- ##### FUNCTION gtk_container_get_focus_chain ##### -->
<para>
</para>
@container:
@focusable_widgets:
@Returns:
<!-- ##### FUNCTION gtk_container_set_focus_chain ##### -->
<para>
</para>
@container:
@focusable_widgets:
<!-- ##### FUNCTION gtk_container_unset_focus_chain ##### -->
<para>
</para>
@container:
<!-- ##### FUNCTION gtk_container_class_find_child_property ##### -->
<para>
</para>
@cclass:
@property_name:
@Returns:
<!-- # Unused Parameters # -->
@class:
<!-- ##### FUNCTION gtk_container_class_install_child_property ##### -->
<para>
</para>
@cclass:
@property_id:
@pspec:
<!-- # Unused Parameters # -->
@class:
<!-- ##### FUNCTION gtk_container_class_list_child_properties ##### -->
<para>
</para>
@cclass:
@n_properties:
@Returns:
<!-- # Unused Parameters # -->
@class:
1999-08-16 18:51:52 +00:00
<!-- ##### SIGNAL GtkContainer::add ##### -->
<para>
</para>
@container: the object which received the signal.
@widget:
<!-- ##### SIGNAL GtkContainer::check-resize ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container: the object which received the signal.
<!-- ##### SIGNAL GtkContainer::remove ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
@container: the object which received the signal.
@widget:
1999-08-16 18:51:52 +00:00
<!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
<para>
</para>
@container: the object which received the signal.
@widget:
<!-- ##### ARG GtkContainer:border-width ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
<!-- ##### ARG GtkContainer:child ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>
<!-- ##### ARG GtkContainer:resize-mode ##### -->
1999-08-16 18:51:52 +00:00
<para>
</para>