モジュール javafx.base
パッケージ javafx.beans.binding

クラスListExpression<E>

    • プロパティのサマリー

      プロパティ 
      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.lang.Iterableから継承されたメソッド

        forEach
    • コンストラクタの詳細

      • ListExpression

        public ListExpression​()
    • メソッドの詳細

      • listExpression

        public static <E> ListExpression<E> listExpression​(ObservableListValue<E> value)
        ObservableListValueをラップするListExpressionを返します。 ObservableListValueがすでにListExpressionである場合に返されます。 それ以外の場合、ObservableListValueにバインドされる新しいListBindingが作成されます。
        型パラメータ:
        E - ラップされたListの型
        パラメータ:
        value - ソースObservableListValue
        戻り値:
        必要に応じてObservableListValueをラップするListExpression
        例外:
        NullPointerException - valuenullの場合
      • getSize

        public int 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 - indexnullである場合
      • 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を返します。
        定義:
        size、インタフェース: Collection<E>
        定義:
        size、インタフェース: List<E>
        戻り値:
        このリスト内の要素数
      • isEmpty

        public boolean isEmpty​()
        空のプロパティの値を取得します。
        定義:
        isEmpty、インタフェース: Collection<E>
        定義:
        isEmpty、インタフェース: List<E>
        プロパティの説明:
        リストが空である場合にtrueであるブール型プロパティ。
        戻り値:
        このリストに要素が含まれていない場合はtrue
      • contains

        public boolean contains​(Object obj)
        インタフェースからコピーされた説明: List
        指定された要素がこのリストに含まれている場合にtrueを返します。 より正式には、このリストにObjects.equals(o, e)などの少なくとも1つの要素eが含まれている場合にのみtrueを返します。
        定義:
        contains、インタフェース: Collection<E>
        定義:
        contains、インタフェース: List<E>
        パラメータ:
        obj - このリストの存在がテストされる要素
        戻り値:
        指定された要素がこのリスト内にある場合はtrue
      • iterator

        public Iterator<E> iterator​()
        インタフェースからコピーされた説明: List
        このリスト内の要素を適切な順序で反復するイテレータを返します。
        定義:
        iterator、インタフェース: Collection<E>
        定義:
        iterator、インタフェース: Iterable<E>
        定義:
        iterator、インタフェース: List<E>
        戻り値:
        リスト内の要素を適切な順序で反復するイテレータ
      • 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()と同一です。
        定義:
        toArray、インタフェース: Collection<E>
        定義:
        toArray、インタフェース: List<E>
        型パラメータ:
        T - コレクションを含む配列の実行時の型
        パラメータ:
        array - このリストの要素が格納される配列。それ以外の場合は、同じ実行時型の新しい配列がこの目的のために割り当てられます。
        戻り値:
        このリストの要素が含まれている配列
      • 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を返します。
        定義:
        remove、インタフェース: Collection<E>
        定義:
        remove、インタフェース: List<E>
        パラメータ:
        obj - このリストから削除される要素(存在する場合)
        戻り値:
        指定された要素がこのリストに含まれていた場合は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を加えます。 新しい要素は、指定されたコレクションのイテレータによって返される順序でこのリストに挿入されます。 オペレーションの進行中に、指定されたコレクションが変更された場合の、このオペレーションの動作は定義されていません。 (これは、指定されたコレクションがこのリストで、しかも空ではない場合に起こります。)
        定義:
        addAll、インタフェース: List<E>
        パラメータ:
        i - 指定されたコレクションから最初の要素を挿入するインデックス
        elements - このリストに追加される要素を含むコレクション
        戻り値:
        呼出しの結果としてこのリストが変更された場合はtrue
      • 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
        すべての要素をこのリストから削除します(オプションの操作)。 この呼出しが戻ると、このリストは空になります。
        定義:
        clear、インタフェース: Collection<E>
        定義:
        clear、インタフェース: List<E>
      • get

        public E get​(int i)
        インタフェースからコピーされた説明: List
        このリスト内の指定された位置にある要素を返します。
        定義:
        get、インタフェース: List<E>
        パラメータ:
        i - 戻す要素のインデックス
        戻り値:
        このリスト内の指定された位置にある要素
      • set

        public E set​(int i,
                     E element)
        インタフェースからコピーされた説明: List
        このリスト内の指定された位置にある要素を、指定された要素に置き換えます(オプションの操作)。
        定義:
        set、インタフェース: List<E>
        パラメータ:
        i - 置き換える要素のインデックス
        element - 指定された位置に格納される要素。
        戻り値:
        指定された位置に以前あった要素。
      • add

        public void add​(int i,
                        E element)
        インタフェースからコピーされた説明: List
        このリスト内の指定された位置に、指定された要素を挿入します(オプションの操作)。 その位置とそれ以降に要素があればそれらを右に移動させ、各要素のインデックスに1を加えます。
        定義:
        add、インタフェース: List<E>
        パラメータ:
        i - 指定された要素が挿入されるインデックス
        element - 挿入される要素
      • remove

        public E remove​(int i)
        インタフェースからコピーされた説明: List
        このリスト内の指定された位置にある要素を削除します(オプションの操作)。 後続の要素を左に移動します(インデックスから1を減算)。 リストから削除された要素が返されます。
        定義:
        remove、インタフェース: List<E>
        パラメータ:
        i - 削除される要素のインデックス
        戻り値:
        指定された位置に以前あった要素。
      • indexOf

        public int indexOf​(Object obj)
        インタフェースからコピーされた説明: List
        指定された要素がこのリスト内で最初に検出された位置のインデックスを返します。指定された要素がこのリストにない場合は -1を返します。 より正式には、Objects.equals(o, get(i))のような最も低いインデックスi、またはそのようなインデックスがない場合は -1を返します。
        定義:
        indexOf、インタフェース: List<E>
        パラメータ:
        obj - 検索する要素
        戻り値:
        指定された要素がこのリスト内で最初に検出された位置のインデックス。その要素がこのリストにない場合は -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 (これを含まない)までの部分のビューを返します。 fromIndextoIndexが等しい場合は、空のリストが返されます。 返されるリストはこのリストに連動しているため、返されるリスト内での非構造的な変更はこのリストに反映され、このリスト内での変更は返されるリストに反映されます。 返されるリストは、このリストによってサポートされている、任意のリスト・オペレーションをすべてサポートします。

        このメソッドでは、配列に一般的に見られるような、明示的な範囲操作は必要ありません。 リストを予期する操作は、リスト全体ではなくsubListビューを渡すことで範囲操作として使用できます。 たとえば、次のイディオムは、ある範囲の要素をリストから削除します。

        
              list.subList(from, to).clear();
         
        indexOfおよびlastIndexOfでも同様のイディオムを構築して、CollectionsクラスのすべてのアルゴリズムをsubListに適用できます。

        バッキング・リスト(すなわち、このリスト)の構造が、返されたリストを経由せずに変更された場合、このメソッドで返されるリストのセマンティックスは定義されていません。 構造の変更とは、リストのサイズが変わるような変更や、進行中のイテレーションが不正な結果に終わるような変更のことです。

        定義:
        subList、インタフェース: List<E>
        パラメータ:
        from - subListの下位エンドポイント(inclusive)
        to - subListの上位エンドポイント(exclusive)
        戻り値:
        このリスト内の指定された範囲のビュー
      • 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 - 削除する範囲の最後(含まない)