- java.lang.Object
-
- javafx.beans.binding.ListExpression<E>
-
- 型パラメータ:
E-List要素の型。
- すべての実装されたインタフェース:
Iterable<E>,Collection<E>,List<E>,Observable,ObservableListValue<E>,ObservableObjectValue<E>,ObservableValue<E>,ObservableList<E>
- 直系の既知のサブクラス:
ListBinding,ReadOnlyListProperty
public abstract class ListExpression<E> extends Object implements ObservableListValue<E>
ListExpressionは、流暢なスタイルでバインディングを生成する追加の簡易なメソッドであるObservableListValueです。ListExpressionの具体的なサブクラスは、この式の実際の値を提供するメソッドObservableObjectValue.get()を実装する必要があります。ListExpressionのラップされたリストがnullである場合、Listインタフェースを実装するすべてのメソッドが不変の空のリストに適用されるかのように動作します。- 導入されたバージョン:
- JavaFX 2.1
-
-
プロパティのサマリー
プロパティ Type プロパティ 説明 abstract ReadOnlyBooleanPropertyemptyリストが空である場合にtrueであるブール型プロパティ。abstract ReadOnlyIntegerPropertysizeリストのサイズを表す整数プロパティ。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 ListExpression()
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 voidadd(int i, E element)このリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。booleanadd(E element)指定された要素をこのリストの最後に追加します(オプションの操作)。booleanaddAll(int i, Collection<? extends E> elements)指定されたコレクション内のすべての要素を、このリストの指定された位置に挿入します(オプションの操作)。booleanaddAll(E... elements)要素のvar-arg追加の便利なメソッドです。booleanaddAll(Collection<? extends E> elements)指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序で、このリストの最後に追加します(オプションの操作)。StringBindingasString()Stringに変換されたListExpressionの値を保持するStringBindingを作成します。voidclear()すべての要素をこのリストから削除します(オプションの操作)。booleancontains(Object obj)指定された要素がこのリストに含まれている場合にtrueを返します。booleancontainsAll(Collection<?> objects)指定されたコレクションのすべての要素がこのリストに含まれている場合にtrueを返します。abstract ReadOnlyBooleanPropertyemptyProperty()リストが空である場合にtrueであるブール型プロパティ。Eget(int i)このリスト内の指定された位置にある要素を返します。intgetSize()リストのサイズObservableList<E>getValue()このObservableValueの現在の値を返しますintindexOf(Object obj)指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。booleanisEmpty()空のプロパティの値を取得します。BooleanBindingisEqualTo(ObservableList<?> other)このリストが別のObservableListと同等である場合にtrueを保持する新しいBooleanBindingを作成します。BooleanBindingisNotEqualTo(ObservableList<?> other)このリストが別のObservableListと同等でない場合にtrueを保持する新しいBooleanBindingを作成します。BooleanBindingisNotNull()ラップされたリストがnullでない場合にtrueを保持する新しいBooleanBindingを作成します。BooleanBindingisNull()ラップされたリストがnullである場合にtrueを保持する新しいBooleanBindingを作成します。Iterator<E>iterator()このリスト内の要素を適切な順序で反復するイテレータを返します。intlastIndexOf(Object obj)指定された要素がこのリスト内で最後に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。static <E> ListExpression<E>listExpression(ObservableListValue<E> value)ObservableListValueをラップするListExpressionを返します。ListIterator<E>listIterator()このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。ListIterator<E>listIterator(int i)リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。Eremove(int i)このリスト内の指定された位置にある要素を削除します(オプションの操作)。voidremove(int from, int to)sublist(from, to).clear()を呼び出す簡単な方法。booleanremove(Object obj)指定された要素がこのリストにあれば、その最初のものをリストから削除します(オプションの操作)。booleanremoveAll(E... elements)removeAllメソッドのvar-arg使用の便利なメソッド。booleanremoveAll(Collection<?> objects)このリストから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。booleanretainAll(E... elements)retainAllメソッドのvar-arg使用の便利なメソッド。booleanretainAll(Collection<?> objects)このリスト内で、指定されたコレクションに含まれている要素だけを保持します(オプションの操作)。Eset(int i, E element)このリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。booleansetAll(E... elements)ObservableListを消去し、渡されたすべての要素をvar-argsとして追加します。booleansetAll(Collection<? extends E> elements)ObservableListをクリアし、コレクションのすべての要素を追加します。intsize()このリスト内にある要素の数を返します。abstract ReadOnlyIntegerPropertysizeProperty()リストのサイズを表す整数プロパティ。List<E>subList(int from, int to)このリストの、指定されたfromIndex(これを含む)からtoIndex(これを含まない)までの部分のビューを返します。Object[]toArray()このリスト内のすべての要素を適切な順序で(最初の要素から最後の要素へ)含んでいる配列を返します。<T> T[]toArray(T[] array)このリスト内のすべての要素を適切な順序で(最初の要素から最後の要素へ)含んでいる配列を返します。返される配列の実行時の型は、指定された配列の型になります。ObjectBinding<E>valueAt(int index)指定された位置の要素を含む新しいObjectBindingを作成します。ObjectBinding<E>valueAt(ObservableIntegerValue index)指定された位置の要素を含む新しいObjectBindingを作成します。-
インタフェース java.util.Collectionから継承されたメソッド
parallelStream, removeIf, stream
-
インタフェース java.util.Listから継承されたメソッド
equals, hashCode, of, of, of, of, of, of, of, of, of, of, of, of, replaceAll, sort, spliterator
-
クラス java.lang.Objectから継承されたメソッド
clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait
-
インタフェースjavafx.beans.Observableから継承されたメソッド
addListener、removeListener
-
インタフェースjavafx.collections.ObservableListから継承されたメソッド
addListener, filtered, removeListener, sorted, sorted
-
インタフェースjavafx.beans.value.ObservableObjectValueから継承されたメソッド
get
-
インタフェースjavafx.beans.value.ObservableValueから継承されたメソッド
addListener、removeListener
-
-
-
-
プロパティ詳細
-
size
public abstract ReadOnlyIntegerProperty sizeProperty
リストのサイズを表す整数プロパティ。- 関連項目:
getSize()
-
empty
public abstract ReadOnlyBooleanProperty emptyProperty
リストが空である場合にtrueであるブール型プロパティ。- 関連項目:
isEmpty()
-
-
メソッドの詳細
-
getValue
public ObservableList<E> getValue()
次のインタフェースからコピーされた説明:ObservableValueこのObservableValueの現在の値を返します- 定義:
- インタフェース
ObservableValue<E>内のgetValue - 戻り値:
- 現行値
-
listExpression
public static <E> ListExpression<E> listExpression(ObservableListValue<E> value)
ObservableListValueをラップするListExpressionを返します。ObservableListValueがすでにListExpressionである場合に返されます。 それ以外の場合、ObservableListValueにバインドされる新しいListBindingが作成されます。- 型パラメータ:
E- ラップされたListの型- パラメータ:
value- ソースObservableListValue- 戻り値:
- 必要に応じて
ObservableListValueをラップするListExpression - 例外:
NullPointerException-valueがnullの場合
-
getSize
public int getSize()
リストのサイズ- 戻り値:
- サイズ
-
sizeProperty
public abstract ReadOnlyIntegerProperty sizeProperty()
リストのサイズを表す整数プロパティ。- 関連項目:
getSize()
-
emptyProperty
public abstract ReadOnlyBooleanProperty emptyProperty()
リストが空である場合にtrueであるブール型プロパティ。- 関連項目:
isEmpty()
-
valueAt
public ObjectBinding<E> valueAt(int index)
指定された位置の要素を含む新しいObjectBindingを作成します。indexがリストの後を指す場合、ObjectBindingにはnullが含まれます。- パラメータ:
index- 要素のインデックス- 戻り値:
ObjectBinding- 例外:
IllegalArgumentException-indexが0未満の場合
-
valueAt
public ObjectBinding<E> valueAt(ObservableIntegerValue index)
指定された位置の要素を含む新しいObjectBindingを作成します。indexがリスト外を指す場合、ObjectBindingにはnullが含まれます。- パラメータ:
index- 要素のインデックス- 戻り値:
ObjectBinding- 例外:
NullPointerException-indexがnullである場合
-
isEqualTo
public BooleanBinding isEqualTo(ObservableList<?> other)
このリストが別のObservableListと同等である場合にtrueを保持する新しいBooleanBindingを作成します。- パラメータ:
other- 他のObservableList- 戻り値:
- 新しい
BooleanBinding - 例外:
NullPointerException-otherがnullである場合
-
isNotEqualTo
public BooleanBinding isNotEqualTo(ObservableList<?> other)
このリストが別のObservableListと同等でない場合にtrueを保持する新しいBooleanBindingを作成します。- パラメータ:
other- 他のObservableList- 戻り値:
- 新しい
BooleanBinding - 例外:
NullPointerException-otherがnullである場合
-
isNull
public BooleanBinding isNull()
ラップされたリストがnullである場合にtrueを保持する新しいBooleanBindingを作成します。- 戻り値:
- 新しい
BooleanBinding
-
isNotNull
public BooleanBinding isNotNull()
ラップされたリストがnullでない場合にtrueを保持する新しいBooleanBindingを作成します。- 戻り値:
- 新しい
BooleanBinding
-
asString
public StringBinding asString()
Stringに変換されたListExpressionの値を保持するStringBindingを作成します。 このListExpressionの値が変更される場合、StringBindingの値が自動的に更新されます。- 戻り値:
- 新しい
StringBinding
-
size
public int size()
インタフェースからコピーされた説明:Listこのリスト内にある要素の数を返します。 このリストにInteger.MAX_VALUEより多くの要素がある場合は、Integer.MAX_VALUEを返します。
-
isEmpty
public boolean isEmpty()
空のプロパティの値を取得します。
-
contains
public boolean contains(Object obj)
インタフェースからコピーされた説明:List指定された要素がこのリストに含まれている場合にtrueを返します。 より正式には、このリストにObjects.equals(o, e)などの少なくとも1つの要素eが含まれている場合にのみtrueを返します。
-
toArray
public Object[] toArray()
インタフェースからコピーされた説明:Listこのリスト内のすべての要素を適切な順序で(最初の要素から最後の要素へ)含んでいる配列を返します。返される配列は、それへの参照がこのリストで保持されない場合に、安全になります。 つまり、このメソッドは、このリストが配列に連動している場合でも、新しい配列を割り当てる必要があります。 このため、呼出し側は、返された配列を自由に変更できます。
このメソッドは、配列ベースのAPIとコレクションベースのAPIの間の橋渡し役として機能します。
- 定義:
toArray、インタフェース:Collection<E>- 定義:
toArray、インタフェース:List<E>- 戻り値:
- このリスト内のすべての要素を適切な順序で含んでいる配列
- 関連項目:
Arrays.asList(Object[])
-
toArray
public <T> T[] toArray(T[] array)
インタフェースからコピーされた説明:Listこのリスト内のすべての要素を適切な順序で(最初の要素から最後の要素へ)含んでいる配列を返します。返される配列の実行時の型は、指定された配列の型になります。 指定された配列にリストが収まる場合は、その配列で返されます。 それ以外の場合は、指定された配列の実行時の型とこのリストのサイズを使って新しい配列が割り当てられます。指定された配列にリストが収まり、さらに余分な領域がある場合(配列にリストより多くの要素がある場合)、配列でリストの末尾に続く要素は
nullに設定されます。 このリストにnull要素がないことを呼出し側が知っている場合にのみ、この特性を利用してリストの長さを判断できます。List.toArray()メソッドと同様に、このメソッドは配列ベースのAPIとコレクションベースのAPIの間のブリッジとして機能します。 さらに、このメソッドでは出力配列の実行時の型を正確に制御できるため、環境によっては割当ての手間を抑えるために使用できます。xが、文字列だけからなるリストであることがわかっていると仮定します。 次のコードを使うと、新しく割り当てられたStringの配列にリストをダンプできます。String[] y = x.toArray(new String[0]);toArray(new Object[0])は、機能の点でtoArray()と同一です。
-
add
public boolean add(E element)
インタフェースからコピーされた説明:List指定された要素をこのリストの最後に追加します(オプションの操作)。このオペレーションをサポートするリストは、リストに追加できる要素に制限を加える場合があります。 たとえば、リストにはnull要素の追加を拒否するものもあれば、追加される要素の型について制限を加えるものもあります。 Listクラスは、追加できる要素について制約があれば、ドキュメントでそれを明確に記述するようにしてください。
- 定義:
add、インタフェース:Collection<E>- 定義:
add、インタフェース:List<E>- パラメータ:
element- リストに追加される要素。- 戻り値:
true(Collection.add(E)で指定されているとおり)
-
remove
public boolean remove(Object obj)
インタフェースからコピーされた説明:List指定された要素がこのリストにあれば、その最初のものをリストから削除します(オプションの操作)。 このリストにその要素がない場合は、変更されません。 より正式には、Objects.equals(o, get(i))(そのような要素が存在する場合)のような最も低いインデックスiを持つ要素を削除します。 指定された要素がこのリストに含まれていた場合、つまり、呼出しの結果としてこのリストが変更された場合にtrueを返します。
-
containsAll
public boolean containsAll(Collection<?> objects)
インタフェースからコピーされた説明:List指定されたコレクションのすべての要素がこのリストに含まれている場合にtrueを返します。- 定義:
containsAll、インタフェース:Collection<E>- 定義:
containsAll、インタフェース:List<E>- パラメータ:
objects- このリストの包含をチェックするコレクション- 戻り値:
- 指定されたコレクションのすべての要素がこのリストに含まれている場合は
true - 関連項目:
List.contains(Object)
-
addAll
public boolean addAll(Collection<? extends E> elements)
インタフェースからコピーされた説明:List指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序で、このリストの最後に追加します(オプションの操作)。 オペレーションの進行中に、指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。 (これは、指定されたコレクションがこのリストで、しかも空ではない場合に起こります。)- 定義:
addAll、インタフェース:Collection<E>- 定義:
addAll、インタフェース:List<E>- パラメータ:
elements- このリストに追加される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのリストが変更された場合は
true - 関連項目:
List.add(Object)
-
addAll
public boolean addAll(int i, Collection<? extends E> elements)インタフェースからコピーされた説明:List指定されたコレクション内のすべての要素を、このリストの指定された位置に挿入します(オプションの操作)。 その位置とそれ以降に要素がある場合は、それらを右に移動して、各要素のインデックスに1を加えます。 新しい要素は、指定されたコレクションのイテレータによって返される順序でこのリストに挿入されます。 オペレーションの進行中に、指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。 (これは、指定されたコレクションがこのリストで、しかも空ではない場合に起こります。)
-
removeAll
public boolean removeAll(Collection<?> objects)
インタフェースからコピーされた説明:Listこのリストから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。- 定義:
removeAll、インタフェース:Collection<E>- 定義:
removeAll、インタフェース:List<E>- パラメータ:
objects- このリストから削除される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのリストが変更された場合は
true - 関連項目:
List.remove(Object),List.contains(Object)
-
retainAll
public boolean retainAll(Collection<?> objects)
インタフェースからコピーされた説明:Listこのリスト内で、指定されたコレクションに含まれている要素だけを保持します(オプションの操作)。 つまり、指定されたコレクションに含まれていないすべての要素をこのリストから削除します。- 定義:
retainAll、インタフェース:Collection<E>- 定義:
retainAll、インタフェース:List<E>- パラメータ:
objects- このリストに保持される要素を含むコレクション- 戻り値:
- 呼出しの結果としてこのリストが変更された場合は
true - 関連項目:
List.remove(Object),List.contains(Object)
-
clear
public void clear()
インタフェースからコピーされた説明:Listすべての要素をこのリストから削除します(オプションの操作)。 この呼出しが戻ると、このリストは空になります。
-
set
public E set(int i, E element)
インタフェースからコピーされた説明:Listこのリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。
-
add
public void add(int i, E element)インタフェースからコピーされた説明:Listこのリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。 その位置とそれ以降に要素があればそれらを右に移動させ、各要素のインデックスに1を加えます。
-
remove
public E remove(int i)
インタフェースからコピーされた説明:Listこのリスト内の指定された位置にある要素を削除します(オプションの操作)。 後続の要素を左に移動します(インデックスから1を減算)。 リストから削除された要素が返されます。
-
indexOf
public int indexOf(Object obj)
インタフェースからコピーされた説明:List指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。 より正式には、Objects.equals(o, get(i))のような最も低いインデックスi、またはそのようなインデックスがない場合は -1を返します。
-
lastIndexOf
public int lastIndexOf(Object obj)
インタフェースからコピーされた説明:List指定された要素がこのリスト内で最後に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。 より正式には、Objects.equals(o, get(i))のような最高のインデックスi、またはそのようなインデックスがない場合は -1を返します。- 定義:
lastIndexOf、インタフェース:List<E>- パラメータ:
obj- 検索する要素- 戻り値:
- 指定された要素がこのリスト内で最後に検出された位置のインデックス。その要素がこのリストにない場合は -1
-
listIterator
public ListIterator<E> listIterator()
インタフェースからコピーされた説明:Listこのリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。- 定義:
listIterator、インタフェース:List<E>- 戻り値:
- このリスト内の要素を(適切な順序で)反復するリスト・イテレータ
-
listIterator
public ListIterator<E> listIterator(int i)
インタフェースからコピーされた説明:Listリスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。 指定されたインデックスは、nextの最初の呼出しによって返される最初の要素を示します。previousの最初の呼出しは、指定されたインデックスから1を引いたインデックスを持つ要素を返します。- 定義:
listIterator、インタフェース:List<E>- パラメータ:
i- リスト・イテレータから返される最初の要素のインデックス(nextへの呼び出しによって)- 戻り値:
- リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータ
-
subList
public List<E> subList(int from, int to)
インタフェースからコピーされた説明:Listこのリストの、指定されたfromIndex(これを含む)からtoIndex(これを含まない)までの部分のビューを返します。fromIndexとtoIndexが等しい場合は、空のリストが返されます。 返されるリストはこのリストに連動しているため、返されるリスト内での非構造的な変更はこのリストに反映され、このリスト内での変更は返されるリストに反映されます。 返されるリストは、このリストによってサポートされている、任意のリスト・オペレーションをすべてサポートします。このメソッドでは、配列に一般的に見られるような、明示的な範囲操作は必要ありません。 リストを予期する操作は、リスト全体ではなくsubListビューを渡すことで範囲操作として使用できます。 たとえば、次のイディオムは、ある範囲の要素をリストから削除します。
list.subList(from, to).clear();indexOfおよびlastIndexOfでも同様のイディオムを構築して、CollectionsクラスのすべてのアルゴリズムをsubListに適用できます。バッキング・リスト(すなわち、このリスト)の構造が、返されたリストを経由せずに変更された場合、このメソッドで返されるリストのセマンティックスは定義されていません。 構造の変更とは、リストのサイズが変わるような変更や、進行中のイテレーションが不正な結果に終わるような変更のことです。
-
addAll
public boolean addAll(E... elements)
次のインタフェースからコピーされた説明:ObservableList要素のvar-arg追加の便利なメソッドです。- 定義:
- インタフェース
ObservableList<E>のaddAll - パラメータ:
elements- 追加する要素- 戻り値:
- true(Collection.add(E)で指定されているとおり)
-
setAll
public boolean setAll(E... elements)
次のインタフェースからコピーされた説明:ObservableListObservableListを消去し、渡されたすべての要素をvar-argsとして追加します。- 定義:
- インタフェース
ObservableList<E>のsetAll - パラメータ:
elements- 設定する要素- 戻り値:
- true(Collection.add(E)で指定されているとおり)
-
setAll
public boolean setAll(Collection<? extends E> elements)
次のインタフェースからコピーされた説明:ObservableListObservableListをクリアし、コレクションのすべての要素を追加します。- 定義:
- インタフェース
ObservableList<E>のsetAll - パラメータ:
elements- このobservableArrayListに追加される要素を使用したコレクション。- 戻り値:
- true(Collection.add(E)で指定されているとおり)
-
removeAll
public boolean removeAll(E... elements)
次のインタフェースからコピーされた説明:ObservableListremoveAllメソッドのvar-arg使用の便利なメソッド。- 定義:
- インタフェース
ObservableList<E>のremoveAll - パラメータ:
elements- 削除する要素- 戻り値:
- この呼出しの結果、リストが変更された場合はtrue
-
retainAll
public boolean retainAll(E... elements)
次のインタフェースからコピーされた説明:ObservableListretainAllメソッドのvar-arg使用の便利なメソッド。- 定義:
- インタフェース
ObservableList<E>のretainAll - パラメータ:
elements- 保持する要素- 戻り値:
- この呼出しの結果、リストが変更された場合はtrue
-
remove
public void remove(int from, int to)次のインタフェースからコピーされた説明:ObservableListsublist(from, to).clear()を呼び出す簡単な方法。 これは一般的な操作であるため、ObservableListは便利な使い方のためにこのメソッドを持っています。- 定義:
remove、インタフェース:ObservableList<E>- パラメータ:
from- 削除する範囲の開始(含む)to- 削除する範囲の最後(含まない)
-
-