<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkContainer: GTK+ 2 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="prev" href="GtkButtonBox.html" title="GtkButtonBox">
<link rel="next" href="GtkItem.html" title="GtkItem">
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#GtkContainer.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#GtkContainer.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
<a href="#GtkContainer.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#GtkContainer.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
<a href="#GtkContainer.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="AbstractObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkButtonBox.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkItem.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkContainer"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkContainer.top_of_page"></a>GtkContainer</span></h2>
<p>GtkContainer</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkContainer.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#GTK-IS-RESIZE-CONTAINER:CAPS" title="GTK_IS_RESIZE_CONTAINER()">GTK_IS_RESIZE_CONTAINER</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#GTK-CONTAINER-WARN-INVALID-CHILD-PROPERTY-ID:CAPS" title="GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID()">GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()">gtk_container_add</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()">gtk_container_remove</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-add-with-properties" title="gtk_container_add_with_properties ()">gtk_container_add_with_properties</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk2-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="returnvalue">GtkResizeMode</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-resize-mode" title="gtk_container_get_resize_mode ()">gtk_container_get_resize_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-resize-mode" title="gtk_container_set_resize_mode ()">gtk_container_set_resize_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-check-resize" title="gtk_container_check_resize ()">gtk_container_check_resize</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()">gtk_container_foreach</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-foreach-full" title="gtk_container_foreach_full ()">gtk_container_foreach_full</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-children" title="gtk_container_get_children ()">gtk_container_get_children</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-reallocate-redraws" title="gtk_container_set_reallocate_redraws ()">gtk_container_set_reallocate_redraws</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-focus-child" title="gtk_container_get_focus_child ()">gtk_container_get_focus_child</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-focus-child" title="gtk_container_set_focus_child ()">gtk_container_set_focus_child</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-focus-vadjustment" title="gtk_container_get_focus_vadjustment ()">gtk_container_get_focus_vadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()">gtk_container_set_focus_vadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-focus-hadjustment" title="gtk_container_get_focus_hadjustment ()">gtk_container_get_focus_hadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()">gtk_container_set_focus_hadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-resize-children" title="gtk_container_resize_children ()">gtk_container_resize_children</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-type" title="gtk_container_child_type ()">gtk_container_child_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-get" title="gtk_container_child_get ()">gtk_container_child_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()">gtk_container_child_set</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-get-property" title="gtk_container_child_get_property ()">gtk_container_child_get_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-set-property" title="gtk_container_child_set_property ()">gtk_container_child_set_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-get-valist" title="gtk_container_child_get_valist ()">gtk_container_child_get_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-child-set-valist" title="gtk_container_child_set_valist ()">gtk_container_child_set_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()">gtk_container_forall</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-border-width" title="gtk_container_get_border_width ()">gtk_container_get_border_width</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-border-width" title="gtk_container_set_border_width ()">gtk_container_set_border_width</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-propagate-expose" title="gtk_container_propagate_expose ()">gtk_container_propagate_expose</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-get-focus-chain" title="gtk_container_get_focus_chain ()">gtk_container_get_focus_chain</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-set-focus-chain" title="gtk_container_set_focus_chain ()">gtk_container_set_focus_chain</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkContainer.html#gtk-container-unset-focus-chain" title="gtk_container_unset_focus_chain ()">gtk_container_unset_focus_chain</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkContainer.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
<td class="property_name"><a class="link" href="GtkContainer.html#GtkContainer--border-width" title="The “border-width” property">border-width</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</td>
<td class="property_name"><a class="link" href="GtkContainer.html#GtkContainer--child" title="The “child” property">child</a></td>
<td class="property_flags">Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="gtk2-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a></td>
<td class="property_name"><a class="link" href="GtkContainer.html#GtkContainer--resize-mode" title="The “resize-mode” property">resize-mode</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkContainer.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-add" title="The “add” signal">add</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-check-resize" title="The “check-resize” signal">check-resize</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-remove" title="The “remove” signal">remove</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkContainer.html#GtkContainer-set-focus-child" title="The “set-focus-child” signal">set-focus-child</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkContainer.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkContainer.html#GtkContainer-struct" title="struct GtkContainer">GtkContainer</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GtkContainer.html#gtk-container-border-width" title="gtk_container_border_width">gtk_container_border_width</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GtkContainer.html#gtk-container-children" title="gtk_container_children">gtk_container_children</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkContainer.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<span class="lineart">╰──</span> <a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> GtkContainer
<span class="lineart">├──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
<span class="lineart">├──</span> <a class="link" href="GtkBox.html" title="GtkBox">GtkBox</a>
<span class="lineart">├──</span> <a class="link" href="GtkCList.html" title="GtkCList">GtkCList</a>
<span class="lineart">├──</span> <a class="link" href="GtkFixed.html" title="GtkFixed">GtkFixed</a>
<span class="lineart">├──</span> <a class="link" href="GtkPaned.html" title="GtkPaned">GtkPaned</a>
<span class="lineart">├──</span> <a class="link" href="GtkIconView.html" title="GtkIconView">GtkIconView</a>
<span class="lineart">├──</span> <a class="link" href="GtkLayout.html" title="GtkLayout">GtkLayout</a>
<span class="lineart">├──</span> <a class="link" href="GtkList.html" title="GtkList">GtkList</a>
<span class="lineart">├──</span> <a class="link" href="GtkMenuShell.html" title="GtkMenuShell">GtkMenuShell</a>
<span class="lineart">├──</span> <a class="link" href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a>
<span class="lineart">├──</span> <a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a>
<span class="lineart">├──</span> <a class="link" href="GtkTable.html" title="GtkTable">GtkTable</a>
<span class="lineart">├──</span> <a class="link" href="GtkTextView.html" title="GtkTextView">GtkTextView</a>
<span class="lineart">├──</span> <a class="link" href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a>
<span class="lineart">├──</span> <a class="link" href="GtkToolItemGroup.html" title="GtkToolItemGroup">GtkToolItemGroup</a>
<span class="lineart">├──</span> <a class="link" href="GtkToolPalette.html" title="GtkToolPalette">GtkToolPalette</a>
<span class="lineart">├──</span> <a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a>
<span class="lineart">╰──</span> <a class="link" href="GtkTreeView.html" title="GtkTreeView">GtkTreeView</a>
</pre>
</div>
<div class="refsect1">
<a name="GtkContainer.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkContainer implements
AtkImplementorIface and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkContainer.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <gtk/gtk.h>
</pre>
</div>
<div class="refsect1">
<a name="GtkContainer.description"></a><h2>Description</h2>
</div>
<div class="refsect1">
<a name="GtkContainer.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="GTK-IS-RESIZE-CONTAINER:CAPS"></a><h3>GTK_IS_RESIZE_CONTAINER()</h3>
<pre class="programlisting">#define GTK_IS_RESIZE_CONTAINER(widget) (GTK_IS_CONTAINER (widget) && ((GtkContainer*) (widget))->resize_mode != GTK_RESIZE_PARENT)
</pre>
</div>
<hr>
<div class="refsect2">
<a name="GTK-CONTAINER-WARN-INVALID-CHILD-PROPERTY-ID:CAPS"></a><h3>GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID()</h3>
<pre class="programlisting">#define GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID(object, property_id, pspec)</pre>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-add"></a><h3>gtk_container_add ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_add (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>Adds <em class="parameter"><code>widget</code></em>
to <em class="parameter"><code>container</code></em>
. Typically used for simple containers
such as <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, <a class="link" href="GtkFrame.html" title="GtkFrame"><span class="type">GtkFrame</span></a>, or <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>; for more complicated
layout containers such as <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> or <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>, this function will
pick default packing parameters that may not be correct. So
consider functions such as <a class="link" href="GtkBox.html#gtk-box-pack-start" title="gtk_box_pack_start ()"><code class="function">gtk_box_pack_start()</code></a> and
<a class="link" href="GtkTable.html#gtk-table-attach" title="gtk_table_attach ()"><code class="function">gtk_table_attach()</code></a> as an alternative to <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> in
those cases. A widget may be added to only one container at a time;
you can't place the same widget inside two different containers.</p>
<div class="refsect3">
<a name="gtk-container-add.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a widget to be placed inside <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-remove"></a><h3>gtk_container_remove ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_remove (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>Removes <em class="parameter"><code>widget</code></em>
from <em class="parameter"><code>container</code></em>
. <em class="parameter"><code>widget</code></em>
must be inside <em class="parameter"><code>container</code></em>
.
Note that <em class="parameter"><code>container</code></em>
will own a reference to <em class="parameter"><code>widget</code></em>
, and that this
may be the last reference held; so removing a widget from its
container can destroy that widget. If you want to use <em class="parameter"><code>widget</code></em>
again, you need to add a reference to it while it's not inside
a container, using <a href="../gobject/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>
again it's usually more efficient to simply destroy it directly
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
container and help break any circular reference count cycles.</p>
<div class="refsect3">
<a name="gtk-container-remove.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a current child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-add-with-properties"></a><h3>gtk_container_add_with_properties ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Adds <em class="parameter"><code>widget</code></em>
to <em class="parameter"><code>container</code></em>
, setting child properties at the same time.
See <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> and <a class="link" href="GtkContainer.html#gtk-container-child-set" title="gtk_container_child_set ()"><code class="function">gtk_container_child_set()</code></a> for more details.</p>
<div class="refsect3">
<a name="gtk-container-add-with-properties.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> </p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a widget to be placed inside <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_prop_name</p></td>
<td class="parameter_description"><p>the name of the first child property to set </p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>Varargs</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-resize-mode"></a><h3>gtk_container_get_resize_mode ()</h3>
<pre class="programlisting"><a class="link" href="gtk2-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="returnvalue">GtkResizeMode</span></a>
gtk_container_get_resize_mode (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Returns the resize mode for the container. See
<a class="link" href="GtkContainer.html#gtk-container-set-resize-mode" title="gtk_container_set_resize_mode ()"><code class="function">gtk_container_set_resize_mode()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-get-resize-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-resize-mode.returns"></a><h4>Returns</h4>
<p> the current resize mode</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-resize-mode"></a><h3>gtk_container_set_resize_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_resize_mode (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="gtk2-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a> resize_mode</code></em>);</pre>
<p>Sets the resize mode for the container.</p>
<p>The resize mode of a container determines whether a resize request
will be passed to the container's parent, queued for later execution
or executed immediately.</p>
<div class="refsect3">
<a name="gtk-container-set-resize-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>resize_mode</p></td>
<td class="parameter_description"><p>the new resize mode</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-check-resize"></a><h3>gtk_container_check_resize ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_check_resize (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-foreach"></a><h3>gtk_container_foreach ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<p>Invokes <em class="parameter"><code>callback</code></em>
on each non-internal child of <em class="parameter"><code>container</code></em>
. See
<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. Most applications should use
<a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>, rather than <a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-foreach.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a callback. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback_data</p></td>
<td class="parameter_description"><p>callback user data</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-foreach-full"></a><h3>gtk_container_foreach_full ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
<em class="parameter"><code><a class="link" href="gtk2-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>,
<em class="parameter"><code><a href="../glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_container_foreach_full</code> is deprecated and should not be used in newly-written code.</p></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-children"></a><h3>gtk_container_get_children ()</h3>
<pre class="programlisting"><a href="../glib/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>
<p>Returns the container's non-internal children. See
<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.</p>
<div class="refsect3">
<a name="gtk-container-get-children.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-children.returns"></a><h4>Returns</h4>
<p>a newly-allocated list of the container's non-internal children. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-reallocate-redraws"></a><h3>gtk_container_set_reallocate_redraws ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_reallocate_redraws (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> needs_redraws</code></em>);</pre>
<p>Sets the <em class="parameter"><code>reallocate_redraws</code></em>
flag of the container to the given value.</p>
<p>Containers requesting reallocation redraws get automatically
redrawn if any of their children changed allocation.</p>
<div class="refsect3">
<a name="gtk-container-set-reallocate-redraws.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>needs_redraws</p></td>
<td class="parameter_description"><p>the new value for the container's <em class="parameter"><code>reallocate_redraws</code></em>
flag</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-child"></a><h3>gtk_container_get_focus_child ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_container_get_focus_child (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Returns the current focus child widget inside <em class="parameter"><code>container</code></em>
. This is not the
currently focused widget. That can be obtained by calling
<a class="link" href="GtkWindow.html#gtk-window-get-focus" title="gtk_window_get_focus ()"><code class="function">gtk_window_get_focus()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-get-focus-child.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-child.returns"></a><h4>Returns</h4>
<p>The child widget which will receive the
focus inside <em class="parameter"><code>container</code></em>
when the <em class="parameter"><code>conatiner</code></em>
is focussed,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is set. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-child"></a><h3>gtk_container_set_focus_child ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>);</pre>
<p>Sets, or unsets if <em class="parameter"><code>child</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the focused child of <em class="parameter"><code>container</code></em>
.</p>
<p>This function emits the GtkContainer::set_focus_child signal of
<em class="parameter"><code>container</code></em>
. Implementations of <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> can override the
default behaviour by overriding the class closure of this signal.</p>
<p>This is function is mostly meant to be used by widgets. Applications can use
<a class="link" href="GtkWidget.html#gtk-widget-grab-focus" title="gtk_widget_grab_focus ()"><code class="function">gtk_widget_grab_focus()</code></a> to manualy set the focus to a specific widget.</p>
<div class="refsect3">
<a name="gtk-container-set-focus-child.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-vadjustment"></a><h3>gtk_container_get_focus_vadjustment ()</h3>
<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
gtk_container_get_focus_vadjustment (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Retrieves the vertical focus adjustment for the container. See
<a class="link" href="GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()"><code class="function">gtk_container_set_focus_vadjustment()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-get-focus-vadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-vadjustment.returns"></a><h4>Returns</h4>
<p>the vertical focus adjustment, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
none has been set. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-vadjustment"></a><h3>gtk_container_set_focus_vadjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_focus_vadjustment (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<p>Hooks up an adjustment to focus handling in a container, so when a
child of the container is focused, the adjustment is scrolled to
show that widget. This function sets the vertical alignment. See
<a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-vadjustment" title="gtk_scrolled_window_get_vadjustment ()"><code class="function">gtk_scrolled_window_get_vadjustment()</code></a> for a typical way of obtaining
the adjustment and <a class="link" href="GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()"><code class="function">gtk_container_set_focus_hadjustment()</code></a> for setting
the horizontal adjustment.</p>
<p>The adjustments have to be in pixel units and in the same coordinate
system as the allocation for immediate children of the container.</p>
<div class="refsect3">
<a name="gtk-container-set-focus-vadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>adjustment</p></td>
<td class="parameter_description"><p>an adjustment which should be adjusted when the focus
is moved among the descendents of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-hadjustment"></a><h3>gtk_container_get_focus_hadjustment ()</h3>
<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
gtk_container_get_focus_hadjustment (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Retrieves the horizontal focus adjustment for the container. See
<a class="link" href="GtkContainer.html#gtk-container-set-focus-hadjustment" title="gtk_container_set_focus_hadjustment ()"><code class="function">gtk_container_set_focus_hadjustment()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-get-focus-hadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-hadjustment.returns"></a><h4>Returns</h4>
<p>the horizontal focus adjustment, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
none has been set. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-hadjustment"></a><h3>gtk_container_set_focus_hadjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_set_focus_hadjustment (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>,
<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<p>Hooks up an adjustment to focus handling in a container, so when a child
of the container is focused, the adjustment is scrolled to show that
widget. This function sets the horizontal alignment.
See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-hadjustment" title="gtk_scrolled_window_get_hadjustment ()"><code class="function">gtk_scrolled_window_get_hadjustment()</code></a> for a typical way of obtaining
the adjustment and <a class="link" href="GtkContainer.html#gtk-container-set-focus-vadjustment" title="gtk_container_set_focus_vadjustment ()"><code class="function">gtk_container_set_focus_vadjustment()</code></a> for setting
the vertical adjustment.</p>
<p>The adjustments have to be in pixel units and in the same coordinate
system as the allocation for immediate children of the container.</p>
<div class="refsect3">
<a name="gtk-container-set-focus-hadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>adjustment</p></td>
<td class="parameter_description"><p>an adjustment which should be adjusted when the focus is
moved among the descendents of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-resize-children"></a><h3>gtk_container_resize_children ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_resize_children (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-type"></a><h3>gtk_container_child_type ()</h3>
<pre class="programlisting"><a href="../gobject/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>
<p>Returns the type of the children supported by the container.</p>
<p>Note that this may return <a href="../gobject/gobject-Type-Information.html#G-TYPE-NONE:CAPS"><code class="literal">G_TYPE_NONE</code></a> to indicate that no more
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
children.</p>
<div class="refsect3">
<a name="gtk-container-child-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-child-type.returns"></a><h4>Returns</h4>
<p> a <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get"></a><h3>gtk_container_child_get ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>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>
.</p>
<div class="refsect3">
<a name="gtk-container-child-get.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_prop_name</p></td>
<td class="parameter_description"><p>the name of the first property to get</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>Varargs</p></td>
<td class="parameter_description"><p>return location for the first property, followed
optionally by more name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set"></a><h3>gtk_container_child_set ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_prop_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Sets one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
<div class="refsect3">
<a name="gtk-container-child-set.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_prop_name</p></td>
<td class="parameter_description"><p>the name of the first property to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>Varargs</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get-property"></a><h3>gtk_container_child_get_property ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>Gets the value of a child property for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
<div class="refsect3">
<a name="gtk-container-child-get-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>the name of the property to get</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a location to return the value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set-property"></a><h3>gtk_container_child_set_property ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
<em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>Sets a child property for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
<div class="refsect3">
<a name="gtk-container-child-set-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>the name of the property to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the value to set the property to</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-get-valist"></a><h3>gtk_container_child_get_valist ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>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>
.</p>
<div class="refsect3">
<a name="gtk-container-child-get-valist.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_property_name</p></td>
<td class="parameter_description"><p>the name of the first property to get</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>return location for the first property, followed
optionally by more name/return location pairs, followed by <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-child-set-valist"></a><h3>gtk_container_child_set_valist ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Sets one or more child properties for <em class="parameter"><code>child</code></em>
and <em class="parameter"><code>container</code></em>
.</p>
<div class="refsect3">
<a name="gtk-container-child-set-valist.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a widget which is a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_property_name</p></td>
<td class="parameter_description"><p>the name of the first property to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of property names and values, starting
with <em class="parameter"><code>first_prop_name</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-forall"></a><h3>gtk_container_forall ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html#GtkCallback" title="GtkCallback ()"><span class="type">GtkCallback</span></a> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> callback_data</code></em>);</pre>
<p>Invokes <em class="parameter"><code>callback</code></em>
on each child of <em class="parameter"><code>container</code></em>
, including children
that are considered "internal" (implementation details of the
container). "Internal" children generally weren't added by the user
of the container, but were added by the container implementation
itself. Most applications should use <a class="link" href="GtkContainer.html#gtk-container-foreach" title="gtk_container_foreach ()"><code class="function">gtk_container_foreach()</code></a>,
rather than <a class="link" href="GtkContainer.html#gtk-container-forall" title="gtk_container_forall ()"><code class="function">gtk_container_forall()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-forall.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a callback</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback_data</p></td>
<td class="parameter_description"><p>callback user data</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-border-width"></a><h3>gtk_container_get_border_width ()</h3>
<pre class="programlisting"><a href="../glib/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>
<p>Retrieves the border width of the container. See
<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>.</p>
<div class="refsect3">
<a name="gtk-container-get-border-width.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-border-width.returns"></a><h4>Returns</h4>
<p> the current border width</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-border-width"></a><h3>gtk_container_set_border_width ()</h3>
<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>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> border_width</code></em>);</pre>
<p>Sets the border width of the container.</p>
<p>The border width of a container is the amount of space to leave
around the outside of the container. The only exception to this is
<a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>; because toplevel windows can't leave space outside,
they leave the space inside. The border is added on all sides of
the container. To add space to only one side, one approach is to
create a <a class="link" href="GtkAlignment.html" title="GtkAlignment"><span class="type">GtkAlignment</span></a> widget, call <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a>
to give it a size, and place it on the side of the container as
a spacer.</p>
<div class="refsect3">
<a name="gtk-container-set-border-width.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>border_width</p></td>
<td class="parameter_description"><p>amount of blank space to leave <span class="emphasis"><em>outside</em></span>
the container. Valid values are in the range 0-65535 pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-propagate-expose"></a><h3>gtk_container_propagate_expose ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
<em class="parameter"><code><a href="../html/gdk2-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> *event</code></em>);</pre>
<p>When a container receives an expose event, it must send synthetic
expose events to all children that don't have their own <a href="../html/gdk2-Windows.html#GdkWindow"><span class="type">GdkWindows</span></a>.
This function provides a convenient way of doing this. A container,
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>
once for each child, passing in the event the container received.</p>
<p>gtk_container_propagate_expose() takes care of deciding whether
an expose event needs to be sent to the child, intersecting
the event's area with the child area, and sending the event.</p>
<p>In most cases, a container can simply either simply inherit the
<span class="type">“expose”</span> implementation from <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>, or, do some drawing
and then chain to the ::expose implementation from <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>.</p>
<p>Note that the ::expose-event signal has been replaced by a ::draw
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>
has been replaced by <code class="function">gtk_container_propagate_draw()</code>.
The GTK+ 3 migration guide
for hints on how to port from ::expose-event to ::draw.</p>
<div class="refsect3">
<a name="gtk-container-propagate-expose.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>child</p></td>
<td class="parameter_description"><p>a child of <em class="parameter"><code>container</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a expose event sent to container</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-get-focus-chain"></a><h3>gtk_container_get_focus_chain ()</h3>
<pre class="programlisting"><a href="../glib/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>,
<em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> **focusable_widgets</code></em>);</pre>
<p>Retrieves the focus chain of the container, if one has been
set explicitly. If no focus chain has been explicitly
set, GTK+ computes the focus chain based on the positions
of the children. In that case, GTK+ stores <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in
<em class="parameter"><code>focusable_widgets</code></em>
and returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-get-focus-chain.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>focusable_widgets</p></td>
<td class="parameter_description"><p>location
to store the focus chain of the
container, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. You should free this list
using <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> when you are done with it, however
no additional reference count is added to the
individual widgets in the focus chain. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-container-get-focus-chain.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the focus chain of the container
has been set explicitly.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-set-focus-chain"></a><h3>gtk_container_set_focus_chain ()</h3>
<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>,
<em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *focusable_widgets</code></em>);</pre>
<p>Sets a focus chain, overriding the one computed automatically by GTK+.</p>
<p>In principle each widget in the chain should be a descendant of the
container, but this is not enforced by this method, since it's allowed
to set the focus chain before you pack the widgets, or have a widget
in the chain that isn't always packed. The necessary checks are done
when the focus chain is actually traversed.</p>
<div class="refsect3">
<a name="gtk-container-set-focus-chain.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>focusable_widgets</p></td>
<td class="parameter_description"><p>the new focus chain. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-unset-focus-chain"></a><h3>gtk_container_unset_focus_chain ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_unset_focus_chain (<em class="parameter"><code><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Removes a focus chain explicitly set with <a class="link" href="GtkContainer.html#gtk-container-set-focus-chain" title="gtk_container_set_focus_chain ()"><code class="function">gtk_container_set_focus_chain()</code></a>.</p>
<div class="refsect3">
<a name="gtk-container-unset-focus-chain.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-find-child-property"></a><h3>gtk_container_class_find_child_property ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
gtk_container_class_find_child_property
(<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
<p>Finds a child property of a container class by name.</p>
<div class="refsect3">
<a name="gtk-container-class-find-child-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cclass</p></td>
<td class="parameter_description"><p>a <a href="../gtk4/GtkContainer.html#GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GtkContainerClass]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>the name of the child property to find</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>returns</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> of the child property or
<a href="../glib/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. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-install-child-property"></a><h3>gtk_container_class_install_child_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_container_class_install_child_property
(<em class="parameter"><code><a href="../gtk4/GtkContainer.html#GtkContainerClass"><span class="type">GtkContainerClass</span></a> *cclass</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id</code></em>,
<em class="parameter"><code><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> *pspec</code></em>);</pre>
<p>Installs a child property on a container class.</p>
<div class="refsect3">
<a name="gtk-container-class-install-child-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cclass</p></td>
<td class="parameter_description"><p>a <a href="../gtk4/GtkContainer.html#GtkContainerClass"><span class="type">GtkContainerClass</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_id</p></td>
<td class="parameter_description"><p>the id for the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>the <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> for the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-class-list-child-properties"></a><h3>gtk_container_class_list_child_properties ()</h3>
<pre class="programlisting"><a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> **
gtk_container_class_list_child_properties
(<em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *cclass</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *n_properties</code></em>);</pre>
<p>Returns all child properties of a container class.</p>
<div class="refsect3">
<a name="gtk-container-class-list-child-properties.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cclass</p></td>
<td class="parameter_description"><p>a <a href="../gtk4/GtkContainer.html#GtkContainerClass"><span class="type">GtkContainerClass</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GtkContainerClass]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_properties</p></td>
<td class="parameter_description"><p>location to return the number of child properties found</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>returns</p></td>
<td class="parameter_description"><p>a newly
allocated <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="../gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a>*.
The array must be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkContainer.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkContainer-struct"></a><h3>struct GtkContainer</h3>
<pre class="programlisting">struct GtkContainer;</pre>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-border-width"></a><h3>gtk_container_border_width</h3>
<pre class="programlisting">#define gtk_container_border_width gtk_container_set_border_width
</pre>
<div class="warning"><p><code class="literal">gtk_container_border_width</code> is deprecated and should not be used in newly-written code.</p></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-container-children"></a><h3>gtk_container_children</h3>
<pre class="programlisting">#define gtk_container_children gtk_container_get_children
</pre>
<div class="warning"><p><code class="literal">gtk_container_children</code> is deprecated and should not be used in newly-written code.</p></div>
</div>
</div>
<div class="refsect1">
<a name="GtkContainer.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkContainer--border-width"></a><h3>The <code class="literal">“border-width”</code> property</h3>
<pre class="programlisting"> “border-width” <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
<p>The width of the empty border outside the containers children.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: <= 65535</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer--child"></a><h3>The <code class="literal">“child”</code> property</h3>
<pre class="programlisting"> “child” <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *</pre>
<p>Can be used to add a new child to the container.</p>
<p>Flags: Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer--resize-mode"></a><h3>The <code class="literal">“resize-mode”</code> property</h3>
<pre class="programlisting"> “resize-mode” <a class="link" href="gtk2-Standard-Enumerations.html#GtkResizeMode" title="enum GtkResizeMode"><span class="type">GtkResizeMode</span></a></pre>
<p>Specify how resize events are handled.</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_RESIZE_PARENT</p>
</div>
</div>
<div class="refsect1">
<a name="GtkContainer.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkContainer-add"></a><h3>The <code class="literal">“add”</code> signal</h3>
<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,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer-check-resize"></a><h3>The <code class="literal">“check-resize”</code> signal</h3>
<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,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer-remove"></a><h3>The <code class="literal">“remove”</code> signal</h3>
<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,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkContainer-set-focus-child"></a><h3>The <code class="literal">“set-focus-child”</code> signal</h3>
<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,
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.26.1</div>
</body>
</html>