JavaTM 2 Platform
Standard Ed. 6

javax.swing
类 AbstractListModel

java.lang.Object
  继承者 javax.swing.AbstractListModel
所有已实现的接口:
Serializable, ListModel
直接已知子类:
BasicDirectoryModel, DefaultComboBoxModel, DefaultListModel, MetalFileChooserUI.DirectoryComboBoxModel, MetalFileChooserUI.FilterComboBoxModel

public abstract class AbstractListModel
extends Object
implements ListModel, Serializable

该数据模型的抽象定义提供一个带内容的 List

警告:此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder


字段摘要
protected  EventListenerList listenerList
           
 
构造方法摘要
AbstractListModel()
           
 
方法摘要
 void addListDataListener(ListDataListener l)
          将某个侦听器添加到每次更改数据模型都要通知的列表。
protected  void fireContentsChanged(Object source, int index0, int index1)
          AbstractListModel 子类必须在列表的一个或多个元素发生更改之后调用此方法。
protected  void fireIntervalAdded(Object source, int index0, int index1)
          AbstractListModel 子类必须在将一个或多个元素添加到模型中之后调用此方法。
protected  void fireIntervalRemoved(Object source, int index0, int index1)
          AbstractListModel 子类必须在从模型中移除一个或多个元素之后调用此方法。
 ListDataListener[] getListDataListeners()
          返回已在此 AbstractListModel 上注册的所有列表数据侦听器组成的数组。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          返回目前已在此模型上注册为 FooListener 的所有对象组成的数组。
 void removeListDataListener(ListDataListener l)
          将某个侦听器从每次更改数据模型都要通知的列表中移除。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
从接口 javax.swing.ListModel 继承的方法
getElementAt, getSize
 

字段详细信息

listenerList

protected EventListenerList listenerList
构造方法详细信息

AbstractListModel

public AbstractListModel()
方法详细信息

addListDataListener

public void addListDataListener(ListDataListener l)
将某个侦听器添加到每次更改数据模型都要通知的列表。

指定者:
接口 ListModel 中的 addListDataListener
参数:
l - 要添加的 ListDataListener

removeListDataListener

public void removeListDataListener(ListDataListener l)
将某个侦听器从每次更改数据模型都要通知的列表中移除。

指定者:
接口 ListModel 中的 removeListDataListener
参数:
l - 要移除的 ListDataListener

getListDataListeners

public ListDataListener[] getListDataListeners()
返回已在此 AbstractListModel 上注册的所有列表数据侦听器组成的数组。

返回:
此模型的所有 ListDataListener,如果当前没有已注册的列表数据侦听器,则返回一个空数组。
从以下版本开始:
1.4
另请参见:
addListDataListener(javax.swing.event.ListDataListener), removeListDataListener(javax.swing.event.ListDataListener)

fireContentsChanged

protected void fireContentsChanged(Object source,
                                   int index0,
                                   int index1)
AbstractListModel 子类必须在列表的一个或多个元素发生更改之后调用此方法。更改的元素由 index0 和 index1 封闭的区间(包括端点)指定。注意,index0 不必小于或等于 index1。

参数:
source - 更改的 ListModel,通常为 "this"
index0 - 新区间的一端
index1 - 新区间的另一端
另请参见:
EventListenerList, DefaultListModel

fireIntervalAdded

protected void fireIntervalAdded(Object source,
                                 int index0,
                                 int index1)
AbstractListModel 子类必须在将一个或多个元素添加到模型中之后调用此方法。新元素由 index0 和 index1 封闭的区间(包括端点)指定。注意,index0 不必小于或等于 index1。

参数:
source - 更改的 ListModel,通常为 "this"
index0 - 新区间的一端
index1 - 新区间的另一端
另请参见:
EventListenerList, DefaultListModel

fireIntervalRemoved

protected void fireIntervalRemoved(Object source,
                                   int index0,
                                   int index1)
AbstractListModel 子类必须在从模型中移除一个或多个元素之后调用此方法。index0index1 是已移除区间的端点。注意,index0 不必小于或等于 index1

参数:
source - 更改的 ListModel,通常为 "this"
index0 - 移除区间的一端,包括 index0
index1 - 移除区间的另一端,包括 index1
另请参见:
EventListenerList, DefaultListModel

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
返回目前已在此模型上注册为 FooListener 的所有对象组成的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值来指定 listenerType 参数,如 FooListener.class。例如,可以使用以下代码查询列表模型 m,以获得其列表数据侦听器:

ListDataListener[] ldls = (ListDataListener[])(m.getListeners(ListDataListener.class));
如果不存在这样的侦听器,则此方法将返回一个空数组。

参数:
listenerType - 请求的侦听器类型;此参数应该指定一个从 java.util.EventListener 遗传下来的接口
返回:
在此模型上注册为 FooListener 的所有对象组成的数组
抛出:
ClassCastException - 如果 listenerType 未指定实现 java.util.EventListener 的类或接口。
从以下版本开始:
1.3
另请参见:
getListDataListeners()

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策