javax.swing
類別 DefaultListModel

java.lang.Object
  javax.swing.AbstractListModel
      javax.swing.DefaultListModel

所有已實作的介面：

Serializable, ListModel

public class DefaultListModel
extends AbstractListModel

此類別以鬆散方式實作 java.util.Vector API，它實作 1.1.x 版本的 java.util.Vector，沒有 collection 類別支持，並且在發生更改時通知 ListDataListener。目前，它委託給一個 Vector，在將來的版本中，它將是一個真正的 Collection 實作。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

欄位摘要

從類別 javax.swing.AbstractListModel 繼承的欄位

listenerList

建構子摘要

DefaultListModel()

方法摘要

void	add(int index, Object element) 在此列表的指定位置處插入指定元素。
void	addElement(Object obj) 將指定元件添加到此類別表的末尾。
int	capacity() 返回此列表的當前容量。
void	clear() 從此列表中移除所有元素。
boolean	contains(Object elem) 測試指定物件是否為此類別表中的元件。
void	copyInto(Object[] anArray) 將此列表的元件複製到指定陣列中。
Object	elementAt(int index) 返回指定索引處的元件。
Enumeration<?>	elements() 返回此列表的元件列舉。
void	ensureCapacity(int minCapacity) 增加此列表的容量（如有必要），以確保其至少能夠保存最小容量參數指定的元件數。
Object	firstElement() 返回此列表中的第一個元件。
Object	get(int index) 返回列表中指定位置處的元素。
Object	getElementAt(int index) 返回指定索引處的元件。
int	getSize() 返回此列表中的元件數。
int	indexOf(Object elem) 搜尋 elem 的第一次出現。
int	indexOf(Object elem, int index) 從 index 開始搜尋 elem 的第一次出現。
void	insertElementAt(Object obj, int index) 將指定物件作為此列表中的元件插入到指定的 index 處。
boolean	isEmpty() 測試此列表中是否有元件。
Object	lastElement() 返回列表的最後一個元件。
int	lastIndexOf(Object elem) 返回 elem 最後一次出現處的索引。
int	lastIndexOf(Object elem, int index) 從指定的索引處開始反向搜尋 elem，並返回該物件的索引。
Object	remove(int index) 移除此列表中指定位置處的元素。
void	removeAllElements() 從此列表中移除所有元件，並將它們的大小設置為零。
boolean	removeElement(Object obj) 從此列表中移除參數的第一個（索引最小的）比對項。
void	removeElementAt(int index) 刪除指定索引處的元件。
void	removeRange(int fromIndex, int toIndex) 刪除指定索引範圍中的元件。
Object	set(int index, Object element) 使用指定元素替換此列表中指定位置上的元素。
void	setElementAt(Object obj, int index) 將此列表指定 index 處的元件設置為指定的物件。
void	setSize(int newSize) 設置此列表的大小。
int	size() 返回此列表中的元件數。
Object[]	toArray() 以正確順序返回包含此列表中所有元素的陣列。
String	toString() 返回顯示並標識此物件的屬性的字元串。
void	trimToSize() 對此列表的容量進行裁剪，使其等於此列表的當前大小。

從類別 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()

方法詳細資訊

getSize

public int getSize()

返回此列表中的元件數。

此方法等同於 size，後者實作 1.2 Collections 框架中定義的 List 介面。此方法連同 setSize 一起存在，因此可以將 size 看作為一個 JavaBean 屬性。

返回：

此列表中的元件數

另請參見：

size()

getElementAt

public Object getElementAt(int index)

返回指定索引處的元件。

註：儘管此方法未過時，但首選使用方法是 get(int)，該方法實作 1.2 Collections 框架中定義的 List 介面。

參數：

index - 此列表中的索引

返回：

指定索引處的元件

拋出：

ArrayIndexOutOfBoundsException - 如果 index 為負或大於此列表的當前大小

另請參見：

get(int)

copyInto

public void copyInto(Object[] anArray)

將此列表的元件複製到指定陣列中。陣列必須足夠大，能夠保存此列表中的所有物件，否則拋出 IndexOutOfBoundsException。

參數：

anArray - 要將元件複製到其中的陣列

另請參見：

Vector.copyInto(Object[])

trimToSize

public void trimToSize()

對此列表的容量進行裁剪，使其等於此列表的當前大小。

另請參見：

Vector.trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)

增加此列表的容量（如有必要），以確保其至少能夠保存最小容量參數指定的元件數。

參數：

minCapacity - 所需的最小容量

另請參見：

Vector.ensureCapacity(int)

setSize

public void setSize(int newSize)

設置此列表的大小。

參數：

newSize - 此列表的新大小

另請參見：

Vector.setSize(int)

capacity

public int capacity()

返回此列表的當前容量。

返回：

當前容量

另請參見：

Vector.capacity()

size

public int size()

返回此列表中的元件數。

返回：

此列表中的元件數

另請參見：

Vector.size()

isEmpty

public boolean isEmpty()

測試此列表中是否有元件。

返回：

當且僅當此列表中沒有元件（也就是說其大小為零）時返回 true；否則返回 false

另請參見：

Vector.isEmpty()

elements

public Enumeration<?> elements()

返回此列表的元件列舉。

返回：

此列表的元件列舉

另請參見：

Vector.elements()

contains

public boolean contains(Object elem)

測試指定物件是否為此類別表中的元件。

參數：

elem - 物件

返回：

如果指定物件是此列表中的元件，則返回 true

另請參見：

Vector.contains(Object)

indexOf

public int indexOf(Object elem)

搜尋 elem 的第一次出現。

參數：

elem - 一個物件

返回：

此列表中該參數第一次出現時所在位置上的索引；如果沒有找到該物件，則返回 -1

另請參見：

Vector.indexOf(Object)

indexOf

public int indexOf(Object elem,
                   int index)

從 index 開始搜尋 elem 的第一次出現。

參數：

elem - 所需的元件

index - 從其所在的位置開始進行搜尋的索引

返回：

index 之後第一次出現 elem 處的索引；如果在列表中沒有找到 elem，則返回 -1

另請參見：

Vector.indexOf(Object,int)

lastIndexOf

public int lastIndexOf(Object elem)

返回 elem 最後一次出現處的索引。

參數：

elem - 所需的元件

返回：

列表中 elem 最後一次出現處的索引；如果沒有找到該物件，則返回 -1

另請參見：

Vector.lastIndexOf(Object)

lastIndexOf

public int lastIndexOf(Object elem,
                       int index)

從指定的索引處開始反向搜尋 elem，並返回該物件的索引。

參數：

elem - 所需的元件

index - 從其所在的位置開始進行搜尋的索引

返回：

列表中 index 之前最後一次出現 elem 處的索引；如果在列表中沒有找到該物件，則返回 -1

另請參見：

Vector.lastIndexOf(Object,int)

elementAt

public Object elementAt(int index)

返回指定索引處的元件。如果索引為負或不小於列表的大小，則拋出 ArrayIndexOutOfBoundsException。

註：儘管此方法未過時，但首選使用方法是 get(int)，該方法實作 1.2 Collections 框架中定義的 List 介面。

參數：

index - 此列表中的一個索引

返回：

指定索引處的元件

另請參見：

get(int), Vector.elementAt(int)

firstElement

public Object firstElement()

返回此列表中的第一個元件。如果此向量沒有元件，則拋出 NoSuchElementException。

返回：

此列表的第一個元件

另請參見：

Vector.firstElement()

lastElement

public Object lastElement()

返回列表的最後一個元件。如果此向量沒有元件，則拋出 NoSuchElementException。

返回：

列表的最後一個元件

另請參見：

Vector.lastElement()

setElementAt

public void setElementAt(Object obj,
                         int index)

將此列表指定 index 處的元件設置為指定的物件。丟棄該位置以前的元件。

如果索引無效，則拋出 ArrayIndexOutOfBoundsException。

註：儘管此方法未過時，但首選使用方法是 set(int,Object)，該方法實作 1.2 Collections 框架中定義的 List 介面。

參數：

obj - 元件的設置目標

index - 指定的索引

另請參見：

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

removeElementAt

public void removeElementAt(int index)

刪除指定索引處的元件。

如果索引無效，則拋出 ArrayIndexOutOfBoundsException。

註：儘管此方法未過時，但首選使用方法是 remove(int)，該方法實作 1.2 Collections 框架中定義的 List 介面。

參數：

index - 要移除物件的索引

另請參見：

remove(int), Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(Object obj,
                            int index)

將指定物件作為此列表中的元件插入到指定的 index 處。

如果索引無效，則拋出 ArrayIndexOutOfBoundsException。

註：儘管此方法未過時，但首選使用方法是 add(int,Object)，該方法實作 1.2 Collections 框架中定義的 List 介面。

參數：

obj - 要插入的元件

index - 插入新元件的位置

拋出：

ArrayIndexOutOfBoundsException - 如果索引無效

另請參見：

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

addElement

public void addElement(Object obj)

將指定元件添加到此類別表的末尾。

參數：

obj - 要添加的元件

另請參見：

Vector.addElement(Object)

removeElement

public boolean removeElement(Object obj)

從此列表中移除參數的第一個（索引最小的）比對項。

參數：

obj - 要移除的元件

返回：

如果該參數是此列表的一個元件，則返回 true；否則返回 false

另請參見：

Vector.removeElement(Object)

removeAllElements

public void removeAllElements()

從此列表中移除所有元件，並將它們的大小設置為零。

註：儘管此方法未過時，但首選使用方法是 clear，該方法實作 1.2 Collections 框架中定義的 List 介面。

另請參見：

clear(), Vector.removeAllElements()

toString

public String toString()

返回顯示並標識此物件的屬性的字元串。

覆寫：

類別 Object 中的 toString

返回：

此物件的 String 表示形式

toArray

public Object[] toArray()

以正確順序返回包含此列表中所有元素的陣列。

返回：

包含列表元素的陣列

另請參見：

Vector.toArray()

get

public Object get(int index)

返回列表中指定位置處的元素。

如果索引超出範圍（index < 0 || index >= size()），則拋出 ArrayIndexOutOfBoundsException。

參數：

index - 要返回的元素的索引

set

public Object set(int index,
                  Object element)

使用指定元素替換此列表中指定位置上的元素。

如果索引超出範圍（index < 0 || index >= size()），則拋出 ArrayIndexOutOfBoundsException。

參數：

index - 要替換的元素的索引

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

返回：

以前在指定位置上的元素

add

public void add(int index,
                Object element)

在此列表的指定位置處插入指定元素。

如果索引超出範圍（index < 0 || index > size()），則拋出 ArrayIndexOutOfBoundsException。

參數：

index - 指定元素的插入位置的索引

element - 要插入的元素

remove

public Object remove(int index)

移除此列表中指定位置處的元素。返回從列表中移除的元素。

如果索引超出範圍（index < 0 || index >= size()），則拋出 ArrayIndexOutOfBoundsException。

參數：

index - 要移除的元素的索引

clear

public void clear()

從此列表中移除所有元素。此調用返回後，列表將是空的（除非該調用拋出異常）。

removeRange

public void removeRange(int fromIndex,
                        int toIndex)

刪除指定索引範圍中的元件。移除元件包括指定範圍兩個端點處的元件，因此，如果指定範圍 (1,5)，則移除索引 1 處的元件和索引 5 處的元件，以及它們之間的所有元件。

如果索引無效，則拋出 ArrayIndexOutOfBoundsException。如果 fromIndex > toIndex，則拋出 IllegalArgumentException。

參數：

fromIndex - 範圍低端點的索引

toIndex - 範圍高端點的索引

另請參見：

remove(int)