📄 qbutton.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/qbutton.cpp:125 -->
<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>QButton类</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>QButton类参考</h1>
<p>QButton类是按钮窗口部件的抽象基类，提供了按钮所共有的功能。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qbutton-h.html">qbutton.h</a>></tt>
<p>继承了<a href="qwidget.html">QWidget</a>。
<p>被<a href="qcheckbox.html">QCheckBox</a>、<a href="qpushbutton.html">QPushButton</a>、<a href="qradiobutton.html">QRadioButton</a>和<a href="qtoolbutton.html">QToolButton</a>继承。
<p><a href="qbutton-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QButton"><b>QButton</b></a> ( QWidget * parent = 0, const char * name = 0, WFlags f = 0 )</div></li>
<li><div class=fn><a href="#~QButton"><b>~QButton</b></a> ()</div></li>
<li><div class=fn>QString <a href="#text"><b>text</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const QString & )</div></li>
<li><div class=fn>const QPixmap * <a href="#pixmap"><b>pixmap</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( const QPixmap & )</div></li>
<li><div class=fn>QKeySequence <a href="#accel"><b>accel</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setAccel"><b>setAccel</b></a> ( const QKeySequence & )</div></li>
<li><div class=fn>bool <a href="#isToggleButton"><b>isToggleButton</b></a> () const</div></li>
<li><div class=fn>enum <a href="#ToggleType-enum"><b>ToggleType</b></a> { SingleShot, Toggle, Tristate }</div></li>
<li><div class=fn>ToggleType <a href="#toggleType"><b>toggleType</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setDown"><b>setDown</b></a> ( bool )</div></li>
<li><div class=fn>bool <a href="#isDown"><b>isDown</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isOn"><b>isOn</b></a> () const</div></li>
<li><div class=fn>enum <a href="#ToggleState-enum"><b>ToggleState</b></a> { Off, NoChange, On }</div></li>
<li><div class=fn>ToggleState <a href="#state"><b>state</b></a> () const</div></li>
<li><div class=fn>bool autoResize () const <em>(obsolete)</em></div></li>
<li><div class=fn>void setAutoResize ( bool ) <em>(obsolete)</em></div></li>
<li><div class=fn>bool <a href="#autoRepeat"><b>autoRepeat</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setAutoRepeat"><b>setAutoRepeat</b></a> ( bool )</div></li>
<li><div class=fn>bool <a href="#isExclusiveToggle"><b>isExclusiveToggle</b></a> () const</div></li>
<li><div class=fn>QButtonGroup * <a href="#group"><b>group</b></a> () const</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>void <a href="#animateClick"><b>animateClick</b></a> ()</div></li>
<li><div class=fn>void <a href="#toggle"><b>toggle</b></a> ()</div></li>
</ul>
<h2>信号</h2>
<ul>
<li><div class=fn>void <a href="#pressed"><b>pressed</b></a> ()</div></li>
<li><div class=fn>void <a href="#released"><b>released</b></a> ()</div></li>
<li><div class=fn>void <a href="#clicked"><b>clicked</b></a> ()</div></li>
<li><div class=fn>void <a href="#toggled"><b>toggled</b></a> ( bool on )</div></li>
<li><div class=fn>void <a href="#stateChanged"><b>stateChanged</b></a> ( int state )</div></li>
</ul>
<h2>属性</h2>
<ul>
<li><div class=fn>QKeySequence <a href="#accel-prop"><b>accel</b></a> - 与按钮有关的快捷键</div></li>
<li><div class=fn>bool <a href="#autoRepeat-prop"><b>autoRepeat</b></a> - 是否能够自动重复</div></li>
<li><div class=fn>bool autoResize - 是否能够自动重定义大小 <em>（废弃的）</em></div></li>
<li><div class=fn>bool <a href="#down-prop"><b>down</b></a> - 按钮是否被按下</div></li>
<li><div class=fn>bool <a href="#exclusiveToggle-prop"><b>exclusiveToggle</b></a> - 按钮是否是排它的 <em>（只读）</em></div></li>
<li><div class=fn>bool <a href="#on-prop"><b>on</b></a> - 按钮是否被切换 <em>（只读）</em></div></li>
<li><div class=fn>QPixmap <a href="#pixmap-prop"><b>pixmap</b></a> - 在按钮上显示的像素映射</div></li>
<li><div class=fn>QString <a href="#text-prop"><b>text</b></a> - 在按钮上显示的文本</div></li>
<li><div class=fn>bool <a href="#toggleButton-prop"><b>toggleButton</b></a> - 按钮是否是一个切换按钮 <em>（只读）</em></div></li>
<li><div class=fn>ToggleState <a href="#toggleState-prop"><b>toggleState</b></a> - 按钮是否被切换 <em>（只读）</em></div></li>
<li><div class=fn>ToggleType <a href="#toggleType-prop"><b>toggleType</b></a> - 按钮的切换类型 <em>（只读）</em></div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn>void <a href="#setToggleButton"><b>setToggleButton</b></a> ( bool b )</div></li>
<li><div class=fn>virtual void <a href="#setToggleType"><b>setToggleType</b></a> ( ToggleType type )</div></li>
<li><div class=fn>void <a href="#setOn"><b>setOn</b></a> ( bool on )</div></li>
<li><div class=fn>virtual void <a href="#setState"><b>setState</b></a> ( ToggleState s )</div></li>
<li><div class=fn>virtual bool <a href="#hitButton"><b>hitButton</b></a> ( const QPoint & pos ) const</div></li>
<li><div class=fn>virtual void <a href="#drawButton"><b>drawButton</b></a> ( QPainter * )</div></li>
<li><div class=fn>virtual void <a href="#drawButtonLabel"><b>drawButtonLabel</b></a> ( QPainter * )</div></li>
<li><div class=fn>virtual void <a href="#paintEvent"><b>paintEvent</b></a> ( QPaintEvent * )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
<p> QButton类是按钮窗口部件的抽象基类，提供了按钮所共有的功能。
<p>
<p> <b>如果你想创建一个按钮，请使用<a href="qpushbutton.html">QPushButton</a>。</b>
<p> QButton类实现了一个<em>抽象</em>按钮，并且让它的子类来指定如何回复用户的行为和如何画按钮。
<p> QButton提供了推动和切换按钮。<a href="qradiobutton.html">QRadioButton</a>和<a href="qcheckbox.html">QCheckBox</a>类只提供了切换按钮，QPushButton和<a href="qtoolbutton.html">QToolButton</a>提供了切换按钮和推动按钮。
<p> 任何按钮都可以有一个文本的或者像素映射的标签。<a href="#setText">setText</a>()设置按钮为一个文本按钮并且<a href="#setPixmap">setPixmap</a>()设置它为一个像素映射按钮。文本/像素映射的使用中需要创建当按钮被取消使用时所需的“失效的”外观。
<p> QButton提供了按钮所要用到的绝大多数状态：
<ul>
<li> <a href="#isDown">isDown</a>()决定按钮是否被<em>按</em>下。
<li> <a href="#isOn">isOn</a>()决定按钮是否是<em>开的</em>。只有切换按钮才能被切换为开或关（请看下面）。
<li> <a href="qwidget.html#isEnabled">isEnabled</a>()决定按钮是否可以被用户按下。
<li> <a href="#setAutoRepeat">setAutoRepeat</a>()决定如果用户按下按钮，按钮是否可以自动回复。
<li> <a href="#setToggleButton">setToggleButton</a>()决定按钮是否是一个切换按钮。
</ul>
<p> isDown()和isOn()的不同点如下：
当用户点击一个切换按钮并且把它切换为开，按钮首先被<em>按下</em>并且然后被释放变为<em>开</em>状态。当用户再次点击（切换为关），按钮首先移动到被<em>按下</em>状态，然后变为<em>关</em>状态（isOn()和isDown()都为假）。
<p> 默认按钮（在很多对话框中被使用的）由<a href="qpushbutton.html#setDefault">QPushButton::setDefault</a>()和<a href="qpushbutton.html#setAutoDefault">QPushButton::setAutoDefault</a>()提供。
<p> QButton提供五个信号：
<ol type=1>
<li> 当鼠标光标在按钮内，鼠标左键被按下时，<a href="#pressed">pressed</a>()被发送。
<li> 当鼠标左键被释放时，<a href="#released">released</a>()被发送。
<li> 当按钮首先被按下然后又被释放或者快捷键被按下，或者当<a href="#animateClick">animateClick</a>()被调用时，<a href="#clicked">clicked</a>()被发送。
<li> 当切换按钮的状态变化时，<a href="#toggled">toggled</a>(bool)被发送。
<li> 当一个三态切换按钮的状态变化时，<a href="#stateChanged">stateChanged</a>(int)被发送。
</ol>
<p> 如果一个文本按钮的文本中有“&”，QButton会创建一个自动快捷键。下面的代码创建一个标签为“Rock & Roll”（c下面有下划线）的推动按钮。这个按钮有一个自动快捷键，Alt+C：
<p> <pre>
<a href="qpushbutton.html">QPushButton</a> *p = new <a href="qpushbutton.html">QPushButton</a>( "Ro&ck && Roll", this );
</pre>
<p> 在这个实例中，当用户按下Alt+C时，按钮将会调用animateClick()。
<p> 你也可以使用<a href="#setAccel">setAccel</a>()函数来设置一个定制的快捷键。这个对于绝大多数像素映射按钮是很有用的，因为它们没有自动快捷键。
<p> <pre>
<a href="qpushbutton.html">QPushButton</a> *p;
p-><a href="#setPixmap">setPixmap</a>( QPixmap("print.png") );
p-><a href="#setAccel">setAccel</a>( ALT+Key_F7 );
</pre>
<p> Qt所提供的所有按钮（<a href="qpushbutton.html">QPushButton</a>、<a href="qtoolbutton.html">QToolButton</a>、<a href="qcheckbox.html">QCheckBox</a>和<a href="qradiobutton.html">QRadioButton</a>）都能够既显示文本也显示像素映射。
<p> 为了继承QButton，你至少不得不重新实现<a href="#drawButton">drawButton</a>()（绘制按钮的外形）和<a href="#drawButtonLabel">drawButtonLabel</a>()（绘制它的文本或像素映射）。通常也被建议重新实现<a href="qwidget.html#sizeHint">sizeHint</a>()，并且有时也被建议重新实现<a href="#hitButton">hitButton</a>()（为了决定一个按钮按下是否在按钮内）。
<p> 为了减少闪烁，<a href="#paintEvent">QButton::paintEvent</a>()设置drawButton()中所要画的一个像素映射。你不用在QButton的子类中重新实现<a href="#paintEvent">paintEvent</a>()，除非你想接管全部的绘制工作。
<p> <p>也可以参考<a href="qbuttongroup.html">QButtonGroup</a>和<a href="abstractwidgets.html">抽象窗口部件类</a>。
<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="ToggleState-enum"></a>QButton::ToggleState</h3>
<p> 这个枚举类型定义了一个切换按钮在任何时候的状态。可能的值如下：
<ul>
<li><tt>QButton::Off</tt> - 按钮在“关”状态
<li><tt>QButton::NoChange</tt> - 按钮在默认/未改变状态
<li><tt>QButton::On</tt> - 按钮在“开”状态
</ul>
<h3 class=fn><a name="ToggleType-enum"></a>QButton::ToggleType</h3>
<p> 这个枚举类型定义了按钮对一个鼠标/键盘按下可以做什么响应：
<ul>
<li><tt>QButton::SingleShot</tt> - 按下按钮导致一个行为，然后按钮返回一个未按下状态。
<li><tt>QButton::Toggle</tt> - 按下按钮，在<a href="#ToggleState-enum">On</a>和<a href="#ToggleState-enum">Off</a>状态中切换。
<li><tt>QButton::Tristate</tt> - 按下按钮，在<a href="#ToggleState-enum">On</a>、<a href="#ToggleState-enum">Off</a>和<a href="#ToggleState-enum">NoChange</a>状态中循环。
</ul><p>
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QButton"></a>QButton::QButton ( <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 )
</h3>
构造一个父对象为<em>parent</em>并且名称为<em>name</em>，使用窗口部件标记<em>f</em>的标准按钮。
<p> 如果<em>parent</em>是一个<a href="qbuttongroup.html">QButtonGroup</a>，这个构造函数将调用<a href="qbuttongroup.html#insert">QButtonGroup::insert</a>()。
<h3 class=fn><a name="~QButton"></a>QButton::~QButton ()
</h3>
销毁这个按钮。
<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel"></a>QButton::accel () const
</h3><p>
返回这个按钮的相关快捷键。详细情况请参考<a href="qbutton.html#accel-prop">“accel”</a>属性。
<h3 class=fn>void <a name="animateClick"></a>QButton::animateClick ()<tt> [槽]</tt>
</h3>
执行一个自动点击：按钮被按下并且在一小段时间后被释放。
<p> <a href="#pressed">pressed</a>()、<a href="#released">released</a>()、<a href="#clicked">clicked</a>()、<a href="#toggled">toggled</a>()和<a href="#stateChanged">stateChanged</a>()信号在适当的时候被发送。
<p> 如果按钮是<a href="qwidget.html#setEnabled">失效的</a>，这个函数将不做任何事情。
<p> <p>也可以参考<a href="#accel-prop">accel</a>。
<h3 class=fn>bool <a name="autoRepeat"></a>QButton::autoRepeat () const
</h3><p>
如果autoRepeat生效，返回真，否则返回假。详细情况请参考<a href="qbutton.html#autoRepeat-prop">“autoRepeat”</a>属性。
<h3 class=fn>bool <a name="autoResize"></a>QButton::autoResize () const
</h3><p>
如果autoResize生效，返回真，否则返回假。详细情况请参考<a href="qbutton.html#autoResize-prop">“autoResize”</a>属性。
<h3 class=fn>void <a name="clicked"></a>QButton::clicked ()<tt> [信号]</tt>
</h3>
<p> 当按钮被激活时（比如，当鼠标光标在按钮中，按钮首先被按下并且然后被释放），或者当快捷键被按下时，或者<a href="#animateClick">animateClick</a>()被调用时，这个信号被发送。如果你调用<a href="#setDown">setDown</a>()，这个信号<em>不</em>被发送。
<p> 如果你想把几个按钮连接到同一个槽中，<a href="qbuttongroup.html#clicked">QButtonGroup::clicked</a>()信号可以做这样的工作。
<p> <p>也可以参考<a href="#pressed">pressed</a>()、<a href="#released">released</a>()、<a href="#toggled">toggled</a>()、<a href="#autoRepeat-prop">autoRepeat</a>和<a href="#down-prop">down</a>。
<p>实例：<a href="simple-qfont-demo-walkthrough.html#x2109">fonts/simple-qfont-demo/viewer.cpp</a>、<a href="listbox-example.html#x1309">listbox/listbox.cpp</a>、<a href="clientserver-example.html#x777">network/clientserver/client/client.cpp</a>、<a href="ftpclient-example.html#x649">network/ftpclient/ftpmainwindow.cpp</a>、<a href="richtext-example.html#x581">richtext/richtext.cpp</a>、<a href="tutorial1-02.html#x2277">t2/main.cpp</a>和<a href="tutorial1-04.html#x2293">t4/main.cpp</a>。
<h3 class=fn>void <a name="drawButton"></a>QButton::drawButton ( <a href="qpainter.html">QPainter</a> * )<tt> [虚 保护]</tt>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -