<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- q3toolbar.cpp -->
<head>
<title>Qt 4.6: Q3ToolBar Class Reference</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<a name="//apple_ref/cpp/cl//Q3ToolBar"></a>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td></tr></table><h1 class="title">Q3ToolBar Class Reference<br /><span class="small-subtitle">[<a href="qt3support.html">Qt3Support</a> module]</span>
</h1>
<p>The Q3ToolBar class provides a movable panel containing widgets such as tool buttons. <a href="#details">More...</a></p>
<pre> #include <Q3ToolBar></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#qtoolbar">Porting to Qt 4</a> for more information.</p>
<p>Inherits <a href="q3dockwindow.html">Q3DockWindow</a>.</p>
<ul>
<li><a href="q3toolbar-members.html">List of all members, including inherited members</a></li>
</ul>
<hr />
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li><div class="fn"><b><a href="q3toolbar.html#label-prop">label</a></b> : QString</div></li>
</ul>
<ul>
<li><div bar="2" class="fn"></div>10 properties inherited from <a href="q3dockwindow.html#properties">Q3DockWindow</a></li>
<li><div bar="2" class="fn"></div>2 properties inherited from <a href="q3frame.html#properties">Q3Frame</a></li>
<li><div bar="2" class="fn"></div>6 properties inherited from <a href="qframe.html#properties">QFrame</a></li>
<li><div bar="2" class="fn"></div>58 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li><div bar="2" class="fn"></div>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<hr />
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#Q3ToolBar">Q3ToolBar</a></b> ( const QString & <i>label</i>, Q3MainWindow * <i>parent</i>, Qt::ToolBarDock <i>dock</i> = Qt::DockTop, bool <i>newLine</i> = false, const char * <i>name</i> = 0 )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#Q3ToolBar-2">Q3ToolBar</a></b> ( const QString & <i>label</i>, Q3MainWindow * <i>mainWindow</i>, QWidget * <i>parent</i>, bool <i>newLine</i> = false, const char * <i>name</i> = 0, Qt::WindowFlags <i>f</i> = 0 )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#Q3ToolBar-3">Q3ToolBar</a></b> ( Q3MainWindow * <i>parent</i> = 0, const char * <i>name</i> = 0 )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#dtor.Q3ToolBar">~Q3ToolBar</a></b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#addSeparator">addSeparator</a></b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#clear">clear</a></b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#label-prop">label</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Q3MainWindow * </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#mainWindow">mainWindow</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#label-prop">setLabel</a></b> ( const QString & )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#setStretchableWidget">setStretchableWidget</a></b> ( QWidget * <i>w</i> )</td></tr>
</table>
<hr />
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#event">event</a></b> ( QEvent * <i>e</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual QSize </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#minimumSizeHint">minimumSizeHint</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#setOrientation">setOrientation</a></b> ( Qt::Orientation <i>o</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#setVisible">setVisible</a></b> ( bool <i>visible</i> )</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>35 public functions inherited from <a href="q3dockwindow.html#public-functions">Q3DockWindow</a></li>
<li><div bar="2" class="fn"></div>4 public functions inherited from <a href="q3frame.html#public-functions">Q3Frame</a></li>
<li><div bar="2" class="fn"></div>14 public functions inherited from <a href="qframe.html#public-functions">QFrame</a></li>
<li><div bar="2" class="fn"></div>217 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li><div bar="2" class="fn"></div>13 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<hr />
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="q3toolbar.html#resizeEvent">resizeEvent</a></b> ( QResizeEvent * <i>e</i> )</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>7 protected functions inherited from <a href="q3dockwindow.html#protected-functions">Q3DockWindow</a></li>
<li><div bar="2" class="fn"></div>5 protected functions inherited from <a href="q3frame.html#protected-functions">Q3Frame</a></li>
<li><div bar="2" class="fn"></div>3 protected functions inherited from <a href="qframe.html#protected-functions">QFrame</a></li>
<li><div bar="2" class="fn"></div>37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li><div bar="2" class="fn"></div>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li><div bar="2" class="fn"></div>1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"></div>4 public slots inherited from <a href="q3dockwindow.html#public-slots">Q3DockWindow</a></li>
<li><div class="fn"></div>19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li><div class="fn"></div>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li><div class="fn"></div>3 signals inherited from <a href="q3dockwindow.html#signals">Q3DockWindow</a></li>
<li><div class="fn"></div>1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li><div class="fn"></div>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
<li><div class="fn"></div>4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li><div class="fn"></div>5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li><div class="fn"></div>7 protected functions inherited from <a href="q3dockwindow.html#protected-functions">Q3DockWindow</a></li>
<li><div class="fn"></div>5 protected functions inherited from <a href="q3frame.html#protected-functions">Q3Frame</a></li>
<li><div class="fn"></div>3 protected functions inherited from <a href="qframe.html#protected-functions">QFrame</a></li>
<li><div class="fn"></div>37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li><div class="fn"></div>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li><div class="fn"></div>1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li><div class="fn"></div>1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The Q3ToolBar class provides a movable panel containing widgets such as tool buttons.</p>
<p>A toolbar is a panel that contains a set of controls, usually represented by small icons. It's purpose is to provide quick access to frequently used commands or options. Within a <a href="q3mainwindow.html">Q3MainWindow</a> the user can drag toolbars within and between the <a href="q3dockarea.html">dock areas</a>. Toolbars can also be dragged out of any dock area to float freely as top-level windows.</p>
<p>Q3ToolBar is a specialization of <a href="porting4.html#qdockwindow">QDockWindow</a>, and so provides all the functionality of a <a href="porting4.html#qdockwindow">QDockWindow</a>.</p>
<p>To use Q3ToolBar you simply create a Q3ToolBar as a child of a <a href="q3mainwindow.html">Q3MainWindow</a>, create a number of <a href="qtoolbutton.html">QToolButton</a> widgets (or other widgets) in left to right (or top to bottom) order and call <a href="q3toolbar.html#addSeparator">addSeparator</a>() when you want a separator. When a toolbar is floated the caption used is the label given in the constructor call. This can be changed with <a href="q3toolbar.html#label-prop">setLabel</a>().</p>
<p>You may use most widgets within a toolbar, with <a href="qtoolbutton.html">QToolButton</a> and <a href="qcombobox.html">QComboBox</a> being the most common. But note that the toolbar's actions must be <a href="q3action.html">Q3Action</a>s.</p>
<p>If you create a new widget on an already visible Q3ToolBar, this widget will automatically become visible without needing a <a href="qwidget.html#show">show</a>() call. (This differs from every other Qt widget container. We recommend calling <a href="qwidget.html#show">show</a>() anyway since we hope to fix this anomaly in a future release.)</p>
<p>Q3ToolBars, like QDockWindows, are located in <a href="q3dockarea.html">Q3DockArea</a>s or float as top-level windows. <a href="q3mainwindow.html">Q3MainWindow</a> provides four Q3DockAreas (top, left, right and bottom). When you create a new toolbar (as in the example above) as a child of a <a href="q3mainwindow.html">Q3MainWindow</a> the toolbar will be added to the top dock area. You can move it to another dock area (or float it) by calling <a href="q3mainwindow.html#moveDockWindow">Q3MainWindow::moveDockWindow</a>(). Dock areas lay out their windows in lines.</p>
<p>If the main window is resized so that the area occupied by the toolbar is too small to show all its widgets a little arrow button (which looks like a right-pointing chevron, '&#187;') will appear at the right or bottom of the toolbar depending on its orientation. Clicking this button pops up a menu that shows the 'overflowing' items. QToolButtons are represented in the menu using their textLabel property, other <a href="qabstractbutton.html">QAbstractButton</a> subclasses are represented using their text property, and QComboBoxes are represented as submenus, with the caption text being used in the submenu item.</p>
<p>Usually a toolbar will get precisely the space it needs. However, with <a href="q3dockwindow.html#setHorizontalStretchable">setHorizontalStretchable</a>(), <a href="q3dockwindow.html#setVerticalStretchable">setVerticalStretchable</a>() or <a href="q3toolbar.html#setStretchableWidget">setStretchableWidget</a>() you can tell the main window to expand the toolbar to fill all available space in the specified orientation.</p>
<p>The toolbar arranges its buttons either horizontally or vertically (see <a href="q3dockwindow.html#orientation">orientation</a>() for details). Generally, <a href="q3dockarea.html">Q3DockArea</a> will set the orientation correctly for you, but you can set it yourself with <a href="q3toolbar.html#setOrientation">setOrientation</a>() and track any changes by connecting to the <a href="q3dockwindow.html#orientationChanged">orientationChanged</a>() signal.</p>
<p>You can use the <a href="q3toolbar.html#clear">clear</a>() method to remove all items from a toolbar.</p>
<p align="center"><img src="images/qdockwindow.png" alt="Toolbar (dock window)" /></p><p>A floating <a href="porting4.html#qtoolbar">QToolbar</a> (dock window)</p>
<p>See also <a href="qtoolbutton.html">QToolButton</a> and <a href="q3mainwindow.html">Q3MainWindow</a>.</p>
<hr />
<h2>Property Documentation</h2>
<a name="//apple_ref/cpp/instm/Q3ToolBar/label"></a>
<a name="//apple_ref/cpp/instm/Q3ToolBar/setLabel"></a>
<h3 class="fn"><a name="label-prop"></a>label : <a href="qstring.html">QString</a></h3>
<p>This property holds the toolbar's label.</p>
<p>If the toolbar is floated the label becomes the toolbar window's caption. There is no default label text.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b>label</b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b>setLabel</b> ( const QString & )</td></tr>
</table>
<hr />
<h2>Member Function Documentation</h2>
<a name="//apple_ref/cpp/instm/Q3ToolBar/Q3ToolBar"></a>
<h3 class="fn"><a name="Q3ToolBar"></a>Q3ToolBar::Q3ToolBar ( const <a href="qstring.html">QString</a> & <i>label</i>, <a href="q3mainwindow.html">Q3MainWindow</a> * <i>parent</i>, <a href="qt-qt3.html#ToolBarDock-typedef">Qt::ToolBarDock</a> <i>dock</i> = Qt::DockTop, bool <i>newLine</i> = false, const char * <i>name</i> = 0 )</h3>
<p>Constructs an empty toolbar.</p>
<p>The toolbar is called <i>name</i> and is a child of <i>parent</i> and is managed by <i>parent</i>. It is initially located in dock area <i>dock</i> and is labeled <i>label</i>. If <i>newLine</i> is true the toolbar will be placed on a new line in the dock area.</p>
<h3 class="fn"><a name="Q3ToolBar-2"></a>Q3ToolBar::Q3ToolBar ( const <a href="qstring.html">QString</a> & <i>label</i>, <a href="q3mainwindow.html">Q3MainWindow</a> * <i>mainWindow</i>, <a href="qwidget.html">QWidget</a> * <i>parent</i>, bool <i>newLine</i> = false, const char * <i>name</i> = 0, <a href="qt.html#WindowType-enum">Qt::WindowFlags</a> <i>f</i> = 0 )</h3>
<p>Constructs an empty horizontal toolbar.</p>
<p>The toolbar is called <i>name</i> and is a child of <i>parent</i> and is managed by <i>mainWindow</i>. The <i>label</i> and <i>newLine</i> parameters are passed straight to <a href="q3mainwindow.html#addDockWindow">Q3MainWindow::addDockWindow</a>(). <i>name</i> and the widget flags <i>f</i> are passed on to the <a href="q3dockwindow.html" class="compat">Q3DockWindow</a> constructor.</p>
<p>Use this constructor if you want to create torn-off (undocked, floating) toolbars or toolbars in the <a href="qstatusbar.html">status bar</a>.</p>
<h3 class="fn"><a name="Q3ToolBar-3"></a>Q3ToolBar::Q3ToolBar ( <a href="q3mainwindow.html">Q3MainWindow</a> * <i>parent</i> = 0, const char * <i>name</i> = 0 )</h3>
<p>This is an overloaded function.</p>
<p>Constructs an empty toolbar called <i>name</i>, with parent <i>parent</i>, in its <i>parent</i>'s top dock area, without any label and without requiring a newline.</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/~Q3ToolBar"></a>
<h3 class="fn"><a name="dtor.Q3ToolBar"></a>Q3ToolBar::~Q3ToolBar ()</h3>
<p>Destructor.</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/addSeparator"></a>
<h3 class="fn"><a name="addSeparator"></a>void Q3ToolBar::addSeparator ()</h3>
<p>Adds a separator to the right/bottom of the toolbar.</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/clear"></a>
<h3 class="fn"><a name="clear"></a>void Q3ToolBar::clear () <tt> [virtual]</tt></h3>
<p>Deletes all the toolbar's child widgets.</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/event"></a>
<h3 class="fn"><a name="event"></a>bool Q3ToolBar::event ( <a href="qevent.html">QEvent</a> * <i>e</i> ) <tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qobject.html#event">QObject::event</a>().</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/mainWindow"></a>
<h3 class="fn"><a name="mainWindow"></a><a href="q3mainwindow.html">Q3MainWindow</a> * Q3ToolBar::mainWindow () const</h3>
<p>Returns a pointer to the <a href="q3mainwindow.html" class="compat">Q3MainWindow</a> which manages this toolbar.</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/minimumSizeHint"></a>
<h3 class="fn"><a name="minimumSizeHint"></a><a href="qsize.html">QSize</a> Q3ToolBar::minimumSizeHint () const <tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#minimumSizeHint-prop">QWidget::minimumSizeHint</a>().</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/resizeEvent"></a>
<h3 class="fn"><a name="resizeEvent"></a>void Q3ToolBar::resizeEvent ( <a href="qresizeevent.html">QResizeEvent</a> * <i>e</i> ) <tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#resizeEvent">QWidget::resizeEvent</a>().</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/setOrientation"></a>
<h3 class="fn"><a name="setOrientation"></a>void Q3ToolBar::setOrientation ( <a href="qt.html#Orientation-enum">Qt::Orientation</a> <i>o</i> ) <tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="q3dockwindow.html#setOrientation">Q3DockWindow::setOrientation</a>().</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/setStretchableWidget"></a>
<h3 class="fn"><a name="setStretchableWidget"></a>void Q3ToolBar::setStretchableWidget ( <a href="qwidget.html">QWidget</a> * <i>w</i> ) <tt> [virtual]</tt></h3>
<p>Sets the widget <i>w</i> to be expanded if this toolbar is requested to stretch.</p>
<p>The request to stretch might occur because <a href="q3mainwindow.html" class="compat">Q3MainWindow</a> right-justifies the dock area the toolbar is in, or because this toolbar's <a href="q3dockwindow.html#isVerticalStretchable">isVerticalStretchable</a>() or <a href="q3dockwindow.html#isHorizontalStretchable">isHorizontalStretchable</a>() is set to true.</p>
<p>If you call this function and the toolbar is not yet stretchable, setStretchable() is called.</p>
<p>See also <a href="q3mainwindow.html#rightJustification-prop">Q3MainWindow::setRightJustification</a>(), <a href="q3dockwindow.html#setVerticalStretchable">setVerticalStretchable</a>(), and <a href="q3dockwindow.html#setHorizontalStretchable">setHorizontalStretchable</a>().</p>
<a name="//apple_ref/cpp/instm/Q3ToolBar/setVisible"></a>
<h3 class="fn"><a name="setVisible"></a>void Q3ToolBar::setVisible ( bool <i>visible</i> ) <tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#visible-prop">QWidget::setVisible</a>().</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="40%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td>
<td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="40%" align="right"><div align="right">Qt 4.6.3</div></td>
</tr></table></div></address></body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
8e6051afcdb111a0317a58fb64c2abf5
>
files
>
3547
