javafx
Свойства и наблюдаемые
Поиск…
замечания
Свойства можно наблюдать, и к ним можно добавить слушателей. Они последовательно используются для свойств Node
.
Типы свойств и наименований
Стандартные свойства
В зависимости от типа свойства существует до 3 методов для одного свойства. Пусть <property>
обозначает имя свойства и <Property>
имя свойства с первой буквой в верхнем регистре. И пусть T
- тип свойства; для примитивных оболочек мы используем здесь примитивный тип, например String
для StringProperty
и double
для ReadOnlyDoubleProperty
.
Имя метода | параметры | Тип возврата | Цель |
---|---|---|---|
<property>Property | () | Само свойство, например DoubleProperty , ReadOnlyStringProperty , ObjectProperty<VPos> | вернуть свойство для добавления слушателей / привязки |
get<Property> | () | T | вернуть значение, завернутое в свойство |
set<Property> | (T) | void | установить значение свойства |
Обратите внимание, что сеттер не существует для свойств readonly.
Свойства списка Readonly
Свойства Readonly list - это свойства, которые предоставляют только метод getter. Тип такого свойства - ObservableList
, предпочтительно с указанным типом agrument. Значение этого свойства никогда не изменяется; вместо этого может быть изменено содержимое ObservableList
.
Свойства Readonly map
Подобно свойствам readonly list свойства readonly map предоставляют только getter, и содержимое может быть изменено вместо значения свойства. Геттер возвращает ObservableMap
.
Пример StringProperty
В следующем примере показано объявление свойства ( StringProperty
в этом случае) и демонстрируется, как добавить к нему ChangeListener
.
import java.text.MessageFormat;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.beans.value.ChangeListener;
import javafx.beans.value.ObservableValue;
public class Person {
private final StringProperty name = new SimpleStringProperty();
public final String getName() {
return this.name.get();
}
public final void setName(String value) {
this.name.set(value);
}
public final StringProperty nameProperty() {
return this.name;
}
public static void main(String[] args) {
Person person = new Person();
person.nameProperty().addListener(new ChangeListener<String>() {
@Override
public void changed(ObservableValue<? extends String> observable, String oldValue, String newValue) {
System.out.println(MessageFormat.format("The name changed from \"{0}\" to \"{1}\"", oldValue, newValue));
}
});
person.setName("Anakin Skywalker");
person.setName("Darth Vader");
}
}
Пример ReadOnlyIntegerProperty
В этом примере показано, как использовать свойство оболочки readonly для создания свойства, которое невозможно записать. В этом случае cost
и price
могут быть изменены, но profit
всегда будет price - cost
.
import java.text.MessageFormat;
import javafx.beans.property.IntegerProperty;
import javafx.beans.property.ReadOnlyIntegerProperty;
import javafx.beans.property.ReadOnlyIntegerWrapper;
import javafx.beans.property.SimpleIntegerProperty;
import javafx.beans.value.ChangeListener;
import javafx.beans.value.ObservableValue;
public class Product {
private final IntegerProperty price = new SimpleIntegerProperty();
private final IntegerProperty cost = new SimpleIntegerProperty();
private final ReadOnlyIntegerWrapper profit = new ReadOnlyIntegerWrapper();
public Product() {
// the property itself can be written to
profit.bind(price.subtract(cost));
}
public final int getCost() {
return this.cost.get();
}
public final void setCost(int value) {
this.cost.set(value);
}
public final IntegerProperty costProperty() {
return this.cost;
}
public final int getPrice() {
return this.price.get();
}
public final void setPrice(int value) {
this.price.set(value);
}
public final IntegerProperty priceProperty() {
return this.price;
}
public final int getProfit() {
return this.profit.get();
}
public final ReadOnlyIntegerProperty profitProperty() {
// return a readonly view of the property
return this.profit.getReadOnlyProperty();
}
public static void main(String[] args) {
Product product = new Product();
product.profitProperty().addListener(new ChangeListener<Number>() {
@Override
public void changed(ObservableValue<? extends Number> observable, Number oldValue, Number newValue) {
System.out.println(MessageFormat.format("The profit changed from {0}$ to {1}$", oldValue, newValue));
}
});
product.setCost(40);
product.setPrice(50);
product.setCost(20);
product.setPrice(30);
}
}