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

クラスJavaBeanStringProperty

  • すべての実装されたインタフェース:
    Observable, JavaBeanProperty<String>, ReadOnlyJavaBeanProperty<String>, Property<String>, ReadOnlyProperty<String>, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>, WritableObjectValue<String>, WritableStringValue, WritableValue<String>

    public final class JavaBeanStringProperty
extends StringProperty
implements JavaBeanProperty<String>
    JavaBeanStringPropertyは、String型の通常のJava BeanプロパティとJavaFX StringProperty間のアダプタを提供します。 直接作成できませんが、JavaBeanStringPropertyBuilderを使用する必要があります。

    Java Beanクラスは、少なくとも、プロパティのゲッターとセッターを実装する必要があります。 クラスとgetterメソッドとsetterメソッドは、宣言されている必要があります。 このクラスのインスタンスのgetterが呼び出されると、Java Beanのプロパティが返されます。 setterが呼び出されると、値がJava Beanプロパティに渡されます。 Java Beanプロパティがバインドされる場合(つまり、PropertyChangeListenersをサポートする場合)、このJavaBeanStringPropertyは、Java Beanの変更を認識します。 それ以外の場合、fireValueChangedEvent()を呼び出して変更を通知できます。 Java Beanプロパティが制約もされる場合(つまり、VetoableChangeListenersをサポートする場合)、このJavaBeanStringPropertyは、ObservableValue<String>にバインドされている場合に変更を拒否します。

    アプリケーションをモジュールとしてデプロイ

    Java Beanクラスが名前付きモジュールにある場合は、javafx.baseモジュールに反射的にアクセス可能である必要があります。 モジュールが少なくともjavafx.baseモジュールに含まれているパッケージをopensすると、クラスは反射的にアクセス可能です。

    com.foo.MyBeanClassがfoo.appモジュールである場合、例えば、module-info.javaは次のようになります: 

    module foo.app {
    opens com.foo to javafx.base;
}

    あるいは、モジュールが含まれているパッケージを無条件にexportsすると、クラスは反射的にアクセス可能です。

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

    • メソッドの詳細

      • bind

        public void bind​(ObservableValue<? extends String> observable)
        このPropertyの一方向バインディングを作成します。

        JavaFXが弱いリスナーを通じて実装されるすべてのバインドの呼出しを持つことに注意してください。 これはバインドされたプロパティがガベージ・コレクションされて更新を停止できることを意味します。

        定義:
        インタフェースProperty<String>のbind
        パラメータ:
        observable - このPropertyをバインドするobservable。

      • isBound

        public boolean isBound​()
        Propertyがバインドされているかどうかを確認するために使用できます。
        定義:
        インタフェースProperty<String>のisBound
        戻り値:
        Propertyがバインドされている場合はtrue、そうでない場合はfalse
        関連項目:
        Property.bind(javafx.beans.value.ObservableValue)

      • getBean

        public Object getBean​()
        このプロパティを含むObjectを返します。 このプロパティがObjectに含まれていない場合、nullが返されます。
        定義:
        インタフェースReadOnlyProperty<String>のgetBean
        戻り値:
        含まれているObjectまたはnull

      • getName

        public String getName​()
        このプロパティの名前を返します。 プロパティに名前がない場合、このメソッドは空のStringを返します。
        定義:
        インタフェースReadOnlyProperty<String>のgetName
        戻り値:
        名前または空のString

      • addListener

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

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

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

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

      • removeListener

        public void removeListener​(ChangeListener<? super String> listener)
        ObservableValueの値が変更されるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

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

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

      • addListener

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

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

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

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

      • removeListener

        public void removeListener​(InvalidationListener listener)
        Observableの値が無効になるたびに通知されるリスナーのリストから指定されたリスナーを削除します。

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

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

      • fireValueChangedEvent

        public void fireValueChangedEvent​()
        Java Beanプロパティがバインドされていない場合(つまり、PropertyChangeListenersをサポートしていない場合)、このメソッドを呼び出して、アダプタにJava Bean値の変更を通知できます。
        定義:
        インタフェースReadOnlyJavaBeanProperty<String>のfireValueChangedEvent

      • dispose

        public void dispose​()
        使用しなくなるJavaFXプロパティを示し、参照を削除できます。 通常このメソッドを呼び出すと、プロパティでリスナーを登録解除してJava Beanプロパティの監視を停止します。
        定義:
        インタフェースReadOnlyJavaBeanProperty<String>のdispose