📄 qrangecontrol.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/qrangecontrol.cpp:43 -->
<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>QRangeControl类</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>QRangeControl类参考</h1>
<p>QRangeControl类提供了一个范围内的一个整数值。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qrangecontrol-h.html">qrangecontrol.h</a>></tt>
<p>由<a href="qdial.html">QDial</a>、<a href="qscrollbar.html">QScrollBar</a>、<a href="qslider.html">QSlider</a>和<a href="qspinbox.html">QSpinBox</a>继承。
<p><a href="qrangecontrol-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QRangeControl"><b>QRangeControl</b></a> ()</div></li>
<li><div class=fn><a href="#QRangeControl-2"><b>QRangeControl</b></a> ( int minValue, int maxValue, int lineStep, int pageStep, int value )</div></li>
<li><div class=fn>virtual <a href="#~QRangeControl"><b>~QRangeControl</b></a> ()</div></li>
<li><div class=fn>int <a href="#value"><b>value</b></a> () const</div></li>
<li><div class=fn>void <a href="#setValue"><b>setValue</b></a> ( int value )</div></li>
<li><div class=fn>void <a href="#addPage"><b>addPage</b></a> ()</div></li>
<li><div class=fn>void <a href="#subtractPage"><b>subtractPage</b></a> ()</div></li>
<li><div class=fn>void <a href="#addLine"><b>addLine</b></a> ()</div></li>
<li><div class=fn>void <a href="#subtractLine"><b>subtractLine</b></a> ()</div></li>
<li><div class=fn>int <a href="#minValue"><b>minValue</b></a> () const</div></li>
<li><div class=fn>int <a href="#maxValue"><b>maxValue</b></a> () const</div></li>
<li><div class=fn>void <a href="#setRange"><b>setRange</b></a> ( int minValue, int maxValue )</div></li>
<li><div class=fn>void <a href="#setMinValue"><b>setMinValue</b></a> ( int minVal )</div></li>
<li><div class=fn>void <a href="#setMaxValue"><b>setMaxValue</b></a> ( int maxVal )</div></li>
<li><div class=fn>int <a href="#lineStep"><b>lineStep</b></a> () const</div></li>
<li><div class=fn>int <a href="#pageStep"><b>pageStep</b></a> () const</div></li>
<li><div class=fn>void <a href="#setSteps"><b>setSteps</b></a> ( int lineStep, int pageStep )</div></li>
<li><div class=fn>int <a href="#bound"><b>bound</b></a> ( int v ) const</div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn>int <a href="#positionFromValue"><b>positionFromValue</b></a> ( int logical_val, int span ) const</div></li>
<li><div class=fn>int <a href="#valueFromPosition"><b>valueFromPosition</b></a> ( int pos, int span ) const</div></li>
<li><div class=fn>void <a href="#directSetValue"><b>directSetValue</b></a> ( int value )</div></li>
<li><div class=fn>int <a href="#prevValue"><b>prevValue</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#valueChange"><b>valueChange</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#rangeChange"><b>rangeChange</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#stepChange"><b>stepChange</b></a> ()</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QRangeControl类提供了一个范围内的一个整数值。
<p>
<p> 尽管QRangeControl最初始是为了<a href="qscrollbar.html">QScrollBar</a>窗口部件而设计的,但它也可以和像<a href="qslider.html">QSlider</a>和<a href="qspinbox.html">QSpinBox</a>这样的其它窗口部件关联使用。这里是这个类中五个主要概念:
<p> <ol type=1>
<p> <li> 当前值。这是QRangeControl所维护的一个有限制的整数。<a href="#value">value</a>()返回这个值,并且可以通过包括<a href="#setValue">setValue</a>()的几个函数来设置它。
<p> <li> 最小值。这是value()可以返回的最小值。<a href="#minValue">minValue</a>()可以返回这个值,并且可以通过<a href="#setRange">setRange</a>()或构造函数来设置它。
<p> <li> 最大值。这是value()可以返回的最大值。<a href="#maxValue">maxValue</a>()可以返回这个值,并且可以通过<a href="#setRange">setRange</a>()或构造函数来设置它。
<p> <li> 线步。这是QRangeControl所提供的比较小的两个自然步的差并且通常与用户按下方向键进行关联。线步可以由<a href="#lineStep">lineStep</a>()返回并且可以使用<a href="#setSteps">setSteps</a>()来设置。<a href="#addLine">addLine</a>()和<a href="#subtractLine">subtractLine</a>()这两个函数分别地用来给当前值增加或减少lineStep()。
<p> <li> 页步。这是QRangeControl所提供的比较大的两个自然步的差并且通常与用户按下PageUp或PageDown进行关联。页步可以由<a href="#pageStep">pageStep</a>()返回并且可以使用<a href="#setSteps">setSteps</a>()来设置。<a href="#addPage">addPage</a>()和<a href="#substractPage">substractPage</a>()这两个函数分别地用来给当前值增加或减少pageStep()。
<p> </ol>
<p> 单位(1)可以被看做事第三种步长。<a href="#setValue">setValue</a>()可以让你设置当前值为允许范围内的任何一个整数,对于<em>n</em>这一整数值,而不仅仅是<a href="#minValue">minValue</a>() + <em>n</em> * lineStep()。一些窗口部件也允许用户设置为任意值,而其它的也许只提供了lineStep()或pageStep()的倍数。
<p> QRangeControl提供了适用于在屏幕上表示范围控制的更新和信号的发射的三个虚函数,叫做<a href="#valueChange">valueChange</a>()、<a href="#rangeChange">rangeChange</a>()和<a href="#stepChange">stepChange</a>()。
<p> QRangeControl也提供了一个叫做<a href="#bound">bound</a>()的函数,它可以强制任意整数变为这个范围控制所允许的范围中。
<p> 我们建议所有继承QRangeControl的窗口部件都至少提供一个叫做valueChanged()的信号,一些窗口部件也许需要提供addStep()、<a href="#addPage">addPage</a>()、substractStep()和substractPage()做为槽。
<p> 注意如果你计划实现一个使用QRangeControl的窗口部件,你不得不使用多重继承,因为QRangeControl并不是继承于<a href="qwidget.html">QWidget</a>的。
<p>也可以参考<a href="misc.html">杂项类</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QRangeControl"></a>QRangeControl::QRangeControl ()
</h3>
构造一个最小值为0、最大值为99、线步为1、页步为10并且初始值为0的范围控制。
<h3 class=fn><a name="QRangeControl-2"></a>QRangeControl::QRangeControl ( int minValue, int maxValue, int lineStep, int pageStep, int value )
</h3>
构造一个最小值为<em>minValue</em>、最大值为<em>maxValue</em>、线步为<em>lineStep</em>、页步为<em>pageStep</em>并且初始值为<em>value</em>(已经使用<a href="#bound">bound</a>()被保证在允许范围内)的范围控制。
<h3 class=fn><a name="~QRangeControl"></a>QRangeControl::~QRangeControl ()<tt> [虚]</tt>
</h3>
销毁这个范围控制。
<h3 class=fn>void <a name="addLine"></a>QRangeControl::addLine ()
</h3>
与<tt>setValue( value() + lineStep() )</tt>相同。
<p> 如果值发生改变,那么<a href="#valueChange">valueChange</a>()被调用。
<p> <p>也可以参考<a href="#subtractLine">subtractLine</a>()、<a href="#addPage">addPage</a>()和<a href="#setValue">setValue</a>()。
<h3 class=fn>void <a name="addPage"></a>QRangeControl::addPage ()
</h3>
与<tt>setValue( value() + pageStep() )</tt>相同。
<p> 如果值发生改变,那么<a href="#valueChange">valueChange</a>()被调用。
<p> <p>也可以参考<a href="#subtractPage">subtractPage</a>()、<a href="#addLine">addLine</a>()和<a href="#setValue">setValue</a>()。
<h3 class=fn>int <a name="bound"></a>QRangeControl::bound ( int v ) const
</h3>
强制值<em>v</em>进入从<a href="#minValue">minValue</a>()到<a href="#maxValue">maxValue</a>()所确定的范围内,并且返回结果。
<p> 这个函数的提供可以让你很容易地强制转换其它数值而不是<a href="#value">value</a>()进入允许范围。你不需要为了QRangeControl本身而调用它。
<p> <p>也可以参考<a href="#setValue">setValue</a>()、<a href="#value">value</a>()、<a href="#minValue">minValue</a>()和<a href="#maxValue">maxValue</a>()。
<h3 class=fn>void <a name="directSetValue"></a>QRangeControl::directSetValue ( int value )<tt> [保护]</tt>
</h3>
不调用<a href="#valueChange">valueChange</a>()而直接设置范围控制的值为<em>value</em>。
<p> 强制新<em>value</em>进入合法范围。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -