モジュール javafx.base

パッケージ javafx.beans

インタフェースObservable

既知のすべてのサブインタフェース:

Binding<T>, JavaBeanProperty<T>, NumberBinding, NumberExpression, ObservableArray<T>, ObservableBooleanValue, ObservableDoubleValue, ObservableFaceArray, ObservableFloatArray, ObservableFloatValue, ObservableIntegerArray, ObservableIntegerValue, ObservableList<E>, ObservableListValue<E>, ObservableLongValue, ObservableMap<K,V>, ObservableMapValue<K,V>, ObservableNumberValue, ObservableObjectValue<T>, ObservableSet<E>, ObservableSetValue<E>, ObservableStringValue, ObservableValue<T>, Property<T>, ReadOnlyJavaBeanProperty<T>, ReadOnlyProperty<T>, TextInputControl.Content, WritableListValue<E>, WritableMapValue<K,V>, WritableSetValue<E>

既知のすべての実装クラス:

BooleanBinding, BooleanExpression, BooleanProperty, BooleanPropertyBase, DoubleBinding, DoubleExpression, DoubleProperty, DoublePropertyBase, FilteredList, FloatBinding, FloatExpression, FloatProperty, FloatPropertyBase, IntegerBinding, IntegerExpression, IntegerProperty, IntegerPropertyBase, JavaBeanBooleanProperty, JavaBeanDoubleProperty, JavaBeanFloatProperty, JavaBeanIntegerProperty, JavaBeanLongProperty, JavaBeanObjectProperty, JavaBeanStringProperty, ListBinding, ListExpression, ListProperty, ListPropertyBase, LongBinding, LongExpression, LongProperty, LongPropertyBase, MapBinding, MapExpression, MapProperty, MapPropertyBase, ModifiableObservableListBase, NumberExpressionBase, ObjectBinding, ObjectExpression, ObjectProperty, ObjectPropertyBase, ObservableArrayBase, ObservableListBase, ObservableValueBase, ReadOnlyBooleanProperty, ReadOnlyBooleanPropertyBase, ReadOnlyBooleanWrapper, ReadOnlyDoubleProperty, ReadOnlyDoublePropertyBase, ReadOnlyDoubleWrapper, ReadOnlyFloatProperty, ReadOnlyFloatPropertyBase, ReadOnlyFloatWrapper, ReadOnlyIntegerProperty, ReadOnlyIntegerPropertyBase, ReadOnlyIntegerWrapper, ReadOnlyJavaBeanBooleanProperty, ReadOnlyJavaBeanDoubleProperty, ReadOnlyJavaBeanFloatProperty, ReadOnlyJavaBeanIntegerProperty, ReadOnlyJavaBeanLongProperty, ReadOnlyJavaBeanObjectProperty, ReadOnlyJavaBeanStringProperty, ReadOnlyListProperty, ReadOnlyListPropertyBase, ReadOnlyListWrapper, ReadOnlyLongProperty, ReadOnlyLongPropertyBase, ReadOnlyLongWrapper, ReadOnlyMapProperty, ReadOnlyMapPropertyBase, ReadOnlyMapWrapper, ReadOnlyObjectProperty, ReadOnlyObjectPropertyBase, ReadOnlyObjectWrapper, ReadOnlySetProperty, ReadOnlySetPropertyBase, ReadOnlySetWrapper, ReadOnlyStringProperty, ReadOnlyStringPropertyBase, ReadOnlyStringWrapper, SetBinding, SetExpression, SetProperty, SetPropertyBase, SimpleBooleanProperty, SimpleDoubleProperty, SimpleFloatProperty, SimpleIntegerProperty, SimpleListProperty, SimpleLongProperty, SimpleMapProperty, SimpleObjectProperty, SimpleSetProperty, SimpleStringProperty, SimpleStyleableBooleanProperty, SimpleStyleableDoubleProperty, SimpleStyleableFloatProperty, SimpleStyleableIntegerProperty, SimpleStyleableLongProperty, SimpleStyleableObjectProperty, SimpleStyleableStringProperty, SortedList, StringBinding, StringExpression, StringProperty, StringPropertyBase, StyleableBooleanProperty, StyleableDoubleProperty, StyleableFloatProperty, StyleableIntegerProperty, StyleableLongProperty, StyleableObjectProperty, StyleableStringProperty, TransformationList

public interface Observable

Observableは、コンテンツをラップし、無効にするコンテンツを監視できるエンティティです。

Observableの実装は、遅延評価をサポートする場合があります。つまり、コンテンツが変更後にすぐに再計算されず、遅延して次のリクエスト時に実行されることを意味します。 このライブラリのすべてのバインディングおよびプロパティは、遅延評価をサポートします。

このクラスの実装は、イベント・ハンドラでの時間の大量消費を回避するためにできるだけ少ないイベントを生成する必要があります。 このライブラリの実装は、最初の無効化イベントの発生時に無効とマークされます。 値が再計算されて再度有効になるまで、追加の無効化イベントを生成しません。

導入されたバージョン:

JavaFX 2.0

関連項目:

ObservableValue、ObservableList、ObservableMap

メソッドのサマリー

修飾子と型	メソッド	説明
void	addListener(InvalidationListener listener)	Observableが無効になるたびに通知されるInvalidationListenerを追加します。
void	removeListener(InvalidationListener listener)	Observableの値が無効になるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

メソッドの詳細

addListener

void addListener(InvalidationListener listener)

Observableが無効になるたびに通知されるInvalidationListenerを追加します。 同じリスナーが複数回追加される場合、複数回通知されます。 つまり、一意性を確認するためにチェックが実行されません。

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

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

パラメータ:

listener - 登録するリスナー

例外:

NullPointerException - リスナーがnullである場合

関連項目:

removeListener(InvalidationListener)

removeListener

void removeListener(InvalidationListener listener)

Observableの値が無効になるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

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

パラメータ:

listener - 削除するリスナー

例外:

NullPointerException - リスナーがnullである場合

関連項目:

addListener(InvalidationListener)