<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- q3action.cpp -->
<title>Qt 4.8: Q3ActionGroup Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li>Qt3SupportLight</li>
<li>Q3ActionGroup</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">Q3ActionGroup Class Reference</h1>
<!-- $$$Q3ActionGroup-brief -->
<p>The Q3ActionGroup class groups actions together. <a href="#details">More...</a></p>
<!-- @@@Q3ActionGroup -->
<pre class="cpp"> <span class="preprocessor">#include <Q3ActionGroup></span></pre><p><b>This class is part of the Qt 3 support library.</b> It is provided to keep old source code working. We strongly advise against using it in new code. See <a href="porting4.html#qactiongroup">Porting to Qt 4</a> for more information.</p>
<p><b>Inherits: </b><a href="q3action.html">Q3Action</a>.</p>
<ul>
<li><a href="q3actiongroup-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="q3actiongroup.html#exclusive-prop">exclusive</a></b> : bool</li>
<li class="fn"><b><a href="q3actiongroup.html#usesDropDown-prop">usesDropDown</a></b> : bool</li>
</ul>
<ul>
<li class="fn">11 properties inherited from <a href="q3action.html#properties">Q3Action</a></li>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#Q3ActionGroup">Q3ActionGroup</a></b> ( QObject * <i>parent</i>, const char * <i>name</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#Q3ActionGroup-2">Q3ActionGroup</a></b> ( QObject * <i>parent</i>, const char * <i>name</i>, bool <i>exclusive</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#dtor.Q3ActionGroup">~Q3ActionGroup</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#add">add</a></b> ( Q3Action * <i>action</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addSeparator">addSeparator</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#insert">insert</a></b> ( Q3Action * <i>action</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#exclusive-prop">isExclusive</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#exclusive-prop">setExclusive</a></b> ( bool )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#usesDropDown-prop">setUsesDropDown</a></b> ( bool <i>enable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#usesDropDown-prop">usesDropDown</a></b> () const</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addTo">addTo</a></b> ( QWidget * <i>w</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#removeFrom">removeFrom</a></b> ( QWidget * <i>w</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setEnabled">setEnabled</a></b> ( bool <i>enable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setIconSet">setIconSet</a></b> ( const QIcon & <i>icon</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setMenuText">setMenuText</a></b> ( const QString & <i>text</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setOn">setOn</a></b> ( bool <i>on</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setText">setText</a></b> ( const QString & <i>txt</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setToggleAction">setToggleAction</a></b> ( bool <i>toggle</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setToolTip">setToolTip</a></b> ( const QString & <i>text</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setVisible">setVisible</a></b> ( bool <i>visible</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#setWhatsThis">setWhatsThis</a></b> ( const QString & <i>text</i> )</td></tr>
</table>
<ul>
<li class="fn">21 public functions inherited from <a href="q3action.html#public-functions">Q3Action</a></li>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#activated">activated</a></b> ( Q3Action * <i>action</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#selected">selected</a></b> ( Q3Action * <i>action</i> )</td></tr>
</table>
<ul>
<li class="fn">2 signals inherited from <a href="q3action.html#signals">Q3Action</a></li>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="protected-functions"></a>
<h2>Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addedTo">addedTo</a></b> ( QWidget * <i>actionWidget</i>, QWidget * <i>container</i>, Q3Action * <i>a</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addedTo-2">addedTo</a></b> ( int <i>index</i>, Q3PopupMenu * <i>menu</i>, Q3Action * <i>a</i> )</td></tr>
</table>
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addedTo-3">addedTo</a></b> ( QWidget * <i>actionWidget</i>, QWidget * <i>container</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#addedTo-4">addedTo</a></b> ( int <i>index</i>, Q3PopupMenu * <i>menu</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3actiongroup.html#childEvent">childEvent</a></b> ( QChildEvent * <i>e</i> )</td></tr>
</table>
<ul>
<li class="fn">2 protected functions inherited from <a href="q3action.html#protected-functions">Q3Action</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">6 public slots inherited from <a href="q3action.html#public-slots">Q3Action</a></li>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$Q3ActionGroup-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The Q3ActionGroup class groups actions together.</p>
<p>In some situations it is useful to group actions together. For example, if you have a left justify action, a right justify action and a center action, only one of these actions should be active at any one time, and one simple way of achieving this is to group the actions together in an action group.</p>
<p>An action group can also be added to a menu or a toolbar as a single unit, with all the actions within the action group appearing as separate menu options and toolbar buttons.</p>
<p>The actions in an action group emit their <a href="q3actiongroup.html#activated">activated</a>() (and for toggle actions, <a href="q3action.html#toggled">toggled</a>()) signals as usual.</p>
<p>The <a href="q3actiongroup.html#exclusive-prop">setExclusive</a>() function is used to ensure that only one action is active at any one time: it should be used with actions which have their <tt>toggleAction</tt> set to true.</p>
<p>Action group actions appear as individual menu options and toolbar buttons. For exclusive action groups use <a href="q3actiongroup.html#usesDropDown-prop">setUsesDropDown</a>() to display the actions in a subwidget of any widget the action group is added to. For example, the actions would appear in a combobox in a toolbar or as a submenu in a menu.</p>
<p>Actions can be added to an action group using <a href="q3actiongroup.html#add">add</a>(), but normally they are added by creating the action with the action group as parent. Actions can have separators dividing them using <a href="q3actiongroup.html#addSeparator">addSeparator</a>(). Action groups are added to widgets with <a href="q3actiongroup.html#addTo">addTo</a>().</p>
</div>
<!-- @@@Q3ActionGroup -->
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$exclusive-prop$$$isExclusive$$$setExclusivebool -->
<h3 class="fn"><a name="exclusive-prop"></a><span class="name">exclusive</span> : <span class="type">bool</span></h3>
<p>This property holds whether the action group does exclusive toggling.</p>
<p>If exclusive is true only one toggle action in the action group can ever be active at any one time. If the user chooses another toggle action in the group the one they chose becomes active and the one that was active becomes inactive.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isExclusive</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setExclusive</b></span> ( bool )</td></tr>
</table>
<p><b>See also </b><a href="q3action.html#toggleAction-prop">Q3Action::toggleAction</a>.</p>
<!-- @@@exclusive -->
<!-- $$$usesDropDown-prop$$$usesDropDown$$$setUsesDropDownbool -->
<h3 class="fn"><a name="usesDropDown-prop"></a><span class="name">usesDropDown</span> : <span class="type">bool</span></h3>
<p>This property holds whether the group's actions are displayed in a subwidget of the widgets the action group is added to.</p>
<p>Exclusive action groups added to a toolbar display their actions in a combobox with the action's <a href="q3action.html#text-prop">Q3Action::text</a> and <a href="q3action.html#iconSet-prop">Q3Action::iconSet</a> properties shown. Non-exclusive groups are represented by a tool button showing their <a href="q3action.html#iconSet-prop">Q3Action::iconSet</a> and <a href="q3action.html#text-prop">text</a>() property.</p>
<p>In a popup menu the member actions are displayed in a submenu.</p>
<p>Changing usesDropDown only affects <i>subsequent</i> calls to <a href="q3actiongroup.html#addTo">addTo</a>().</p>
<p>This property's default is false.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>usesDropDown</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setUsesDropDown</b></span> ( bool <i>enable</i> )</td></tr>
</table>
<!-- @@@usesDropDown -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$Q3ActionGroup[overload1]$$$Q3ActionGroupQObject*constchar* -->
<h3 class="fn"><a name="Q3ActionGroup"></a>Q3ActionGroup::<span class="name">Q3ActionGroup</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i>, const <span class="type">char</span> * <i>name</i> = 0 )</h3>
<p>Constructs an action group called <i>name</i>, with parent <i>parent</i>.</p>
<p>The action group is exclusive by default. Call setExclusive(false) to make the action group non-exclusive.</p>
<!-- @@@Q3ActionGroup -->
<!-- $$$Q3ActionGroup$$$Q3ActionGroupQObject*constchar*bool -->
<h3 class="fn"><a name="Q3ActionGroup-2"></a>Q3ActionGroup::<span class="name">Q3ActionGroup</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i>, const <span class="type">char</span> * <i>name</i>, <span class="type">bool</span> <i>exclusive</i> )</h3>
<p>Constructs an action group called <i>name</i>, with parent <i>parent</i>.</p>
<p>If <i>exclusive</i> is true only one toggle action in the group will ever be active.</p>
<p><b>See also </b><a href="q3actiongroup.html#exclusive-prop">exclusive</a>.</p>
<!-- @@@Q3ActionGroup -->
<!-- $$$~Q3ActionGroup[overload1]$$$~Q3ActionGroup -->
<h3 class="fn"><a name="dtor.Q3ActionGroup"></a>Q3ActionGroup::<span class="name">~Q3ActionGroup</span> ()</h3>
<p>Destroys the object and frees allocated resources.</p>
<!-- @@@~Q3ActionGroup -->
<!-- $$$activated[overload1]$$$activatedQ3Action* -->
<h3 class="fn"><a name="activated"></a><span class="type">void</span> Q3ActionGroup::<span class="name">activated</span> ( <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>action</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted from groups when one of its actions gets activated.</p>
<p>The argument is the <i>action</i> which was activated.</p>
<p><b>See also </b><a href="q3actiongroup.html#exclusive-prop">setExclusive</a>(), <a href="q3action.html#on-prop">isOn</a>(), and <a href="q3action.html#toggled">Q3Action::toggled</a>().</p>
<!-- @@@activated -->
<!-- $$$add[overload1]$$$addQ3Action* -->
<h3 class="fn"><a name="add"></a><span class="type">void</span> Q3ActionGroup::<span class="name">add</span> ( <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>action</i> )</h3>
<p>Adds action <i>action</i> to this group.</p>
<p>Normally an action is added to a group by creating it with the group as parent, so this function is not usually used.</p>
<p><b>See also </b><a href="q3actiongroup.html#addTo">addTo</a>().</p>
<!-- @@@add -->
<!-- $$$addSeparator[overload1]$$$addSeparator -->
<h3 class="fn"><a name="addSeparator"></a><span class="type">void</span> Q3ActionGroup::<span class="name">addSeparator</span> ()</h3>
<p>Adds a separator to the group.</p>
<!-- @@@addSeparator -->
<!-- $$$addTo[overload1]$$$addToQWidget* -->
<h3 class="fn"><a name="addTo"></a><span class="type">bool</span> Q3ActionGroup::<span class="name">addTo</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>w</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#addTo">Q3Action::addTo</a>().</p>
<p>Adds this action group to the widget <i>w</i>.</p>
<p>If <a href="q3actiongroup.html#exclusive-prop">isExclusive</a>() is false or <a href="q3actiongroup.html#usesDropDown-prop">usesDropDown</a>() is false, the actions within the group are added to the widget individually. For example, if the widget is a menu, the actions will appear as individual menu options, and if the widget is a toolbar, the actions will appear as toolbar buttons.</p>
<p>If both <a href="q3actiongroup.html#exclusive-prop">isExclusive</a>() and <a href="q3actiongroup.html#usesDropDown-prop">usesDropDown</a>() are true, the actions are presented either in a combobox (if <i>w</i> is a toolbar) or in a submenu (if <i>w</i> is a menu).</p>
<p>All actions should be added to the action group <i>before</i> the action group is added to the widget. If actions are added to the action group <i>after</i> the action group has been added to the widget these later actions will <i>not</i> appear.</p>
<p><b>See also </b><a href="q3actiongroup.html#exclusive-prop">setExclusive</a>(), <a href="q3actiongroup.html#usesDropDown-prop">setUsesDropDown</a>(), and <a href="q3actiongroup.html#removeFrom">removeFrom</a>().</p>
<!-- @@@addTo -->
<!-- $$$addedTo[overload1]$$$addedToQWidget*QWidget*Q3Action* -->
<h3 class="fn"><a name="addedTo"></a><span class="type">void</span> Q3ActionGroup::<span class="name">addedTo</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>actionWidget</i>, <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>container</i>, <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>a</i> )<tt> [virtual protected]</tt></h3>
<p>This function is called from the <a href="q3actiongroup.html#addTo">addTo</a>() function when it has created a widget (<i>actionWidget</i>) for the child action <i>a</i> in the <i>container</i>.</p>
<!-- @@@addedTo -->
<!-- $$$addedTo$$$addedTointQ3PopupMenu*Q3Action* -->
<h3 class="fn"><a name="addedTo-2"></a><span class="type">void</span> Q3ActionGroup::<span class="name">addedTo</span> ( <span class="type">int</span> <i>index</i>, <span class="type"><a href="q3popupmenu.html">Q3PopupMenu</a></span> * <i>menu</i>, <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>a</i> )<tt> [virtual protected]</tt></h3>
<p>This is an overloaded function.</p>
<p>This function is called from the <a href="q3actiongroup.html#addTo">addTo</a>() function when it has created a menu item for the child action at the index position <i>index</i> in the popup menu <i>menu</i>.</p>
<!-- @@@addedTo -->
<!-- $$$addedTo$$$addedToQWidget*QWidget* -->
<h3 class="fn"><a name="addedTo-3"></a><span class="type">void</span> Q3ActionGroup::<span class="name">addedTo</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>actionWidget</i>, <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>container</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="q3action.html#addedTo">Q3Action::addedTo</a>().</p>
<p>This is an overloaded function.</p>
<p>This function is called from the <a href="q3actiongroup.html#addTo">addTo</a>() function when it has created a widget (<i>actionWidget</i>) in the <i>container</i>.</p>
<!-- @@@addedTo -->
<!-- $$$addedTo$$$addedTointQ3PopupMenu* -->
<h3 class="fn"><a name="addedTo-4"></a><span class="type">void</span> Q3ActionGroup::<span class="name">addedTo</span> ( <span class="type">int</span> <i>index</i>, <span class="type"><a href="q3popupmenu.html">Q3PopupMenu</a></span> * <i>menu</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="q3action.html#addedTo-2">Q3Action::addedTo</a>().</p>
<p>This is an overloaded function.</p>
<p>This function is called from the <a href="q3actiongroup.html#addTo">addTo</a>() function when it has created a menu item at the index position <i>index</i> in the popup menu <i>menu</i>.</p>
<!-- @@@addedTo -->
<!-- $$$childEvent[overload1]$$$childEventQChildEvent* -->
<h3 class="fn"><a name="childEvent"></a><span class="type">void</span> Q3ActionGroup::<span class="name">childEvent</span> ( <span class="type"><a href="qchildevent.html">QChildEvent</a></span> * <i>e</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#childEvent">QObject::childEvent</a>().</p>
<!-- @@@childEvent -->
<!-- $$$insert[overload1]$$$insertQ3Action* -->
<h3 class="fn"><a name="insert"></a><span class="type">void</span> Q3ActionGroup::<span class="name">insert</span> ( <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>action</i> )</h3>
<p>Use add(<i>action</i>) instead.</p>
<!-- @@@insert -->
<!-- $$$removeFrom[overload1]$$$removeFromQWidget* -->
<h3 class="fn"><a name="removeFrom"></a><span class="type">bool</span> Q3ActionGroup::<span class="name">removeFrom</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>w</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#removeFrom">Q3Action::removeFrom</a>().</p>
<!-- @@@removeFrom -->
<!-- $$$selected[overload1]$$$selectedQ3Action* -->
<h3 class="fn"><a name="selected"></a><span class="type">void</span> Q3ActionGroup::<span class="name">selected</span> ( <span class="type"><a href="q3action.html">Q3Action</a></span> * <i>action</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted from exclusive groups when toggle actions change state.</p>
<p>The argument is the <i>action</i> whose state changed to "on".</p>
<p><b>See also </b><a href="q3actiongroup.html#exclusive-prop">setExclusive</a>(), <a href="q3action.html#on-prop">isOn</a>(), and <a href="q3action.html#toggled">Q3Action::toggled</a>().</p>
<!-- @@@selected -->
<!-- $$$setEnabled[overload1]$$$setEnabledbool -->
<h3 class="fn"><a name="setEnabled"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setEnabled</span> ( <span class="type">bool</span> <i>enable</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#enabled-prop">Q3Action::setEnabled</a>().</p>
<!-- @@@setEnabled -->
<!-- $$$setIconSet[overload1]$$$setIconSetconstQIcon& -->
<h3 class="fn"><a name="setIconSet"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setIconSet</span> ( const <span class="type"><a href="qicon.html">QIcon</a></span> & <i>icon</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#iconSet-prop">Q3Action::setIconSet</a>().</p>
<!-- @@@setIconSet -->
<!-- $$$setMenuText[overload1]$$$setMenuTextconstQString& -->
<h3 class="fn"><a name="setMenuText"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setMenuText</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>text</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#menuText-prop">Q3Action::setMenuText</a>().</p>
<!-- @@@setMenuText -->
<!-- $$$setOn[overload1]$$$setOnbool -->
<h3 class="fn"><a name="setOn"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setOn</span> ( <span class="type">bool</span> <i>on</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#on-prop">Q3Action::setOn</a>().</p>
<!-- @@@setOn -->
<!-- $$$setText[overload1]$$$setTextconstQString& -->
<h3 class="fn"><a name="setText"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setText</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>txt</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#text-prop">Q3Action::setText</a>().</p>
<!-- @@@setText -->
<!-- $$$setToggleAction[overload1]$$$setToggleActionbool -->
<h3 class="fn"><a name="setToggleAction"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setToggleAction</span> ( <span class="type">bool</span> <i>toggle</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#toggleAction-prop">Q3Action::setToggleAction</a>().</p>
<!-- @@@setToggleAction -->
<!-- $$$setToolTip[overload1]$$$setToolTipconstQString& -->
<h3 class="fn"><a name="setToolTip"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setToolTip</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>text</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#toolTip-prop">Q3Action::setToolTip</a>().</p>
<!-- @@@setToolTip -->
<!-- $$$setVisible[overload1]$$$setVisiblebool -->
<h3 class="fn"><a name="setVisible"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setVisible</span> ( <span class="type">bool</span> <i>visible</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#visible-prop">Q3Action::setVisible</a>().</p>
<!-- @@@setVisible -->
<!-- $$$setWhatsThis[overload1]$$$setWhatsThisconstQString& -->
<h3 class="fn"><a name="setWhatsThis"></a><span class="type">void</span> Q3ActionGroup::<span class="name">setWhatsThis</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>text</i> )<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3action.html#whatsThis-prop">Q3Action::setWhatsThis</a>().</p>
<!-- @@@setWhatsThis -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
