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

431 lines
21 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="Class AbstractListModel">Class AbstractListModel&lt;E&gt;</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>javax.swing.AbstractListModel&lt;E&gt;</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
<span class="paramLabel">参数类型</span>
</dt>
<dd>
<code>E</code> - 这个模型的元素的类型
</dd>
</dl>
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> <a href="../../javax/swing/ListModel.html" title="javax.swing中的接口">ListModel</a> &lt;E&gt;</span>
</dd>
</dl>
<dl>
<dt>
已知直接子类:
</dt>
<dd>
<span><a href="../../javax/swing/plaf/basic/BasicDirectoryModel.html" title="javax.swing.plaf.basic中的类">BasicDirectoryModel</a> <a href="../../javax/swing/DefaultComboBoxModel.html" title="javax.swing中的类">DefaultComboBoxModel</a> <a href="../../javax/swing/DefaultListModel.html" title="javax.swing中的类">DefaultListModel</a> <a href="../../javax/swing/plaf/metal/MetalFileChooserUI.DirectoryComboBoxModel.html" title="javax.swing.plaf.metal中的类">MetalFileChooserUI.DirectoryComboBoxModel</a> <a href="../../javax/swing/plaf/metal/MetalFileChooserUI.FilterComboBoxModel.html" title="javax.swing.plaf.metal中的类">MetalFileChooserUI.FilterComboBoxModel</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">AbstractListModel&lt;E&gt;</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../javax/swing/ListModel.html" title="interface in javax.swing">ListModel</a>&lt;E&gt;, <a href="../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">
<span>数据模型的抽象定义提供了一个<code>List</code>及其内容。</span>
<p> <span><strong>警告:</strong>此类的序列化对象与将来的Swing版本不兼容。</span> <span>当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。</span> <span>从1.4开始对所有JavaBeans的长期存储的支持已被添加到<code>java.beans</code>包中。</span> <span>请参阅<a href="../../java/beans/XMLEncoder.html" title="java.beans中的类"><code>XMLEncoder</code></a></span> </p>
</div> </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>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../javax/swing/event/EventListenerList.html" title="class in javax.swing.event">EventListenerList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#listenerList">listenerList</a></span></code> </td>
</tr>
</tbody>
</table> </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/AbstractListModel.html#AbstractListModel--">AbstractListModel</a></span>()</code> </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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#addListDataListener-javax.swing.event.ListDataListener-">addListDataListener</a></span>(<a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a> l)</code>
<div class="block">
将一个监听器添加到每次发生数据模型更改时通知的列表。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#fireContentsChanged-java.lang.Object-int-int-">fireContentsChanged</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source, int index0, int index1)</code>
<div class="block">
<code>AbstractListModel</code>子类必须
<b></b>该列表的一个或多个元素更改
<b></b>调用此方法。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#fireIntervalAdded-java.lang.Object-int-int-">fireIntervalAdded</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source, int index0, int index1)</code>
<div class="block">
<code>AbstractListModel</code>子类必须
<b>在将</b>一个或多个元素添加到模型
<b></b>调用此方法。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#fireIntervalRemoved-java.lang.Object-int-int-">fireIntervalRemoved</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source, int index0, int index1)</code>
<div class="block">
<code>AbstractListModel</code>子类必须
<b></b>从模型中删除一个或多个元素
<b>之后</b>调用此方法。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#getListDataListeners--">getListDataListeners</a></span>()</code>
<div class="block">
返回在此
<code>AbstractListModel</code>
<code>AbstractListModel</code>的所有列表数据监听器的
<code>AbstractListModel</code>
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>&lt;T extends <a href="../../java/util/EventListener.html" title="interface in java.util">EventListener</a>&gt;<br/>T[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/swing/AbstractListModel.html#getListeners-java.lang.Class-">getListeners</a></span>(<a href="../../java/lang/Class.html" title="class in java.lang"></a>&lt;T&gt; listenerType)</code>
<div class="block">
返回此模型上当前注册为
<code><em>Foo</em>Listener</code>的所有对象的数组。
</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/AbstractListModel.html#removeListDataListener-javax.swing.event.ListDataListener-">removeListDataListener</a></span>(<a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a> l)</code>
<div class="block">
从每次发生数据模型更改时通知的列表中移除侦听器。
</div> </td>
</tr>
</tbody>
</table>
<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>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.swing.ListModel">
<!-- --> </a> <h3>Methods inherited from interface javax.swing.<a href="../../javax/swing/ListModel.html" title="interface in javax.swing">ListModel</a></h3> <code><a href="../../javax/swing/ListModel.html#getElementAt-int-">getElementAt</a>, <a href="../../javax/swing/ListModel.html#getSize--">getSize</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="listenerList">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>listenerList</h4> <pre>protected <a href="../../javax/swing/event/EventListenerList.html" title="class in javax.swing.event">EventListenerList</a> listenerList</pre> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="AbstractListModel--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>AbstractListModel</h4> <pre>public AbstractListModel()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="addListDataListener-javax.swing.event.ListDataListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addListDataListener</h4> <pre>public void addListDataListener(<a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a> l)</pre>
<div class="block">
将一个监听器添加到每次发生数据模型更改时通知的列表。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/ListModel.html#addListDataListener-javax.swing.event.ListDataListener-">addListDataListener</a></code>在界面
<code><a href="../../javax/swing/ListModel.html" title="interface in javax.swing">ListModel</a>&lt;<a href="../../javax/swing/AbstractListModel.html" title="type parameter in AbstractListModel">E</a>&gt;</code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>l</code> - 要添加的
<code>ListDataListener</code>
</dd>
</dl> </li>
</ul> <a name="removeListDataListener-javax.swing.event.ListDataListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeListDataListener</h4> <pre>public void removeListDataListener(<a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a> l)</pre>
<div class="block">
从每次发生数据模型更改时通知的列表中移除侦听器。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/swing/ListModel.html#removeListDataListener-javax.swing.event.ListDataListener-">removeListDataListener</a></code>在界面
<code><a href="../../javax/swing/ListModel.html" title="interface in javax.swing">ListModel</a>&lt;<a href="../../javax/swing/AbstractListModel.html" title="type parameter in AbstractListModel">E</a>&gt;</code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>l</code> - 要删除的
<code>ListDataListener</code>
</dd>
</dl> </li>
</ul> <a name="getListDataListeners--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getListDataListeners</h4> <pre>public <a href="../../javax/swing/event/ListDataListener.html" title="interface in javax.swing.event">ListDataListener</a>[] getListDataListeners()</pre>
<div class="block">
返回在此
<code>AbstractListModel</code>
<code>AbstractListModel</code>的所有列表数据侦听器的
<code>AbstractListModel</code>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所有这个模型的
<code>ListDataListener</code> s或一个空数组如果没有列表数据侦听器当前注册
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.4
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/AbstractListModel.html#addListDataListener-javax.swing.event.ListDataListener-"><code>addListDataListener(javax.swing.event.ListDataListener)</code></a>
<a href="../../javax/swing/AbstractListModel.html#removeListDataListener-javax.swing.event.ListDataListener-"><code>removeListDataListener(javax.swing.event.ListDataListener)</code></a>
</dd>
</dl> </li>
</ul> <a name="fireContentsChanged-java.lang.Object-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>fireContentsChanged</h4> <pre>protected void fireContentsChanged(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source,
int index0,
int index1)</pre>
<div class="block">
<span><code>AbstractListModel</code>子类必须在列表的一个或多个元素更改<b></b>调用此方法。</span>
<span>已更改的元素由闭合间隔index0指定index1 - 包括端点。</span>
<span>请注意index0不能小于或等于index1。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> -
<code>ListModel</code>发生变化,通常是“这”
</dd>
<dd>
<code>index0</code> - 新区间的一端
</dd>
<dd>
<code>index1</code> - 新间隔的另一端
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/swing/event/EventListenerList.html" title="javax.swing.event中的类"><code>EventListenerList</code></a> <a href="../../javax/swing/DefaultListModel.html" title="javax.swing中的类"><code>DefaultListModel</code></a></span>
</dd>
</dl> </li>
</ul> <a name="fireIntervalAdded-java.lang.Object-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>fireIntervalAdded</h4> <pre>protected void fireIntervalAdded(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source,
int index0,
int index1)</pre>
<div class="block">
<span><code>AbstractListModel</code>子类必须<b>在将</b>一个或多个元素添加到模型<b></b>调用此方法。</span>
<span>新元素由闭合间隔index0指定index1 - 包含enpoints。</span>
<span>请注意index0不能小于或等于index1。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> -
<code>ListModel</code>发生变化,通常是“这”
</dd>
<dd>
<code>index0</code> - 新区间的一端
</dd>
<dd>
<code>index1</code> - 新间隔的另一端
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/swing/event/EventListenerList.html" title="javax.swing.event中的类"><code>EventListenerList</code></a> <a href="../../javax/swing/DefaultListModel.html" title="javax.swing中的类"><code>DefaultListModel</code></a></span>
</dd>
</dl> </li>
</ul> <a name="fireIntervalRemoved-java.lang.Object-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>fireIntervalRemoved</h4> <pre>protected void fireIntervalRemoved(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> source,
int index0,
int index1)</pre>
<div class="block">
<span><code>AbstractListModel</code>子类必须<b></b>从模型中删除一个或多个元素<b>之后</b>调用此方法。</span>
<span><code>index0</code><code>index1</code>是已被删除的间隔的终点。</span>
<span>请注意, <code>index0</code>不能小于等于<code>index1</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> -
<code>ListModel</code>改变了,通常是“这个”
</dd>
<dd>
<code>index0</code> - 删除间隔的一端,包括
<code>index0</code>
</dd>
<dd>
<code>index1</code> - 删除间隔的另一端,包括
<code>index1</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../javax/swing/event/EventListenerList.html" title="javax.swing.event中的类"><code>EventListenerList</code></a> <a href="../../javax/swing/DefaultListModel.html" title="javax.swing中的类"><code>DefaultListModel</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getListeners-java.lang.Class-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getListeners</h4> <pre>public &lt;T extends <a href="../../java/util/EventListener.html" title="interface in java.util">EventListener</a>&gt; T[] getListeners(<a href="../../java/lang/Class.html" title="class in java.lang"></a>&lt;T&gt; listenerType)</pre>
<div class="block">
<span>返回此模型上当前注册为<code><em>Foo</em>Listener</code>的所有对象的数组。</span>
<span><code><em>Foo</em>Listener</code>是使用<code>add<em>Foo</em>Listener</code>方法进行注册。</span>
<p> <span>您可以使用类文字指定<code>listenerType</code>参数,例如<code><em>Foo</em>Listener.class</code></span> <span>例如,您可以使用以下代码查询其列表数据监听器列表模型<code>m</code> </span> </p>
<pre> <span>ListDataListener[] ldls = (ListDataListener[])(m.getListeners(ListDataListener.class));</span> </pre>
<span>如果没有这样的侦听器存在,这个方法返回一个空数组。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>listenerType</code> - 所请求的听众的类型;</span>
<span>此参数应指定从<code>java.util.EventListener</code>下降的<code>java.util.EventListener</code></span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
在该模型上注册为
<code><em>Foo</em>Listener</code>的所有对象的数组,如果没有添加此类侦听器,则为空数组
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ClassCastException.html" title="class in java.lang">ClassCastException</a></code> - 如果
<code>listenerType</code>没有指定实现java.util.EventListener的类或
<code>java.util.EventListener</code>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/swing/AbstractListModel.html#getListDataListeners--"><code>getListDataListeners()</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>