uTools-Manuals/docs/java/javax/swing/BoundedRangeModel.html

486 lines
20 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.swing
</div>
<h2 class="title" title="Interface BoundedRangeModel">Interface BoundedRangeModel</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../javax/swing/DefaultBoundedRangeModel.html" title="javax.swing中的类">DefaultBoundedRangeModel</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">BoundedRangeModel</span></pre>
<div class="block">
<span>定义组件使用的数据模型,如<code>Slider</code> s和<code>ProgressBar</code> s。</span>
<span>定义四个相关的整数属性:最小值,最大值,范围和值。</span>
<span>这四个整数定义了两个这样的嵌套范围:</span>
<pre> <span>minimum &lt;= value &lt;= value+extent &lt;= maximum</span> </pre>
<span>外部范围为<code>minimum,maximum</code> ,内部范围为<code>value,value+extent</code></span>
<span>内范围必须位于外之一内,即<code>value</code>必须小于或等于<code>maximum</code><code>value+extent</code>必须大于或等于<code>minimum</code><code>maximum</code>必须大于或等于<code>minimum</code></span>
<span>这个模型有一些特点,可能会有一点令人惊讶。</span>
<span>存在这些怪癖是为了方便Swing BoundedRangeModel客户端<code>Slider</code><code>ScrollBar</code></span>
<ul>
<li> <span>最小和最大设置方法“正确”其他三个属性以适应其新的值参数。</span> <span>例如,设置模型的最小值可能会更改其最大值,值和范围属性(按此顺序),以维护上述约束。</span> </li>
<li> <span>值和范围集方法“纠正”他们的参数,以适应其他三个属性所定义的限制。</span> <span>例如,如果<code>value == maximum</code> <code>setExtent(10)</code>范围(返回)更改为零。</span> </li>
<li> <span>四个BoundedRangeModel值被定义为Java Beans属性但是Swing ChangeEvents用于通知客户端更改而不是PropertyChangeEvents。</span> <span>这样做是为了保持监控BoundedRangeModel的开销。</span> <span>更改通常以MouseDragged率报告。</span> </li>
</ul>
<p> <span>用于指定由滑块使用的自定义界范围模型示例,请参见<a href="http://www.oracle.com/technetwork/java/architecture-142923.html#separable">Separable model architecture</a><em>摆动架构概述。</em></span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/swing/DefaultBoundedRangeModel.html" title="javax.swing中的类"><code>DefaultBoundedRangeModel</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#addChangeListener-javax.swing.event.ChangeListener-">addChangeListener</a></span>(<a href="../../javax/swing/event/ChangeListener.html" title="interface in javax.swing.event">ChangeListener</a> x)</code>
<div class="block">
添加一个ChangeListener到模型的监听器列表。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#getExtent--">getExtent</a></span>()</code>
<div class="block">
返回模型的范围,以模型值开始的内部范围的长度。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#getMaximum--">getMaximum</a></span>()</code>
<div class="block">
返回模型的最大值。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#getMinimum--">getMinimum</a></span>()</code>
<div class="block">
返回最小可接受值。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#getValue--">getValue</a></span>()</code>
<div class="block">
返回模型的当前值。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#getValueIsAdjusting--">getValueIsAdjusting</a></span>()</code>
<div class="block">
如果当前对value属性的更改是一系列更改的一部分则返回true。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#removeChangeListener-javax.swing.event.ChangeListener-">removeChangeListener</a></span>(<a href="../../javax/swing/event/ChangeListener.html" title="interface in javax.swing.event">ChangeListener</a> x)</code>
<div class="block">
从模型的监听器列表中删除一个ChangeListener。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setExtent-int-">setExtent</a></span>(int newExtent)</code>
<div class="block">
设置模型的范围。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setMaximum-int-">setMaximum</a></span>(int newMaximum)</code>
<div class="block">
将模型的最大值设置为
<i>newMaximum</i>
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setMinimum-int-">setMinimum</a></span>(int newMinimum)</code>
<div class="block">
将模型的最小值设置为
<i>newMinimum</i>
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setRangeProperties-int-int-int-int-boolean-">setRangeProperties</a></span>(int value, int extent, int min, int max, boolean adjusting)</code>
<div class="block">
该方法通过单个方法调用来设置所有模型的数据。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setValue-int-">setValue</a></span>(int newValue)</code>
<div class="block">
如果
<code>newValue</code>满足模型的约束,
<code>newValue</code>模型的当前值设置为newValue。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/BoundedRangeModel.html#setValueIsAdjusting-boolean-">setValueIsAdjusting</a></span>(boolean b)</code>
<div class="block">
该属性表示任何即将到来的对模型值的更改都应被视为单个事件。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getMinimum--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMinimum</h4> <pre>int getMinimum()</pre>
<div class="block">
返回最小可接受值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
最小属性的值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setMinimum-int-"><code>setMinimum(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setMinimum-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMinimum</h4> <pre>void setMinimum(int newMinimum)</pre>
<div class="block">
<span>将模型的最小值设置为<i>newMinimum</i></span>
<span>其他三个属性也可以更改,以确保:</span>
<pre> <span>minimum &lt;= value &lt;= value+extent &lt;= maximum</span> </pre>
<p> <span>如果模型发生变化,通知任何听众。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>newMinimum</code> - 模型的新的最小值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#getMinimum--"><code>getMinimum()</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#addChangeListener-javax.swing.event.ChangeListener-"><code>addChangeListener(javax.swing.event.ChangeListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="getMaximum--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMaximum</h4> <pre>int getMaximum()</pre>
<div class="block">
<span>返回模型的最大值。</span>
<span>请注意,模型值的上限为(最大范围)。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
最大属性的值。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setMaximum-int-"><code>setMaximum(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setExtent-int-"><code>setExtent(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setMaximum-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMaximum</h4> <pre>void setMaximum(int newMaximum)</pre>
<div class="block">
<span>将模型的最大值设置为<i>newMaximum</i></span>
<span>另外三个属性也可以改变,以确保</span>
<pre> <span>minimum &lt;= value &lt;= value+extent &lt;= maximum</span> </pre>
<p> <span>如果模型发生变化,通知任何听众。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>newMaximum</code> - 模型的最大值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#getMaximum--"><code>getMaximum()</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#addChangeListener-javax.swing.event.ChangeListener-"><code>addChangeListener(javax.swing.event.ChangeListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="getValue--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValue</h4> <pre>int getValue()</pre>
<div class="block">
<span>返回模型的当前值。</span>
<span>请注意,模型值的上限为<code>maximum - extent</code> ,下限为<code>minimum</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
模型的价值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setValue-int-"><code>setValue(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setValue-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setValue</h4> <pre>void setValue(int newValue)</pre>
<div class="block">
<span>如果<code>newValue</code>满足模型的约束, <code>newValue</code>模型的当前值设置为newValue。</span>
<span>这些限制是:</span>
<pre> <span>minimum &lt;= value &lt;= value+extent &lt;= maximum</span> </pre>
<span>否则,如果<code>newValue</code>小于<code>minimum</code>它设置为<code>minimum</code> ,如果它大于<code>maximum</code>那么它设置为<code>maximum</code> ,如果它大于<code>value+extent</code>那么它设置为<code>value+extent</code></span>
<p> <span>当BoundedRange模型与滚动条一起使用时该值指定滚动条旋钮也称为“大拇指”或“电梯”的原点。</span> <span>该值通常表示要滚动的对象的可见部分的原点。</span> </p>
<p> <span>如果模型发生变化,通知任何听众。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>newValue</code> - 模型的新价值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#getValue--"><code>getValue()</code></a>
</dd>
</dl> </li>
</ul> <a name="setValueIsAdjusting-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setValueIsAdjusting</h4> <pre>void setValueIsAdjusting(boolean b)</pre>
<div class="block">
<span>该属性表示任何即将到来的对模型值的更改都应被视为单个事件。</span>
<span>在该值的一系列更改开始时此属性将设置为true并且在值完成更改后将其设置为false。</span>
<span>通常,这允许监听器只在提交的最终值更改时执行操作,而不必对所有中间值进行更新。</span>
<p> <span>当拖动正在进行时,滑块和滚动条使用此属性。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>b</code> - 如果值属性的即将更改是系列的一部分则为true
</dd>
</dl> </li>
</ul> <a name="getValueIsAdjusting--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValueIsAdjusting</h4> <pre>boolean getValueIsAdjusting()</pre>
<div class="block">
如果当前对value属性的更改是一系列更改的一部分则返回true。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
valueIsAdjustingProperty。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setValueIsAdjusting-boolean-"><code>setValueIsAdjusting(boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="getExtent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getExtent</h4> <pre>int getExtent()</pre>
<div class="block">
返回模型的范围,以模型值开始的内部范围的长度。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该模型的范围属性的值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setExtent-int-"><code>setExtent(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setValue-int-"><code>setValue(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setExtent-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setExtent</h4> <pre>void setExtent(int newExtent)</pre>
<div class="block">
<span>设置模型的范围。</span>
<span><i>newExtent</i>被强制为大于或等于零且小于或等于最大值。</span>
<p> <span>当BoundedRange模型与滚动条一起使用时范围定义滚动条旋钮的长度又称“大拇指”或“电梯”</span> <span>范围通常表示滚动对象的多少可见。</span> <span>当与滑块一起使用时该范围确定该值可以“跳转”多少例如当用户按PgUp或PgDn时。</span> </p>
<p> <span>如果模型发生变化,通知任何听众。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>newExtent</code> - 模型的新范围
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#getExtent--"><code>getExtent()</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setValue-int-"><code>setValue(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setRangeProperties-int-int-int-int-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRangeProperties</h4> <pre>void setRangeProperties(int value,
int extent,
int min,
int max,
boolean adjusting)</pre>
<div class="block">
<span>该方法通过单个方法调用来设置所有模型的数据。</span>
<span>该方法导致生成单个更改事件。</span>
<span>当您需要同时调整所有模型数据并且不希望发生单独的更改事件时,这很方便。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 一个int给出当前值
</dd>
<dd>
<code>extent</code> - 一个int给出值可以“跳”的量
</dd>
<dd>
<code>min</code> - 一个int给出最小值
</dd>
<dd>
<code>max</code> - 一个int给出最大值
</dd>
<dd>
<code>adjusting</code> - 一个布尔值如果正在进行一系列更改则返回true
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#setValue-int-"><code>setValue(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setExtent-int-"><code>setExtent(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setMinimum-int-"><code>setMinimum(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setMaximum-int-"><code>setMaximum(int)</code></a>
<a href="../../javax/swing/BoundedRangeModel.html#setValueIsAdjusting-boolean-"><code>setValueIsAdjusting(boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="addChangeListener-javax.swing.event.ChangeListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addChangeListener</h4> <pre>void addChangeListener(<a href="../../javax/swing/event/ChangeListener.html" title="interface in javax.swing.event">ChangeListener</a> x)</pre>
<div class="block">
添加一个ChangeListener到模型的监听器列表。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>x</code> - 要添加的ChangeListener
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#removeChangeListener-javax.swing.event.ChangeListener-"><code>removeChangeListener(javax.swing.event.ChangeListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeChangeListener-javax.swing.event.ChangeListener-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>removeChangeListener</h4> <pre>void removeChangeListener(<a href="../../javax/swing/event/ChangeListener.html" title="interface in javax.swing.event">ChangeListener</a> x)</pre>
<div class="block">
从模型的监听器列表中删除一个ChangeListener。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>x</code> - 要删除的ChangeListener
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/BoundedRangeModel.html#addChangeListener-javax.swing.event.ChangeListener-"><code>addChangeListener(javax.swing.event.ChangeListener)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>