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

<div class="header">
<div class="subTitle">
     javax.swing 
   </div>
<h2 class="title" title="Class SpinnerListModel">Class SpinnerListModel</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../javax/swing/AbstractSpinnerModel.html" title="class in javax.swing">javax.swing.AbstractSpinnerModel</a></li>
<li>
<ul class="inheritance">
<li>javax.swing.SpinnerListModel</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </dt>
<dd>
<span><a href="../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> ， <a href="../../javax/swing/SpinnerModel.html" title="javax.swing中的接口">SpinnerModel</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">SpinnerListModel</span>
extends <a href="../../javax/swing/AbstractSpinnerModel.html" title="class in javax.swing">AbstractSpinnerModel</a>
implements <a href="../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">
<span>一个简单的实现的<code>SpinnerModel</code> ，其值由数组或一个被定义<code>List</code> 。</span>
<span>例如，创建一个由一个星期几的名称的数组定义的模型：</span>
<pre>  <span>String[] days = new DateFormatSymbols().getWeekdays();
 SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));</span> </pre>
<span>此类仅存储对数组的引用或<code>List</code> ，因此如果底层序列的元素发生更改， <code>ChangeListeners</code>通过调用<code>fireStateChanged</code>通知<code>fireStateChanged</code> 。</span>
<p> <span>此模型继承了<code>ChangeListener</code> 。</span> <span>当模型的<code>value</code>或<code>list</code>属性更改时， <code>ChangeListener</code>将被通知。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.4 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/swing/JSpinner.html" title="javax.swing中的类"><code>JSpinner</code></a> ， <a href="../../javax/swing/SpinnerModel.html" title="javax.swing中的接口"><code>SpinnerModel</code></a> ， <a href="../../javax/swing/AbstractSpinnerModel.html" title="javax.swing中的类"><code>AbstractSpinnerModel</code></a> ， <a href="../../javax/swing/SpinnerNumberModel.html" title="javax.swing中的类"><code>SpinnerNumberModel</code></a> ， <a href="../../javax/swing/SpinnerDateModel.html" title="javax.swing中的类"><code>SpinnerDateModel</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.swing.AbstractSpinnerModel">
<!-- --> </a> <h3>Fields inherited from class javax.swing.<a href="../../javax/swing/AbstractSpinnerModel.html" title="class in javax.swing">AbstractSpinnerModel</a></h3> <code><a href="../../javax/swing/AbstractSpinnerModel.html#listenerList">listenerList</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#SpinnerListModel--">SpinnerListModel</a></span>()</code>
<div class="block">
              构造一个有效的空 
             <code>SpinnerListModel</code> 。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#SpinnerListModel-java.util.List-">SpinnerListModel</a></span>(<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt; values)</code>
<div class="block">
              构造一个 
             <code>SpinnerModel</code> ，其值序列由指定的List 
             <code>List</code> 。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#SpinnerListModel-java.lang.Object:A-">SpinnerListModel</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] values)</code>
<div class="block">
              构造一个 
             <code>SpinnerModel</code> ，其值序列由指定的数组定义。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== 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="t4"><span><a href="javascript:show(8);">具体的方法</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><a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#getList--">getList</a></span>()</code>
<div class="block">
              返回定义此模型序列的 
             <code>List</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#getNextValue--">getNextValue</a></span>()</code>
<div class="block">
              返回基础序列的下一个合法值 
             <code>null</code>如果值已经是最后一个元素。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#getPreviousValue--">getPreviousValue</a></span>()</code>
<div class="block">
              如果值已经是第一个元素，则返回底层序列的前一个元素或 
             <code>null</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#getValue--">getValue</a></span>()</code>
<div class="block">
              返回序列的当前元素。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#setList-java.util.List-">setList</a></span>(<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt; list)</code>
<div class="block">
              更改定义此序列的列表，并将模型 
             <code>value</code>的索引重置为零。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/SpinnerListModel.html#setValue-java.lang.Object-">setValue</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> elt)</code>
<div class="block">
              更改序列的当前元素并通知 
             <code>ChangeListeners</code> 。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.swing.AbstractSpinnerModel">
<!-- --> </a> <h3>Methods inherited from class javax.swing.<a href="../../javax/swing/AbstractSpinnerModel.html" title="class in javax.swing">AbstractSpinnerModel</a></h3> <code><a href="../../javax/swing/AbstractSpinnerModel.html#addChangeListener-javax.swing.event.ChangeListener-">addChangeListener</a>, <a href="../../javax/swing/AbstractSpinnerModel.html#fireStateChanged--">fireStateChanged</a>, <a href="../../javax/swing/AbstractSpinnerModel.html#getChangeListeners--">getChangeListeners</a>, <a href="../../javax/swing/AbstractSpinnerModel.html#getListeners-java.lang.Class-">getListeners</a>, <a href="../../javax/swing/AbstractSpinnerModel.html#removeChangeListener-javax.swing.event.ChangeListener-">removeChangeListener</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../java/lang/Object.html#clone--">clone</a>, <a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../java/lang/Object.html#notify--">notify</a>, <a href="../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../java/lang/Object.html#toString--">toString</a>, <a href="../../java/lang/Object.html#wait--">wait</a>, <a href="../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="SpinnerListModel-java.util.List-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SpinnerListModel</h4> <pre>public SpinnerListModel(<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt; values)</pre>
<div class="block">
<span>构造一个<code>SpinnerModel</code> ，其值序列由指定的List <code>List</code> 。</span>
<span>模型的初始值（ <i>当前元素</i> ）将为<code>values.get(0)</code> 。</span>
<span>如果<code>values</code>为<code>null</code>或具有零大小，则抛出<code>IllegalArugmentException</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>values</code> - 该模型所代表的序列 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>values</code>是 
            <code>null</code>或零大小 
           </dd>
</dl> </li>
</ul> <a name="SpinnerListModel-java.lang.Object:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SpinnerListModel</h4> <pre>public SpinnerListModel(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] values)</pre>
<div class="block">
<span>构造一个<code>SpinnerModel</code> ，其值序列由指定的数组定义。</span>
<span>模型的初始值为<code>values[0]</code> 。</span>
<span>如果<code>values</code>为<code>null</code>或长度为零，则会抛出<code>IllegalArgumentException</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>values</code> - 该模型所代表的序列 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>values</code>是 
            <code>null</code>或零长度 
           </dd>
</dl> </li>
</ul> <a name="SpinnerListModel--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SpinnerListModel</h4> <pre>public SpinnerListModel()</pre>
<div class="block">
<span>构造一个有效的空<code>SpinnerListModel</code> 。</span>
<span>该模型的列表将包含一个单独的<code>"empty"</code>字符串元素。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getList--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getList</h4> <pre>public <a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt; getList()</pre>
<div class="block">
            返回定义此模型序列的 
           <code>List</code> 。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             该值为 
            <code>list</code>属性 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerListModel.html#setList-java.util.List-"><code>setList(java.util.List&lt;?&gt;)</code></a>
</dd>
</dl> </li>
</ul> <a name="setList-java.util.List-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setList</h4> <pre>public void setList(<a href="../../java/util/List.html" title="interface in java.util">List</a>&lt;?&gt; list)</pre>
<div class="block">
<span>更改定义此序列的列表，并将模型<code>value</code>的索引重置为零。</span>
<span>请注意， <code>list</code>未被复制，该模型仅存储对它的引用。</span>
<p> <span>如果<code>list</code>不等于当前列表，则此方法将触发<code>ChangeEvent</code> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>list</code> - 该模型表示的序列 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>list</code>为 
            <code>null</code>或零长度 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerListModel.html#getList--"><code>getList()</code></a>
</dd>
</dl> </li>
</ul> <a name="getValue--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getValue</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getValue()</pre>
<div class="block">
            返回序列的当前元素。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/SpinnerModel.html#getValue--">getValue</a></code>在接口 
            <code><a href="../../javax/swing/SpinnerModel.html" title="interface in javax.swing">SpinnerModel</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>value</code>属性 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerModel.html#getValue--"><code>SpinnerModel.getValue()</code></a> ， 
            <a href="../../javax/swing/SpinnerListModel.html#setValue-java.lang.Object-"><code>setValue(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="setValue-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setValue</h4> <pre>public void setValue(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> elt)</pre>
<div class="block">
<span>更改序列的当前元素并通知<code>ChangeListeners</code> 。</span>
<span>如果指定的值不等于底层序列的元素，则抛出<code>IllegalArgumentException</code> 。</span>
<span>在以下示例中， <code>setValue</code>调用将导致抛出异常：</span>
<pre>  <span>String[] values = {"one", "two", "free", "four"};
 SpinnerModel model = new SpinnerListModel(values);
 model.setValue("TWO");</span> </pre>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/SpinnerModel.html#setValue-java.lang.Object-">setValue</a></code>在接口 
            <code><a href="../../javax/swing/SpinnerModel.html" title="interface in javax.swing">SpinnerModel</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>elt</code> - 将是模型当前值的序列元素 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果不允许指定的值 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerModel.html#setValue-java.lang.Object-"><code>SpinnerModel.setValue(java.lang.Object)</code></a> ， 
            <a href="../../javax/swing/SpinnerListModel.html#getValue--"><code>getValue()</code></a>
</dd>
</dl> </li>
</ul> <a name="getNextValue--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNextValue</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getNextValue()</pre>
<div class="block">
            如果值已经是最后一个元素，则返回底层序列的下一个合法值或 
           <code>null</code> 。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/SpinnerModel.html#getNextValue--">getNextValue</a></code>在接口 
            <code><a href="../../javax/swing/SpinnerModel.html" title="interface in javax.swing">SpinnerModel</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             下一个合法值的底层序列或 
            <code>null</code>如果值已经是最后一个元素 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerModel.html#getNextValue--"><code>SpinnerModel.getNextValue()</code></a> ， 
            <a href="../../javax/swing/SpinnerListModel.html#getPreviousValue--"><code>getPreviousValue()</code></a>
</dd>
</dl> </li>
</ul> <a name="getPreviousValue--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getPreviousValue</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getPreviousValue()</pre>
<div class="block">
            如果值已经是第一个元素，则返回底层序列的前一个元素或 
           <code>null</code> 。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/SpinnerModel.html#getPreviousValue--">getPreviousValue</a></code>在界面 
            <code><a href="../../javax/swing/SpinnerModel.html" title="interface in javax.swing">SpinnerModel</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             前一个元素的底层序列或 
            <code>null</code>如果值已经是第一个元素 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/swing/SpinnerModel.html#getPreviousValue--"><code>SpinnerModel.getPreviousValue()</code></a> ， 
            <a href="../../javax/swing/SpinnerListModel.html#getNextValue--"><code>getNextValue()</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>