?? 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 + -