模块 java.desktop

包 javax.swing

类 DefaultListModel<E>

java.lang.Object

javax.swing.AbstractListModel <E>

javax.swing.DefaultListModel<E>

类型参数：

E - 该模型元素的类型

所有已实现的接口：

Serializable , ListModel<E>

public class DefaultListModel<E> extends AbstractListModel <E>
      

此类松散地实现了 java.util.Vector API，因为它实现了 java.util.Vector 的 1.1.x 版本，没有集合类支持，并在发生更改时通知 ListDataListener s。目前它委托给 Vector ，在未来的版本中它将是一个真正的 Collection 实现。

Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。

自从：

1.2

字段摘要

在类 javax.swing.AbstractListModel 中声明的字段

listenerList

构造方法总结

构造方法

构造方法	描述
DefaultListModel()	构造一个 DefaultListModel

方法总结

修饰符和类型	方法	描述
void	add(int index, E element)	在此list中的指定位置插入指定元素。
void	addAll(int index, Collection<? extends E> c)	从指定索引开始添加集合中存在的所有元素。
void	addAll(Collection<? extends E> c)	将集合中存在的所有元素添加到列表中。
void	addElement(E element)	将指定的组件添加到此list的末尾。
int	capacity()	返回此list的当前容量。
void	clear()	从此list中删除所有元素。
boolean	contains(Object elem)	测试指定对象是否是此list中的组件。
void	copyInto(Object[] anArray)	将此list的组件复制到指定的数组中。
E	elementAt(int index)	返回指定索引处的组件。
Enumeration<E>	elements()	返回此list的组件的枚举。
void	ensureCapacity(int minCapacity)	如有必要，增加此list的容量，以确保它至少可以容纳最小容量参数指定的组件数。
E	firstElement()	返回此list的第一个组件。
E	get(int index)	返回此list中指定位置的元素。
E	getElementAt(int index)	返回指定索引处的组件。
int	getSize()	返回此list中的组件数。
int	indexOf(Object elem)	搜索第一次出现的 elem 。
int	indexOf(Object elem, int index)	搜索第一次出现的 elem，从 index 开始搜索。
void	insertElementAt(E element, int index)	将指定元素作为组件插入此list中指定的 index 处。
boolean	isEmpty()	测试此list是否包含任何组件。
E	lastElement()	返回列表的最后一个组件。
int	lastIndexOf(Object elem)	返回最后一次出现的 elem 的索引。
int	lastIndexOf(Object elem, int index)	向后搜索 elem ，从指定的索引开始，并返回一个索引给它。
E	remove(int index)	移除此list中指定位置的元素。
void	removeAllElements()	从此list中删除所有组件并将其大小设置为零。
boolean	removeElement(Object obj)	从此list中移除参数的第一个（最低索引）出现。
void	removeElementAt(int index)	删除指定索引处的组件。
void	removeRange(int fromIndex, int toIndex)	删除指定索引范围内的组件。
E	set(int index, E element)	用指定元素替换此list中指定位置的元素。
void	setElementAt(E element, int index)	将此list的指定 index 处的组件设置为指定元素。
void	setSize(int newSize)	设置此list的大小。
int	size()	返回此list中的组件数。
Object[]	toArray()	以正确的顺序返回包含此list中所有元素的数组。
String	toString()	返回显示和标识此对象属性的字符串。
void	trimToSize()	将此list的容量修剪为列表的当前大小。

在类 javax.swing.AbstractListModel 中声明的方法

addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener

在类 java.lang.Object 中声明的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

DefaultListModel

public DefaultListModel()
            

构造一个 DefaultListModel

方法详情

getSize

public int getSize()
            

返回此list中的组件数。

此方法与 size 相同，它实现了 1.2 集合框架中定义的 List 接口。此方法与 setSize 一起存在，因此 size 可识别为 JavaBean 属性。

返回：

此list中的组件数

参见：

• size()

getElementAt

public E  getElementAt(int index)
            

返回指定索引处的组件。

笔记：尽管不推荐使用此方法，但首选方法是 get(int) ，它实现了 1.2 Collections 框架中定义的 List 接口。

参数：

index - 此list的索引

返回：

指定索引处的组件

抛出：

ArrayIndexOutOfBoundsException - 如果 index 为负数或大于此list的当前大小

参见：

• get(int)

copyInto

public void copyInto(Object [] anArray)
            

将此list的组件复制到指定的数组中。该数组必须足够大以容纳此list中的所有对象，否则将抛出 IndexOutOfBoundsException。

参数：

anArray - 组件被复制到的数组

参见：

• Vector.copyInto(Object[])

trimToSize

public void trimToSize()
            

将此list的容量修剪为列表的当前大小。

参见：

• Vector.trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)
            

如有必要，增加此list的容量，以确保它至少可以容纳最小容量参数指定的组件数。

参数：

minCapacity - 所需的最小容量

参见：

• Vector.ensureCapacity(int)

setSize

public void setSize(int newSize)
            

设置此list的大小。

参数：

newSize - 这个列表的新大小

参见：

• Vector.setSize(int)

capacity

public int capacity()
            

返回此list的当前容量。

返回：

目前的容量

参见：

• Vector.capacity()

size

public int size()
            

返回此list中的组件数。

返回：

此list中的组件数

参见：

• Vector.size()

isEmpty

public boolean isEmpty()
            

测试此list是否包含任何组件。

返回：

true 当且仅当此list没有组件时，即它的大小为零； false否则

参见：

• Vector.isEmpty()

elements

public Enumeration <E > elements()
            

返回此list的组件的枚举。

返回：

此list的组件的枚举

参见：

• Vector.elements()

contains

public boolean contains(Object  elem)
            

测试指定对象是否是此list中的组件。

参数：

elem - 一个对象

返回：

true 如果指定对象与此list中的组件相同

参见：

• Vector.contains(Object)

indexOf

public int indexOf(Object  elem)
            

搜索第一次出现的 elem 。

参数：

elem - 一个对象

返回：

此list中参数第一次出现的索引；如果未找到对象，则返回 -1

参见：

• Vector.indexOf(Object)

indexOf

public int indexOf(Object  elem, int index)
            

搜索第一次出现的 elem，从 index 开始搜索。

参数：

elem - 所需的组件

index - 开始搜索的索引

返回：

在 index 之后找到第一次出现 elem 的索引；如果在列表中找不到 elem，则返回 -1

参见：

• Vector.indexOf(Object,int)

lastIndexOf

public int lastIndexOf(Object  elem)
            

返回最后一次出现的 elem 的索引。

参数：

elem - 所需的组件

返回：

elem 在列表中最后一次出现的索引；如果未找到对象，则返回 elem

参见：

• Vector.lastIndexOf(Object)

lastIndexOf

public int lastIndexOf(Object  elem, int index)
            

向后搜索 elem ，从指定的索引开始，并返回一个索引给它。

参数：

elem - 所需的组件

index - 开始搜索的索引

返回：

elem 在此list中最后一次出现的索引，位置小于 index ；如果未找到对象，则返回 -1

参见：

• Vector.lastIndexOf(Object,int)

elementAt

public E  elementAt(int index)
            

返回指定索引处的组件。

笔记：尽管不推荐使用此方法，但首选方法是 get(int) ，它实现了 1.2 Collections 框架中定义的 List 接口。

参数：

index - 此list的索引

返回：

指定索引处的组件

抛出：

ArrayIndexOutOfBoundsException - 如果索引为负数或不小于列表的大小

参见：

• get(int)
• Vector.elementAt(int)

firstElement

public E  firstElement()
            

返回此list的第一个组件。

返回：

此list的第一个组件

抛出：

NoSuchElementException - 如果这个向量没有组件

参见：

• Vector.firstElement()

lastElement

public E  lastElement()
            

返回列表的最后一个组件。

返回：

列表的最后一个组成部分

抛出：

NoSuchElementException - 如果这个向量没有组件

参见：

• Vector.lastElement()

setElementAt

public void setElementAt(E  element, int index)
            

将此list的指定 index 处的组件设置为指定元素。该位置的前一个组件将被丢弃。

笔记：尽管不推荐使用此方法，但首选方法是 set(int,Object) ，它实现了 1.2 集合框架中定义的 List 接口。

参数：

element - 要设置的组件

index - 指定索引

抛出：

ArrayIndexOutOfBoundsException - 如果索引无效

参见：

• set(int,Object)
• Vector.setElementAt(Object,int)

removeElementAt

public void removeElementAt(int index)
            

删除指定索引处的组件。

笔记：尽管不推荐使用此方法，但首选方法是 remove(int) ，它实现了 1.2 集合框架中定义的 List 接口。

参数：

index - 要删除的对象的索引

抛出：

ArrayIndexOutOfBoundsException - 如果索引无效

参见：

• remove(int)
• Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E  element, int index)
            

将指定元素作为组件插入此list中指定的 index 处。

笔记：尽管不推荐使用此方法，但首选方法是 add(int,Object) ，它实现了 1.2 集合框架中定义的 List 接口。

参数：

element - 要插入的组件

index - 插入新组件的位置

抛出：

ArrayIndexOutOfBoundsException - 如果索引无效

参见：

• add(int,Object)
• Vector.insertElementAt(Object,int)

addElement

public void addElement(E  element)
            

将指定的组件添加到此list的末尾。

参数：

element - 要添加的组件

参见：

• Vector.addElement(Object)

removeElement

public boolean removeElement(Object  obj)
            

从此list中移除参数的第一个（最低索引）出现。

参数：

obj - 要删除的组件

返回：

true 如果参数是这个列表的一个组成部分； false否则

参见：

• Vector.removeElement(Object)

removeAllElements

public void removeAllElements()
            

从此list中删除所有组件并将其大小设置为零。

笔记：尽管不推荐使用此方法，但首选方法是 clear ，它实现了 1.2 集合框架中定义的 List 接口。

参见：

• clear()
• Vector.removeAllElements()

toString

public String  toString()
            

返回显示和标识此对象属性的字符串。

重写：

toString 在类 Object 中

返回：

此对象的字符串表示形式

toArray

public Object [] toArray()
            

以正确的顺序返回包含此list中所有元素的数组。

返回：

包含列表元素的数组

参见：

• Vector.toArray()

get

public E  get(int index)
            

返回此list中指定位置的元素。

参数：

index - 要返回的元素的索引

返回：

此list中指定位置的元素

抛出：

ArrayIndexOutOfBoundsException - 如果索引超出范围 (index < 0 || index >= size())

set

public E  set(int index, E  element)
            

用指定元素替换此list中指定位置的元素。

参数：

index - 要替换的元素的索引

element - 要存储在指定位置的元素

返回：

先前在指定位置的元素

抛出：

ArrayIndexOutOfBoundsException - 如果索引超出范围 (index < 0 || index >= size())

add

public void add(int index, E  element)
            

在此list中的指定位置插入指定元素。

参数：

index - 要插入指定元素的索引

element - 要插入的元素

抛出：

ArrayIndexOutOfBoundsException - 如果索引超出范围 (index < 0 || index > size())

remove

public E  remove(int index)
            

移除此list中指定位置的元素。返回从列表中删除的元素

参数：

index - 要删除的元素的索引

返回：

先前在指定位置的元素

抛出：

ArrayIndexOutOfBoundsException - 如果索引超出范围 (index < 0 || index >= size())

clear

public void clear()
            

从此list中删除所有元素。此调用返回后列表将为空（除非它抛出异常）。

removeRange

public void removeRange(int fromIndex, int toIndex)
            

删除指定索引范围内的组件。移除是包含在内的，因此指定范围 (1,5) 会移除索引 1 处的组件和索引 5 处的组件，以及它们之间的所有组件。

参数：

fromIndex - 范围下限的索引

toIndex - 范围上限的索引

抛出：

ArrayIndexOutOfBoundsException - 如果索引无效

IllegalArgumentException - 如果 fromIndex > toIndex

参见：

• remove(int)

addAll

public void addAll(Collection <? extends E > c)
            

将集合中存在的所有元素添加到列表中。

参数：

c - 包含要添加的元素的集合

抛出：

NullPointerException - 如果 c 为空

addAll

public void addAll(int index, Collection <? extends E > c)
            

从指定索引开始添加集合中存在的所有元素。

参数：

index - 从指定集合中插入第一个元素的索引

c - 包含要添加的元素的集合

抛出：

ArrayIndexOutOfBoundsException - 如果 index 不在当前持有的元素数量范围内

NullPointerException - 如果 c 为空