📄 qtoolbutton.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/widgets/qtoolbutton.cpp:74 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QToolButton类</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主页</font></a>
| <a href="classes.html">
<font color="#004faf">所有的类</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的类</font></a>
| <a href="annotated.html">
<font color="#004faf">注释的类</font></a>
| <a href="groups.html">
<font color="#004faf">分组的类</font></a>
| <a href="functions.html">
<font color="#004faf">函数</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QToolButton类参考</h1>
<p> QToolButton类提供了用于命令或者选项的可以快速访问的按钮，通常可以用在QToolBar里面。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qtoolbutton-h.html">qtoolbutton.h</a>></tt>
<p>继承了<a href="qbutton.html">QButton</a>。
<p><a href="qtoolbutton-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QToolButton"><b>QToolButton</b></a> ( QWidget * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#QToolButton-2"><b>QToolButton</b></a> ( const QIconSet & iconSet, const QString & textLabel, const QString & grouptext, QObject * receiver, const char * slot, QToolBar * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#QToolButton-3"><b>QToolButton</b></a> ( ArrowType type, QWidget * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#~QToolButton"><b>~QToolButton</b></a> ()</div></li>
<li><div class=fn>void setOnIconSet ( const QIconSet & ) <em>（废弃）</em></div></li>
<li><div class=fn>void setOffIconSet ( const QIconSet & ) <em>（废弃）</em></div></li>
<li><div class=fn>void setIconSet ( const QIconSet & set, bool on ) <em>（废弃）</em></div></li>
<li><div class=fn>QIconSet onIconSet () const <em>（废弃）</em></div></li>
<li><div class=fn>QIconSet offIconSet () const <em>（废弃）</em></div></li>
<li><div class=fn>QIconSet iconSet ( bool on ) const <em>（废弃）</em></div></li>
<li><div class=fn>virtual void <a href="#setIconSet"><b>setIconSet</b></a> ( const QIconSet & )</div></li>
<li><div class=fn>QIconSet <a href="#iconSet"><b>iconSet</b></a> () const</div></li>
<li><div class=fn>bool <a href="#usesBigPixmap"><b>usesBigPixmap</b></a> () const</div></li>
<li><div class=fn>bool <a href="#usesTextLabel"><b>usesTextLabel</b></a> () const</div></li>
<li><div class=fn>QString <a href="#textLabel"><b>textLabel</b></a> () const</div></li>
<li><div class=fn>void <a href="#setPopup"><b>setPopup</b></a> ( QPopupMenu * popup )</div></li>
<li><div class=fn>QPopupMenu * <a href="#popup"><b>popup</b></a> () const</div></li>
<li><div class=fn>void <a href="#setPopupDelay"><b>setPopupDelay</b></a> ( int delay )</div></li>
<li><div class=fn>int <a href="#popupDelay"><b>popupDelay</b></a> () const</div></li>
<li><div class=fn>void <a href="#openPopup"><b>openPopup</b></a> ()</div></li>
<li><div class=fn>void <a href="#setAutoRaise"><b>setAutoRaise</b></a> ( bool enable )</div></li>
<li><div class=fn>bool <a href="#autoRaise"><b>autoRaise</b></a> () const</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>virtual void <a href="#setUsesBigPixmap"><b>setUsesBigPixmap</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setUsesTextLabel"><b>setUsesTextLabel</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setTextLabel-2"><b>setTextLabel</b></a> ( const QString & newLabel, bool tipToo )</div></li>
<li><div class=fn>virtual void <a href="#setToggleButton"><b>setToggleButton</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setOn"><b>setOn</b></a> ( bool enable )</div></li>
<li><div class=fn>void <a href="#toggle"><b>toggle</b></a> ()</div></li>
<li><div class=fn>void <a href="#setTextLabel"><b>setTextLabel</b></a> ( const QString & )</div></li>
</ul>
<h2>属性</h2>
<ul>
<li><div class=fn>bool <a href="#autoRaise-prop"><b>autoRaise</b></a> - 自动浮起是否生效</div></li>
<li><div class=fn>QIconSet <a href="#iconSet-prop"><b>iconSet</b></a> - 提供显示在按钮上的图标的图标集</div></li>
<li><div class=fn>QIconSet offIconSet - 当按钮在“关”状态时使用的图标集 <em>（废弃）</em></div></li>
<li><div class=fn>bool <a href="#on-prop"><b>on</b></a> - 工具按钮是否为开</div></li>
<li><div class=fn>QIconSet onIconSet - 当按钮在“开”状态时使用的图标集 <em>（废弃）</em></div></li>
<li><div class=fn>int <a href="#popupDelay-prop"><b>popupDelay</b></a> - 在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间</div></li>
<li><div class=fn>QString <a href="#textLabel-prop"><b>textLabel</b></a> - 按钮的标签</div></li>
<li><div class=fn>bool <a href="#toggleButton-prop"><b>toggleButton</b></a> - 工具按钮是否是切换按钮</div></li>
<li><div class=fn>bool <a href="#usesBigPixmap-prop"><b>usesBigPixmap</b></a> - 工具按钮是否使用大的像素映射</div></li>
<li><div class=fn>bool <a href="#usesTextLabel-prop"><b>usesTextLabel</b></a> - 工具按钮是否在按钮像素映射下方显示标签</div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn>bool <a href="#uses3D"><b>uses3D</b></a> () const</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
<p> QToolButton类提供了用于命令或者选项的可以快速访问的按钮，通常可以用在<a href="qtoolbar.html">QToolBar</a>里面。
<p>
<p> 工具按钮是提供对特定命令或者选项快速访问的特殊按钮。和普通的命令按钮不同，工具按钮通常不显示文本标签，而是图标。它的经典用法事选择工具，例如在一个绘图程序中的“笔”工具。这个被QToolButton作为切换按钮重新实现。（请参考<a href="#setToggleButton">setToggleButton</a>()）。
<p> QToolButton支持自动浮起。在自动浮起模式中，按钮只有在鼠标指向它的时候才绘制三维的框架。当按钮被用在QToolBar里面的时候，这个特征会自动被启用。可以使用<a href="#setAutoRaise">setAutoRaise</a>()来改变它。
<p> 工具按钮的图标是被设置为<a href="qiconset.html">QIconSet</a>。这使得它可以为失效和激活状态指定不同的像素映射。当按钮的功能不可用的时候，失效的像素映射被使用。当因为用户用鼠标指向按钮而自动浮起时，激活的像素映射被显示。
<p> 按钮的外观和尺寸可以通过<a href="#setUsesBigPixmap">setUsesBigPixmap</a>()和<a href="#setUsesTextLabel">setUsesTextLabel</a>()来调节。当被用在<a href="qtoolbar.html">QToolBar</a>里面时，按钮会自动地调节来适合<a href="qmainwindow.html">QMainWindow</a>的设置（请参考<a href="qmainwindow.html#setUsesTextLabel">QMainWindow::setUsesTextLabel</a>()和<a href="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>()）。
<p> 工具按钮可以提供一个弹出菜单的额外选择。这个特征有时对于网页浏览器中的“后退”按钮是有用的。在按下按钮一段时间之后，一个菜单会弹出来显示所有可以后退浏览的可能页面。你可以使用<a href="#setPopup">setPopup</a>()来为QToolButton设置一个弹出菜单。默认延时是600毫秒，你可以使用<a href="#setPopupDelay">setPopupDelay</a>()来调节它。
<p> <center><img src="qdockwindow.png" alt="Toolbar with Toolbuttons"></center> <blockquote><p align="center"><em> 一个有QToolbutton的浮动的QToolbar
</em></p>
</blockquote><p> <p>也可以参考<a href="qpushbutton.html">QPushButton</a>、<a href="qtoolbar.html">QToolBar</a>、<a href="qmainwindow.html">QMainWindow</a>、<a href="guibooks.html#fowler">图形用户界面设计手册：推动按钮</a>和<a href="basic.html">基本窗口部件</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QToolButton"></a>QToolButton::QToolButton ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
</h3>
构造一个父对象为<em>parent</em>并且名称为<em>name</em>的空工具按钮。
<h3 class=fn><a name="QToolButton-2"></a>QToolButton::QToolButton ( const <a href="qiconset.html">QIconSet</a> & iconSet, const <a href="qstring.html">QString</a> & textLabel, const <a href="qstring.html">QString</a> & grouptext, <a href="qobject.html">QObject</a> * receiver, const char * slot, <a href="qtoolbar.html">QToolBar</a> * parent, const char * name = 0 )
</h3>
构造一个父对象为<em>parent</em>（必须为<a href="qtoolbar.html">QToolBar</a>）并且名称为<em>name</em>的工具按钮。
<p> 工具按钮将显示<em>iconSet</em>，它的文本标签和工具提示设置为<em>textLabel</em>并且它的状态条信息设置为<em>grouptext</em>。它将被连接到<em>receiver</em>对象的<em>slot</em>槽。
<h3 class=fn><a name="QToolButton-3"></a>QToolButton::QToolButton ( <a href="qt.html#ArrowType-enum">ArrowType</a> type, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
</h3>
把工具按钮构造为箭头按钮。ArrowType <em>type</em>定义了箭头的方向。可用的值为LeftArrow、RightArrow、UpArrow和DownArrow。
<p> 箭头按钮的自动重复默认是打开的。
<p> <em>parent</em>和<em>name</em>参数被发送给<a href="qwidget.html">QWidget</a>构造函数。
<h3 class=fn><a name="~QToolButton"></a>QToolButton::~QToolButton ()
</h3>
销毁这个对象并且释放任何被分配的资源。
<h3 class=fn>bool <a name="autoRaise"></a>QToolButton::autoRaise () const
</h3>
<p>如果自动浮起有效，返回真，否则返回假。详细情况请参考<a href="qtoolbutton.html#autoRaise-prop">“autoRaise”</a>属性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet"></a>QToolButton::iconSet () const
</h3>
<p>返回提供显示在按钮上的图标的图标集。详细情况请参考<a href="qtoolbutton.html#iconSet-prop">“iconSet”</a>属性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet-2"></a>QToolButton::iconSet ( bool on ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 从Qt 3.0开始，<a href="qiconset.html">QIconSet</a>可以包含开和关两套图标了。
<p> 为了方便移植，这个函数将忽略<em>on</em>参数并且返回<a href="#iconSet-prop">iconSet</a>属性。如果你依赖于<em>on</em>参数，你也许要把你的代码升级到QIconSet开/关机制了。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="offIconSet"></a>QToolButton::offIconSet () const
</h3>
<p>返回当按钮在“关”状态下被使用的图标集。详细情况请参考<a href="qtoolbutton.html#offIconSet-prop">“offIconSet”</a>属性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="onIconSet"></a>QToolButton::onIconSet () const
</h3>
<p>返回当按钮在“开”状态下被使用的图标集。详细情况请参考<a href="qtoolbutton.html#onIconSet-prop">“onIconSet”</a>属性。
<h3 class=fn>void <a name="openPopup"></a>QToolButton::openPopup ()
</h3>
打开（弹出）关联的弹出菜单。如果没有这样的菜单，这个函数就什么也不做。直到这个弹出菜单已经被用户关闭，这个函数才会返回。
<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a> * <a name="popup"></a>QToolButton::popup () const
</h3>
返回关联的弹出菜单，或者如果没有定义弹出菜单，返回0。
<p> <p>也可以参考<a href="#setPopup">setPopup</a>()。
<h3 class=fn>int <a name="popupDelay"></a>QToolButton::popupDelay () const
</h3>
<p>返回在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考<a href="qtoolbutton.html#popupDelay-prop">“popupDelay”</a>属性。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -