← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkContainer.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2011-09-08 20:30:15 UTC
  • mfrom: (1.14.10 upstream)
  • Revision ID: package-import@ubuntu.com-20110908203015-hmdoq5jt1bl50nq3
Tags: 2.24.6-0ubuntu1
* debian/watch: Look for bz2 tarballs, and restrict to GTK 2 versions.
* New upstream bug fix release.
* Drop 094_git_fileselector_error.patch, include_m4_dir.patch: Included
  upstream.
* 003_gdk.pc_privates.patch, 009_gtk-export-filechooser.patch: Unfuzz.
* debian/libgail-doc.install, debian/libgtk2.0-doc.install.in: Install
  documentation from the source tree, as it's not being installed any more.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkContainer.html
60
60
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-add-with-properties" title="gtk_container_add_with_properties ()">gtk_container_add_with_properties</a>   (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
62
62
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
63
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
63
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
64
64
                                                         <em class="parameter"><code>...</code></em>);
65
65
<a class="link" href="gtk-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="returnvalue">GtkResizeMode</span></a>       <a class="link" href="GtkContainer.html#gtk-container-get-resize-mode" title="gtk_container_get_resize_mode ()">gtk_container_get_resize_mode</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
66
66
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-resize-mode" title="gtk_container_set_resize_mode ()">gtk_container_set_resize_mode</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
68
68
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-check-resize" title="gtk_container_check_resize ()">gtk_container_check_resize</a>          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()">gtk_container_foreach</a>               (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
70
70
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
71
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);
 
71
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);
72
72
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-foreach-full" title="gtk_container_foreach_full ()">gtk_container_foreach_full</a>          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
73
73
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
74
74
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
75
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>,
76
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);
 
75
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>,
 
76
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);
77
77
#define             <a class="link" href="GtkContainer.html#gtk-container-children" title="gtk_container_children">gtk_container_children</a>
78
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="GtkContainer.html#gtk-container-get-children" title="gtk_container_get_children ()">gtk_container_get_children</a>          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
 
78
<span class="returnvalue">GList</span> *             <a class="link" href="GtkContainer.html#gtk-container-get-children" title="gtk_container_get_children ()">gtk_container_get_children</a>          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
79
79
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-reallocate-redraws" title="gtk_container_set_reallocate_redraws ()">gtk_container_set_reallocate_redraws</a>
80
80
                                                        (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
81
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);
 
81
                                                         <em class="parameter"><code><span class="type">gboolean</span> needs_redraws</code></em>);
82
82
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkContainer.html#gtk-container-get-focus-child" title="gtk_container_get_focus_child ()">gtk_container_get_focus_child</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
83
83
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-focus-child" title="gtk_container_set_focus_child ()">gtk_container_set_focus_child</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
84
84
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);
89
89
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()">gtk_container_set_focus_hadjustment</a> (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
90
90
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);
91
91
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-resize-children" title="gtk_container_resize_children ()">gtk_container_resize_children</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
92
 
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               <a class="link" href="GtkContainer.html#gtk-container-child-type" title="gtk_container_child_type ()">gtk_container_child_type</a>            (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
 
92
<span class="returnvalue">GType</span>               <a class="link" href="GtkContainer.html#gtk-container-child-type" title="gtk_container_child_type ()">gtk_container_child_type</a>            (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
93
93
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-get" title="gtk_container_child_get ()">gtk_container_child_get</a>             (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
94
94
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
95
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
95
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
96
96
                                                         <em class="parameter"><code>...</code></em>);
97
97
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()">gtk_container_child_set</a>             (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
98
98
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
99
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
99
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
100
100
                                                         <em class="parameter"><code>...</code></em>);
101
101
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-get-property" title="gtk_container_child_get_property ()">gtk_container_child_get_property</a>    (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
102
102
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
103
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
104
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
 
103
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 
104
                                                         <em class="parameter"><code><span class="type">GValue</span> *value</code></em>);
105
105
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-set-property" title="gtk_container_child_set_property ()">gtk_container_child_set_property</a>    (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
106
106
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
107
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
108
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
 
107
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 
108
                                                         <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);
109
109
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-get-valist" title="gtk_container_child_get_valist ()">gtk_container_child_get_valist</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
110
110
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
111
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
111
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
112
112
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
113
113
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-child-set-valist" title="gtk_container_child_set_valist ()">gtk_container_child_set_valist</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
114
114
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
115
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
115
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
116
116
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
117
117
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()">gtk_container_forall</a>                (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
118
118
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
119
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);
120
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkContainer.html#gtk-container-get-border-width" title="gtk_container_get_border_width ()">gtk_container_get_border_width</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
 
119
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);
 
120
<span class="returnvalue">guint</span>               <a class="link" href="GtkContainer.html#gtk-container-get-border-width" title="gtk_container_get_border_width ()">gtk_container_get_border_width</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
121
121
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()">gtk_container_set_border_width</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
122
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);
 
122
                                                         <em class="parameter"><code><span class="type">guint</span> border_width</code></em>);
123
123
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-propagate-expose" title="gtk_container_propagate_expose ()">gtk_container_propagate_expose</a>      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
124
124
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
125
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> *event</code></em>);
126
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkContainer.html#gtk-container-get-focus-chain" title="gtk_container_get_focus_chain ()">gtk_container_get_focus_chain</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
127
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);
 
125
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> *event</code></em>);
 
126
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkContainer.html#gtk-container-get-focus-chain" title="gtk_container_get_focus_chain ()">gtk_container_get_focus_chain</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
 
127
                                                         <em class="parameter"><code><span class="type">GList</span> **focusable_widgets</code></em>);
128
128
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-set-focus-chain" title="gtk_container_set_focus_chain ()">gtk_container_set_focus_chain</a>       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
129
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);
 
129
                                                         <em class="parameter"><code><span class="type">GList</span> *focusable_widgets</code></em>);
130
130
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-unset-focus-chain" title="gtk_container_unset_focus_chain ()">gtk_container_unset_focus_chain</a>     (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);
131
 
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *        <a class="link" href="GtkContainer.html#gtk-container-class-find-child-property" title="gtk_container_class_find_child_property ()">gtk_container_class_find_child_property</a>
132
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
133
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);
 
131
<span class="returnvalue">GParamSpec</span> *        <a class="link" href="GtkContainer.html#gtk-container-class-find-child-property" title="gtk_container_class_find_child_property ()">gtk_container_class_find_child_property</a>
 
132
                                                        (<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
 
133
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);
134
134
<span class="returnvalue">void</span>                <a class="link" href="GtkContainer.html#gtk-container-class-install-child-property" title="gtk_container_class_install_child_property ()">gtk_container_class_install_child_property</a>
135
135
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *cclass</code></em>,
136
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
137
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);
138
 
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **       <a class="link" href="GtkContainer.html#gtk-container-class-list-child-properties" title="gtk_container_class_list_child_properties ()">gtk_container_class_list_child_properties</a>
139
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
140
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);
 
136
                                                         <em class="parameter"><code><span class="type">guint</span> property_id</code></em>,
 
137
                                                         <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);
 
138
<span class="returnvalue">GParamSpec</span> **       <a class="link" href="GtkContainer.html#gtk-container-class-list-child-properties" title="gtk_container_class_list_child_properties ()">gtk_container_class_list_child_properties</a>
 
139
                                                        (<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
 
140
                                                         <em class="parameter"><code><span class="type">guint</span> *n_properties</code></em>);
141
141
</pre>
142
142
</div>
143
143
<div class="refsect1">
144
144
<a name="GtkContainer.object-hierarchy"></a><h2>Object Hierarchy</h2>
145
145
<pre class="synopsis">
146
 
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
147
 
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
146
  GObject
 
147
   +----GInitiallyUnowned
148
148
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
149
149
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
150
150
                     +----GtkContainer
177
177
<div class="refsect1">
178
178
<a name="GtkContainer.properties"></a><h2>Properties</h2>
179
179
<pre class="synopsis">
180
 
  "<a class="link" href="GtkContainer.html#GtkContainer--border-width" title='The "border-width" property'>border-width</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
 
180
  "<a class="link" href="GtkContainer.html#GtkContainer--border-width" title='The "border-width" property'>border-width</a>"             <span class="type">guint</span>                 : Read / Write
181
181
  "<a class="link" href="GtkContainer.html#GtkContainer--child" title='The "child" property'>child</a>"                    <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Write
182
182
  "<a class="link" href="GtkContainer.html#GtkContainer--resize-mode" title='The "resize-mode" property'>resize-mode</a>"              <a class="link" href="gtk-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a>         : Read / Write
183
183
</pre>
185
185
<div class="refsect1">
186
186
<a name="GtkContainer.signals"></a><h2>Signals</h2>
187
187
<pre class="synopsis">
188
 
  "<a class="link" href="GtkContainer.html#GtkContainer-add" title='The "add" signal'>add</a>"                                            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
189
 
  "<a class="link" href="GtkContainer.html#GtkContainer-check-resize" title='The "check-resize" signal'>check-resize</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
190
 
  "<a class="link" href="GtkContainer.html#GtkContainer-remove" title='The "remove" signal'>remove</a>"                                         : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
191
 
  "<a class="link" href="GtkContainer.html#GtkContainer-set-focus-child" title='The "set-focus-child" signal'>set-focus-child</a>"                                : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
 
188
  "<a class="link" href="GtkContainer.html#GtkContainer-add" title='The "add" signal'>add</a>"                                            : <code class="literal">Run First</code>
 
189
  "<a class="link" href="GtkContainer.html#GtkContainer-check-resize" title='The "check-resize" signal'>check-resize</a>"                                   : <code class="literal">Run Last</code>
 
190
  "<a class="link" href="GtkContainer.html#GtkContainer-remove" title='The "remove" signal'>remove</a>"                                         : <code class="literal">Run First</code>
 
191
  "<a class="link" href="GtkContainer.html#GtkContainer-set-focus-child" title='The "set-focus-child" signal'>set-focus-child</a>"                                : <code class="literal">Run First</code>
192
192
</pre>
193
193
</div>
194
194
<div class="refsect1">
306
306
child properties for the child.
307
307
</p>
308
308
<div class="example">
309
 
<a name="id1207492"></a><p class="title"><b>Example 55. Child properties in UI definitions</b></p>
 
309
<a name="id1328190"></a><p class="title"><b>Example 55. Child properties in UI definitions</b></p>
310
310
<div class="example-contents">
311
311
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
312
312
    <tbody>
369
369
<tbody>
370
370
<tr>
371
371
<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
372
 
<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> on which <code class="function">set_child_property()</code> or <code class="function">get_child_property()</code>
 
372
<td>the <span class="type">GObject</span> on which <code class="function">set_child_property()</code> or <code class="function">get_child_property()</code>
373
373
was called</td>
374
374
</tr>
375
375
<tr>
378
378
</tr>
379
379
<tr>
380
380
<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
381
 
<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the property</td>
 
381
<td>the <span class="type">GParamSpec</span> of the property</td>
382
382
</tr>
383
383
</tbody>
384
384
</table></div>
438
438
may be the last reference held; so removing a widget from its
439
439
container can destroy that widget. If you want to use <em class="parameter"><code>widget</code></em>
440
440
again, you need to add a reference to it while it's not inside
441
 
a container, using <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>. If you don't want to use <em class="parameter"><code>widget</code></em>
 
441
a container, using <code class="function">g_object_ref()</code>. If you don't want to use <em class="parameter"><code>widget</code></em>
442
442
again it's usually more efficient to simply destroy it directly
443
443
using <a class="link" href="GtkWidget.html#gtk-widget-destroy" title="gtk_widget_destroy ()"><code class="function">gtk_widget_destroy()</code></a> since this will remove it from the
444
444
container and help break any circular reference count cycles.
464
464
<a name="gtk-container-add-with-properties"></a><h3>gtk_container_add_with_properties ()</h3>
465
465
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_add_with_properties   (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
466
466
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
467
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
467
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
468
468
                                                         <em class="parameter"><code>...</code></em>);</pre>
469
469
<p>
470
470
Adds <em class="parameter"><code>widget</code></em> to <em class="parameter"><code>container</code></em>, setting child properties at the same time.
553
553
<a name="gtk-container-foreach"></a><h3>gtk_container_foreach ()</h3>
554
554
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_foreach               (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
555
555
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
556
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
 
556
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);</pre>
557
557
<p>
558
558
Invokes <em class="parameter"><code>callback</code></em> on each non-internal child of <em class="parameter"><code>container</code></em>. See
559
559
<a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a> for details on what constitutes an
586
586
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_foreach_full          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
587
587
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
588
588
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
589
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>,
590
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
 
589
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>,
 
590
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> notify</code></em>);</pre>
591
591
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
592
592
<h3 class="title">Warning</h3>
593
593
<p><code class="literal">gtk_container_foreach_full</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a> instead.</p>
611
611
<hr>
612
612
<div class="refsect2">
613
613
<a name="gtk-container-get-children"></a><h3>gtk_container_get_children ()</h3>
614
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gtk_container_get_children          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
 
614
<pre class="programlisting"><span class="returnvalue">GList</span> *             gtk_container_get_children          (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
615
615
<p>
616
616
Returns the container's non-internal children. See
617
617
<a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a> for details on what constitutes an "internal" child.
637
637
<a name="gtk-container-set-reallocate-redraws"></a><h3>gtk_container_set_reallocate_redraws ()</h3>
638
638
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_reallocate_redraws
639
639
                                                        (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
640
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);</pre>
 
640
                                                         <em class="parameter"><code><span class="type">gboolean</span> needs_redraws</code></em>);</pre>
641
641
<p>
642
642
Sets the <em class="parameter"><code>reallocate_redraws</code></em> flag of the container to the given value.
643
643
</p>
681
681
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
682
682
<td>The child widget which will receive the
683
683
focus inside <em class="parameter"><code>container</code></em> when the <em class="parameter"><code>conatiner</code></em> is focussed,
684
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
684
or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none is set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
685
685
</td>
686
686
</tr>
687
687
</tbody>
694
694
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_child       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
695
695
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
696
696
<p>
697
 
Sets, or unsets if <em class="parameter"><code>child</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the focused child of <em class="parameter"><code>container</code></em>.
 
697
Sets, or unsets if <em class="parameter"><code>child</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, the focused child of <em class="parameter"><code>container</code></em>.
698
698
</p>
699
699
<p>
700
700
This function emits the GtkContainer::set_focus_child signal of
715
715
</tr>
716
716
<tr>
717
717
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
718
 
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
718
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
719
719
</td>
720
720
</tr>
721
721
</tbody>
739
739
</tr>
740
740
<tr>
741
741
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
742
 
<td>the vertical focus adjustment, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
742
<td>the vertical focus adjustment, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if
743
743
none has been set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
744
744
</td>
745
745
</tr>
798
798
</tr>
799
799
<tr>
800
800
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
801
 
<td>the horizontal focus adjustment, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
801
<td>the horizontal focus adjustment, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if
802
802
none has been set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
803
803
</td>
804
804
</tr>
849
849
<hr>
850
850
<div class="refsect2">
851
851
<a name="gtk-container-child-type"></a><h3>gtk_container_child_type ()</h3>
852
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               gtk_container_child_type            (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
 
852
<pre class="programlisting"><span class="returnvalue">GType</span>               gtk_container_child_type            (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
853
853
<p>
854
854
Returns the type of the children supported by the container.
855
855
</p>
856
856
<p>
857
 
Note that this may return <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><code class="literal">G_TYPE_NONE</code></a> to indicate that no more
 
857
Note that this may return <code class="literal">G_TYPE_NONE</code> to indicate that no more
858
858
children can be added, e.g. for a <a class="link" href="GtkPaned.html" title="GtkPaned"><span class="type">GtkPaned</span></a> which already has two 
859
859
children.
860
860
</p>
868
868
</tr>
869
869
<tr>
870
870
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
871
 
<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</td>
 
871
<td>a <span class="type">GType</span>.</td>
872
872
</tr>
873
873
</tbody>
874
874
</table></div>
878
878
<a name="gtk-container-child-get"></a><h3>gtk_container_child_get ()</h3>
879
879
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get             (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
880
880
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
881
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
881
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
882
882
                                                         <em class="parameter"><code>...</code></em>);</pre>
883
883
<p>
884
884
Gets the values of one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
908
908
<a name="gtk-container-child-set"></a><h3>gtk_container_child_set ()</h3>
909
909
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set             (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
910
910
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
911
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
 
911
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_prop_name</code></em>,
912
912
                                                         <em class="parameter"><code>...</code></em>);</pre>
913
913
<p>
914
914
Sets one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
938
938
<a name="gtk-container-child-get-property"></a><h3>gtk_container_child_get_property ()</h3>
939
939
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get_property    (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
940
940
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
941
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
942
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 
941
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 
942
                                                         <em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
943
943
<p>
944
944
Gets the value of a child property for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
945
945
</p>
972
972
<a name="gtk-container-child-set-property"></a><h3>gtk_container_child_set_property ()</h3>
973
973
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set_property    (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
974
974
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
975
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
976
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 
975
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
 
976
                                                         <em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);</pre>
977
977
<p>
978
978
Sets a child property for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
979
979
</p>
1006
1006
<a name="gtk-container-child-get-valist"></a><h3>gtk_container_child_get_valist ()</h3>
1007
1007
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_get_valist      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1008
1008
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
1009
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
1009
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
1010
1010
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
1011
1011
<p>
1012
1012
Gets the values of one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
1031
1031
<tr>
1032
1032
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
1033
1033
<td>return location for the first property, followed
1034
 
optionally by more name/return location pairs, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1034
optionally by more name/return location pairs, followed by <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
1035
1035
</td>
1036
1036
</tr>
1037
1037
</tbody>
1042
1042
<a name="gtk-container-child-set-valist"></a><h3>gtk_container_child_set_valist ()</h3>
1043
1043
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_child_set_valist      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1044
1044
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
1045
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 
1045
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
1046
1046
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
1047
1047
<p>
1048
1048
Sets one or more child properties for <em class="parameter"><code>child</code></em> and <em class="parameter"><code>container</code></em>.
1066
1066
</tr>
1067
1067
<tr>
1068
1068
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
1069
 
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
 
1069
<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
1070
1070
with <em class="parameter"><code>first_prop_name</code></em>
1071
1071
</td>
1072
1072
</tr>
1078
1078
<a name="gtk-container-forall"></a><h3>gtk_container_forall ()</h3>
1079
1079
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_forall                (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1080
1080
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
1081
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
 
1081
                                                         <em class="parameter"><code><span class="type">gpointer</span> callback_data</code></em>);</pre>
1082
1082
<p>
1083
1083
Invokes <em class="parameter"><code>callback</code></em> on each child of <em class="parameter"><code>container</code></em>, including children
1084
1084
that are considered "internal" (implementation details of the
1109
1109
<hr>
1110
1110
<div class="refsect2">
1111
1111
<a name="gtk-container-get-border-width"></a><h3>gtk_container_get_border_width ()</h3>
1112
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_container_get_border_width      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
 
1112
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_container_get_border_width      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
1113
1113
<p>
1114
1114
Retrieves the border width of the container. See
1115
1115
<a class="link" href="GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()"><code class="function">gtk_container_set_border_width()</code></a>.
1133
1133
<div class="refsect2">
1134
1134
<a name="gtk-container-set-border-width"></a><h3>gtk_container_set_border_width ()</h3>
1135
1135
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_border_width      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1136
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);</pre>
 
1136
                                                         <em class="parameter"><code><span class="type">guint</span> border_width</code></em>);</pre>
1137
1137
<p>
1138
1138
Sets the border width of the container.
1139
1139
</p>
1168
1168
<a name="gtk-container-propagate-expose"></a><h3>gtk_container_propagate_expose ()</h3>
1169
1169
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_propagate_expose      (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1170
1170
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
1171
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> *event</code></em>);</pre>
 
1171
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> *event</code></em>);</pre>
1172
1172
<p>
1173
1173
When a container receives an expose event, it must send synthetic
1174
 
expose events to all children that don't have their own <a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a>.
 
1174
expose events to all children that don't have their own <a href="../gdk/gdk-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a>.
1175
1175
This function provides a convenient way of doing this. A container,
1176
1176
when it receives an expose event, calls <a class="link" href="GtkContainer.html#gtk-container-propagate-expose" title="gtk_container_propagate_expose ()"><code class="function">gtk_container_propagate_expose()</code></a>
1177
1177
once for each child, passing in the event the container received.
1189
1189
<p>
1190
1190
Note that the ::expose-event signal has been replaced by a ::draw
1191
1191
signal in GTK+ 3, and consequently, <a class="link" href="GtkContainer.html#gtk-container-propagate-expose" title="gtk_container_propagate_expose ()"><code class="function">gtk_container_propagate_expose()</code></a>
1192
 
has been replaced by <a href="http://library.gnome.org/devel/gtk/GtkContainer.html#gtk-container-propagate-draw"><code class="function">gtk_container_propagate_draw()</code></a>.
 
1192
has been replaced by <code class="function">gtk_container_propagate_draw()</code>.
1193
1193
The GTK+ 3 migration guide
1194
1194
for hints on how to port from ::expose-event to ::draw.
1195
1195
</p>
1216
1216
<hr>
1217
1217
<div class="refsect2">
1218
1218
<a name="gtk-container-get-focus-chain"></a><h3>gtk_container_get_focus_chain ()</h3>
1219
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_container_get_focus_chain       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1220
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);</pre>
 
1219
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_container_get_focus_chain       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
 
1220
                                                         <em class="parameter"><code><span class="type">GList</span> **focusable_widgets</code></em>);</pre>
1221
1221
<p>
1222
1222
Retrieves the focus chain of the container, if one has been
1223
1223
set explicitly. If no focus chain has been explicitly
1224
1224
set, GTK+ computes the focus chain based on the positions
1225
 
of the children. In that case, GTK+ stores <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in
1226
 
<em class="parameter"><code>focusable_widgets</code></em> and returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
 
1225
of the children. In that case, GTK+ stores <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> in
 
1226
<em class="parameter"><code>focusable_widgets</code></em> and returns <code class="literal">FALSE</code>.
1227
1227
</p>
1228
1228
<div class="variablelist"><table border="0">
1229
1229
<col align="left" valign="top">
1237
1237
<td><p><span class="term"><em class="parameter"><code>focusable_widgets</code></em> :</span></p></td>
1238
1238
<td>location
1239
1239
to store the focus chain of the
1240
 
container, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free this list
1241
 
using <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> when you are done with it, however
 
1240
container, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. You should free this list
 
1241
using <code class="function">g_list_free()</code> when you are done with it, however
1242
1242
no additional reference count is added to the
1243
1243
individual widgets in the focus chain. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
1244
1244
</td>
1246
1246
<tr>
1247
1247
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1248
1248
<td>
1249
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the focus chain of the container
 
1249
<code class="literal">TRUE</code> if the focus chain of the container
1250
1250
has been set explicitly.</td>
1251
1251
</tr>
1252
1252
</tbody>
1256
1256
<div class="refsect2">
1257
1257
<a name="gtk-container-set-focus-chain"></a><h3>gtk_container_set_focus_chain ()</h3>
1258
1258
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_set_focus_chain       (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
1259
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);</pre>
 
1259
                                                         <em class="parameter"><code><span class="type">GList</span> *focusable_widgets</code></em>);</pre>
1260
1260
<p>
1261
1261
Sets a focus chain, overriding the one computed automatically by GTK+.
1262
1262
</p>
1302
1302
<hr>
1303
1303
<div class="refsect2">
1304
1304
<a name="gtk-container-class-find-child-property"></a><h3>gtk_container_class_find_child_property ()</h3>
1305
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *        gtk_container_class_find_child_property
1306
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
1307
 
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
 
1305
<pre class="programlisting"><span class="returnvalue">GParamSpec</span> *        gtk_container_class_find_child_property
 
1306
                                                        (<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
 
1307
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
1308
1308
<p>
1309
1309
Finds a child property of a container class by name.
1310
1310
</p>
1322
1322
</tr>
1323
1323
<tr>
1324
1324
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1325
 
<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child property or
1326
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>class</code></em> has no child property with that name. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
1325
<td>the <span class="type">GParamSpec</span> of the child property or
 
1326
<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>class</code></em> has no child property with that name. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1327
1327
</td>
1328
1328
</tr>
1329
1329
</tbody>
1334
1334
<a name="gtk-container-class-install-child-property"></a><h3>gtk_container_class_install_child_property ()</h3>
1335
1335
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_container_class_install_child_property
1336
1336
                                                        (<em class="parameter"><code><span class="type">GtkContainerClass</span> *cclass</code></em>,
1337
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
1338
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
 
1337
                                                         <em class="parameter"><code><span class="type">guint</span> property_id</code></em>,
 
1338
                                                         <em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
1339
1339
<p>
1340
1340
Installs a child property on a container class.
1341
1341
</p>
1353
1353
</tr>
1354
1354
<tr>
1355
1355
<td><p><span class="term"><em class="parameter"><code>pspec</code></em> :</span></p></td>
1356
 
<td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</td>
 
1356
<td>the <span class="type">GParamSpec</span> for the property</td>
1357
1357
</tr>
1358
1358
</tbody>
1359
1359
</table></div>
1361
1361
<hr>
1362
1362
<div class="refsect2">
1363
1363
<a name="gtk-container-class-list-child-properties"></a><h3>gtk_container_class_list_child_properties ()</h3>
1364
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **       gtk_container_class_list_child_properties
1365
 
                                                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
1366
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre>
 
1364
<pre class="programlisting"><span class="returnvalue">GParamSpec</span> **       gtk_container_class_list_child_properties
 
1365
                                                        (<em class="parameter"><code><span class="type">GObjectClass</span> *cclass</code></em>,
 
1366
                                                         <em class="parameter"><code><span class="type">guint</span> *n_properties</code></em>);</pre>
1367
1367
<p>
1368
1368
Returns all child properties of a container class.
1369
1369
</p>
1382
1382
<tr>
1383
1383
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1384
1384
<td>a newly
1385
 
allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*.
1386
 
The array must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
 
1385
allocated <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of <span class="type">GParamSpec</span>*.
 
1386
The array must be freed with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
1387
1387
</td>
1388
1388
</tr>
1389
1389
</tbody>
1394
1394
<a name="GtkContainer.property-details"></a><h2>Property Details</h2>
1395
1395
<div class="refsect2">
1396
1396
<a name="GtkContainer--border-width"></a><h3>The <code class="literal">"border-width"</code> property</h3>
1397
 
<pre class="programlisting">  "border-width"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
 
1397
<pre class="programlisting">  "border-width"             <span class="type">guint</span>                 : Read / Write</pre>
1398
1398
<p>The width of the empty border outside the containers children.</p>
1399
1399
<p>Allowed values: &lt;= 65535</p>
1400
1400
<p>Default value: 0</p>
1419
1419
<a name="GtkContainer-add"></a><h3>The <code class="literal">"add"</code> signal</h3>
1420
1420
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
1421
1421
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>    *widget,
1422
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1422
                                                        <span class="type">gpointer</span>      user_data)      : <code class="literal">Run First</code></pre>
1423
1423
<p>
1424
1424
</p>
1425
1425
<div class="variablelist"><table border="0">
1440
1440
<div class="refsect2">
1441
1441
<a name="GtkContainer-check-resize"></a><h3>The <code class="literal">"check-resize"</code> signal</h3>
1442
1442
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
1443
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 
1443
                                                        <span class="type">gpointer</span>      user_data)      : <code class="literal">Run Last</code></pre>
1444
1444
<p>
1445
1445
</p>
1446
1446
<div class="variablelist"><table border="0">
1462
1462
<a name="GtkContainer-remove"></a><h3>The <code class="literal">"remove"</code> signal</h3>
1463
1463
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
1464
1464
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>    *widget,
1465
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1465
                                                        <span class="type">gpointer</span>      user_data)      : <code class="literal">Run First</code></pre>
1466
1466
<p>
1467
1467
</p>
1468
1468
<div class="variablelist"><table border="0">
1484
1484
<a name="GtkContainer-set-focus-child"></a><h3>The <code class="literal">"set-focus-child"</code> signal</h3>
1485
1485
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container,
1486
1486
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>    *widget,
1487
 
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 
1487
                                                        <span class="type">gpointer</span>      user_data)      : <code class="literal">Run First</code></pre>
1488
1488
<p>
1489
1489
</p>
1490
1490
<div class="variablelist"><table border="0">