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の長期ストレージのサポートがjava.beans
パッケージに追加されました。 XMLEncoder
を参照してください。
- 導入されたバージョン:
- 1.2
-
フィールドのサマリー
クラス javax.swing.AbstractListModelで宣言されたフィールド
listenerList
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明void
リスト内の指定された位置に指定された要素を挿入します。void
addAll
(int index, Collection<? extends E> c) 指定された索引から開始して、コレクション内に存在するすべての要素を追加します。void
addAll
(Collection<? extends E> c) コレクション内に存在するすべての要素をリストに追加します。void
addElement
(E element) 指定されたコンポーネントをリストの末尾に追加します。int
capacity()
このリストの現在の容量を返します。void
clear()
このリストからすべての要素を削除します。boolean
指定されたオブジェクトがこのリスト内のコンポーネントかどうかを判定します。void
リストのコンポーネントを、指定された配列にコピーします。elementAt
(int index) 指定されたインデックスの要素を返します。elements()
このリストのコンポーネントの列挙を返します。void
ensureCapacity
(int minCapacity) このリストの容量を必要に応じて増やし、少なくとも最小収容引数で指定されるコンポーネント数を保持できるようにします。このリストの最初のコンポーネントを返します。get
(int index) このリスト内の指定された位置にある要素を返します。getElementAt
(int index) 指定されたインデックスの要素を返します。int
getSize()
このリスト内のコンポーネント数を返します。int
最初に現れるelem
を検索します。int
index
以降に最初に現れるelem
を検索します。void
insertElementAt
(E element, int index) 指定された要素を、このリスト内の指定されたindex
の位置にコンポーネントとして挿入します。boolean
isEmpty()
このリストがコンポーネントを保持しているかどうかを判定します。リストの最後のコンポーネントを返します。int
lastIndexOf
(Object elem) elem
が最後に現れる位置のインデックスを返します。int
lastIndexOf
(Object elem, int index) 指定されたインデックスから後ろ向きにelem
を検索し、検出された位置のインデックスを返します。remove
(int index) このリストの指定された位置にある要素を削除します。void
リストからすべてのコンポーネントを削除し、そのサイズをゼロに設定します。boolean
removeElement
(Object obj) リストから、最初に現れた引数(下限のインデックス)を削除します。void
removeElementAt
(int index) 指定されたインデックスのコンポーネントを削除します。void
removeRange
(int fromIndex, int toIndex) 指定されたインデックス範囲にあるコンポーネントを削除します。リストの指定された位置にある要素を、指定された要素で置き換えます。void
setElementAt
(E element, int index) このリストの指定されたindex
のコンポーネントを、指定された要素として設定します。void
setSize
(int newSize) このリストのサイズを設定します。int
size()
このリスト内のコンポーネント数を返します。Object[]
toArray()
リスト内のすべての要素が正しい順序で格納されている配列を返します。toString()
このオブジェクトのプロパティを表示および識別する文字列を返します。void
このリストの容量を切り捨てて、このリストの現在のサイズにします。クラス javax.swing.AbstractListModelで宣言されたメソッド
addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener
-
コンストラクタの詳細
-
DefaultListModel
public DefaultListModel()DefaultListModel
を構築します。
-
-
メソッドの詳細
-
getSize
public int getSize()このリスト内のコンポーネント数を返します。このメソッドは、1.2のCollections Frameworkで定義された
List
インタフェースを実装するsize
と同じです。 このメソッドはsetSize
との組み合わせで存在するので、size
はJavaBeanプロパティとして識別できます。- 戻り値:
- リスト内のコンポーネント数
- 関連項目:
-
getElementAt
public E getElementAt(int index) 指定されたインデックスの要素を返します。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
get(int)
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。- パラメータ:
index
- このリストのインデックス- 戻り値:
- 指定されたインデックスのコンポーネント
- 例外:
ArrayIndexOutOfBoundsException
-index
が負の値であるか、このリストの現在のサイズより大きい場合- 関連項目:
-
copyInto
public void copyInto(Object[] anArray) リストのコンポーネントを、指定された配列にコピーします。 配列には、このリストのすべてのオブジェクトを保持するのに十分な大きさが必要です。そうでない場合は、IndexOutOfBoundsException
がスローされます。- パラメータ:
anArray
- コピーしたコンポーネントをコピーする配列- 関連項目:
-
trimToSize
public void trimToSize()このリストの容量を切り捨てて、このリストの現在のサイズにします。- 関連項目:
-
ensureCapacity
public void ensureCapacity(int minCapacity) このリストの容量を必要に応じて増やし、少なくとも最小収容引数で指定されるコンポーネント数を保持できるようにします。- パラメータ:
minCapacity
- 目的の最小容量- 関連項目:
-
setSize
public void setSize(int newSize) このリストのサイズを設定します。- パラメータ:
newSize
- このリストの新しいサイズ- 関連項目:
-
capacity
public int capacity()このリストの現在の容量を返します。- 戻り値:
- 現在の容量
- 関連項目:
-
size
public int size()このリスト内のコンポーネント数を返します。- 戻り値:
- リスト内のコンポーネント数
- 関連項目:
-
isEmpty
public boolean isEmpty()このリストがコンポーネントを保持しているかどうかを判定します。- 戻り値:
- このリストがコンポーネントを持っていない場合、つまりサイズがゼロの場合にかぎり
true
、そうでない場合はfalse
- 関連項目:
-
elements
public Enumeration<E> elements()このリストのコンポーネントの列挙を返します。- 戻り値:
- リストのコンポーネントの列挙
- 関連項目:
-
contains
public boolean contains(Object elem) 指定されたオブジェクトがこのリスト内のコンポーネントかどうかを判定します。- パラメータ:
elem
- オブジェクト- 戻り値:
- 指定されたオブジェクトがこのリスト内のコンポーネントと同じである場合は
true
- 関連項目:
-
indexOf
public int indexOf(Object elem) 最初に現れるelem
を検索します。- パラメータ:
elem
- オブジェクト- 戻り値:
- このリスト内で最初に検出された引数のインデックス。オブジェクトが見つからない場合は、
-1
を返す - 関連項目:
-
indexOf
public int indexOf(Object elem, int index) index
以降に最初に現れるelem
を検索します。- パラメータ:
elem
- 目的のコンポーネントindex
- 検索開始位置のインデックス- 戻り値:
index
のあとで、最初に検出されたelem
のインデックス。リスト内にelem
が見つからない場合は-1
を返す- 関連項目:
-
lastIndexOf
public int lastIndexOf(Object elem) elem
が最後に現れる位置のインデックスを返します。- パラメータ:
elem
- 目的のコンポーネント- 戻り値:
- リストに
elem
が最後に出現したインデックス。オブジェクトが見つからない場合はelem
を返します - 関連項目:
-
lastIndexOf
public int lastIndexOf(Object elem, int index) 指定されたインデックスから後ろ向きにelem
を検索し、検出された位置のインデックスを返します。- パラメータ:
elem
- 目的のコンポーネントindex
- 検索開始位置のインデックス- 戻り値:
- このリスト内で、
index
より前の最後に検出されたelem
のインデックス。オブジェクトが見つからない場合は、-1
を返す - 関連項目:
-
elementAt
public E elementAt(int index) 指定されたインデックスの要素を返します。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
get(int)
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。- パラメータ:
index
- このリストのインデックス- 戻り値:
- 指定されたインデックスのコンポーネント
- 例外:
ArrayIndexOutOfBoundsException
- インデックスが負であるか、リストのサイズより小さい場合- 関連項目:
-
firstElement
public E firstElement()このリストの最初のコンポーネントを返します。- 戻り値:
- リストの最初のコンポーネント
- 例外:
NoSuchElementException
- このベクトルがコンポーネントを持たない場合- 関連項目:
-
lastElement
public E lastElement()リストの最後のコンポーネントを返します。- 戻り値:
- リストの最後のコンポーネント
- 例外:
NoSuchElementException
- このベクトルがコンポーネントを持たない場合- 関連項目:
-
setElementAt
public void setElementAt(E element, int index) このリストの指定されたindex
のコンポーネントを、指定された要素として設定します。 そのインデックスにあった要素は破棄されます。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
set(int,Object)
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。- パラメータ:
element
- コンポーネントに設定されるオブジェクトindex
- 指定するインデックス- 例外:
ArrayIndexOutOfBoundsException
- 索引が無効な場合- 関連項目:
-
removeElementAt
public void removeElementAt(int index) 指定されたインデックスのコンポーネントを削除します。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
remove(int)
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。- パラメータ:
index
- 削除されるオブジェクトのインデックス- 例外:
ArrayIndexOutOfBoundsException
- 索引が無効な場合- 関連項目:
-
insertElementAt
public void insertElementAt(E element, int index) 指定された要素を、このリスト内の指定されたindex
の位置にコンポーネントとして挿入します。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
add(int,Object)
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。- パラメータ:
element
- 挿入されるコンポーネントindex
- 新しいコンポーネントを挿入する位置- 例外:
ArrayIndexOutOfBoundsException
- インデックスが無効だった場合- 関連項目:
-
addElement
public void addElement(E element) 指定されたコンポーネントをリストの末尾に追加します。- パラメータ:
element
- 追加されるコンポーネント- 関連項目:
-
removeElement
public boolean removeElement(Object obj) リストから、最初に現れた引数(下限のインデックス)を削除します。- パラメータ:
obj
- 削除されるコンポーネント- 戻り値:
- 引数がこのリストのコンポーネントであった場合は
true
、そうでない場合はfalse
- 関連項目:
-
removeAllElements
public void removeAllElements()リストからすべてのコンポーネントを削除し、そのサイズをゼロに設定します。ノート: このメソッドは非推奨ではありませんが、使用する好ましいメソッドは
clear
です。これは1.2 Collections Frameworkで定義されたList
インタフェースを実装します。 -
toString
public String toString()このオブジェクトのプロパティを表示および識別する文字列を返します。 -
toArray
public Object[] toArray()リスト内のすべての要素が正しい順序で格納されている配列を返します。- 戻り値:
- リストの要素が格納されている配列
- 関連項目:
-
get
public E get(int index) このリスト内の指定された位置にある要素を返します。- パラメータ:
index
- 返される要素のインデックス- 戻り値:
- このリスト内の指定された位置にある要素
- 例外:
ArrayIndexOutOfBoundsException
- 索引が(index < 0 || index >= size()
)の範囲外であるかどうか
-
set
リストの指定された位置にある要素を、指定された要素で置き換えます。- パラメータ:
index
- 置換される要素のインデックスelement
- 指定された位置に格納される要素。- 戻り値:
- 指定された位置に以前あった要素。
- 例外:
ArrayIndexOutOfBoundsException
- 索引が(index < 0 || index >= size()
)の範囲外であるかどうか
-
add
public void add(int index, E element) リスト内の指定された位置に指定された要素を挿入します。- パラメータ:
index
- 指定の要素が挿入される位置のインデックスelement
- 挿入される要素- 例外:
ArrayIndexOutOfBoundsException
- 索引が(index < 0 || index > size()
)の範囲外であるかどうか
-
remove
public E remove(int index) このリストの指定された位置にある要素を削除します。 リストから削除された要素が返されます- パラメータ:
index
- 削除される要素のインデックス- 戻り値:
- 指定された位置に以前あった要素。
- 例外:
ArrayIndexOutOfBoundsException
- 索引が(index < 0 || index >= size()
)の範囲外であるかどうか
-
clear
public void clear()このリストからすべての要素を削除します。 リストは、この呼出しが返されると、呼出しが例外をスローしないかぎり、空になります。 -
removeRange
public void removeRange(int fromIndex, int toIndex) 指定されたインデックス範囲にあるコンポーネントを削除します。 削除対象は上限と下限の値を含むので、1と5の範囲を指定すると、インデックス1と5のコンポーネント、そしてその間のすべてのコンポーネントが削除されます。- パラメータ:
fromIndex
- 範囲の下限のインデックスtoIndex
- 範囲の上限のインデックス- 例外:
ArrayIndexOutOfBoundsException
- インデックスが無効だった場合IllegalArgumentException
-fromIndex > toIndex
の場合- 関連項目:
-
addAll
public void addAll(Collection<? extends E> c) コレクション内に存在するすべての要素をリストに追加します。- パラメータ:
c
- 追加する要素を含むコレクション- 例外:
NullPointerException
-c
がnullである場合
-
addAll
public void addAll(int index, Collection<? extends E> c) 指定された索引から開始して、コレクション内に存在するすべての要素を追加します。- パラメータ:
index
- 指定されたコレクションの最初の要素を挿入する位置のインデックス。c
- 追加する要素を含むコレクション- 例外:
ArrayIndexOutOfBoundsException
-index
が現在保持されている要素数の範囲内にないかどうかNullPointerException
-c
がnullである場合
-