qtoolbutton.html

QT参考文档

<h3 class=fn>void <a name="setAutoRaise"></a>QToolButton::setAutoRaise ( bool&nbsp;enable )
</h3>
<p>设置自动浮起是否有效为<em>enable</em>。详细情况请参考<a href="qtoolbutton.html#autoRaise-prop">“autoRaise”</a>属性。

<h3 class=fn>void <a name="setIconSet"></a>QToolButton::setIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置提供显示在按钮上的图标的图标集。详细情况请参考<a href="qtoolbutton.html#iconSet-prop">“iconSet”</a>属性。

<h3 class=fn>void <a name="setIconSet-2"></a>QToolButton::setIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp;&nbsp;set, bool&nbsp;on )
</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开/关机制了。
<p> <p>也可以参考<a href="#iconSet-prop">iconSet</a>和<a href="qiconset.html#State-enum">QIconSet::State</a>。

<h3 class=fn>void <a name="setOffIconSet"></a>QToolButton::setOffIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp; )
</h3>
<p>设置当按钮在“关”状态下被使用的图标集。详细情况请参考<a href="qtoolbutton.html#offIconSet-prop">“offIconSet”</a>属性。

<h3 class=fn>void <a name="setOn"></a>QToolButton::setOn ( bool&nbsp;enable )<tt> [虚 槽]</tt>
</h3>
<p>设置按钮是否为开为<em>enable</em>。详细情况请参考<a href="qtoolbutton.html#on-prop">“on”</a>属性。

<h3 class=fn>void <a name="setOnIconSet"></a>QToolButton::setOnIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp; )
</h3>
<p>设置当按钮在“开”状态下被使用的图标集。详细情况请参考<a href="qtoolbutton.html#onIconSet-prop">“onIconSet”</a>属性。

<h3 class=fn>void <a name="setPopup"></a>QToolButton::setPopup ( <a href="qpopupmenu.html">QPopupMenu</a>&nbsp;*&nbsp;popup )
</h3>
把弹出菜单<em>popup</em>和这个工具按钮关联起来。
<p> 每次在工具按钮被按下一定时间之后，弹出菜单将被显示。一个经典的实例是一些网页浏览器的工具条上的“后退”按钮。如果用户点击它，浏览器简单地后退浏览到上一页。如果用户按下这个按钮一段时间，工具按钮会显示一个包含当前历史列表的菜单。
<p> 弹出菜单的所有权不会被传递给工具按钮。
<p> <p>也可以参考<a href="#popup">popup</a>()。

<h3 class=fn>void <a name="setPopupDelay"></a>QToolButton::setPopupDelay ( int&nbsp;delay )
</h3>
<p>设置在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考<a href="qtoolbutton.html#popupDelay-prop">“popupDelay”</a>属性。

<h3 class=fn>void <a name="setTextLabel"></a>QToolButton::setTextLabel ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [槽]</tt>
</h3>
<p>设置按钮的标签。详细情况请参考<a href="qtoolbutton.html#textLabel-prop">“textLabel”</a>属性。

<h3 class=fn>void <a name="setTextLabel-2"></a>QToolButton::setTextLabel ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;newLabel, bool&nbsp;tipToo )<tt> [虚 槽]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 设置按钮的标签为<em>newLabel</em>并且如果<em>tipToo</em>为真，自动地把工具提示也设置为<em>newLabel</em>。

<h3 class=fn>void <a name="setToggleButton"></a>QToolButton::setToggleButton ( bool&nbsp;enable )<tt> [虚 槽]</tt>
</h3>
<p>设置工具按钮是否是切换按钮为<em>enable</em>。详细情况请参考<a href="qtoolbutton.html#toggleButton-prop">“toggleButton”</a>属性。

<h3 class=fn>void <a name="setUsesBigPixmap"></a>QToolButton::setUsesBigPixmap ( bool&nbsp;enable )<tt> [虚 槽]</tt>
</h3>
<p>设置工具按钮是否使用大的像素映射为<em>enable</em>。详细情况请参考<a href="qtoolbutton.html#usesBigPixmap-prop">“usesBigPixmap”</a>属性。

<h3 class=fn>void <a name="setUsesTextLabel"></a>QToolButton::setUsesTextLabel ( bool&nbsp;enable )<tt> [虚 槽]</tt>
</h3>
<p>设置工具按钮是否在按钮像素映射下方显示标签为<em>enable</em>。详细情况请参考<a href="qtoolbutton.html#usesTextLabel-prop">“usesTextLabel”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="textLabel"></a>QToolButton::textLabel () const
</h3>
<p>返回按钮的标签。详细情况请参考<a href="qtoolbutton.html#textLabel-prop">“textLabel”</a>属性。

<h3 class=fn>void <a name="toggle"></a>QToolButton::toggle ()<tt> [槽]</tt>
</h3>  
切换工具按钮的状态。
<p> 这个函数对于<a href="qbutton.html#isToggleButton">非切换按钮</a>无效。
<p> <p>也可以参考<a href="#toggleButton-prop">toggleButton</a>和<a href="qbutton.html#toggled">toggled</a>()。

<h3 class=fn>bool <a name="uses3D"></a>QToolButton::uses3D () const<tt> [保护]</tt>
</h3>
如果这个按钮应该被使用浮起的边缘绘制，返回真，否则返回假。
<p>也可以参考<a href="qbutton.html#drawButton">drawButton</a>()。

<h3 class=fn>bool <a name="usesBigPixmap"></a>QToolButton::usesBigPixmap () const
</h3>
<p>如果工具按钮使用大地像素映射，返回真，否则返回假。详细情况请参考<a href="qtoolbutton.html#usesBigPixmap-prop">“usesBigPixmap”</a>属性。

<h3 class=fn>bool <a name="usesTextLabel"></a>QToolButton::usesTextLabel () const
</h3>
<p>如果工具按钮在按钮像素映射下方显示标签，返回真，否则返回假。详细情况请参考<a href="qtoolbutton.html#usesTextLabel-prop">“usesTextLabel”</a>属性。

<hr><h2>属性文档</h2>
<h3 class=fn>bool <a name="autoRaise-prop"></a>autoRaise</h3>
<p>这个属性保存的是自动浮起是否生效。
<p>默认是失效的（也就是假）。
<p>通过<a href="#setAutoRaise">setAutoRaise</a>()设置属性值并且通过<a href="#autoRaise">autoRaise</a>()来获得属性值。

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet-prop"></a>iconSet</h3> 
<p>这个属性保存的是提供显示在按钮上的图标的图标集。
<p>设置这个属性把<a href="qbutton.html#pixmap-prop">QToolButton::pixmap</a>设置为零像素映射。没有默认图标集。
<p> <p>也可以参考<a href="qbutton.html#pixmap-prop">pixmap</a>、<a href="#toggleButton-prop">toggleButton</a>和<a href="#on-prop">on</a>。
<p>通过<a href="#setIconSet">setIconSet</a>()设置属性值并且通过<a href="#iconSet">iconSet</a>()来获得属性值。

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="offIconSet-prop"></a>offIconSet</h3>
<p>这个属性保存的是当按钮在“关”状态时使用的图标集。
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 从Qt 3.0开始，<a href="qiconset.html">QIconSet</a>可以包含开和关两套图标了。现在<a href="#iconSet-prop">QToolButton::iconSet</a>属性替换了<a href="#onIconSet-prop">QToolButton::onIconSet</a>和<a href="#offIconSet-prop">QToolButton::offIconSet</a>。
<p> 为了方便移植，这个函数将忽略<em>on</em>参数并且返回<a href="#iconSet-prop">iconSet</a>属性。如果你依赖于<em>on</em>参数，你也许要把你的代码升级到QIconSet开/关机制了。
<p> <p>也可以参考<a href="#iconSet-prop">iconSet</a>和<a href="qiconset.html#State-enum">QIconSet::State</a>。
<p>通过<a href="#setOffIconSet">setOffIconSet</a>()设置属性值并且通过<a href="#offIconSet">offIconSet</a>()来获得属性值。

<h3 class=fn>bool <a name="on-prop"></a>on</h3>
<p>这个属性保存的是工具按钮是否为开。
<p>这个属性对于<a href="qbutton.html#isToggleButton">非切换按钮</a>无效。默认为假（也就是关）。
<p> <p>也可以参考<a href="#toggleButton-prop">toggleButton</a>和<a href="#toggle">toggle</a>()。
<p>通过<a href="#setOn">setOn</a>()设置属性值。

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="onIconSet-prop"></a>onIconSet</h3>
<p>这个属性保存的是当按钮在“开”状态时使用的图标集。
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 从Qt 3.0开始，<a href="qiconset.html">QIconSet</a>可以包含开和关两套图标了。现在<a href="#iconSet-prop">QToolButton::iconSet</a>属性替换了<a href="#onIconSet-prop">QToolButton::onIconSet</a>和<a href="#offIconSet-prop">QToolButton::offIconSet</a>。
<p> 为了方便移植，这个函数将忽略<em>on</em>参数并且返回<a href="#iconSet-prop">iconSet</a>属性。如果你依赖于<em>on</em>参数，你也许要把你的代码升级到QIconSet开/关机制了。
<p> <p>也可以参考<a href="#iconSet-prop">iconSet</a>和<a href="qiconset.html#State-enum">QIconSet::State</a>。
<p>通过<a href="#setOnIconSet">setOnIconSet</a>()设置属性值并且通过<a href="#onIconSet">onIconSet</a>()来获得属性值。

<h3 class=fn>int <a name="popupDelay-prop"></a>popupDelay</h3>
<p>这个属性保存的是在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。
<p>通常是在半秒左右。0值可以为工具按钮设置一个特殊区域来打开弹出菜单。
<p> <p>也可以参考<a href="#setPopup">setPopup</a>()。
<p>通过<a href="#setPopupDelay">setPopupDelay</a>()设置属性值并且通过<a href="#popupDelay">popupDelay</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="textLabel-prop"></a>textLabel</h3>
<p>这个属性保存的是按钮的标签。
<p>设置这个属性会自动地设置这个文本为工具提示。
<p>通过<a href="#setTextLabel">setTextLabel</a>()设置属性值并且通过<a href="#textLabel">textLabel</a>()来获得属性值。

<h3 class=fn>bool <a name="toggleButton-prop"></a>toggleButton</h3>
<p>这个属性保存的是工具按钮是否是切换按钮。
<p>切换按钮像<a href="qcheckbox.html">检查框</a>一样也有开/关状态。默认情况下，工具按钮不是切换按钮。
<p> <p>也可以参考<a href="#on-prop">on</a>和<a href="#toggle">toggle</a>()。
<p>通过<a href="#setToggleButton">setToggleButton</a>()设置属性值。

<h3 class=fn>bool <a name="usesBigPixmap-prop"></a>usesBigPixmap</h3>
<p>这个属性保存的是工具按钮是否使用大的像素映射。
<p>QToolButton自动地链接这个属性到它所在的<a href="qmainwindow.html">QMainWindow</a>中的相应信号。我们强烈建议你使用<a href="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>()来替代它。
<p> 这个属性默认为真。
<p> <b>警告：</b> 如果你设置一些按钮（在QMainWindow中）使用大的像素映射并且其它的使用小的像素映射，QMainWindow可能不能得到正确的几何形状。
<p>通过<a href="#setUsesBigPixmap">setUsesBigPixmap</a>()设置属性值并且通过<a href="#usesBigPixmap">usesBigPixmap</a>()来获得属性值。

<h3 class=fn>bool <a name="usesTextLabel-prop"></a>usesTextLabel</h3>
<p>这个属性保存的是工具按钮是否在按钮像素映射下方显示标签。
<p>默认为假。
<p> QToolButton自动地链接这个槽到它所在的<a href="qmainwindow.html">QMainWindow</a>中的相应信号。
<p>通过<a href="#setUsesTextLabel">setUsesTextLabel</a>()设置属性值并且通过<a href="#usesTextLabel">usesTextLabel</a>()来获得属性值。
<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>