<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>QToolButton Class Reference</h1>
<p>The QToolButton class provides a quick-access button to
commands or options, usually used inside a QToolBar.
<liclass=fn>bool <ahref="#autoRaise-prop"><b>autoRaise</b></a> - whether auto-raising is enabled</li>
<liclass=fn>BackgroundMode <ahref="#backgroundMode-prop"><b>backgroundMode</b></a> - the toolbutton's background mode <em>(read only)</em></li>
<liclass=fn>QIconSet <ahref="#iconSet-prop"><b>iconSet</b></a> - the icon set providing the icon shown on the button</li>
<liclass=fn>QIconSet offIconSet - the icon set that is used when the button is in an "off" state <em>(obsolete)</em></li>
<liclass=fn>bool <ahref="#on-prop"><b>on</b></a> - whether this tool button is on</li>
<liclass=fn>QIconSet onIconSet - the icon set that is used when the button is in an "on" state <em>(obsolete)</em></li>
<liclass=fn>QPixmap <ahref="#pixmap-prop"><b>pixmap</b></a> - the pixmap of the button <em>(read only)</em></li>
<liclass=fn>int <ahref="#popupDelay-prop"><b>popupDelay</b></a> - the time delay between pressing the button and the appearance of the associated popup menu in milliseconds</li>
<liclass=fn>QString <ahref="#textLabel-prop"><b>textLabel</b></a> - the label of this button</li>
<liclass=fn>TextPosition <ahref="#textPosition-prop"><b>textPosition</b></a> - the position of the text label of this button</li>
<liclass=fn>bool <ahref="#toggleButton-prop"><b>toggleButton</b></a> - whether this tool button is a toggle button</li>
<liclass=fn>bool <ahref="#usesBigPixmap-prop"><b>usesBigPixmap</b></a> - whether this toolbutton uses big pixmaps</li>
<liclass=fn>bool <ahref="#usesTextLabel-prop"><b>usesTextLabel</b></a> - whether the toolbutton displays a text label below the button pixmap</li>
Constructs a tool button called <em>name</em>, that is a child of <em>parent</em> (which must be a <ahref="qtoolbar.html">QToolBar</a>).
<p> The tool button will display <em>iconSet</em>, with its text label and
tool tip set to <em>textLabel</em> and its status bar message set to <em>grouptext</em>. It will be connected to the <em>slot</em> in object <em>receiver</em>.
Constructs a tool button as an arrow button. The <ahref="qt.html#ArrowType-enum">ArrowType</a><em>type</em> defines the arrow direction. Possible values are <ahref="qt.html#ArrowType-enum">LeftArrow</a>, <ahref="qt.html#ArrowType-enum">RightArrow</a>, <ahref="qt.html#ArrowType-enum">UpArrow</a> and <ahref="qt.html#ArrowType-enum">DownArrow</a>.
<p> An arrow button has auto-repeat turned on by default.
<p> The <em>parent</em> and <em>name</em> arguments are sent to the <ahref="qwidget.html">QWidget</a>
<p>This property holds the icon set that is used when the button is in an "off" state.
<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p> Since Qt 3.0, <ahref="qiconset.html">QIconSet</a> contains both the On and Off icons. There is
now an <ahref="#iconSet-prop">QToolButton::iconSet</a> property that replaces both <ahref="#onIconSet-prop">QToolButton::onIconSet</a> and <ahref="#offIconSet-prop">QToolButton::offIconSet</a>.
<p> For ease of porting, this property is a synonym for <ahref="#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application
code and use the QIconSet On/Off mechanism.
<p><p>See also <ahref="#iconSet-prop">iconSet</a> and <ahref="qiconset.html#State-enum">QIconSet::State</a>.
<p>Set this property's value with <ahref="#setOffIconSet">setOffIconSet</a>() and get this property's value with <ahref="#offIconSet">offIconSet</a>().
<h3class=fn>bool <aname="on-prop"></a>on</h3>
<p>This property holds whether this tool button is on.
<p>This property has no effect on <ahref="qbutton.html#isToggleButton">non-toggling
buttons.</a> The default is FALSE (i.e. off).
<p><p>See also <ahref="#toggleButton-prop">toggleButton</a> and <ahref="#toggle">toggle</a>().
<p>Set this property's value with <ahref="#setOn">setOn</a>().
<p>This property holds the icon set that is used when the button is in an "on" state.
<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p> Since Qt 3.0, <ahref="qiconset.html">QIconSet</a> contains both the On and Off icons. There is
now an <ahref="#iconSet-prop">QToolButton::iconSet</a> property that replaces both <ahref="#onIconSet-prop">QToolButton::onIconSet</a> and <ahref="#offIconSet-prop">QToolButton::offIconSet</a>.
<p> For ease of porting, this property is a synonym for <ahref="#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application
code and use the QIconSet On/Off mechanism.
<p><p>See also <ahref="#iconSet-prop">iconSet</a> and <ahref="qiconset.html#State-enum">QIconSet::State</a>.
<p>Set this property's value with <ahref="#setOnIconSet">setOnIconSet</a>() and get this property's value with <ahref="#onIconSet">onIconSet</a>().
<h3class=fn><ahref="qpixmap.html">QPixmap</a><aname="pixmap-prop"></a>pixmap</h3><p>This property holds the pixmap of the button.
<p>The pixmap property has no meaning for tool buttons. Use the
<p>This property holds the time delay between pressing the button and the appearance of the associated popup menu in milliseconds.
<p>Usually this is around half a second. A value of 0 draws the down
arrow button to the side of the button which can be used to open
up the popup menu.
<p><p>See also <ahref="#setPopup">setPopup</a>().
<p>Set this property's value with <ahref="#setPopupDelay">setPopupDelay</a>() and get this property's value with <ahref="#popupDelay">popupDelay</a>().
<p>This property holds the position of the text label of this button.
<p>
<p>Set this property's value with <ahref="#setTextPosition">setTextPosition</a>() and get this property's value with <ahref="#textPosition">textPosition</a>().
<p>This property holds whether this toolbutton uses big pixmaps.
<p>QToolButton automatically connects this property to the relevant
signal in the <ahref="qmainwindow.html">QMainWindow</a> in which it resides. We strongly
recommend that you use <ahref="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>() instead.
<p> This property's default is TRUE.
<p><b>Warning:</b> If you set some buttons (in a QMainWindow) to have big
pixmaps and others to have small pixmaps, QMainWindow may not get
the geometry right.
<p>Set this property's value with <ahref="#setUsesBigPixmap">setUsesBigPixmap</a>() and get this property's value with <ahref="#usesBigPixmap">usesBigPixmap</a>().
<p>This property holds whether the toolbutton displays a text label below the button pixmap.
<p>The default is FALSE.
<p> QToolButton automatically connects this slot to the relevant
signal in the <ahref="qmainwindow.html">QMainWindow</a> in which is resides.
<p>Set this property's value with <ahref="#setUsesTextLabel">setUsesTextLabel</a>() and get this property's value with <ahref="#usesTextLabel">usesTextLabel</a>().
<!-- eof -->
<hr><p>
This file is part of the <ahref="index.html">Qt toolkit</a>.
