javax.swing
クラス DefaultListModel

java.lang.Object
  |
  +--javax.swing.AbstractListModel
        |
        +--javax.swing.DefaultListModel

public class DefaultListModel

extends AbstractListModel

java.util.Vector API を実装して、JListDataModel リスナーに変更が生じるときを通知します。これは現在 Vector に委譲されていて、将来のリリースでは実際の Collection の実装になります。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

直列化された形式

クラス 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) 指定された引数が最初に現れる位置を検索します。
int	indexOf(Object elem, int index) 指定された引数が最初に現れる位置を index から検索します。
void	insertElementAt(Object obj, int index) 指定されたオブジェクトを、リストの指定された index のコンポーネントとして挿入します。
boolean	isEmpty() リストがコンポーネントを保持しているかどうかを返します。
Object	lastElement() リストの最後のコンポーネントを返します。
int	lastIndexOf(Object elem) 指定されたオブジェクトがリスト内で最後に現れるインデックスを返します。
int	lastIndexOf(Object elem, int index) 指定されたオブジェクトを指定されたインデックスから始めて逆方向に検索して、インデックスを返します。
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, removeListDataListener

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

DefaultListModel

public DefaultListModel()

メソッドの詳細

getSize

public int getSize()

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

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

戻り値:

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

関連項目:

size()

getElementAt

public Object 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 elements()

リストのコンポーネントの列挙を返します。

戻り値:

リストのコンポーネントの列挙

関連項目:

Vector.elements()

contains

public boolean contains(Object elem)

指定されたオブジェクトがリスト内のコンポーネントかどうかを判定します。

パラメータ:

elem - オブジェクト

戻り値:

指定されたオブジェクトがリスト内のコンポーネントと同じ場合は true

関連項目:

Vector.contains(Object)

indexOf

public int indexOf(Object elem)

指定された引数が最初に現れる位置を検索します。

パラメータ:

elem - オブジェクト

戻り値:

リスト内で引数が最初に現れるインデックス。オブジェクトが見つからない場合は -1

関連項目:

Vector.indexOf(Object)

indexOf

public int indexOf(Object elem,
                   int index)

指定された引数が最初に現れる位置を index から検索します。

パラメータ:

elem - オブジェクト

index - 検索を開始するインデックス

戻り値:

オブジェクト引数がリスト内で最初に現れるインデックス (リストの index またはそれ以降の位置)。オブジェクトが見つからない場合は -1

関連項目:

Vector.indexOf(Object,int)

lastIndexOf

public int lastIndexOf(Object elem)

指定されたオブジェクトがリスト内で最後に現れるインデックスを返します。

パラメータ:

elem - 対象のコンポーネント

戻り値:

指定されたオブジェクトがリスト内で最後に現れるインデックス。オブジェクトが見つからない場合は -1

関連項目:

Vector.lastIndexOf(Object)

lastIndexOf

public int lastIndexOf(Object elem,
                       int index)

指定されたオブジェクトを指定されたインデックスから始めて逆方向に検索して、インデックスを返します。

パラメータ:

elem - 対象のコンポーネント

index - 検索を開始するインデックス

戻り値:

指定されたオブジェクトがリスト内で最後に現れるインデックス (リストの index よりも前の位置)。オブジェクトが見つからない場合は -1

関連項目:

Vector.lastIndexOf(Object,int)

elementAt

public Object elementAt(int index)

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

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

パラメータ:

obj - 設定するコンポーネント

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(Object obj,
                            int index)

指定されたオブジェクトを、リストの指定された index のコンポーネントとして挿入します。

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

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

関連項目:

clear(), Vector.removeAllElements()

toString

public String toString()

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

戻り値:

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

オーバーライド:

クラス Object 内の toString

toArray

public Object[] toArray()

リスト内のすべての要素を正しい順序で保持する配列を返します。

配列 a の実行時の型がリスト内の各要素の実行時の型のスーパータイプでない場合は、ArrayStoreException をスローします。

パラメータ:

a - 配列に十分なサイズがある場合は、リストの要素が格納される配列。そうでない場合は、同じ実行時の型の新しい配列がこの目的のために割り当てられる

戻り値:

リストの要素を保持する配列

関連項目:

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)