gtk3/docs/reference/gtk/html/GtkHBox.html
2021-04-30 10:11:19 +01:00

160 lines
8.8 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkHBox: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog">
<link rel="next" href="GtkVBox.html" title="GtkVBox">
<meta name="generator" content="GTK-Doc V1.33.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="#GtkHBox.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
<a href="#GtkHBox.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
<a href="#GtkHBox.implemented-interfaces" class="shortcut">Implemented Interfaces</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="DeprecatedObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkFontSelectionDialog.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkVBox.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkHBox"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkHBox.top_of_page"></a>GtkHBox</span></h2>
<p>GtkHBox — A horizontal container box</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkHBox.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody><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="GtkHBox.html#gtk-hbox-new" title="gtk_hbox_new ()">gtk_hbox_new</a> <span class="c_punctuation">()</span>
</td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkHBox.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody><tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkHBox.html#GtkHBox-struct" title="struct GtkHBox">GtkHBox</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkHBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> <a class="link" href="GtkBox.html" title="GtkBox">GtkBox</a>
<span class="lineart">╰──</span> GtkHBox
</pre>
</div>
<div class="refsect1">
<a name="GtkHBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkHBox implements
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and <a class="link" href="gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkHBox.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkHBox.description"></a><h2>Description</h2>
<p><a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a> is a container that organizes child widgets into a single row.</p>
<p>Use the <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> packing interface to determine the arrangement,
spacing, width, and alignment of <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a> children.</p>
<p>All children are allocated the same height.</p>
<p>GtkHBox has been deprecated. You can use <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> instead, which is a
very quick and easy change. If you have derived your own classes from
GtkHBox, you can simply change the inheritance to derive directly
from <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>. No further changes are needed, since the default
value of the <a class="link" href="gtk3-Orientable.html#GtkOrientable--orientation" title="The “orientation” property"><span class="type">“orientation”</span></a> property is
<a class="link" href="gtk3-Standard-Enumerations.html#GTK-ORIENTATION-HORIZONTAL:CAPS"><code class="literal">GTK_ORIENTATION_HORIZONTAL</code></a>.</p>
<p>If you have a grid-like layout composed of nested boxes, and you dont
need first-child or last-child styling, the recommendation is to switch
to <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a>. For more information about migrating to <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a>, see
<a class="link" href="gtk-migrating-GtkGrid.html" title="Migrating from other containers to GtkGrid">Migrating from other containers to GtkGrid</a>.</p>
</div>
<div class="refsect1">
<a name="GtkHBox.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-hbox-new"></a><h3>gtk_hbox_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_hbox_new (<em class="parameter"><code><span class="type">gboolean</span> homogeneous</code></em>,
<em class="parameter"><code><span class="type">gint</span> spacing</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_hbox_new</code> has been deprecated since version 3.2 and should not be used in newly-written code.</p>
<p>You should use <a class="link" href="GtkBox.html#gtk-box-new" title="gtk_box_new ()"><code class="function">gtk_box_new()</code></a> with a <a class="link" href="gtk3-Standard-Enumerations.html#GTK-ORIENTATION-HORIZONTAL:CAPS"><code class="literal">GTK_ORIENTATION_HORIZONTAL</code></a>
<a class="link" href="gtk3-Orientable.html#GtkOrientable--orientation" title="The “orientation” property"><span class="type">“orientation”</span></a> instead</p>
</div>
<p>Creates a new <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a>.</p>
<div class="refsect3">
<a name="gtk-hbox-new.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>homogeneous</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if all children are to be given equal space allotments.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>spacing</p></td>
<td class="parameter_description"><p>the number of pixels to place by default between children.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-hbox-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a>.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkHBox.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkHBox-struct"></a><h3>struct GtkHBox</h3>
<pre class="programlisting">struct GtkHBox;</pre>
</div>
</div>
<div class="refsect1">
<a name="GtkHBox.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>