qpushbutton.html

这是qt3的帮助文档的中文版

<h3 class=fn>bool <a name="isMenuButton"></a>QPushButton::isMenuButton () const
</h3>
<p>如果这个推动按钮有一个菜单按钮在上面，返回真，否则返回假。详细情况请参考<a href="qpushbutton.html#menuButton-prop">“menuButton”</a>属性。

<h3 class=fn>bool <a name="isOn"></a>QButton::isOn () const
</h3>
<p>如果按钮被切换，返回真，否则返回假。详细情况请参考<a href="qbutton.html#on-prop">“on”</a>属性。

<h3 class=fn>bool <a name="isToggleButton"></a>QButton::isToggleButton () const
</h3>
<p>如果按钮是一个切换按钮，返回真，否则返回假。详细情况请参考<a href="qbutton.html#toggleButton-prop">“toggleButton”</a>属性。

<h3 class=fn>const&nbsp;<a href="qpixmap.html">QPixmap</a>&nbsp;* <a name="pixmap"></a>QButton::pixmap () const
</h3>
<p>返回这个按钮上显示的像素映射。详细情况请参考<a href="qbutton.html#pixmap-prop">“pixmap”</a>属性。

<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a>&nbsp;* <a name="popup"></a>QPushButton::popup () const
</h3>
返回这个按钮关联的弹出菜单或者如果没有弹出菜单被定义，返回0。
<p> <p>也可以参考<a href="#setPopup">setPopup</a>()。

<h3 class=fn>void <a name="pressed"></a>QButton::pressed ()<tt> [信号]</tt>
</h3>
当这个按钮被按下，这个信号被发射。
<p> <p>也可以参考<a href="qbutton.html#released">released</a>()和<a href="qbutton.html#clicked">clicked</a>()。
<p>实例：<a href="httpd-example.html#x636">network/httpd/httpd.cpp</a>和<a href="popup-example.html#x1572">popup/popup.cpp</a>。

<h3 class=fn>void <a name="released"></a>QButton::released ()<tt> [信号]</tt>
</h3>
当这个按钮被释放，这个信号被发射。
<p> <p>也可以参考<a href="qbutton.html#pressed">pressed</a>()、<a href="qbutton.html#clicked">clicked</a>()和<a href="qbutton.html#toggled">toggled</a>()。

<h3 class=fn>void <a name="setAccel"></a>QButton::setAccel ( const&nbsp;<a href="qkeysequence.html">QKeySequence</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置按钮的相关快捷键。详细情况请参考<a href="qbutton.html#accel-prop">“accel”</a>属性。

<h3 class=fn>void <a name="setAutoDefault"></a>QPushButton::setAutoDefault ( bool&nbsp;autoDef )<tt> [虚]</tt>
</h3>
<p>设置这个推动按钮是否是自动默认按钮为<em>autoDef</em>。详细情况请参考<a href="qpushbutton.html#autoDefault-prop">“autoDefault”</a>。

<h3 class=fn>void <a name="setAutoRepeat"></a>QButton::setAutoRepeat ( bool )<tt> [虚]</tt>
</h3>
<p>设置autoRepeat是否生效。详细情况请参考<a href="qbutton.html#autoRepeat-prop">“autoRepeat”</a>属性。

<h3 class=fn>void <a name="setDefault"></a>QPushButton::setDefault ( bool&nbsp;def )<tt> [虚]</tt>
</h3>
<p>设置这个推动按钮是否是默认按钮为<em>def</em>。详细情况请参考<a href="qpushbutton.html#default-prop">“default”</a>属性。

<h3 class=fn>void <a name="setDown"></a>QButton::setDown ( bool )<tt> [虚]</tt>
</h3>
<p>设置按钮是否被按下。详细情况请参考<a href="qbutton.html#down-prop">“down”</a>属性。

<h3 class=fn>void <a name="setFlat"></a>QPushButton::setFlat ( bool )
</h3>
<p>设置边缘是否失效。详细情况请参考<a href="qpushbutton.html#flat-prop">“flat”</a>属性。

<h3 class=fn>void <a name="setIconSet"></a>QPushButton::setIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp; )
</h3>
<p>设置这个推动按钮上的图标。详细情况请参考<a href="qpushbutton.html#iconSet-prop">“iconSet”</a>属性。

<h3 class=fn>void <a name="setIsMenuButton"></a>QPushButton::setIsMenuButton ( bool&nbsp;enable )<tt> [虚]</tt>
</h3>
<b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

<h3 class=fn>void <a name="setOn"></a>QPushButton::setOn ( bool )<tt> [虚 槽]</tt>
</h3>
<p>设置这个推动按钮是否被切换。详细情况请参考<a href="qpushbutton.html#on-prop">“on”</a>属性。

<h3 class=fn>void <a name="setPixmap"></a>QButton::setPixmap ( const&nbsp;<a href="qpixmap.html">QPixmap</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置这个按钮上显示的像素映射。详细情况请参考<a href="qbutton.html#pixmap-prop">“pixmap”</a>属性。

<h3 class=fn>void <a name="setPopup"></a>QPushButton::setPopup ( <a href="qpopupmenu.html">QPopupMenu</a>&nbsp;*&nbsp;popup )
</h3>
把弹出菜单<em>popup</em>和这个推动按钮关联起来并且这样就把它变为一个菜单按钮。
<p> 这个弹出菜单的所有权并<em>不</em>被转让给这个推动按钮。
<p> <p>也可以参考<a href="#popup">popup</a>()。
<p>实例：<a href="qdir-example.html#x1829">qdir/qdir.cpp</a>。

<h3 class=fn>void <a name="setText"></a>QButton::setText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置这个按钮上显示的文本。详细情况请参考<a href="qbutton.html#text-prop">“text”</a>属性。

<h3 class=fn>void <a name="setToggleButton"></a>QPushButton::setToggleButton ( bool )
</h3>
<p>设置这个按钮是否是切换按钮。详细情况请参考<a href="qpushbutton.html#toggleButton-prop">“toggleButton”</a>属性。

<h3 class=fn><a href="qbutton.html#ToggleState-enum">ToggleState</a> <a name="state"></a>QButton::state () const
</h3>
<p>如果这个按钮被切换，返回真，否则返回假。详细情况请参考<a href="qbutton.html#toggleState-prop">“toggleState”</a>属性。

<h3 class=fn>void <a name="stateChanged"></a>QButton::stateChanged ( int&nbsp;state )<tt> [信号]</tt>
</h3>
只要切换按钮改变状态，这个信号就被发射。如果这个按钮是开的，<em>state</em>为2，如果它在<a href="qcheckbox.html#setTristate">“没有变化”状态</a>，为1，或者如果按钮是关的，为0。
<p> 这也许是一个用户操作、<a href="qbutton.html#toggle">toggle</a>()槽激活、<a href="qbutton.html#setState">setState</a>(),或者因为<a href="#setOn">setOn</a>()被调用的结果。
<p> <p>也可以参考<a href="qbutton.html#clicked">clicked</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QButton::text () const
</h3>
<p>返回这个按钮上显示的文本。详细情况请参考<a href="qbutton.html#text-prop">“text”</a>属性。

<h3 class=fn>void <a name="toggle"></a>QButton::toggle ()<tt> [槽]</tt>
</h3>
切换切换按钮的状态。
<p>也可以参考<a href="#on-prop">on</a>、<a href="qbutton.html#toggled">toggled</a>()和<a href="#toggleButton-prop">toggleButton</a>。

<h3 class=fn>void <a name="toggled"></a>QButton::toggled ( bool&nbsp;on )<tt> [信号]</tt>
</h3>
只要切换按钮改变状态，这个信号就被发射。如果这个按钮是开的，<em>on</em>为真，或者如果按钮是关的，为假。
<p> 这也许是一个用户操作、<a href="qbutton.html#toggle">toggle</a>()槽激活或者因为<a href="#setOn">setOn</a>()被调用的结果。
<p> <p>也可以参考<a href="qbutton.html#clicked">clicked</a>()。
<p>实例：<a href="listbox-example.html#x1310">listbox/listbox.cpp</a>。

<hr><h2>属性文档</h2>
<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel-prop"></a>accel</h3> 
<p>这个属性保存的是按钮相关的快捷键。
<p>如果没有快捷键被设置，这个属性为0。如果你设置这个属性为0，那么任何当前的快捷键都被删除。
<p>使用<a href="#setAccel">setAccel</a>()来设置属性值并且使用<a href="#accel">accel</a>()来得到属性值。

<h3 class=fn>bool <a name="autoDefault-prop"></a>autoDefault</h3> 
<p>这个属性保存的是推动按钮是否是默认按钮。
<p>如果这个属性为真，那么这个推动按钮在对话框中就是自动默认按钮。
<p> 当对话框接收到键盘输入焦点时，对话框中的自动默认阿牛自动变为默认推动按钮。
<p> 在一些图形用户界面风格中，默认按钮周围被绘制一个额外的框架，等于3个像素或更多。Qt会在自动默认按钮周围自动保留这些空间，也就是说，自动默认按钮也许回比它的大小提示稍大。
<p> 对于父对象为<a href="qdialog.html">QDialog</a>的按钮，属性默认值为真，其它为假。
<p>使用<a href="#setAutoDefault">setAutoDefault</a>()来设置属性值并且通过<a href="#autoDefault">autoDefault</a>()来获得属性值。

<h3 class=fn>bool <a name="autoMask-prop"></a>autoMask</h3> 
<p>这个属性保存的是按钮中自动面具特征是否有效。
<p>也可以参考<a href="qwidget.html#autoMask-prop">QWidget::autoMask</a>。

<h3 class=fn>bool <a name="autoRepeat-prop"></a>autoRepeat</h3>
<p>这个属性保存的是自动重复是否生效。
<p>如果autoRepeat生效，那么如果按钮是按下的，<a href="#clicked">clicked</a>()信号会被定期发送。这个属性对切换按钮没有效果。autoRepeat默认是关闭的。
<p>使用<a href="#setAutoRepeat">setAutoRepeat</a>()来设置这个属性值并且使用<a href="#autoRepeat">autoRepeat</a>()来得到这个属性值。

<h3 class=fn>bool <a name="default-prop"></a>default</h3> 
<p>这个属性保存的是推动按钮是否是默认按钮。
<p>如果这个属性被设置为真，那么如果用户在对话框中敲击回车键，这个推动按钮将被按下。
<p> 当用户按下回车键，当前默认按钮得到点击，而与当前对话框中那个窗口部件拥有键盘输入焦点无关。同一时刻只能有一个推动按钮被设置为默认按钮。这个按钮然后被显示有一个额外的框架（这依赖于图形用户界面风格）。
<p> 只有在对话框中，默认按钮行为才被提供。通常当按钮得到焦点，换行键或者空格键被按下时，按钮被点击。
<p> 这个属性默认值为假。
<p>通过<a href="#setDefault">setDefault</a>()可以设置属性值并且通过<a href="#isDefault">isDefault</a>()来获得属性值。

<h3 class=fn>bool <a name="flat-prop"></a>flat</h3> 
<p>这个属性保存的是边缘是否有效。
<p> 这个属性默认值为假。
<p>通过<a href="#setFlat">setFlat</a>()可以设置属性值并且通过<a href="#isFlat">isFlat</a>()来获得属性值。

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet-prop"></a>iconSet</h3> 
<p>这个属性保存的是推动按钮上的图标。
<p>如果这个推动按钮没有图标，这个属性将返回0。
<p>通过<a href="#setIconSet">setIconSet</a>()可以设置属性并且通过<a href="#iconSet">iconSet</a>()来获得属性值。

<h3 class=fn>bool <a name="menuButton-prop"></a>menuButton</h3> 
<p>这个属性保存的是推动按钮上是否有一个菜单按钮。
<p><b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 如果这个属性被设置为真，那么在推动按钮上会绘制一个向下的箭头来表明如果用户在箭头上点击将会弹出一个菜单。
<p>通过<a href="#isMenuButton">isMenuButton</a>()来得到属性值。

<h3 class=fn>bool <a name="on-prop"></a>on</h3> 
<p>这个属性保存的是按钮是否被切换。
<p>这个属性只有对于切换按钮才能被设置。
<p>也可以参考<a href="#on-prop">on</a>、<a href="qbutton.html#toggle">toggle</a>()、<a href="qbutton.html#toggled">toggled</a>()和<a href="#toggleButton-prop">toggleButton</a>。
<p>使用<a href="#isOn">isOn</a>()来得到这个属性值。

<h3 class=fn><a href="qpixmap.html">QPixmap</a> <a name="pixmap-prop"></a>pixmap</h3> 
<p>这个属性保存的是按钮上显示的像素映射。
<p>如果这个像素映射是单色的（也就是，它是一个<a href="qbitmap.html">QBitmap</a>或者它的<a href="qpixmap.html#depth">色深</a>为1）并且它没有一个面具，这个属性将被设置为它自己的面具。这样的目的是为了绘制透明位图，例如，这对于切换按钮是很重要的。
<p> 如果没有像素映射被设置，<a href="qbutton.html#pixmap">pixmap</a>()返回0。
<p>通过<a href="#setPixmap">setPixmap</a>()可以设置属性值并且通过<a href="#pixmap">pixmap</a>()来得到属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="text-prop"></a>text</h3> 
<p>这个属性保存的是按钮上显示的文本。
<p>如果按钮没有文本，这个属性将返回一个零字符串。如果文本中有一个“&”在里面，那么会使用“&”后面紧接着的字符自动创建快捷键。
<p> 这里没有默认文不能。
<p>通过<a href="#setText">setText</a>()可以设置属性值并且通过<a href="#text">text</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="qbutton.html#toggle">toggle</a>()、<a href="#toggleButton-prop">toggleButton</a>和<a href="qbutton.html#toggled">toggled</a>()。
<p>通过<a href="#setToggleButton">setToggleButton</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>