<!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::WMenu 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_1WMenu.html">WMenu</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> </div>
<div class="headertitle">
<div class="title">Wt::WMenu Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="Wt::WMenu" --><!-- doxytag: inherits="Wt::WCompositeWidget" -->
<p>A widget that shows a menu of options.
<a href="classWt_1_1WMenu.html#details">More...</a></p>
<p><code>#include <Wt/WMenu></code></p>
<div class="dynheader">
Inheritance diagram for Wt::WMenu:</div>
<div class="dyncontent">
<div class="center"><img src="classWt_1_1WMenu__inherit__graph.png" border="0" usemap="#Wt_1_1WMenu_inherit__map" alt="Inheritance graph"/></div>
<map name="Wt_1_1WMenu_inherit__map" id="Wt_1_1WMenu_inherit__map">
<area shape="rect" href="classWt_1_1WCompositeWidget.html" title="A widget that hides the implementation of composite widgets." alt="" coords="5,155,168,181"/><area shape="rect" href="classWt_1_1WWidget.html" title="The abstract base class for a user-interface component." alt="" coords="37,80,136,107"/><area shape="rect" href="classWt_1_1WObject.html" title="A base class for objects that participate in the signal/slot system." alt="" coords="39,5,135,32"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classWt_1_1WMenu-members.html">List of all members.</a></p>
<table class="memberdecls">
<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_1WMenu.html#a9a67c54e9bfe9b2f594a54dd18a9d8a4">WMenu</a> (<a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> orientation, <a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new menu. <a href="#a9a67c54e9bfe9b2f594a54dd18a9d8a4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#aedc7dcfb468fedd82eb6e01ddcdd3f77">WMenu</a> (<a class="el" href="classWt_1_1WStackedWidget.html">WStackedWidget</a> *contentsStack, <a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> orientation, <a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> *parent=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new menu. <a href="#aedc7dcfb468fedd82eb6e01ddcdd3f77"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7e2fef60ee49edaa9056b3284964576e"></a><!-- doxytag: member="Wt::WMenu::~WMenu" ref="a7e2fef60ee49edaa9056b3284964576e" args="()" -->
 </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a7e2fef60ee49edaa9056b3284964576e">~WMenu</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d">addItem</a> (const <a class="el" href="classWt_1_1WString.html">WString</a> &name, <a class="el" href="classWt_1_1WWidget.html">WWidget</a> *contents, <a class="el" href="classWt_1_1WMenuItem.html#a5e276ed0505694a7b89a1dd0c62aa55a">WMenuItem::LoadPolicy</a> policy=WMenuItem::LazyLoading)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an item. <a href="#ad7840197cc0caf0430792b9f4a0df60d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#acbccfeebf2c93244516dec81dcc56fda">addItem</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an item. <a href="#acbccfeebf2c93244516dec81dcc56fda"></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_1WMenu.html#a63819cb0a445ab7ad364f5b0e241b67d">removeItem</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes an item. <a href="#a63819cb0a445ab7ad364f5b0e241b67d"></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_1WMenu.html#a7bafc33564cb06d980d75e2f4d89f28d">select</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Selects an item. <a href="#a7bafc33564cb06d980d75e2f4d89f28d"></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_1WMenu.html#aec1801d047dc0f150d1cc12b801aa6c2">select</a> (int index)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Selects an item. <a href="#aec1801d047dc0f150d1cc12b801aa6c2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1Signal.html">Signal</a>< <a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20">itemSelected</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Signal which indicates that a new item was selected. <a href="#a0303879705bcdd8dbffc2d1528670d20"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1Signal.html">Signal</a>< <a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a8737f262f99d0db0a0f4b7aeb01cfe2e">itemSelectRendered</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Signal which indicates that a new selected item is rendered. <a href="#a8737f262f99d0db0a0f4b7aeb01cfe2e"></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_1WMenu.html#a97c9be1df48cb0d27e2e4b904b51e184">close</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Closes an item. <a href="#a97c9be1df48cb0d27e2e4b904b51e184"></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_1WMenu.html#a1040233afcd0372468faff230c685825">close</a> (int index)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Closes an item. <a href="#a1040233afcd0372468faff230c685825"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const std::vector< <a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#abb90d70d722ce95e748b3ed0b88168b5">items</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the items. <a href="#abb90d70d722ce95e748b3ed0b88168b5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1Signal.html">Signal</a>< <a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#ab9fa68e381972fb5385478b1e9eb6c78">itemClosed</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Signal which indicates that an item was closed. <a href="#ab9fa68e381972fb5385478b1e9eb6c78"></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_1WMenu.html#ab3d880e2b089bb084d5634130d61f4d7">setItemHidden</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item, bool hidden)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Hides an item. <a href="#ab3d880e2b089bb084d5634130d61f4d7"></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_1WMenu.html#a20e921974ecea341bdcfd5df9596ed53">setItemHidden</a> (int index, bool hidden)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Hides an item. <a href="#a20e921974ecea341bdcfd5df9596ed53"></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_1WMenu.html#a39e27cd34e0031206e4d0baecf4c9d0a">isItemHidden</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the item widget of the given item is hidden. <a href="#a39e27cd34e0031206e4d0baecf4c9d0a"></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_1WMenu.html#a207ebaad9bb29b1c936b28068e28a96a">isItemHidden</a> (int index) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the item widget of the given index is hidden. <a href="#a207ebaad9bb29b1c936b28068e28a96a"></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_1WMenu.html#a294d53469b71cb5d35fa59865c3b75cb">setItemDisabled</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item, bool disabled)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Disables an item. <a href="#a294d53469b71cb5d35fa59865c3b75cb"></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_1WMenu.html#ac647478bd0bf0086a52a9e572755b3a2">setItemDisabled</a> (int index, bool disabled)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Disables an item. <a href="#ac647478bd0bf0086a52a9e572755b3a2"></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_1WMenu.html#add9599868dd2d679c532e15ce42ef424">isItemDisabled</a> (<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *item) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the item widget of the given item is disabled. <a href="#add9599868dd2d679c532e15ce42ef424"></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_1WMenu.html#acec9860582f2f043fd3dbf42649dbce8">isItemDisabled</a> (int index) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the item widget of the given index is disabled. <a href="#acec9860582f2f043fd3dbf42649dbce8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a4e94081f83aee45db0ffd43073f2b8ca">currentItem</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the currently selected item. <a href="#a4e94081f83aee45db0ffd43073f2b8ca"></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_1WMenu.html#a467ab0da55b4584f1b46abe931354f3d">currentIndex</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the index of the currently selected item. <a href="#a467ab0da55b4584f1b46abe931354f3d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a8f241ce7b48d30c0c5f60abcd8e38a90">orientation</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the orientation. <a href="#a8f241ce7b48d30c0c5f60abcd8e38a90"></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_1WMenu.html#a8bc28b9d703b93569846441213877d4f">setRenderAsList</a> (bool enable)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Renders using an HTML list. <a href="#a8bc28b9d703b93569846441213877d4f"></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_1WMenu.html#a8cc3a34a38722aa07ad8e5e183ed6af3">renderAsList</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the menu is rendered as an HTML list. <a href="#a8cc3a34a38722aa07ad8e5e183ed6af3"></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_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc">setInternalPathEnabled</a> (const std::string &basePath="")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enables internal paths for items. <a href="#ae1807eba0b1002808dbec779d00a79dc"></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_1WMenu.html#aa8e47ce1b3e21eb64202e6ab1b5e48b5">internalPathEnabled</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the menu generates internal paths entries. <a href="#aa8e47ce1b3e21eb64202e6ab1b5e48b5"></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_1WMenu.html#aa5cf3b5b9919d2f130c8acd156447132">setInternalBasePath</a> (const std::string &basePath)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the internal base path. <a href="#aa5cf3b5b9919d2f130c8acd156447132"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const std::string & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a8cdf2f75f67efa0c10c6fb25fd1cd4da">internalBasePath</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the internal base path. <a href="#a8cdf2f75f67efa0c10c6fb25fd1cd4da"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a76785bc6b3ca3f99835bd8a75e6c69d7"></a><!-- doxytag: member="Wt::WMenu::contentsStack" ref="a76785bc6b3ca3f99835bd8a75e6c69d7" args="() const " -->
<a class="el" href="classWt_1_1WStackedWidget.html">WStackedWidget</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#a76785bc6b3ca3f99835bd8a75e6c69d7">contentsStack</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the contents stack associated with the menu. <br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WMenu.html#aea92a8e3abe2ac6130eb93acec605ec9">enableAjax</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Progresses to an Ajax-enabled widget. <a href="#aea92a8e3abe2ac6130eb93acec605ec9"></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_1WMenu.html#a1b4eb0bd90bb2b9a0661fd04ec35224a">internalPathChanged</a> (const std::string &path)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Handling of internal path changes. <a href="#a1b4eb0bd90bb2b9a0661fd04ec35224a"></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_1WMenu.html#ae7e3b026c0275dcb0ea62d4449e36468">nextAfterHide</a> (int index)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the index of the item to be selected after hides. <a href="#ae7e3b026c0275dcb0ea62d4449e36468"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A widget that shows a menu of options. </p>
<p>The WMenu widget offers menu navigation.</p>
<p>Typically, a menu is used in conjunction with a <a class="el" href="classWt_1_1WStackedWidget.html" title="A container widget that stacks its widgets on top of each other.">WStackedWidget</a> (but can be used without too), where different 'contents' are stacked upon each other. Each choice in the menu (which is implemented as a <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a>) corresponds to a tab in the contents stack. The contents stack may contain other items, and could be shared with other <a class="el" href="classWt_1_1WMenu.html" title="A widget that shows a menu of options.">WMenu</a> instances.</p>
<p>When used without a contents stack, you can react to menu item selection using the <a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20" title="Signal which indicates that a new item was selected.">itemSelected()</a> signal, to implement some custom handling of item selection.</p>
<p>Usage example: </p>
<div class="fragment"><pre class="fragment"> <span class="comment">// create the stack where the contents will be located</span>
<a class="code" href="classWt_1_1WStackedWidget.html" title="A container widget that stacks its widgets on top of each other.">Wt::WStackedWidget</a> *contents = <span class="keyword">new</span> <a class="code" href="classWt_1_1WStackedWidget.html" title="A container widget that stacks its widgets on top of each other.">Wt::WStackedWidget</a>(contentsParent);
<span class="comment">// create a menu</span>
<a class="code" href="classWt_1_1WMenu.html" title="A widget that shows a menu of options.">Wt::WMenu</a> *menu = <span class="keyword">new</span> <a class="code" href="classWt_1_1WMenu.html#a9a67c54e9bfe9b2f594a54dd18a9d8a4" title="Creates a new menu.">Wt::WMenu</a>(contents, <a class="code" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912af916b7ec24727db2d972f0770170c7f5" title="Vertical.">Wt::Vertical</a>, menuParent);
menu-><a class="code" href="classWt_1_1WMenu.html#a8bc28b9d703b93569846441213877d4f" title="Renders using an HTML list.">setRenderAsList</a>(<span class="keyword">true</span>);
<span class="comment">// add four items using the default lazy loading policy.</span>
menu-><a class="code" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem</a>(<span class="stringliteral">"Introduction"</span>, <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">"intro"</span>));
menu-><a class="code" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem</a>(<span class="stringliteral">"Download"</span>, <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">"Not yet available"</span>));
menu-><a class="code" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem</a>(<span class="stringliteral">"Demo"</span>, <span class="keyword">new</span> DemoWidget());
menu-><a class="code" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem</a>(<span class="keyword">new</span> <a class="code" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">Wt::WMenuItem</a>(<span class="stringliteral">"Demo2"</span>, <span class="keyword">new</span> DemoWidget()));
</pre></div><p>Historically, a menu was implemented as a table, but <a class="el" href="classWt_1_1WMenu.html#a8bc28b9d703b93569846441213877d4f">rendering as a list</a> (<code><ul></code>) is preferred, as it is the norm form implementations.</p>
<p>After contruction, the first entry will be selected. At any time, it is possible to select a particular item using <a class="el" href="classWt_1_1WMenu.html#a7bafc33564cb06d980d75e2f4d89f28d" title="Selects an item.">select()</a>.</p>
<p>Each item of WMenu may be closeable (see <a class="el" href="classWt_1_1WMenuItem.html#a59b6dee6c95ae958f0c3b76d5ef7272d" title="Make it possible to close this item interactively or by close().">WMenuItem::setCloseable(bool)</a>. Like selection, at any time, it is possible to close a particular item using <a class="el" href="classWt_1_1WMenu.html#a97c9be1df48cb0d27e2e4b904b51e184" title="Closes an item.">close()</a>. You can react to close of item by using the <a class="el" href="classWt_1_1WMenu.html#ab9fa68e381972fb5385478b1e9eb6c78" title="Signal which indicates that an item was closed.">itemClosed()</a> signal.</p>
<p>The WMenu implementation offers fine-grained control on how contents should be preloaded. By default, all contents is lazy-loaded, only when needed. To improve response time, an item may also be preloaded (using <a class="el" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem()</a>). In that case, the item will be loaded in the background, before its first use. In any case, once the contents corresponding to a menu item is loaded, subsequent navigation to it is handled entirely client-side.</p>
<p>The WMenu may participate in the application's internal path, which lets menu items correspond to internal URLs, see <a class="el" href="classWt_1_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc" title="Enables internal paths for items.">setInternalPathEnabled()</a>.</p>
<p>The layout of the menu may be Horizontal or Vertical. The look of the items may be defined through style sheets. The default <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a> implementation uses four style classes to distinguish between inactivated, activated, closeable inactivated and closeable activated menu items: <code>"item"</code>, <code>"itemselected"</code>, <code>"citem"</code>, <code>"citemselected"</code>. By using CSS nested selectors, a different style may be defined for items in a different menu.</p>
<p>You may customize the rendering and behaviour of menu entries by specializing <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a>.</p>
<h3>CSS</h3>
<p>Styling a menu will be different depending of the rendering mode (table, list). Conventionally, menus like this are styled as a list (<a class="el" href="classWt_1_1WMenu.html#a8bc28b9d703b93569846441213877d4f" title="Renders using an HTML list.">setRenderAsList()</a>).</p>
<p>You will want to differentiate between unselected and selected items based on the <code>"item"</code> and <code>"itemselected"</code> style classes as well as between unselected and selected closeable items based on the <code>"citem"</code> and <code>"citemselected"</code> style classes.</p>
<p>For menus without closeable items a styling is pretty simple. For example, assuming you set a <code>"menu"</code> style class for your menu, you can style the items using:</p>
<div class="fragment"><pre class="fragment">.menu * .item {
cursor: pointer; cursor: hand;
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a0cb88ce2189a8986f24a4409498e490e" title="Color blue.">blue</a>;
text-decoration: underline;
}
.menu * .itemselected {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a0cb88ce2189a8986f24a4409498e490e" title="Color blue.">blue</a>;
text-decoration: underline;
font-weight: bold;
}
</pre></div><p>For menus which supports closing and/or enabling disabling of items, the styling is more complex. The close icon is styled by the current CSS theme and can be overriden by using <code>"Wt-closeicon"</code> CSS class. The look of the menu, assuming the default implementation for <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a>, can be customized by using the following selectors (again assuming a menu with as styleclass <code>"menu"</code>):</p>
<div class="fragment"><pre class="fragment">
.Wt-closeicon : a close icon
.menu : the list (you custom menu class)
.menu li : a list item
.menu span : spans of a list item
# not closable items:
.menu a.item span : the inner span of the label of an enabled item
.menu span.item : the label of a disabled item
.menu a.itemselected span : the inner span the label of an enabled selected item
.menu span.itemselected : the label of a disabled selected item
# closable items:
.menu .citem a.label span : the inner span of the label of an enabled item
.menu .citem span.label : the label of a disabled item
.menu .citemselected a.label span : the inner span the label of an enabled selected item
.menu .citemselected span.label : the label of a disabled selected item
</pre></div><p>Example of styling a menu with closeable items:</p>
<div class="fragment"><pre class="fragment">.menu {
overflow: <span class="keyword">auto</span>;
}
.menu li {
display: <span class="keyword">inline</span>;
}
.menu span {
display: block; <span class="keywordtype">float</span>: left;
}
.menu a.item span {
cursor: pointer; cursor: hand;
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a0cb88ce2189a8986f24a4409498e490e" title="Color blue.">blue</a>;
<a class="code" href="classWt_1_1WCompositeWidget.html#a06555482bd1410ce970165c71a8e22e8" title="Returns a CSS margin set.">margin</a>-right: 5px;
}
.menu span.item {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a2ae20330b5a9eb890119be5074615858" title="Color medium gray.">gray</a>;
<a class="code" href="classWt_1_1WCompositeWidget.html#a06555482bd1410ce970165c71a8e22e8" title="Returns a CSS margin set.">margin</a>-right: 5px;
}
.menu a.itemselected span {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133acf5dee884803e93b444f8bd222956bd6" title="Color black.">black</a>;
font-weight: bold;
text-decoration: none;
<a class="code" href="classWt_1_1WCompositeWidget.html#a06555482bd1410ce970165c71a8e22e8" title="Returns a CSS margin set.">margin</a>-right: 5px;
}
.menu span.itemselected {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a2ae20330b5a9eb890119be5074615858" title="Color medium gray.">gray</a>;
font-weight: bold;
text-decoration: none;
<a class="code" href="classWt_1_1WCompositeWidget.html#a06555482bd1410ce970165c71a8e22e8" title="Returns a CSS margin set.">margin</a>-right: 5px;
}
.menu .citem a.label span {
cursor: pointer; cursor: hand;
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a0cb88ce2189a8986f24a4409498e490e" title="Color blue.">blue</a>;
}
.menu .citem span.label {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a2ae20330b5a9eb890119be5074615858" title="Color medium gray.">gray</a>;
}
.menu .citemselected a.label span {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133acf5dee884803e93b444f8bd222956bd6" title="Color black.">black</a>;
font-weight: bold;
text-decoration: none;
}
.menu .citemselected span.label {
color: <a class="code" href="group__style.html#gga9686ea88ce4db2c0a12ea84452f60133a2ae20330b5a9eb890119be5074615858" title="Color medium gray.">gray</a>;
font-weight: bold;
text-decoration: none;
}
</pre></div><dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a> </dd></dl>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a9a67c54e9bfe9b2f594a54dd18a9d8a4"></a><!-- doxytag: member="Wt::WMenu::WMenu" ref="a9a67c54e9bfe9b2f594a54dd18a9d8a4" args="(Orientation orientation, WContainerWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WMenu::WMenu </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> </td>
<td class="paramname"><em>orientation</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</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 menu. </p>
<p>Construct a menu with given <code>orientation</code>. The menu is not associated with a contents stack, and thus you will want to react to the <a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20" title="Signal which indicates that a new item was selected.">itemSelected()</a> signal to react to menu changes. </p>
</div>
</div>
<a class="anchor" id="aedc7dcfb468fedd82eb6e01ddcdd3f77"></a><!-- doxytag: member="Wt::WMenu::WMenu" ref="aedc7dcfb468fedd82eb6e01ddcdd3f77" args="(WStackedWidget *contentsStack, Orientation orientation, WContainerWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WMenu::WMenu </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WStackedWidget.html">WStackedWidget</a> * </td>
<td class="paramname"><em>contentsStack</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> </td>
<td class="paramname"><em>orientation</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</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 menu. </p>
<p>Construct a menu to manage the widgets in <code>contentsStack</code>, and sets the menu <code>orientation</code>.</p>
<p>Each menu item will manage a single widget in the <code>contentsStack</code>, making it the current widget when the menu item is activated. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ad7840197cc0caf0430792b9f4a0df60d"></a><!-- doxytag: member="Wt::WMenu::addItem" ref="ad7840197cc0caf0430792b9f4a0df60d" args="(const WString &name, WWidget *contents, WMenuItem::LoadPolicy policy=WMenuItem::LazyLoading)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * Wt::WMenu::addItem </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td>
<td class="paramname"><em>name</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>contents</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html#a5e276ed0505694a7b89a1dd0c62aa55a">WMenuItem::LoadPolicy</a> </td>
<td class="paramname"><em>policy</em> = <code>WMenuItem::LazyLoading</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds an item. </p>
<p>Adds a menu item with given <code>contents</code>, which is added to the menu's associated contents stack.</p>
<p><code>contents</code> may be <code>0</code> for two reasons:</p>
<ul>
<li>if the menu is not associated with a contents stack, then you cannot associate a menu item with a contents widget</li>
<li>or, you may have one or more items which which are not associated with a contents widget in the contents stack.</li>
</ul>
<p>Returns the corresponding <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#acbccfeebf2c93244516dec81dcc56fda" title="Adds an item.">addItem(WMenuItem *)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="acbccfeebf2c93244516dec81dcc56fda"></a><!-- doxytag: member="Wt::WMenu::addItem" ref="acbccfeebf2c93244516dec81dcc56fda" args="(WMenuItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * Wt::WMenu::addItem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds an item. </p>
<p>Adds a menu item. Use this form to add specialized <a class="el" href="classWt_1_1WMenuItem.html" title="A single item in a menu.">WMenuItem</a> implementations.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem(const WString&, WWidget *, WMenuItem::LoadPolicy)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a97c9be1df48cb0d27e2e4b904b51e184"></a><!-- doxytag: member="Wt::WMenu::close" ref="a97c9be1df48cb0d27e2e4b904b51e184" args="(WMenuItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::close </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Closes an item. </p>
<p>Close the menu item <code>item</code>. Only <a class="el" href="classWt_1_1WMenuItem.html#a59b6dee6c95ae958f0c3b76d5ef7272d">closeable</a> items can be closed.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a1040233afcd0372468faff230c685825" title="Closes an item.">close(int)</a>, <a class="el" href="classWt_1_1WMenuItem.html#a9da31eaf6a40078207bbf484d21b9285" title="Closes this item.">WMenuItem::close()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a1040233afcd0372468faff230c685825"></a><!-- doxytag: member="Wt::WMenu::close" ref="a1040233afcd0372468faff230c685825" args="(int index)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::close </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Closes an item. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a97c9be1df48cb0d27e2e4b904b51e184" title="Closes an item.">close(WMenuItem *)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a467ab0da55b4584f1b46abe931354f3d"></a><!-- doxytag: member="Wt::WMenu::currentIndex" ref="a467ab0da55b4584f1b46abe931354f3d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Wt::WMenu::currentIndex </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the index of the currently selected item. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a4e94081f83aee45db0ffd43073f2b8ca" title="Returns the currently selected item.">currentItem()</a>, <a class="el" href="classWt_1_1WMenu.html#aec1801d047dc0f150d1cc12b801aa6c2" title="Selects an item.">select(int)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a4e94081f83aee45db0ffd43073f2b8ca"></a><!-- doxytag: member="Wt::WMenu::currentItem" ref="a4e94081f83aee45db0ffd43073f2b8ca" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * Wt::WMenu::currentItem </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the currently selected item. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a467ab0da55b4584f1b46abe931354f3d" title="Returns the index of the currently selected item.">currentIndex()</a>, <a class="el" href="classWt_1_1WMenu.html#a7bafc33564cb06d980d75e2f4d89f28d" title="Selects an item.">select(WMenuItem *)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aea92a8e3abe2ac6130eb93acec605ec9"></a><!-- doxytag: member="Wt::WMenu::enableAjax" ref="aea92a8e3abe2ac6130eb93acec605ec9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::enableAjax </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Progresses to an Ajax-enabled widget. </p>
<p>This method is called when the progressive bootstrap method is used, and support for AJAX has been detected. The default behavior will upgrade the widget's event handling to use AJAX instead of full page reloads, and propagate the call to its children.</p>
<p>You may want to reimplement this method if you want to make changes to widget when AJAX is enabled. You should always call the base implementation.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a78016406c4746c56b2c2ffce7c5e181f" title="Progresses to an Ajax-enabled user interface.">WApplication::enableAjax()</a> </dd></dl>
<p>Reimplemented from <a class="el" href="classWt_1_1WCompositeWidget.html#a90e07c1bb6c48732ed4b5d98f91cfda0">Wt::WCompositeWidget</a>.</p>
</div>
</div>
<a class="anchor" id="a8cdf2f75f67efa0c10c6fb25fd1cd4da"></a><!-- doxytag: member="Wt::WMenu::internalBasePath" ref="a8cdf2f75f67efa0c10c6fb25fd1cd4da" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const std::string& Wt::WMenu::internalBasePath </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the internal base path. </p>
<p>The default value is the application's internalPath (<a class="el" href="classWt_1_1WApplication.html#aab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">WApplication::internalPath()</a>) that was recorded when <a class="el" href="classWt_1_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc" title="Enables internal paths for items.">setInternalPathEnabled()</a> was called, and together with each <a class="el" href="classWt_1_1WMenuItem.html#a5ab0b5430b9fb852a45886deb0ff01b1" title="Returns the path component for this item.">WMenuItem::pathComponent()</a> determines the paths for each item.</p>
<p>For example, if <a class="el" href="classWt_1_1WMenu.html#a8cdf2f75f67efa0c10c6fb25fd1cd4da" title="Returns the internal base path.">internalBasePath()</a> is <code>"/examples/"</code> and pathComponent() for a particular item is <code>"charts/"</code>, then the internal path for that item will be <code>"/examples/charts/"</code>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc" title="Enables internal paths for items.">setInternalPathEnabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a1b4eb0bd90bb2b9a0661fd04ec35224a"></a><!-- doxytag: member="Wt::WMenu::internalPathChanged" ref="a1b4eb0bd90bb2b9a0661fd04ec35224a" args="(const std::string &path)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::internalPathChanged </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"><em>path</em></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Handling of internal path changes. </p>
<p>This methods makes the menu react to internal path changes (and also the initial internal path).</p>
<p>You may want to reimplement this if you want to customize the internal path handling. </p>
</div>
</div>
<a class="anchor" id="aa8e47ce1b3e21eb64202e6ab1b5e48b5"></a><!-- doxytag: member="Wt::WMenu::internalPathEnabled" ref="aa8e47ce1b3e21eb64202e6ab1b5e48b5" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::internalPathEnabled </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the menu generates internal paths entries. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc" title="Enables internal paths for items.">setInternalPathEnabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="add9599868dd2d679c532e15ce42ef424"></a><!-- doxytag: member="Wt::WMenu::isItemDisabled" ref="add9599868dd2d679c532e15ce42ef424" args="(WMenuItem *item) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::isItemDisabled </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the item widget of the given item is disabled. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a294d53469b71cb5d35fa59865c3b75cb" title="Disables an item.">setItemDisabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="acec9860582f2f043fd3dbf42649dbce8"></a><!-- doxytag: member="Wt::WMenu::isItemDisabled" ref="acec9860582f2f043fd3dbf42649dbce8" args="(int index) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::isItemDisabled </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 item widget of the given index is disabled. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a294d53469b71cb5d35fa59865c3b75cb" title="Disables an item.">setItemDisabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a39e27cd34e0031206e4d0baecf4c9d0a"></a><!-- doxytag: member="Wt::WMenu::isItemHidden" ref="a39e27cd34e0031206e4d0baecf4c9d0a" args="(WMenuItem *item) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::isItemHidden </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the item widget of the given item is hidden. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ab3d880e2b089bb084d5634130d61f4d7" title="Hides an item.">setItemHidden()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a207ebaad9bb29b1c936b28068e28a96a"></a><!-- doxytag: member="Wt::WMenu::isItemHidden" ref="a207ebaad9bb29b1c936b28068e28a96a" args="(int index) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::isItemHidden </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 item widget of the given index is hidden. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ab3d880e2b089bb084d5634130d61f4d7" title="Hides an item.">setItemHidden()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ab9fa68e381972fb5385478b1e9eb6c78"></a><!-- doxytag: member="Wt::WMenu::itemClosed" ref="ab9fa68e381972fb5385478b1e9eb6c78" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1Signal.html">Signal</a><<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *>& Wt::WMenu::itemClosed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal which indicates that an item was closed. </p>
<p>This signal is emitted when an item was closed. It is emitted both when the user closes an item, or when <a class="el" href="classWt_1_1WMenu.html#a97c9be1df48cb0d27e2e4b904b51e184" title="Closes an item.">close()</a> was invoked. </p>
</div>
</div>
<a class="anchor" id="abb90d70d722ce95e748b3ed0b88168b5"></a><!-- doxytag: member="Wt::WMenu::items" ref="abb90d70d722ce95e748b3ed0b88168b5" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const std::vector<<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *>& Wt::WMenu::items </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the items. </p>
<p>Returns the list of menu items in this menu. </p>
</div>
</div>
<a class="anchor" id="a0303879705bcdd8dbffc2d1528670d20"></a><!-- doxytag: member="Wt::WMenu::itemSelected" ref="a0303879705bcdd8dbffc2d1528670d20" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1Signal.html">Signal</a><<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *>& Wt::WMenu::itemSelected </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal which indicates that a new item was selected. </p>
<p>This signal is emitted when an item was selected. It is emitted both when the user activated an item, or when <a class="el" href="classWt_1_1WMenu.html#a7bafc33564cb06d980d75e2f4d89f28d" title="Selects an item.">select()</a> was invoked.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a8737f262f99d0db0a0f4b7aeb01cfe2e" title="Signal which indicates that a new selected item is rendered.">itemSelectRendered()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8737f262f99d0db0a0f4b7aeb01cfe2e"></a><!-- doxytag: member="Wt::WMenu::itemSelectRendered" ref="a8737f262f99d0db0a0f4b7aeb01cfe2e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1Signal.html">Signal</a><<a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> *>& Wt::WMenu::itemSelectRendered </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Signal which indicates that a new selected item is rendered. </p>
<p>This signal is similar to <a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20">itemSelected</a>, but is emitted from within a stateless slot. Therefore, any slot connected to this signal will be optimized to client-side JavaScript, and must support the contract of a stateless slot (i.e., be idempotent).</p>
<p>If you are unsure what is the difference with the <a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20">itemSelected</a> signal, you'll probably need the latter instead.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a0303879705bcdd8dbffc2d1528670d20" title="Signal which indicates that a new item was selected.">itemSelected()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ae7e3b026c0275dcb0ea62d4449e36468"></a><!-- doxytag: member="Wt::WMenu::nextAfterHide" ref="ae7e3b026c0275dcb0ea62d4449e36468" args="(int index)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Wt::WMenu::nextAfterHide </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the index of the item to be selected after hides. </p>
<p>Returns the index of the item to be selected after the item with given index will be hidden.</p>
<p>By default, if the given index is an index of currently selected item, returns an index of the first visible item to the right of it. If it is not found, returns the index of the first visible item to the left of it. If there are no visible items around the currently selected item, returns the index of currently selected item.</p>
<p>You may want to reimplement this if you want to customize the algorithm of determining the index of the item to be selected after hiding the item with given index. </p>
</div>
</div>
<a class="anchor" id="a8f241ce7b48d30c0c5f60abcd8e38a90"></a><!-- doxytag: member="Wt::WMenu::orientation" ref="a8f241ce7b48d30c0c5f60abcd8e38a90" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceWt.html#a2a8d45559e16a0185bf61bfad0a67912">Orientation</a> Wt::WMenu::orientation </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the orientation. </p>
<p>The orientation is set at time of construction. </p>
</div>
</div>
<a class="anchor" id="a63819cb0a445ab7ad364f5b0e241b67d"></a><!-- doxytag: member="Wt::WMenu::removeItem" ref="a63819cb0a445ab7ad364f5b0e241b67d" args="(WMenuItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::removeItem </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes an item. </p>
<p>Removes the given item. The item and its contents is not deleted.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ad7840197cc0caf0430792b9f4a0df60d" title="Adds an item.">addItem()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8cc3a34a38722aa07ad8e5e183ed6af3"></a><!-- doxytag: member="Wt::WMenu::renderAsList" ref="a8cc3a34a38722aa07ad8e5e183ed6af3" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WMenu::renderAsList </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the menu is rendered as an HTML list. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a8bc28b9d703b93569846441213877d4f" title="Renders using an HTML list.">setRenderAsList(bool)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a7bafc33564cb06d980d75e2f4d89f28d"></a><!-- doxytag: member="Wt::WMenu::select" ref="a7bafc33564cb06d980d75e2f4d89f28d" args="(WMenuItem *item)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::select </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Selects an item. </p>
<p>Select the menu item <code>item</code>.</p>
<p>When <code>item</code> is <code>0</code>, the current selection is removed.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#aec1801d047dc0f150d1cc12b801aa6c2" title="Selects an item.">select(int)</a>, <a class="el" href="classWt_1_1WMenu.html#a4e94081f83aee45db0ffd43073f2b8ca" title="Returns the currently selected item.">currentItem()</a>, <a class="el" href="classWt_1_1WMenuItem.html#a9acd8465249e221093f87d9a726c33af" title="Selects this item.">WMenuItem::select()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aec1801d047dc0f150d1cc12b801aa6c2"></a><!-- doxytag: member="Wt::WMenu::select" ref="aec1801d047dc0f150d1cc12b801aa6c2" args="(int index)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::select </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>index</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Selects an item. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<p>Using a value of -1 removes the current selection.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a7bafc33564cb06d980d75e2f4d89f28d" title="Selects an item.">select(WMenuItem *)</a>, <a class="el" href="classWt_1_1WMenu.html#a467ab0da55b4584f1b46abe931354f3d" title="Returns the index of the currently selected item.">currentIndex()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aa5cf3b5b9919d2f130c8acd156447132"></a><!-- doxytag: member="Wt::WMenu::setInternalBasePath" ref="aa5cf3b5b9919d2f130c8acd156447132" args="(const std::string &basePath)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setInternalBasePath </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"><em>basePath</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the internal base path. </p>
<p>A '/' is appended to turn it into a folder, if needed.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ae1807eba0b1002808dbec779d00a79dc" title="Enables internal paths for items.">setInternalPathEnabled()</a>, <a class="el" href="classWt_1_1WMenu.html#a8cdf2f75f67efa0c10c6fb25fd1cd4da" title="Returns the internal base path.">internalBasePath()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ae1807eba0b1002808dbec779d00a79dc"></a><!-- doxytag: member="Wt::WMenu::setInternalPathEnabled" ref="ae1807eba0b1002808dbec779d00a79dc" args="(const std::string &basePath="")" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setInternalPathEnabled </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"><em>basePath</em> = <code>""</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Enables internal paths for items. </p>
<p>The menu participates in the internal path by changing the internal path when an item has been selected, and listening for path changes to react to path selections. As a consequence this allows the user to bookmark the current menu selection and revisit it later, use back/forward buttons to navigate through history of visited menu items, and allows indexing of pages.</p>
<p>For each menu item, <a class="el" href="classWt_1_1WMenuItem.html#a5ab0b5430b9fb852a45886deb0ff01b1" title="Returns the path component for this item.">WMenuItem::pathComponent()</a> is appended to the <code>basePath</code>, which defaults to the internal path (<a class="el" href="classWt_1_1WApplication.html#aab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">WApplication::internalPath()</a>). A '/' is appended to the base path, to turn it into a folder, if needed.</p>
<p>By default, menu interaction does not change the application internal path.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenuItem.html#a4291756303dbf128b718679cdb907a5a" title="Sets the path component for this item.">WMenuItem::setPathComponent()</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a294d53469b71cb5d35fa59865c3b75cb"></a><!-- doxytag: member="Wt::WMenu::setItemDisabled" ref="a294d53469b71cb5d35fa59865c3b75cb" args="(WMenuItem *item, bool disabled)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setItemDisabled </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>disabled</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Disables an item. </p>
<p>Disables the menu item <code>item</code>. Only an item that is enabled can be selected. By default, all menu items are enabled.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ac647478bd0bf0086a52a9e572755b3a2" title="Disables an item.">setItemDisabled(int, bool)</a>, <a class="el" href="classWt_1_1WMenuItem.html#a68e76f69ea40e66b9f478a84a06e44a8" title="Enables or disables an item.">WMenuItem::setDisabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ac647478bd0bf0086a52a9e572755b3a2"></a><!-- doxytag: member="Wt::WMenu::setItemDisabled" ref="ac647478bd0bf0086a52a9e572755b3a2" args="(int index, bool disabled)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setItemDisabled </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>disabled</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Disables an item. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a294d53469b71cb5d35fa59865c3b75cb" title="Disables an item.">setItemDisabled(WMenuItem *, bool)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ab3d880e2b089bb084d5634130d61f4d7"></a><!-- doxytag: member="Wt::WMenu::setItemHidden" ref="ab3d880e2b089bb084d5634130d61f4d7" args="(WMenuItem *item, bool hidden)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setItemHidden </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WMenuItem.html">WMenuItem</a> * </td>
<td class="paramname"><em>item</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>hidden</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Hides an item. </p>
<p>Hides the menu item <code>item</code>. By default, all menu items are visible.</p>
<p>If the item was currently selected, then the next item to be selected is determined by <a class="el" href="classWt_1_1WMenu.html#ae7e3b026c0275dcb0ea62d4449e36468" title="Returns the index of the item to be selected after hides.">nextAfterHide()</a>.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#a20e921974ecea341bdcfd5df9596ed53" title="Hides an item.">setItemHidden(int, bool)</a>, <a class="el" href="classWt_1_1WMenuItem.html#a0adfa71810c98c38de6e320fc055fef0" title="Hides the item widget.">WMenuItem::hide()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a20e921974ecea341bdcfd5df9596ed53"></a><!-- doxytag: member="Wt::WMenu::setItemHidden" ref="a20e921974ecea341bdcfd5df9596ed53" args="(int index, bool hidden)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setItemHidden </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>hidden</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Hides an item. </p>
<p>Menu items in a menu with <code>N</code> items are numbered from 0 to <code>N</code> - 1.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WMenu.html#ab3d880e2b089bb084d5634130d61f4d7" title="Hides an item.">setItemHidden(WMenuItem *, bool)</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8bc28b9d703b93569846441213877d4f"></a><!-- doxytag: member="Wt::WMenu::setRenderAsList" ref="a8bc28b9d703b93569846441213877d4f" args="(bool enable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WMenu::setRenderAsList </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enable</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Renders using an HTML list. </p>
<p>By default, the the menu is rendered using an HTML <code><table></code> element for layout. Setting this option enables rendering using <code><ul></code> and <code><il></code> elements, as is commonly done for CSS-based designs.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>You cannot use this method after items have been added to the menu. </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>
