<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Wt: Wt::WBoxLayout Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Wt
 <span id="projectnumber">3.2.3</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.5.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceWt.html">Wt</a> </li>
<li class="navelem"><a class="el" href="classWt_1_1WBoxLayout.html">WBoxLayout</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> </div>
<div class="headertitle">
<div class="title">Wt::WBoxLayout Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="Wt::WBoxLayout" --><!-- doxytag: inherits="Wt::WLayout" -->
<p>A layout manager which arranges widgets horizontally or vertically.
<a href="classWt_1_1WBoxLayout.html#details">More...</a></p>
<p><code>#include <Wt/WBoxLayout></code></p>
<div class="dynheader">
Inheritance diagram for Wt::WBoxLayout:</div>
<div class="dyncontent">
<div class="center"><img src="classWt_1_1WBoxLayout__inherit__graph.png" border="0" usemap="#Wt_1_1WBoxLayout_inherit__map" alt="Inheritance graph"/></div>
<map name="Wt_1_1WBoxLayout_inherit__map" id="Wt_1_1WBoxLayout_inherit__map">
<area shape="rect" href="classWt_1_1WHBoxLayout.html" title="A layout manager which arranges widgets horizontally." alt="" coords="5,229,136,256"/><area shape="rect" href="classWt_1_1WVBoxLayout.html" title="A layout manager which arranges widgets vertically." alt="" coords="160,229,291,256"/><area shape="rect" href="classWt_1_1WLayout.html" title="An abstract base class for layout managers." alt="" coords="99,80,197,107"/><area shape="rect" href="classWt_1_1WLayoutItem.html" title="An abstract base class for items that can participate in a layout." alt="" coords="20,5,143,32"/><area shape="rect" href="classWt_1_1WObject.html" title="A base class for objects that participate in the signal/slot system." alt="" coords="167,5,263,32"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classWt_1_1WBoxLayout-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> { <a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803eca174fcc4fd0b807e60c838385be19e1f9">LeftToRight</a>,
<a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ecaa4a4afece8c59ddaf384c08b276aa70f">RightToLeft</a>,
<a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ecaf705eddcc1a4639aeb1908f1c7acface">TopToBottom</a>,
<a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ecaf25be1e7bbefae032ceb333e67bda5f2">BottomToTop</a>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enumeration of the direction in which widgets are layed out. <a href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a9472dd446911a6a6d33b019a34a0c4fc">WBoxLayout</a> (<a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> dir, <a class="el" href="classWt_1_1WWidget.html">WWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new box layout. <a href="#a9472dd446911a6a6d33b019a34a0c4fc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a2932a804ac01e0b314408bf4d366385d">addItem</a> (<a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a layout <em>item</em>. <a href="#a2932a804ac01e0b314408bf4d366385d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#aa01f05c0f40fa89e418b802f78f2870c">removeItem</a> (<a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes a layout <em>item</em> (widget or nested layout). <a href="#aa01f05c0f40fa89e418b802f78f2870c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#aad2ec4be48cb11a7802b3e6d7cb8f0fd">itemAt</a> (int index) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the layout item at a specific <em>index</em>. <a href="#aad2ec4be48cb11a7802b3e6d7cb8f0fd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a961fe311fd07adbf7b60b571ef7a8278">count</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of items in this layout. <a href="#a961fe311fd07adbf7b60b571ef7a8278"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a4dfc3f4f98e857bc0cbc98608a7855f4">clear</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes and deletes all child widgets and nested layouts. <a href="#a4dfc3f4f98e857bc0cbc98608a7855f4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#af669ef9fbcdb8954d1cfa7bb9e47b90f">setDirection</a> (<a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> direction)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the layout direction. <a href="#af669ef9fbcdb8954d1cfa7bb9e47b90f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#aa101f33971e037bed0e4bfea164cf0dc">direction</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the layout direction. <a href="#aa101f33971e037bed0e4bfea164cf0dc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a34d544a1a2bd8beffa6b8e5e84fbc19b">setSpacing</a> (int size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets spacing between each item. <a href="#a34d544a1a2bd8beffa6b8e5e84fbc19b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#aa9d0d7ef4ea1753f898d6d71ad8e9b22">spacing</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the spacing between each item. <a href="#aa9d0d7ef4ea1753f898d6d71ad8e9b22"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6">addWidget</a> (<a class="el" href="classWt_1_1WWidget.html">WWidget</a> *widget, int stretch=0, WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > alignment=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a widget to the layout. <a href="#a7c1ec58e25d0b7add93f5f4342844db6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a062d26b432841995a0be7b7d7aac6413">addLayout</a> (<a class="el" href="classWt_1_1WLayout.html">WLayout</a> *layout, int stretch=0, WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > alignment=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a nested layout to the layout. <a href="#a062d26b432841995a0be7b7d7aac6413"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a3cbd78251252e724d01937e2f6cc803d">addSpacing</a> (const <a class="el" href="classWt_1_1WLength.html">WLength</a> &size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds extra spacing. <a href="#a3cbd78251252e724d01937e2f6cc803d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a811708ce9336d753c20aaedc14b00d5f">addStretch</a> (int stretch=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a stretch element. <a href="#a811708ce9336d753c20aaedc14b00d5f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a9ebc82bb4cc8f0bbb4e272df6ab4c02f">insertWidget</a> (int index, <a class="el" href="classWt_1_1WWidget.html">WWidget</a> *widget, int stretch=0, WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > alignment=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Inserts a widget in the layout. <a href="#a9ebc82bb4cc8f0bbb4e272df6ab4c02f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a8ab8fd1d8b5f3634eac9b559605e4ced">insertLayout</a> (int index, <a class="el" href="classWt_1_1WLayout.html">WLayout</a> *layout, int stretch=0, WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > alignment=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Inserts a nested layout in the layout. <a href="#a8ab8fd1d8b5f3634eac9b559605e4ced"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a0d5d6a9e408c6bc7e25020f8c85cb4cf">insertSpacing</a> (int index, const <a class="el" href="classWt_1_1WLength.html">WLength</a> &size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Inserts extra spacing in the layout. <a href="#a0d5d6a9e408c6bc7e25020f8c85cb4cf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a0174de2ae36e2992b7209cf789d85271">insertStretch</a> (int index, int stretch=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Inserts a stretch element in the layout. <a href="#a0174de2ae36e2992b7209cf789d85271"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a47182ea3c459afdadb3cc03232a8d110">setStretchFactor</a> (<a class="el" href="classWt_1_1WLayout.html">WLayout</a> *layout, int stretch)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the stretch factor for a nested layout. <a href="#a47182ea3c459afdadb3cc03232a8d110"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#af5ce73d289874c80e88ed6fd9934bb39">setStretchFactor</a> (<a class="el" href="classWt_1_1WWidget.html">WWidget</a> *widget, int stretch)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the stretch factor for a widget. <a href="#af5ce73d289874c80e88ed6fd9934bb39"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#ac2628c9ddfb9b6c079a8b5d5261b94c2">setResizable</a> (int index, bool enabled=true, const <a class="el" href="classWt_1_1WLength.html">WLength</a> &initialSize=<a class="el" href="classWt_1_1WLength.html#a0cf39ca4225776879d56ade60320c31a">WLength::Auto</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether the use may drag a particular border. <a href="#ac2628c9ddfb9b6c079a8b5d5261b94c2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WBoxLayout.html#a07a62537e92ad4ff14305dc2e1e8dd9c">isResizable</a> (int index) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the user may drag a particular border. <a href="#a07a62537e92ad4ff14305dc2e1e8dd9c"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A layout manager which arranges widgets horizontally or vertically. </p>
<p>This layout manager arranges widgets horizontally or vertically inside the parent container.</p>
<p>The space is divided so that each widget is given its preferred size, and remaining space is divided according to stretch factors among widgets. If not all widgets can be given their preferred size (there is not enough room), then widgets are given a smaller size (down to their minimum size). If necessary, the container (or parent layout) of this layout is resized to meet minimum size requirements.</p>
<p>The preferred width or height of a widget is based on its natural size, where it presents its contents without overflowing. <a class="el" href="classWt_1_1WWidget.html#a5bebad8f1582b8bebf01a9ed0ee11972" title="Resizes the widget.">WWidget::resize()</a> or (CSS <code>width</code>, <code>height</code> properties) can be used to adjust the preferred size of a widget.</p>
<p>The minimum width or height of a widget is based on the minimum dimensions of the widget or the nested layout. The default minimum height or width for a widget is 0. It can be specified using <a class="el" href="classWt_1_1WWidget.html#a092c7d1ecfde7f004ef120389d91775d" title="Sets a minimum size.">WWidget::setMinimumSize()</a> or using CSS <code>min-width</code> or <code>min-height</code> properties.</p>
<p>You should use <a class="el" href="classWt_1_1WContainerWidget.html#ae269f870992c5843d3097a63795b10d6">WContainerWidget::setOverflow(OverflowAuto) </a> or use a <a class="el" href="classWt_1_1WScrollArea.html" title="A widget that adds scrolling capabilities to its content.">WScrollArea</a> to automatically show scrollbars for widgets inserted in the layout to cope with a size set by the layout manager that is smaller than the preferred size.</p>
<p>When the container of a layout manager has a maximum size set using <a class="el" href="classWt_1_1WWidget.html#af023064cf8007bda6baeb5277d79bbd9" title="Sets a maximum size.">WWidget::setMaximumSize()</a>, then the size of the container will be based on the preferred size of the contents, up to this maximum size, instead of the default behaviour of constraining the size of the children based on the size of the container.</p>
<p>A layout manager may provide resize handles between items which allow the user to change the automatic layout provided by the layout manager (see <a class="el" href="classWt_1_1WBoxLayout.html#ac2628c9ddfb9b6c079a8b5d5261b94c2" title="Sets whether the use may drag a particular border.">setResizable()</a>).</p>
<p>Each item is separated using a constant spacing, which defaults to 6 pixels, and can be changed using <a class="el" href="classWt_1_1WBoxLayout.html#a34d544a1a2bd8beffa6b8e5e84fbc19b" title="Sets spacing between each item.">setSpacing()</a>. In addition, when this layout is a top-level layout (i.e. is not nested inside another layout), a margin is set around the contents. This margin defaults to 9 pixels, and can be changed using <a class="el" href="classWt_1_1WLayout.html#af18bae8c743c9f9a5cabee58826ffb45" title="Set contents margins (in pixels).">setContentsMargins()</a>. You can add more space between two widgets using <a class="el" href="classWt_1_1WBoxLayout.html#a3cbd78251252e724d01937e2f6cc803d" title="Adds extra spacing.">addSpacing()</a>.</p>
<p>For each item a stretch factor may be defined, which controls how remaining space is used. Each item is stretched using the stretch factor to fill the remaining space.</p>
<p>Usage example: </p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">Wt::WContainerWidget</a> *w = <span class="keyword">new</span> <a class="code" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">Wt::WContainerWidget</a>(<span class="keyword">this</span>);
w-><a class="code" href="classWt_1_1WWebWidget.html#a4762c1aa0b5788e54a52270674f21e23" title="Resizes the widget.">resize</a>(WLength(), 600);
<a class="code" href="classWt_1_1WBoxLayout.html" title="A layout manager which arranges widgets horizontally or vertically.">Wt::WBoxLayout</a> *layout = <span class="keyword">new</span> <a class="code" href="classWt_1_1WBoxLayout.html#a9472dd446911a6a6d33b019a34a0c4fc" title="Creates a new box layout.">Wt::WBoxLayout</a>(<a class="code" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ecaf705eddcc1a4639aeb1908f1c7acface" title="Vertical layout, widgets are arranged from top to bottom.">Wt::WBoxLayout::TopToBottom</a>);
layout-><a class="code" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget</a>(<span class="keyword">new</span> <a class="code" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">Wt::WText</a>(<span class="stringliteral">"One"</span>));
layout-><a class="code" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget</a>(<span class="keyword">new</span> <a class="code" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">Wt::WText</a>(<span class="stringliteral">"Two"</span>));
layout-><a class="code" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget</a>(<span class="keyword">new</span> <a class="code" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">Wt::WText</a>(<span class="stringliteral">"Three"</span>));
layout-><a class="code" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget</a>(<span class="keyword">new</span> <a class="code" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">Wt::WText</a>(<span class="stringliteral">"Four"</span>));
w-><a class="code" href="classWt_1_1WContainerWidget.html#a1c84e0ffe330d4798f0ce217f75be08c" title="Sets a layout manager for the container.">setLayout</a>(layout);
</pre></div><dl class="note"><dt><b>Note:</b></dt><dd>This layout manager is applicable only to <a class="el" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">WContainerWidget</a> container widgets. You may use it within an <a class="el" href="classWt_1_1Ext_1_1Container.html" title="A container class which manages its contents using layout managers.">Ext::Container</a> indirectly by first setting a <a class="el" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">WContainerWidget</a> using a <a class="el" href="classWt_1_1WFitLayout.html" title="A layout manager which spans a single widget to all available space.">WFitLayout</a>.</dd>
<dd>
When JavaScript support is not available, not all functionality of the layout is available. In particular, vertical size management is not available.</dd>
<dd>
When a layout is used on a first page with progressive bootstrap, then the layout will progress only in a limited way to a full JavaScript-based layout. You can thus not rely on it to behave properly for example when dynamically adding or removing widgets. </dd></dl>
</div><hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="addc4cd1f8b1158dcf16eb10d429803ec"></a><!-- doxytag: member="Wt::WBoxLayout::Direction" ref="addc4cd1f8b1158dcf16eb10d429803ec" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Wt::WBoxLayout::Direction</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enumeration of the direction in which widgets are layed out. </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="addc4cd1f8b1158dcf16eb10d429803eca174fcc4fd0b807e60c838385be19e1f9"></a><!-- doxytag: member="LeftToRight" ref="addc4cd1f8b1158dcf16eb10d429803eca174fcc4fd0b807e60c838385be19e1f9" args="" -->LeftToRight</em> </td><td>
<p>Horizontal layout, widgets are arranged from left to right. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="addc4cd1f8b1158dcf16eb10d429803ecaa4a4afece8c59ddaf384c08b276aa70f"></a><!-- doxytag: member="RightToLeft" ref="addc4cd1f8b1158dcf16eb10d429803ecaa4a4afece8c59ddaf384c08b276aa70f" args="" -->RightToLeft</em> </td><td>
<p>Horizontal layout, widgets are arranged from right to left. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="addc4cd1f8b1158dcf16eb10d429803ecaf705eddcc1a4639aeb1908f1c7acface"></a><!-- doxytag: member="TopToBottom" ref="addc4cd1f8b1158dcf16eb10d429803ecaf705eddcc1a4639aeb1908f1c7acface" args="" -->TopToBottom</em> </td><td>
<p>Vertical layout, widgets are arranged from top to bottom. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="addc4cd1f8b1158dcf16eb10d429803ecaf25be1e7bbefae032ceb333e67bda5f2"></a><!-- doxytag: member="BottomToTop" ref="addc4cd1f8b1158dcf16eb10d429803ecaf25be1e7bbefae032ceb333e67bda5f2" args="" -->BottomToTop</em> </td><td>
<p>Vertical layout, widgets are arranged from bottom to top. </p>
</td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a9472dd446911a6a6d33b019a34a0c4fc"></a><!-- doxytag: member="Wt::WBoxLayout::WBoxLayout" ref="a9472dd446911a6a6d33b019a34a0c4fc" args="(Direction dir, WWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WBoxLayout::WBoxLayout </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> </td>
<td class="paramname"><em>dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"><em>parent</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new box layout. </p>
<p>This constructor is rarely used. Instead, use the convenient constructors of the specialized <a class="el" href="classWt_1_1WHBoxLayout.html" title="A layout manager which arranges widgets horizontally.">WHBoxLayout</a> or <a class="el" href="classWt_1_1WVBoxLayout.html" title="A layout manager which arranges widgets vertically.">WVBoxLayout</a> classes.</p>
<p>Use <code>parent</code> = <code>0</code> to created a layout manager that can be nested inside other layout managers. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a2932a804ac01e0b314408bf4d366385d"></a><!-- doxytag: member="Wt::WBoxLayout::addItem" ref="a2932a804ac01e0b314408bf4d366385d" args="(WLayoutItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::addItem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a layout <em>item</em>. </p>
<p>The item may be a widget or nested layout.</p>
<p>How the item is layed out with respect to siblings is implementation specific to the layout manager. In some cases, a layout manager will overload this method with extra arguments that specify layout options.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#aa01f05c0f40fa89e418b802f78f2870c" title="Removes a layout item (widget or nested layout).">removeItem(WLayoutItem *)</a>, <a class="el" href="classWt_1_1WLayout.html#a886d2ec4b6b97524ba3dff93252e6540" title="Adds the given widget to the layout.">addWidget(WWidget *)</a> </dd></dl>
<p>Implements <a class="el" href="classWt_1_1WLayout.html#ad4a778298c01d290692afc77e441c629">Wt::WLayout</a>.</p>
</div>
</div>
<a class="anchor" id="a062d26b432841995a0be7b7d7aac6413"></a><!-- doxytag: member="Wt::WBoxLayout::addLayout" ref="a062d26b432841995a0be7b7d7aac6413" args="(WLayout *layout, int stretch=0, WFlags< AlignmentFlag > alignment=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::addLayout </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLayout.html">WLayout</a> * </td>
<td class="paramname"><em>layout</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > </td>
<td class="paramname"><em>alignment</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a nested layout to the layout. </p>
<p>Adds a nested layout, with given <code>stretch</code> factor.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget(WWidget *, int, WFlags<AlignmentFlag>)</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a8ab8fd1d8b5f3634eac9b559605e4ced" title="Inserts a nested layout in the layout.">insertLayout()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a3cbd78251252e724d01937e2f6cc803d"></a><!-- doxytag: member="Wt::WBoxLayout::addSpacing" ref="a3cbd78251252e724d01937e2f6cc803d" args="(const WLength &size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::addSpacing </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLength.html">WLength</a> & </td>
<td class="paramname"><em>size</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds extra spacing. </p>
<p>Adds extra spacing to the layout.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a811708ce9336d753c20aaedc14b00d5f" title="Adds a stretch element.">addStretch()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a0174de2ae36e2992b7209cf789d85271" title="Inserts a stretch element in the layout.">insertStretch()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a811708ce9336d753c20aaedc14b00d5f"></a><!-- doxytag: member="Wt::WBoxLayout::addStretch" ref="a811708ce9336d753c20aaedc14b00d5f" args="(int stretch=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::addStretch </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a stretch element. </p>
<p>Adds a stretch element to the layout. This adds an empty space that stretches as needed.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a3cbd78251252e724d01937e2f6cc803d" title="Adds extra spacing.">addSpacing()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a0174de2ae36e2992b7209cf789d85271" title="Inserts a stretch element in the layout.">insertStretch()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a7c1ec58e25d0b7add93f5f4342844db6"></a><!-- doxytag: member="Wt::WBoxLayout::addWidget" ref="a7c1ec58e25d0b7add93f5f4342844db6" args="(WWidget *widget, int stretch=0, WFlags< AlignmentFlag > alignment=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::addWidget </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"><em>widget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > </td>
<td class="paramname"><em>alignment</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a widget to the layout. </p>
<p>Adds a widget to the layout, with given <code>stretch</code> factor. When the stretch factor is 0, the widget will not be resized by the layout manager (stretched to take excess space).</p>
<p>The <code>alignment</code> parameter is a combination of a horizontal and/or a vertical AlignmentFlag OR'ed together.</p>
<p>The <code>alignment</code> specifies the vertical and horizontal alignment of the item. The default value 0 indicates that the item is stretched to fill the entire column or row. The alignment can be specified as a logical combination of a horizontal alignment (<a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fad033ef69b45d0b75633be34168c9b606" title="Align to the left.">Wt::AlignLeft</a>, <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa121104cdbb5db77c7d038813a93998e5" title="Align horizontally in the center.">Wt::AlignCenter</a>, or <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fab250310385383f0b2f68d4e0ad5567e1" title="Align to the right.">Wt::AlignRight</a>) and a vertical alignment (<a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa58fe5182bd266132c59718c6d30945a9" title="Align top of widget with top of tallest sibling widget.">Wt::AlignTop</a>, <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa2ed90f01dbf74049f428d33769d48e3f" title="Align vertically the middle to the middle of the parent widget.">Wt::AlignMiddle</a>, or <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa4f2aa4abba8500e25651bf8db5f0c162" title="Align bottom of widget to the bottom of the lowest sigling widget.">Wt::AlignBottom</a>).</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a062d26b432841995a0be7b7d7aac6413" title="Adds a nested layout to the layout.">addLayout()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a9ebc82bb4cc8f0bbb4e272df6ab4c02f" title="Inserts a widget in the layout.">insertWidget()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a4dfc3f4f98e857bc0cbc98608a7855f4"></a><!-- doxytag: member="Wt::WBoxLayout::clear" ref="a4dfc3f4f98e857bc0cbc98608a7855f4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::clear </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes and deletes all child widgets and nested layouts. </p>
<p>This is similar to <a class="el" href="classWt_1_1WContainerWidget.html#a608f748cbdda763f1a11556ddad9fbe1" title="Removes and deletes all child widgets.">WContainerWidget::clear()</a>, with the exception that the layout itself is not deleted. </p>
<p>Implements <a class="el" href="classWt_1_1WLayout.html#af9b4512adecf7adca01b8757108be4d6">Wt::WLayout</a>.</p>
</div>
</div>
<a class="anchor" id="a961fe311fd07adbf7b60b571ef7a8278"></a><!-- doxytag: member="Wt::WBoxLayout::count" ref="a961fe311fd07adbf7b60b571ef7a8278" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Wt::WBoxLayout::count </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the number of items in this layout. </p>
<p>This may be a theoretical number, which is greater than the actual number of items. It can be used to iterate over the items in the layout, in conjunction with <a class="el" href="classWt_1_1WBoxLayout.html#aad2ec4be48cb11a7802b3e6d7cb8f0fd" title="Returns the layout item at a specific index.">itemAt()</a>. </p>
<p>Implements <a class="el" href="classWt_1_1WLayout.html#a799b3cce5c1717b18e54c14471e84033">Wt::WLayout</a>.</p>
</div>
</div>
<a class="anchor" id="aa101f33971e037bed0e4bfea164cf0dc"></a><!-- doxytag: member="Wt::WBoxLayout::direction" ref="aa101f33971e037bed0e4bfea164cf0dc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> Wt::WBoxLayout::direction </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the layout direction. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#af669ef9fbcdb8954d1cfa7bb9e47b90f" title="Sets the layout direction.">setDirection()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8ab8fd1d8b5f3634eac9b559605e4ced"></a><!-- doxytag: member="Wt::WBoxLayout::insertLayout" ref="a8ab8fd1d8b5f3634eac9b559605e4ced" args="(int index, WLayout *layout, int stretch=0, WFlags< AlignmentFlag > alignment=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::insertLayout </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WLayout.html">WLayout</a> * </td>
<td class="paramname"><em>layout</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > </td>
<td class="paramname"><em>alignment</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Inserts a nested layout in the layout. </p>
<p>Inserts a nested layout in the layout at position<code>index</code>, with given <code>stretch</code> factor.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a9ebc82bb4cc8f0bbb4e272df6ab4c02f" title="Inserts a widget in the layout.">insertWidget()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a062d26b432841995a0be7b7d7aac6413" title="Adds a nested layout to the layout.">addLayout()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a0d5d6a9e408c6bc7e25020f8c85cb4cf"></a><!-- doxytag: member="Wt::WBoxLayout::insertSpacing" ref="a0d5d6a9e408c6bc7e25020f8c85cb4cf" args="(int index, const WLength &size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::insertSpacing </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLength.html">WLength</a> & </td>
<td class="paramname"><em>size</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Inserts extra spacing in the layout. </p>
<p>Inserts extra spacing in the layout at position <code>index</code>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a0174de2ae36e2992b7209cf789d85271" title="Inserts a stretch element in the layout.">insertStretch()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a3cbd78251252e724d01937e2f6cc803d" title="Adds extra spacing.">addSpacing()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a0174de2ae36e2992b7209cf789d85271"></a><!-- doxytag: member="Wt::WBoxLayout::insertStretch" ref="a0174de2ae36e2992b7209cf789d85271" args="(int index, int stretch=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::insertStretch </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Inserts a stretch element in the layout. </p>
<p>Inserts a stretch element in the layout at position <code>index</code>. This adds an empty space that stretches as needed.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a0d5d6a9e408c6bc7e25020f8c85cb4cf" title="Inserts extra spacing in the layout.">insertSpacing()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a811708ce9336d753c20aaedc14b00d5f" title="Adds a stretch element.">addStretch()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a9ebc82bb4cc8f0bbb4e272df6ab4c02f"></a><!-- doxytag: member="Wt::WBoxLayout::insertWidget" ref="a9ebc82bb4cc8f0bbb4e272df6ab4c02f" args="(int index, WWidget *widget, int stretch=0, WFlags< AlignmentFlag > alignment=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::insertWidget </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"><em>widget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> = <code>0</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">WFlags< <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143f">AlignmentFlag</a> > </td>
<td class="paramname"><em>alignment</em> = <code>0</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Inserts a widget in the layout. </p>
<p>Inserts a widget in the layout at position <code>index</code>, with given <code>stretch</code> factor. When the stretch factor is 0, the widget will not be resized by the layout manager (stretched to take excess space).</p>
<p>The <code>alignment</code> specifies the vertical and horizontal alignment of the item. The default value 0 indicates that the item is stretched to fill the entire column or row. The alignment can be specified as a logical combination of a horizontal alignment (<a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fad033ef69b45d0b75633be34168c9b606" title="Align to the left.">Wt::AlignLeft</a>, <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa121104cdbb5db77c7d038813a93998e5" title="Align horizontally in the center.">Wt::AlignCenter</a>, or <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fab250310385383f0b2f68d4e0ad5567e1" title="Align to the right.">Wt::AlignRight</a>) and a vertical alignment (<a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa58fe5182bd266132c59718c6d30945a9" title="Align top of widget with top of tallest sibling widget.">Wt::AlignTop</a>, <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa2ed90f01dbf74049f428d33769d48e3f" title="Align vertically the middle to the middle of the parent widget.">Wt::AlignMiddle</a>, or <a class="el" href="namespaceWt.html#ab8f772c69bc8180c31f9e4f4593b143fa4f2aa4abba8500e25651bf8db5f0c162" title="Align bottom of widget to the bottom of the lowest sigling widget.">Wt::AlignBottom</a>).</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a8ab8fd1d8b5f3634eac9b559605e4ced" title="Inserts a nested layout in the layout.">insertLayout()</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget(WWidget *, int, WFlags<AlignmentFlag>)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a07a62537e92ad4ff14305dc2e1e8dd9c"></a><!-- doxytag: member="Wt::WBoxLayout::isResizable" ref="a07a62537e92ad4ff14305dc2e1e8dd9c" args="(int index) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WBoxLayout::isResizable </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the user may drag a particular border. </p>
<p>This method returns whether the border that separates item <em>index</em> from the next item may be resized by the user.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#ac2628c9ddfb9b6c079a8b5d5261b94c2" title="Sets whether the use may drag a particular border.">setResizable()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aad2ec4be48cb11a7802b3e6d7cb8f0fd"></a><!-- doxytag: member="Wt::WBoxLayout::itemAt" ref="aad2ec4be48cb11a7802b3e6d7cb8f0fd" args="(int index) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> * Wt::WBoxLayout::itemAt </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the layout item at a specific <em>index</em>. </p>
<p>If there is no item at the <code>index</code>, <code>0</code> is returned.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WLayout.html#afecba709ae19b93ef9bbe167650dbc5c" title="Returns the index of a given item.">indexOf(WLayoutItem *) const</a>, <a class="el" href="classWt_1_1WBoxLayout.html#a961fe311fd07adbf7b60b571ef7a8278" title="Returns the number of items in this layout.">count()</a> </dd></dl>
<p>Implements <a class="el" href="classWt_1_1WLayout.html#a3d48e5e4f56ad5d1b0e60180ebc91442">Wt::WLayout</a>.</p>
</div>
</div>
<a class="anchor" id="aa01f05c0f40fa89e418b802f78f2870c"></a><!-- doxytag: member="Wt::WBoxLayout::removeItem" ref="aa01f05c0f40fa89e418b802f78f2870c" args="(WLayoutItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::removeItem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLayoutItem.html">WLayoutItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes a layout <em>item</em> (widget or nested layout). </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a2932a804ac01e0b314408bf4d366385d" title="Adds a layout item.">addItem(WLayoutItem *)</a>, <a class="el" href="classWt_1_1WLayout.html#a3f5e0f62a0deb8f2473e52c5270128d5" title="Removes the given widget from the layout.">removeWidget(WWidget *)</a> </dd></dl>
<p>Implements <a class="el" href="classWt_1_1WLayout.html#a8c8d94070a51e669f8077249b67742ae">Wt::WLayout</a>.</p>
</div>
</div>
<a class="anchor" id="af669ef9fbcdb8954d1cfa7bb9e47b90f"></a><!-- doxytag: member="Wt::WBoxLayout::setDirection" ref="af669ef9fbcdb8954d1cfa7bb9e47b90f" args="(Direction direction)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::setDirection </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WBoxLayout.html#addc4cd1f8b1158dcf16eb10d429803ec">Direction</a> </td>
<td class="paramname"><em>direction</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the layout direction. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#aa101f33971e037bed0e4bfea164cf0dc" title="Returns the layout direction.">direction()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ac2628c9ddfb9b6c079a8b5d5261b94c2"></a><!-- doxytag: member="Wt::WBoxLayout::setResizable" ref="ac2628c9ddfb9b6c079a8b5d5261b94c2" args="(int index, bool enabled=true, const WLength &initialSize=WLength::Auto)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::setResizable </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enabled</em> = <code>true</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classWt_1_1WLength.html">WLength</a> & </td>
<td class="paramname"><em>initialSize</em> = <code><a class="el" href="classWt_1_1WLength.html#a0cf39ca4225776879d56ade60320c31a">WLength::Auto</a></code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether the use may drag a particular border. </p>
<p>This method sets whether the border that separates item <em>index</em> from the next item may be resized by the user, depending on the value of <em>enabled</em>.</p>
<p>The default value is <em>false</em>.</p>
<p>If an <code>initialSize</code> is given (that is not <a class="el" href="classWt_1_1WLength.html#a0cf39ca4225776879d56ade60320c31a" title="An 'auto' length.">WLength::Auto</a>), then this size is used for the size of the item, overriding the size it would be given by the layout manager. </p>
</div>
</div>
<a class="anchor" id="a34d544a1a2bd8beffa6b8e5e84fbc19b"></a><!-- doxytag: member="Wt::WBoxLayout::setSpacing" ref="a34d544a1a2bd8beffa6b8e5e84fbc19b" args="(int size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WBoxLayout::setSpacing </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>size</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets spacing between each item. </p>
<p>The default spacing is 6 pixels. </p>
</div>
</div>
<a class="anchor" id="a47182ea3c459afdadb3cc03232a8d110"></a><!-- doxytag: member="Wt::WBoxLayout::setStretchFactor" ref="a47182ea3c459afdadb3cc03232a8d110" args="(WLayout *layout, int stretch)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WBoxLayout::setStretchFactor </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLayout.html">WLayout</a> * </td>
<td class="paramname"><em>layout</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the stretch factor for a nested layout. </p>
<p>The <code>layout</code> must have previously been added to this layout using <a class="el" href="classWt_1_1WBoxLayout.html#a8ab8fd1d8b5f3634eac9b559605e4ced" title="Inserts a nested layout in the layout.">insertLayout()</a> or <a class="el" href="classWt_1_1WBoxLayout.html#a062d26b432841995a0be7b7d7aac6413" title="Adds a nested layout to the layout.">addLayout()</a>.</p>
<p>Returns whether the <code>stretch</code> could be set. </p>
</div>
</div>
<a class="anchor" id="af5ce73d289874c80e88ed6fd9934bb39"></a><!-- doxytag: member="Wt::WBoxLayout::setStretchFactor" ref="af5ce73d289874c80e88ed6fd9934bb39" args="(WWidget *widget, int stretch)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WBoxLayout::setStretchFactor </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"><em>widget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stretch</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the stretch factor for a widget. </p>
<p>The <code>widget</code> must have previously been added to this layout using <a class="el" href="classWt_1_1WBoxLayout.html#a9ebc82bb4cc8f0bbb4e272df6ab4c02f" title="Inserts a widget in the layout.">insertWidget()</a> or <a class="el" href="classWt_1_1WBoxLayout.html#a7c1ec58e25d0b7add93f5f4342844db6" title="Adds a widget to the layout.">addWidget()</a>.</p>
<p>Returns whether the <code>stretch</code> could be set. </p>
</div>
</div>
<a class="anchor" id="aa9d0d7ef4ea1753f898d6d71ad8e9b22"></a><!-- doxytag: member="Wt::WBoxLayout::spacing" ref="aa9d0d7ef4ea1753f898d6d71ad8e9b22" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Wt::WBoxLayout::spacing </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the spacing between each item. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WBoxLayout.html#a34d544a1a2bd8beffa6b8e5e84fbc19b" title="Sets spacing between each item.">setSpacing()</a> </dd></dl>
</div>
</div>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr size="1"><address style="text-align: right; margin: 3px"><small>
Generated on Thu Nov 1 2012 for <a href="http://www.webtoolkit.eu/wt">the
C++ Web Toolkit (Wt)</a> by <a
href="http://www.doxygen.org/index.html"><img src="doxygen.png"
alt="doxygen" border="0" style="vertical-align: middle; display:
inline-block; height: 2em"></a> 1.7.5.1</small></address>
</body>
</html>
