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 を柔軟に実装します。1.1.x の java.util.Vector を実装しますが、コレクションクラスはサポートせず、変更発生時には ListDataListener に通知します。現在は Vector に委譲され、今後のリリースでは実際の Collection の実装となります。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

フィールドのサマリー

クラス javax.swing.AbstractListModel から継承されたフィールド

listenerList

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DefaultListModel()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	add(int index, E element) このリスト内の指定された位置に指定された要素を挿入します。
void	addElement(E element) 指定されたコンポーネントをリストの末尾に追加します。
int	capacity() このリストの現在の容量を返します。
void	clear() このリストからすべての要素を削除します。
boolean	contains(Object elem) 指定されたオブジェクトがこのリスト内のコンポーネントかどうかを判定します。
void	copyInto(Object[] anArray) リストのコンポーネントを、指定された配列にコピーします。
E	elementAt(int index) 指定されたインデックスのコンポーネントを返します。
Enumeration<E>	elements() このリストのコンポーネントの列挙を返します。
void	ensureCapacity(int minCapacity) このリストの容量を必要に応じて増やし、少なくとも最小収容引数で指定されるコンポーネント数を保持できるようにします。
E	firstElement() このリストの最初のコンポーネントを返します。
E	get(int index) このリスト内の指定された位置にある要素を返します。
E	getElementAt(int index) 指定されたインデックスのコンポーネントを返します。
int	getSize() このリスト内のコンポーネント数を返します。
int	indexOf(Object elem) 最初に現れる elem を検索します。
int	indexOf(Object elem, int index) index 以降に最初に現れる elem を検索します。
void	insertElementAt(E element, int index) 指定された要素を、このリスト内の指定された index の位置にコンポーネントとして挿入します。
boolean	isEmpty() このリストがコンポーネントを保持しているかどうかを判定します。
E	lastElement() リストの最後のコンポーネントを返します。
int	lastIndexOf(Object elem) elem が最後に現れる位置のインデックスを返します。
int	lastIndexOf(Object elem, int index) 指定されたインデックスから後ろ向きに elem を検索し、検出された位置のインデックスを返します。
E	remove(int index) このリストの指定された位置にある要素を削除します。
void	removeAllElements() リストからすべてのコンポーネントを削除し、そのサイズをゼロに設定します。
boolean	removeElement(Object obj) リストから、最初に現れた引数 (下限のインデックス) を削除します。
void	removeElementAt(int index) 指定されたインデックスのコンポーネントを削除します。
void	removeRange(int fromIndex, int toIndex) 指定されたインデックス範囲にあるコンポーネントを削除します。
E	set(int index, E element) このリストの指定された位置にある要素を、指定された要素で置き換えます。
void	setElementAt(E element, 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()

このリスト内のコンポーネント数を返します。

このメソッドは、1.2 の Collections Framework で定義された List インタフェースを実装する size と同じです。このメソッドは setSize との組み合わせで存在するので、size は JavaBean プロパティーとして識別できます。

戻り値:

リスト内のコンポーネント数

関連項目:

size()

getElementAt

public E getElementAt(int index)

指定されたインデックスのコンポーネントを返します。

注: このメソッドは推奨されません。推奨されるメソッドは get(int) です。これは 1.2 の Collections Framework で定義された 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<E> 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 E elementAt(int index)

指定されたインデックスのコンポーネントを返します。インデックスが負であるか、リストのサイズよりも小さくない場合は、ArrayIndexOutOfBoundsException をスローします。

注: このメソッドは推奨されません。推奨されるメソッドは get(int) です。これは 1.2 の Collections Framework で定義された List インタフェースを実装します。

パラメータ:

index - このリストのインデックス

戻り値:

指定されたインデックスのコンポーネント

関連項目:

get(int), Vector.elementAt(int)

firstElement

public E firstElement()

このリストの最初のコンポーネントを返します。この Vector がコンポーネントを持たない場合は NoSuchElementException をスローします。

戻り値:

リストの最初のコンポーネント

関連項目:

Vector.firstElement()

lastElement

public E lastElement()

リストの最後のコンポーネントを返します。この Vector がコンポーネントを持たない場合は NoSuchElementException をスローします。

戻り値:

リストの最後のコンポーネント

関連項目:

Vector.lastElement()

setElementAt

public void setElementAt(E element,
                int index)

このリストの指定された index のコンポーネントを、指定された要素として設定します。そのインデックスにあった要素は破棄されます。

インデックスが無効な場合は ArrayIndexOutOfBoundsException をスローします。

注: このメソッドは推奨されません。推奨されるメソッドは set(int,Object) です。これは 1.2 の Collections Framework で定義された List インタフェースを実装します。

パラメータ:

element - コンポーネントに設定されるオブジェクト

index - 指定するインデックス

関連項目:

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

removeElementAt

public void removeElementAt(int index)

指定されたインデックスのコンポーネントを削除します。

インデックスが無効な場合は ArrayIndexOutOfBoundsException をスローします。

注: このメソッドは推奨されません。推奨されるメソッドは remove(int) です。これは 1.2 の Collections Framework で定義された List インタフェースを実装します。

パラメータ:

index - 削除されるオブジェクトのインデックス

関連項目:

remove(int), Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E element,
                   int index)

指定された要素を、このリスト内の指定された index の位置にコンポーネントとして挿入します。

インデックスが無効な場合は ArrayIndexOutOfBoundsException をスローします。

注: このメソッドは推奨されません。推奨されるメソッドは add(int,Object) です。これは 1.2 の Collections Framework で定義された List インタフェースを実装します。

パラメータ:

element - 挿入されるコンポーネント

index - 新しいコンポーネントを挿入する位置

例外:

ArrayIndexOutOfBoundsException - インデックスが無効だった場合

関連項目:

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

addElement

public void addElement(E element)

指定されたコンポーネントをリストの末尾に追加します。

パラメータ:

element - 追加されるコンポーネント

関連項目:

Vector.addElement(Object)

removeElement

public boolean removeElement(Object obj)

リストから、最初に現れた引数 (下限のインデックス) を削除します。

パラメータ:

obj - 削除されるコンポーネント

戻り値:

引数がこのリストのコンポーネントであった場合は true、そうでない場合は false

関連項目:

Vector.removeElement(Object)

removeAllElements

public void removeAllElements()

リストからすべてのコンポーネントを削除し、そのサイズをゼロに設定します。

注: このメソッドは推奨されません。推奨されるメソッドは clear です。これは 1.2 の Collections Framework で定義された List インタフェースを実装します。

関連項目:

clear(), Vector.removeAllElements()

toString

public String toString()

このオブジェクトのプロパティーを表示および識別する文字列を返します。

オーバーライド:

toString、クラス: Object

戻り値:

このオブジェクトの文字列表現

toArray

public Object[] toArray()

リスト内のすべての要素が正しい順序で格納されている配列を返します。

戻り値:

リストの要素が格納されている配列

関連項目:

Vector.toArray()

get

public E get(int index)

このリスト内の指定された位置にある要素を返します。

インデックスが範囲外 (index < 0 || index >= size()) の場合は ArrayIndexOutOfBoundsException をスローします。

パラメータ:

index - 返される要素のインデックス

set

public E set(int index,
    E element)

このリストの指定された位置にある要素を、指定された要素で置き換えます。

インデックスが範囲外 (index < 0 || index >= size()) の場合は ArrayIndexOutOfBoundsException をスローします。

パラメータ:

index - 置換される要素のインデックス

element - 指定された位置に格納される要素

戻り値:

指定された位置に以前あった要素

add

public void add(int index,
       E element)

このリスト内の指定された位置に指定された要素を挿入します。

インデックスが範囲外 (index < 0 || index > size()) の場合は ArrayIndexOutOfBoundsException をスローします。

パラメータ:

index - 指定の要素が挿入される位置のインデックス

element - 挿入される要素

remove

public E 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)