- 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 ReadOnlyBooleanProperty
empty
リストが空である場合にtrue
であるブール型プロパティ。abstract ReadOnlyIntegerProperty
size
リストのサイズを表す整数プロパティ。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 ListExpression()
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 void
add(int i, E element)
このリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。boolean
add(E element)
指定された要素をこのリストの最後に追加します(オプションの操作)。boolean
addAll(int i, Collection<? extends E> elements)
指定されたコレクション内のすべての要素を、このリストの指定された位置に挿入します(オプションの操作)。boolean
addAll(E... elements)
要素のvar-arg追加の便利なメソッドです。boolean
addAll(Collection<? extends E> elements)
指定されたコレクション内のすべての要素を、指定されたコレクションのイテレータによって返される順序で、このリストの最後に追加します(オプションの操作)。StringBinding
asString()
String
に変換されたListExpression
の値を保持するStringBinding
を作成します。void
clear()
すべての要素をこのリストから削除します(オプションの操作)。boolean
contains(Object obj)
指定された要素がこのリストに含まれている場合にtrue
を返します。boolean
containsAll(Collection<?> objects)
指定されたコレクションのすべての要素がこのリストに含まれている場合にtrue
を返します。abstract ReadOnlyBooleanProperty
emptyProperty()
リストが空である場合にtrue
であるブール型プロパティ。E
get(int i)
このリスト内の指定された位置にある要素を返します。int
getSize()
リストのサイズObservableList<E>
getValue()
このObservableValue
の現在の値を返しますint
indexOf(Object obj)
指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。boolean
isEmpty()
空のプロパティの値を取得します。BooleanBinding
isEqualTo(ObservableList<?> other)
このリストが別のObservableList
と同等である場合にtrue
を保持する新しいBooleanBinding
を作成します。BooleanBinding
isNotEqualTo(ObservableList<?> other)
このリストが別のObservableList
と同等でない場合にtrue
を保持する新しいBooleanBinding
を作成します。BooleanBinding
isNotNull()
ラップされたリストがnull
でない場合にtrue
を保持する新しいBooleanBinding
を作成します。BooleanBinding
isNull()
ラップされたリストがnull
である場合にtrue
を保持する新しいBooleanBinding
を作成します。Iterator<E>
iterator()
このリスト内の要素を適切な順序で反復するイテレータを返します。int
lastIndexOf(Object obj)
指定された要素がこのリスト内で最後に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。static <E> ListExpression<E>
listExpression(ObservableListValue<E> value)
ObservableListValue
をラップするListExpression
を返します。ListIterator<E>
listIterator()
このリスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。ListIterator<E>
listIterator(int i)
リスト内の指定された位置で始まる、リスト内の要素を(適切な順序で)反復するリスト・イテレータを返します。E
remove(int i)
このリスト内の指定された位置にある要素を削除します(オプションの操作)。void
remove(int from, int to)
sublist(from, to).clear()
を呼び出す簡単な方法。boolean
remove(Object obj)
指定された要素がこのリストにあれば、その最初のものをリストから削除します(オプションの操作)。boolean
removeAll(E... elements)
removeAll
メソッドのvar-arg使用の便利なメソッド。boolean
removeAll(Collection<?> objects)
このリストから、指定されたコレクションに含まれる要素をすべて削除します(オプションの操作)。boolean
retainAll(E... elements)
retainAll
メソッドのvar-arg使用の便利なメソッド。boolean
retainAll(Collection<?> objects)
このリスト内で、指定されたコレクションに含まれている要素だけを保持します(オプションの操作)。E
set(int i, E element)
このリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。boolean
setAll(E... elements)
ObservableListを消去し、渡されたすべての要素をvar-argsとして追加します。boolean
setAll(Collection<? extends E> elements)
ObservableListをクリアし、コレクションのすべての要素を追加します。int
size()
このリスト内にある要素の数を返します。abstract ReadOnlyIntegerProperty
sizeProperty()
リストのサイズを表す整数プロパティ。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)
次のインタフェースからコピーされた説明:ObservableList
ObservableListを消去し、渡されたすべての要素をvar-argsとして追加します。- 定義:
- インタフェース
ObservableList<E>
のsetAll
- パラメータ:
elements
- 設定する要素- 戻り値:
- true(Collection.add(E)で指定されているとおり)
-
setAll
public boolean setAll(Collection<? extends E> elements)
次のインタフェースからコピーされた説明:ObservableList
ObservableListをクリアし、コレクションのすべての要素を追加します。- 定義:
- インタフェース
ObservableList<E>
のsetAll
- パラメータ:
elements
- このobservableArrayListに追加される要素を使用したコレクション。- 戻り値:
- true(Collection.add(E)で指定されているとおり)
-
removeAll
public boolean removeAll(E... elements)
次のインタフェースからコピーされた説明:ObservableList
removeAll
メソッドのvar-arg使用の便利なメソッド。- 定義:
- インタフェース
ObservableList<E>
のremoveAll
- パラメータ:
elements
- 削除する要素- 戻り値:
- この呼出しの結果、リストが変更された場合はtrue
-
retainAll
public boolean retainAll(E... elements)
次のインタフェースからコピーされた説明:ObservableList
retainAll
メソッドのvar-arg使用の便利なメソッド。- 定義:
- インタフェース
ObservableList<E>
のretainAll
- パラメータ:
elements
- 保持する要素- 戻り値:
- この呼出しの結果、リストが変更された場合はtrue
-
remove
public void remove(int from, int to)
次のインタフェースからコピーされた説明:ObservableList
sublist(from, to).clear()
を呼び出す簡単な方法。 これは一般的な操作であるため、ObservableListは便利な使い方のためにこのメソッドを持っています。- 定義:
remove
、インタフェース:ObservableList<E>
- パラメータ:
from
- 削除する範囲の開始(含む)to
- 削除する範囲の最後(含まない)
-
-