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

クラスListBinding<E>

  • 型パラメータ:
    E - List要素の型
    すべての実装されたインタフェース:
    Iterable<E>, Collection<E>, List<E>, Binding<ObservableList<E>>, Observable, ObservableListValue<E>, ObservableObjectValue<E>, ObservableValue<E>, ObservableList<E>

    public abstract class ListBinding<E>
extends ListExpression<E>
implements Binding<ObservableList<E>>
    ObservableListのBindingを実装するために必要なほとんどの機能を提供するベース・クラス。

    ListBindingは、簡単な無効性スキームを提供します。 拡張クラスは、bind(Observable...)を呼び出して依存性を登録できます。 登録された依存性のいずれかが無効になる場合、このListBindingは無効とマークされます。 unbind(Observable...)を使用すると、依存性のリスニングを停止できます。

    このクラスの具体的な実装を提供するには、依存性の現在の状態に基づいてこのバインディングの値を計算するためにメソッドcomputeValue()を実装する必要があります。 get()が無効なバインディングに対して呼び出される場合に呼び出されます。

    このベース・クラスの拡張方法の例は、DoubleBindingを参照してください。

    導入されたバージョン:
    JavaFX 2.1
    関連項目:
    Binding、ListExpression

    • コンストラクタの詳細

      • ListBinding

        public ListBinding​()

    • メソッドの詳細

      • addListener

        public void addListener​(InvalidationListener listener)
        次のインタフェースからコピーされた説明: Observable
        Observableが無効になるたびに通知されるInvalidationListenerを追加します。 同じリスナーが複数回追加される場合、複数回通知されます。 つまり、一意性を確認するためにチェックが実行されません。

        実際の同じInvalidationListenerインスタンスが異なるObservablesに対して安全に登録される場合があるので注意してください。

        Observableは、リスナーの強参照を格納するため、リスナーはガベージ・コレクションされず、メモリー・リークが発生する可能性があります。 使用後にremoveListenerを呼び出してリスナーを登録解除するか、WeakInvalidationListenerのインスタンスを使用してこの状況を回避することをお薦めします。

        定義:
        インタフェースObservableのaddListener
        パラメータ:
        listener - 登録するリスナー
        関連項目:
        Observable.removeListener(InvalidationListener)

      • removeListener

        public void removeListener​(InvalidationListener listener)
        次のインタフェースからコピーされた説明: Observable
        Observableの値が無効になるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

        指定されたリスナーが以前に登録されていない場合(つまり、一度も追加されていなかった場合)、このメソッドの呼出しはno-opです。 以前に追加されたことがある場合は削除されます。 複数回追加された場合、最初の発生のみ削除されます。

        定義:
        インタフェースObservableのremoveListener
        パラメータ:
        listener - 削除するリスナー
        関連項目:
        Observable.addListener(InvalidationListener)

      • addListener

        public void addListener​(ChangeListener<? super ObservableList<E>> listener)
        次のインタフェースからコピーされた説明: ObservableValue
        ObservableValueの値が変更されるたびに通知されるChangeListenerを追加します。 同じリスナーが複数回追加される場合、複数回通知されます。 つまり、一意性を確認するためにチェックが実行されません。

        実際の同じChangeListenerインスタンスが異なるObservableValuesに対して安全に登録される場合があるので注意してください。

        ObservableValueは、リスナーの強参照を格納するため、リスナーはガベージ・コレクションされず、メモリー・リークが発生する可能性があります。 使用後にremoveListenerを呼び出してリスナーを登録解除するか、WeakChangeListenerのインスタンスを使用してこの状況を回避することをお薦めします。

        定義:
        インタフェースObservableValue<E>内のaddListener
        パラメータ:
        listener - 登録するリスナー
        関連項目:
        ObservableValue.removeListener(ChangeListener)

      • removeListener

        public void removeListener​(ChangeListener<? super ObservableList<E>> listener)
        次のインタフェースからコピーされた説明: ObservableValue
        ObservableValueの値が変更されるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

        指定されたリスナーが以前に登録されていない場合(つまり、一度も追加されていなかった場合)、このメソッドの呼出しはno-opです。 以前に追加されたことがある場合は削除されます。 複数回追加された場合、最初の発生のみ削除されます。

        定義:
        インタフェースObservableValue<E>内のremoveListener
        パラメータ:
        listener - 削除するリスナー
        関連項目:
        ObservableValue.addListener(ChangeListener)

      • addListener

        public void addListener​(ListChangeListener<? super E> listener)
        次のインタフェースからコピーされた説明: ObservableList
        リスナーをこの監視可能リストに追加します。
        定義:
        インタフェースObservableList<E>のaddListener
        パラメータ:
        listener - リストの変更をリスニングするリスナー

      • removeListener

        public void removeListener​(ListChangeListener<? super E> listener)
        次のインタフェースからコピーされた説明: ObservableList
        この観測可能リストからリスナーを削除しようとします。 リスナーがこのリストにアタッチされていない場合、何も発生しません。
        定義:
        インタフェースObservableList<E>のremoveListener
        パラメータ:
        listener - 削除するリスナー

      • bind

        protected final void bind​(Observable... dependencies)
        変更の依存性の監視を開始します。 依存性のいずれかの値が変更される場合、バインディングは無効とマークされます。
        パラメータ:
        dependencies - 監視する依存性

      • unbind

        protected final void unbind​(Observable... dependencies)
        変更の依存性の監視を停止します。
        パラメータ:
        dependencies - 監視を停止する依存性

      • dispose

        public void dispose​()
        空であるdispose()のデフォルトの実装。
        定義:
        インタフェースBinding<E>内のdispose

      • get

        public final ObservableList<E> get​()
        computeValue()の結果を返します。 バインディングが無効である場合、メソッドcomputeValue()のみ呼び出されます。 get()の最後の呼出しからバインディングが無効でなくなった場合、結果がキャッシュされて返されます。
        定義:
        インタフェースObservableObjectValue<E>内のget
        戻り値:
        現行値

      • onInvalidating

        protected void onInvalidating​()
        このバインディングが無効になる場合、反応するクラスを拡張して、メソッドonInvalidating()をオーバーライドできます。 デフォルトの実装は空です。

      • invalidate

        public final void invalidate​()
        次のインタフェースからコピーされた説明: Binding
        バインディングを無効とマークします。 これにより、次にリクエストするときにBindingの値が強制的に再計算されます。
        定義:
        インタフェースBinding<E>内のinvalidate

      • isValid

        public final boolean isValid​()
        次のインタフェースからコピーされた説明: Binding
        バインディングが有効かどうかを確認します。
        定義:
        インタフェースBinding<E>内のisValid
        戻り値:
        Bindingが有効な場合はtrue、そうでない場合はfalse

      • computeValue

        protected abstract ObservableList<E> computeValue​()
        このバインディングの現在の値を計算します。

        ListBindingを拡張するクラスは、computeValueの実装を提供する必要があります。

        戻り値:
        現行値

      • toString

        public String toString​()
        このListBindingオブジェクトの文字列表現を返します。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        このListBindingオブジェクトの文字列表現。