1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QToolBar Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QToolBar Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QToolBar class provides a movable panel that contains a set of controls. <a href="#details">More...</a></p>
<p>Inherits <a href="qwidget.html">QWidget</a>.</p><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qtoolbar.html#QToolBar">__init__</a></b> (<i>self</i>, QString <i>title</i>, QWidget <i>parent</i> = None)</li><li><div class="fn" /><b><a href="qtoolbar.html#QToolBar-2">__init__</a></b> (<i>self</i>, QWidget <i>parent</i> = None)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#actionAt">actionAt</a></b> (<i>self</i>, QPoint <i>p</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#actionAt-2">actionAt</a></b> (<i>self</i>, int <i>ax</i>, int <i>ay</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#actionEvent">actionEvent</a></b> (<i>self</i>, QActionEvent <i>event</i>)</li><li><div class="fn" />QRect <b><a href="qtoolbar.html#actionGeometry">actionGeometry</a></b> (<i>self</i>, QAction <i>action</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#addAction">addAction</a></b> (<i>self</i>, QAction <i>action</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-2">addAction</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-3">addAction</a></b> (<i>self</i>, QIcon <i>icon</i>, QString <i>text</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-4">addAction</a></b> (<i>self</i>, QString <i>text</i>, QObject <i>receiver</i>, SLOT() <i>member</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-5">addAction</a></b> (<i>self</i>, QString <i>text</i>, callable <i>receiver</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-6">addAction</a></b> (<i>self</i>, QIcon <i>icon</i>, QString <i>text</i>, QObject <i>receiver</i>, SLOT() <i>member</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addAction-7">addAction</a></b> (<i>self</i>, QIcon <i>icon</i>, QString <i>text</i>, callable <i>receiver</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addSeparator">addSeparator</a></b> (<i>self</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#addWidget">addWidget</a></b> (<i>self</i>, QWidget <i>widget</i>)</li><li><div class="fn" />Qt.ToolBarAreas <b><a href="qtoolbar.html#allowedAreas">allowedAreas</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#changeEvent">changeEvent</a></b> (<i>self</i>, QEvent <i>event</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#childEvent">childEvent</a></b> (<i>self</i>, QChildEvent <i>event</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#clear">clear</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtoolbar.html#event">event</a></b> (<i>self</i>, QEvent <i>event</i>)</li><li><div class="fn" />QSize <b><a href="qtoolbar.html#iconSize">iconSize</a></b> (<i>self</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#insertSeparator">insertSeparator</a></b> (<i>self</i>, QAction <i>before</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#insertWidget">insertWidget</a></b> (<i>self</i>, QAction <i>before</i>, QWidget <i>widget</i>)</li><li><div class="fn" />bool <b><a href="qtoolbar.html#isAreaAllowed">isAreaAllowed</a></b> (<i>self</i>, Qt.ToolBarArea <i>area</i>)</li><li><div class="fn" />bool <b><a href="qtoolbar.html#isMovable">isMovable</a></b> (<i>self</i>)</li><li><div class="fn" />Qt.Orientation <b><a href="qtoolbar.html#orientation">orientation</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#paintEvent">paintEvent</a></b> (<i>self</i>, QPaintEvent <i>event</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#resizeEvent">resizeEvent</a></b> (<i>self</i>, QResizeEvent <i>event</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#setAllowedAreas">setAllowedAreas</a></b> (<i>self</i>, Qt.ToolBarAreas <i>areas</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#setIconSize">setIconSize</a></b> (<i>self</i>, QSize <i>iconSize</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#setMovable">setMovable</a></b> (<i>self</i>, bool <i>movable</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#setOrientation">setOrientation</a></b> (<i>self</i>, Qt.Orientation <i>orientation</i>)</li><li><div class="fn" /><b><a href="qtoolbar.html#setToolButtonStyle">setToolButtonStyle</a></b> (<i>self</i>, Qt.ToolButtonStyle <i>toolButtonStyle</i>)</li><li><div class="fn" />QAction <b><a href="qtoolbar.html#toggleViewAction">toggleViewAction</a></b> (<i>self</i>)</li><li><div class="fn" />Qt.ToolButtonStyle <b><a href="qtoolbar.html#toolButtonStyle">toolButtonStyle</a></b> (<i>self</i>)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qtoolbar.html#actionTriggered">actionTriggered</a></b> (QAction *)</li><li><div class="fn" />void <b><a href="qtoolbar.html#allowedAreasChanged">allowedAreasChanged</a></b> (Qt::ToolBarAreas)</li><li><div class="fn" />void <b><a href="qtoolbar.html#iconSizeChanged">iconSizeChanged</a></b> (const QSize&)</li><li><div class="fn" />void <b><a href="qtoolbar.html#movableChanged">movableChanged</a></b> (bool)</li><li><div class="fn" />void <b><a href="qtoolbar.html#orientationChanged">orientationChanged</a></b> (Qt::Orientation)</li><li><div class="fn" />void <b><a href="qtoolbar.html#toolButtonStyleChanged">toolButtonStyleChanged</a></b> (Qt::ToolButtonStyle)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QToolBar class provides a movable panel that contains a set of controls.</p>
<p>Toolbar buttons are added by adding <i>actions</i>, using <a href="qtoolbar.html#addAction">addAction</a>() or <a href="qwidget.html#insertAction">insertAction</a>(). Groups of buttons can be separated using <a href="qtoolbar.html#addSeparator">addSeparator</a>() or <a href="qtoolbar.html#insertSeparator">insertSeparator</a>(). If a toolbar button is not appropriate, a widget can be inserted instead using <a href="qtoolbar.html#addWidget">addWidget</a>() or <a href="qtoolbar.html#insertWidget">insertWidget</a>(); examples of suitable widgets are <a href="qspinbox.html">QSpinBox</a>, <a href="qdoublespinbox.html">QDoubleSpinBox</a>, and <a href="qcombobox.html">QComboBox</a>. When a toolbar button is pressed it emits the <a href="qtoolbar.html#actionTriggered">actionTriggered</a>() signal.</p>
<p>A toolbar can be fixed in place in a particular area (e.g. at the top of the window), or it can be movable (<a href="qtoolbar.html#movable-prop">isMovable</a>()) between toolbar areas; see <a href="qtoolbar.html#allowedAreas-prop">allowedAreas</a>() and <a href="qtoolbar.html#isAreaAllowed">isAreaAllowed</a>().</p>
<p>When a toolbar is resized in such a way that it is too small to show all the items it contains, an extension button will appear as the last item in the toolbar. Pressing the extension button will pop up a menu containing the items that does not currently fit in the toolbar. Note that only action based items will be shown in the menu. If only non-action based items are to appear in the extension menu (e.g. a <a href="qspinbox.html">QSpinBox</a>), the extension button will appear as usual, but it will be disabled to indicate that some items in the toolbar are currently not visible.</p>
<p>See also <a href="qtoolbutton.html">QToolButton</a>.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QToolBar" />QToolBar.__init__ (<i>self</i>, <a href="qstring.html">QString</a> <i>title</i>, <a href="qwidget.html">QWidget</a> <i>parent</i> = None)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs a <a href="qtoolbar.html">QToolBar</a> with the given <i>parent</i>.</p>
<p>The window title is set to <i>title</i>. This title is used when the toolbar is floating as an independent window. It is also shown in the context menu provided by <a href="qmainwindow.html">QMainWindow</a>.</p>
<p>See also <a href="qwidget.html#windowTitle-prop">setWindowTitle</a>().</p>
<h3 class="fn"><a name="QToolBar-2" />QToolBar.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a> <i>parent</i> = None)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs a <a href="qtoolbar.html">QToolBar</a> with the given <i>parent</i>.</p>
<h3 class="fn"><a name="actionAt" /><a href="qaction.html">QAction</a> QToolBar.actionAt (<i>self</i>, <a href="qpoint.html">QPoint</a> <i>p</i>)</h3><p>Returns the action at point <i>p</i>. This function returns zero if no action was found.</p>
<p>See also <a href="qwidget.html#childAt">QWidget.childAt</a>().</p>
<h3 class="fn"><a name="actionAt-2" /><a href="qaction.html">QAction</a> QToolBar.actionAt (<i>self</i>, int <i>ax</i>, int <i>ay</i>)</h3><p>This is an overloaded member function, provided for convenience.</p>
<p>Returns the action at the point <i>x</i>, <i>y</i>. This function returns zero if no action was found.</p>
<h3 class="fn"><a name="actionEvent" />QToolBar.actionEvent (<i>self</i>, <a href="qactionevent.html">QActionEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="actionGeometry" /><a href="qrect.html">QRect</a> QToolBar.actionGeometry (<i>self</i>, <a href="qaction.html">QAction</a> <i>action</i>)</h3><h3 class="fn"><a name="addAction" />QToolBar.addAction (<i>self</i>, <a href="qaction.html">QAction</a> <i>action</i>)</h3><p>Creates a new action with the given <i>text</i>. This action is added to the end of the toolbar.</p>
<h3 class="fn"><a name="addAction-2" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qstring.html">QString</a> <i>text</i>)</h3><p>This is an overloaded member function, provided for convenience.</p>
<p>Creates a new action with the given <i>icon</i> and <i>text</i>. This action is added to the end of the toolbar.</p>
<h3 class="fn"><a name="addAction-3" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qicon.html">QIcon</a> <i>icon</i>, <a href="qstring.html">QString</a> <i>text</i>)</h3><p>This is an overloaded member function, provided for convenience.</p>
<p>Creates a new action with the given <i>text</i>. This action is added to the end of the toolbar. The action's <a href="qaction.html#triggered">triggered()</a> signal is connected to <i>member</i> in <i>receiver</i>.</p>
<h3 class="fn"><a name="addAction-4" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qstring.html">QString</a> <i>text</i>, <a href="qobject.html">QObject</a> <i>receiver</i>, SLOT() <i>member</i>)</h3><p>This is an overloaded member function, provided for convenience.</p>
<p>Creates a new action with the icon <i>icon</i> and text <i>text</i>. This action is added to the end of the toolbar. The action's <a href="qaction.html#triggered">triggered()</a> signal is connected to <i>member</i> in <i>receiver</i>.</p>
<h3 class="fn"><a name="addAction-5" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qstring.html">QString</a> <i>text</i>, callable <i>receiver</i>)</h3><h3 class="fn"><a name="addAction-6" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qicon.html">QIcon</a> <i>icon</i>, <a href="qstring.html">QString</a> <i>text</i>, <a href="qobject.html">QObject</a> <i>receiver</i>, SLOT() <i>member</i>)</h3><h3 class="fn"><a name="addAction-7" /><a href="qaction.html">QAction</a> QToolBar.addAction (<i>self</i>, <a href="qicon.html">QIcon</a> <i>icon</i>, <a href="qstring.html">QString</a> <i>text</i>, callable <i>receiver</i>)</h3><h3 class="fn"><a name="addSeparator" /><a href="qaction.html">QAction</a> QToolBar.addSeparator (<i>self</i>)</h3><p>Adds a separator to the end of the toolbar.</p>
<p>See also <a href="qtoolbar.html#insertSeparator">insertSeparator</a>().</p>
<h3 class="fn"><a name="addWidget" /><a href="qaction.html">QAction</a> QToolBar.addWidget (<i>self</i>, <a href="qwidget.html">QWidget</a> <i>widget</i>)</h3><p>Adds the given <i>widget</i> to the toolbar as the toolbar's last item.</p>
<p>Note: You should use <a href="qaction.html#visible-prop">QAction.setVisible</a>() to change the visibility of the widget. Using <a href="qwidget.html#visible-prop">QWidget.setVisible</a>(), <a href="qwidget.html#show">QWidget.show</a>() and <a href="qwidget.html#hide">QWidget.hide</a>() does not work.</p>
<p>See also <a href="qtoolbar.html#insertWidget">insertWidget</a>().</p>
<h3 class="fn"><a name="allowedAreas" /><a href="qt-toolbarareas.html">Qt.ToolBarAreas</a> QToolBar.allowedAreas (<i>self</i>)</h3><h3 class="fn"><a name="changeEvent" />QToolBar.changeEvent (<i>self</i>, <a href="qevent.html">QEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="childEvent" />QToolBar.childEvent (<i>self</i>, <a href="qchildevent.html">QChildEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="clear" />QToolBar.clear (<i>self</i>)</h3><p>Removes all actions from the toolbar.</p>
<p>See also <a href="qwidget.html#removeAction">removeAction</a>().</p>
<h3 class="fn"><a name="event" />bool QToolBar.event (<i>self</i>, <a href="qevent.html">QEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="iconSize" /><a href="qsize.html">QSize</a> QToolBar.iconSize (<i>self</i>)</h3><h3 class="fn"><a name="insertSeparator" /><a href="qaction.html">QAction</a> QToolBar.insertSeparator (<i>self</i>, <a href="qaction.html">QAction</a> <i>before</i>)</h3><p>Inserts a separator into the toolbar in front of the toolbar item associated with the <i>before</i> action.</p>
<p>See also <a href="qtoolbar.html#addSeparator">addSeparator</a>().</p>
<h3 class="fn"><a name="insertWidget" /><a href="qaction.html">QAction</a> QToolBar.insertWidget (<i>self</i>, <a href="qaction.html">QAction</a> <i>before</i>, <a href="qwidget.html">QWidget</a> <i>widget</i>)</h3><p>Inserts the given <i>widget</i> in front of the toolbar item associated with the <i>before</i> action.</p>
<p>Note: You should use <a href="qaction.html#visible-prop">QAction.setVisible</a>() to change the visibility of the widget. Using <a href="qwidget.html#visible-prop">QWidget.setVisible</a>(), <a href="qwidget.html#show">QWidget.show</a>() and <a href="qwidget.html#hide">QWidget.hide</a>() does not work.</p>
<p>See also <a href="qtoolbar.html#addWidget">addWidget</a>().</p>
<h3 class="fn"><a name="isAreaAllowed" />bool QToolBar.isAreaAllowed (<i>self</i>, <a href="qt.html#ToolBarArea-enum">Qt.ToolBarArea</a> <i>area</i>)</h3><p>Returns true if this toolbar is dockable in the given <i>area</i>; otherwise returns false.</p>
<h3 class="fn"><a name="isMovable" />bool QToolBar.isMovable (<i>self</i>)</h3><h3 class="fn"><a name="orientation" /><a href="qt.html#Orientation-enum">Qt.Orientation</a> QToolBar.orientation (<i>self</i>)</h3><h3 class="fn"><a name="paintEvent" />QToolBar.paintEvent (<i>self</i>, <a href="qpaintevent.html">QPaintEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="resizeEvent" />QToolBar.resizeEvent (<i>self</i>, <a href="qresizeevent.html">QResizeEvent</a> <i>event</i>)</h3><h3 class="fn"><a name="setAllowedAreas" />QToolBar.setAllowedAreas (<i>self</i>, <a href="qt-toolbarareas.html">Qt.ToolBarAreas</a> <i>areas</i>)</h3><h3 class="fn"><a name="setIconSize" />QToolBar.setIconSize (<i>self</i>, <a href="qsize.html">QSize</a> <i>iconSize</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void setIconSize(const QSize&)</tt>.</p><h3 class="fn"><a name="setMovable" />QToolBar.setMovable (<i>self</i>, bool <i>movable</i>)</h3><h3 class="fn"><a name="setOrientation" />QToolBar.setOrientation (<i>self</i>, <a href="qt.html#Orientation-enum">Qt.Orientation</a> <i>orientation</i>)</h3><h3 class="fn"><a name="setToolButtonStyle" />QToolBar.setToolButtonStyle (<i>self</i>, <a href="qt.html#ToolButtonStyle-enum">Qt.ToolButtonStyle</a> <i>toolButtonStyle</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void setToolButtonStyle(Qt::ToolButtonStyle)</tt>.</p><h3 class="fn"><a name="toggleViewAction" /><a href="qaction.html">QAction</a> QToolBar.toggleViewAction (<i>self</i>)</h3><p>Returns a checkable action that can be used to show or hide this toolbar.</p>
<p>The action's text is set to the toolbar's window title.</p>
<p>See also <a href="qaction.html#text-prop">QAction.text</a> and <a href="qwidget.html#windowTitle-prop">QWidget.windowTitle</a>.</p>
<h3 class="fn"><a name="toolButtonStyle" /><a href="qt.html#ToolButtonStyle-enum">Qt.ToolButtonStyle</a> QToolBar.toolButtonStyle (<i>self</i>)</h3><hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="actionTriggered" />void actionTriggered (QAction *)</h3><p>This signal is emitted when a toolbar button is pressed. The parameter holds the toolbar button's associated <i>action</i>.</p>
<h3 class="fn"><a name="allowedAreasChanged" />void allowedAreasChanged (Qt::ToolBarAreas)</h3><p>This signal is emitted when the collection of allowed areas for the toolbar is changed. The new areas in which the toolbar can be positioned are specified by <i>allowedAreas</i>.</p>
<p>See also <a href="qtoolbar.html#allowedAreas-prop">allowedAreas</a>.</p>
<h3 class="fn"><a name="iconSizeChanged" />void iconSizeChanged (const QSize&)</h3><p>This signal is emitted when the icon size is changed. The <i>iconSize</i> parameter holds the toolbar's new icon size.</p>
<p>See also <a href="qtoolbar.html#iconSize-prop">iconSize</a> and <a href="qmainwindow.html#iconSize-prop">QMainWindow.iconSize</a>.</p>
<h3 class="fn"><a name="movableChanged" />void movableChanged (bool)</h3><p>This signal is emitted when the toolbar becomes movable or fixed. If the toolbar can be moved, <i>movable</i> is true; otherwise it is false.</p>
<p>See also <a href="qtoolbar.html#movable-prop">movable</a>.</p>
<h3 class="fn"><a name="orientationChanged" />void orientationChanged (Qt::Orientation)</h3><p>This signal is emitted when the orientation of the toolbar changes. The new orientation is specified by the <i>orientation</i> given.</p>
<p>See also <a href="qtoolbar.html#orientation-prop">orientation</a>.</p>
<h3 class="fn"><a name="toolButtonStyleChanged" />void toolButtonStyleChanged (Qt::ToolButtonStyle)</h3><p>This signal is emitted when the tool button style is changed. The <i>toolButtonStyle</i> parameter holds the toolbar's new tool button style.</p>
<p>See also <a href="qtoolbar.html#toolButtonStyle-prop">toolButtonStyle</a> and <a href="qmainwindow.html#toolButtonStyle-prop">QMainWindow.toolButtonStyle</a>.</p>
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td width="25%">PyQt 4.0.1 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.trolltech.com">Trolltech AS</a> 2006</td><td align="right" width="25%">Qt 4.1.4</td></tr></table></div></address></body></html>
|
