qbutton.html

QT参考文档

</h3>
绘制按钮。默认实现是不做任何事。
<p> 这个虚函数是通过子类的重新实现来绘制真正的按钮。这些重新实现被假定同时在同一点调用<a href="#drawButtonLabel">drawButtonLabel</a>()。
<p> <p>也可以参考<a href="#drawButtonLabel">drawButtonLabel</a>()和<a href="#paintEvent">paintEvent</a>()。

<h3 class=fn>void <a name="drawButtonLabel"></a>QButton::drawButtonLabel ( <a href="qpainter.html">QPainter</a>&nbsp;* )<tt> [虚 保护]</tt>
</h3>
绘制按钮文本或者像素映射。
<p> 这个虚函数是通过子类的重新实现来绘制真正的按钮。它是由<a href="#drawButton">drawButton</a>()调用的。
<p> <p>也可以参考<a href="#drawButton">drawButton</a>()和<a href="#paintEvent">paintEvent</a>()。

<h3 class=fn><a href="qbuttongroup.html">QButtonGroup</a>&nbsp;* <a name="group"></a>QButton::group () const
</h3> 
返回这个按钮所属的按钮组的指针。
<p> 如果这个按钮不是任何一个<a href="qbuttongroup.html">QButtonGroup</a>的成员，这个函数返回0。
<p> <p>也可以参考<a href="qbuttongroup.html">QButtonGroup</a>。

<h3 class=fn>bool <a name="hitButton"></a>QButton::hitButton ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos ) const<tt> [虚 保护]</tt>
</h3>
如果<em>pos</em>在可以点击的按钮的矩形中，返回真，或者如果在外面返回假。
<p> 默认情况下，可点击区域是整个窗口部件。尽管子类可以重新实现它。

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

<h3 class=fn>bool <a name="isExclusiveToggle"></a>QButton::isExclusiveToggle () const
</h3><p>
如果按钮是排它的，返回真，否则返回假。详细情况请参考<a href="qbutton.html#exclusiveToggle-prop">“exclusiveToggle”</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>void <a name="paintEvent"></a>QButton::paintEvent ( <a href="qpaintevent.html">QPaintEvent</a>&nbsp;* )<tt> [虚 保护]</tt>
</h3>
<a href="#drawButtonLabel">drawButtonLabel</a>().
处理按钮的绘制事件。小的和有代表性的复杂按钮被使用双缓存绘制来减少闪烁。实际的绘制是在虚函数<a href="#drawButton">drawButton</a>()和<a href="#drawButtonLabel">drawButtonLabel</a>()中完成的。
<p> <p>也可以参考<a href="#drawButton">drawButton</a>()和<a href="#drawButtonLabel">drawButtonLabel</a>()。
<p>从<a href="qwidget.html#paintEvent">QWidget</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>void <a name="pressed"></a>QButton::pressed ()<tt> [信号]</tt>
</h3>
当按钮被按下的时候，这个信号被发送。
<p> <p>也可以参考<a href="#released">released</a>()和<a href="#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="#pressed">pressed</a>()、<a href="#clicked">clicked</a>()和<a href="#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="setAutoRepeat"></a>QButton::setAutoRepeat ( bool )<tt> [虚]</tt>
</h3><p>
设置autoRepeat是否生效。详细情况请参考<a href="qbutton.html#autoRepeat-prop">“autoRepeat”</a>属性。

<h3 class=fn>void <a name="setAutoResize"></a>QButton::setAutoResize ( bool )
</h3><p>
设置autoResize是否生效。详细情况请参考<a href="qbutton.html#autoResize-prop">“autoResize”</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="setOn"></a>QButton::setOn ( bool&nbsp;on )<tt> [protected]</tt>
</h3> 
<p> 当<em>on</em>为真，设置这个按钮的状态为开，否则为关。
<p> <p>也可以参考<a href="#toggleState-prop">toggleState</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="setState"></a>QButton::setState ( <a href="qbutton.html#ToggleState-enum">ToggleState</a>&nbsp;s )<tt> [虚 保护]</tt>
</h3>
<p> 设置按钮的状态为<em>s</em>。<em>s</em>可以为<a href="#ToggleState-enum">Off</a>、<a href="#ToggleState-enum">NoChange</a>或<a href="#ToggleState-enum">On</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>QButton::setToggleButton ( bool&nbsp;b )<tt> [protected]</tt>
</h3>
<p> 如果<em>b</em>为真，这个按钮变为一个切换按钮，如果<em>b</em>为假，这个按钮变为一个普通按钮。
<p> <p>也可以参考<a href="#toggleButton-prop">toggleButton</a>。

<h3 class=fn>void <a name="setToggleType"></a>QButton::setToggleType ( <a href="qbutton.html#ToggleType-enum">ToggleType</a>&nbsp;type )<tt> [虚 保护]</tt>
</h3>
设置按钮的切换类型为<em>type</em>。
<p> <em>type</em>可以被设置为<a href="#ToggleType-enum">SingleShot</a>、<a href="#ToggleType-enum">Toggle</a>和<tt>TriState</tt>。

<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="#toggle">toggle</a>()槽激活，或者因为<a href="#setState">setState</a>()或<a href="#setOn">setOn</a>()被调用。
<p> <p>也可以参考<a href="#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="#setOn">setOn</a>()、<a href="#toggled">toggled</a>()和<a href="#toggleButton-prop">toggleButton</a>。

<h3 class=fn><a href="qbutton.html#ToggleType-enum">ToggleType</a> <a name="toggleType"></a>QButton::toggleType () const
</h3>
<p>返回按钮的切换类型。详细情况请参考<a href="qbutton.html#toggleType-prop">“toggleType”</a>属性。

<h3 class=fn>void <a name="toggled"></a>QButton::toggled ( bool&nbsp;on )<tt> [信号]</tt>
</h3>
只要切换按钮改变状态，这个信号就被发送。如果按钮是开的，<em>on</em>为真，或者如果按钮是关的，<em>on</em>为假。
<p> 这也许是一个用户行为的结果，<a href="#toggle">toggle</a>()槽被激活，或者因为<a href="#setOn">setOn</a>()被调用。
<p> <p>也可以参考<a href="#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="autoRepeat-prop"></a>autoRepeat</h3>
<p>这个属性保存的是autoRepeat是否生效。
<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="autoResize-prop"></a>autoResize</h3> 
<p>这个属性保存的是autoResize是否生效。
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 如果autoResize生效，那么只要内容发生改变，按钮就会重新定义自己的大小。
<p>使用<a href="#setAutoResize">setAutoResize</a>()来设置这个属性值并且使用<a href="#autoResize">autoResize</a>()来得到这个属性值。

<h3 class=fn>bool <a name="down-prop"></a>down</h3> 
<p>这个属性保存的是按钮是否被按下。
<p>如果这个属性为真，按钮就被设置为被按下。如果你设置这个属性为真，信号<a href="#pressed">pressed</a>()和<a href="#clicked">clicked</a>()就不会被发送。这个属性默认为假。
<p>使用<a href="#setDown">setDown</a>()来设置这个属性值并且使用<a href="#isDown">isDown</a>()来得到这个属性值。

<h3 class=fn>bool <a name="exclusiveToggle-prop"></a>exclusiveToggle</h3> 
<p>这个属性保存的是按钮是否是排它的。
<p>如果这个属性为真并且这个按钮在一个<a href="qbuttongroup.html">QButtonGroup</a>里，这个按钮只有在其它按钮之一被切换为开的时候，它自己才能被切换为关。这个属性默认为假。
<p>使用<a href="#isExclusiveToggle">isExclusiveToggle</a>()来得到这个属性值。

<h3 class=fn>bool <a name="on-prop"></a>on</h3> 
<p>这个属性保存的是按钮是否被切换。
<p>这个属性只有对于切换按钮才能被设置。
<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="#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>如果按钮没有文本，这个属性将返回一个零字符串。如果文本中有一个“&amp;”，那么一个使用紧随“&amp;”之后的字母的快捷键将被创建。
<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>默认值为假。
<p>使用<a href="#isToggleButton">isToggleButton</a>()来得到这个属性值。

<h3 class=fn><a href="qbutton.html#ToggleState-enum">ToggleState</a> <a name="toggleState-prop"></a>toggleState</h3> <p>这个属性保存的是按钮是否被切换。
<p>如果这个属性被改变，那么它不会导致按钮被重新绘制。
<p>使用<a href="#state">state</a>()来得到这个属性值。

<h3 class=fn><a href="qbutton.html#ToggleType-enum">ToggleType</a> <a name="toggleType-prop"></a>toggleType</h3> <p>这个属性保存的是按钮的切换类型。
<p>默认切换类型是SingleShot。
<p>使用<a href="#toggleType">toggleType</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>