diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanBinding.java index f573c59b88a..a16e65252f6 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanBinding.java @@ -60,7 +60,7 @@ public abstract class BooleanBinding extends BooleanExpression implements Binding { /** - * Sole constructor + * Creates a default {@code BooleanBinding}. */ public BooleanBinding() { } diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanExpression.java index 08479466e35..8f112746f04 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/BooleanExpression.java @@ -45,7 +45,7 @@ public abstract class BooleanExpression implements ObservableBooleanValue { /** - * Sole constructor + * Creates a default {@code BooleanExpression}. */ public BooleanExpression() { } diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleBinding.java index e1ef8e3d482..8695ec4f4c4 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleBinding.java @@ -116,6 +116,12 @@ public abstract class DoubleBinding extends DoubleExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code DoubleBinding}. + */ + public DoubleBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleExpression.java index 58c74c189d2..530ac69c71c 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/DoubleExpression.java @@ -44,6 +44,12 @@ public abstract class DoubleExpression extends NumberExpressionBase implements ObservableDoubleValue { + /** + * Creates a default {@code DoubleExpression}. + */ + public DoubleExpression() { + } + @Override public int intValue() { return (int) get(); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/FloatBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/FloatBinding.java index 52c47b4c2c5..e4c910870f8 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/FloatBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/FloatBinding.java @@ -66,6 +66,12 @@ public abstract class FloatBinding extends FloatExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code FloatBinding}. + */ + public FloatBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/FloatExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/FloatExpression.java index 3d88c283f75..3ea1ef52dc6 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/FloatExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/FloatExpression.java @@ -43,6 +43,12 @@ public abstract class FloatExpression extends NumberExpressionBase implements ObservableFloatValue { + /** + * Creates a default {@code FloatExpression}. + */ + public FloatExpression() { + } + @Override public int intValue() { return (int) get(); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerBinding.java index fec04f64a31..d3a37a75188 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerBinding.java @@ -66,6 +66,12 @@ public abstract class IntegerBinding extends IntegerExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code IntegerBinding}. + */ + public IntegerBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerExpression.java index 53605216c16..d738e3bdc00 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/IntegerExpression.java @@ -43,6 +43,12 @@ public abstract class IntegerExpression extends NumberExpressionBase implements ObservableIntegerValue { + /** + * Creates a default {@code IntegerExpression}. + */ + public IntegerExpression() { + } + @Override public int intValue() { return get(); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/ListBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/ListBinding.java index 17b671b0b95..8fd745fac5f 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/ListBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/ListBinding.java @@ -64,6 +64,12 @@ */ public abstract class ListBinding extends ListExpression implements Binding> { + /** + * Creates a default {@code ListBinding}. + */ + public ListBinding() { + } + private final ListChangeListener listChangeListener = new ListChangeListener() { @Override public void onChanged(Change change) { diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/ListExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/ListExpression.java index da3437195f4..2facdc31a9c 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/ListExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/ListExpression.java @@ -57,6 +57,12 @@ public abstract class ListExpression implements ObservableListValue { private static final ObservableList EMPTY_LIST = FXCollections.emptyObservableList(); + /** + * Creates a default {@code ListExpression}. + */ + public ListExpression() { + } + @Override public ObservableList getValue() { return get(); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/LongBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/LongBinding.java index 1e803b20da6..5b5472e9341 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/LongBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/LongBinding.java @@ -66,6 +66,12 @@ public abstract class LongBinding extends LongExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code LongBinding}. + */ + public LongBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/LongExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/LongExpression.java index b53b0867d56..a484f423dff 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/LongExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/LongExpression.java @@ -42,6 +42,12 @@ public abstract class LongExpression extends NumberExpressionBase implements ObservableLongValue { + /** + * Creates a default {@code LongExpression}. + */ + public LongExpression() { + } + @Override public int intValue() { return (int) get(); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/MapBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/MapBinding.java index b40021e8f46..a0af07d6378 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/MapBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/MapBinding.java @@ -84,6 +84,12 @@ public void onChanged(Change change) { private SizeProperty size0; private EmptyProperty empty0; + /** + * Creates a default {@code MapBinding}. + */ + public MapBinding() { + } + @Override public ReadOnlyIntegerProperty sizeProperty() { if (size0 == null) { diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/MapExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/MapExpression.java index c2ec48f61a3..4e79ac8e43a 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/MapExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/MapExpression.java @@ -91,6 +91,12 @@ public ObservableMap getValue() { return get(); } + /** + * Creates a default {@code MapExpression}. + */ + public MapExpression() { + } + /** * Returns a {@code MapExpression} that wraps a * {@link javafx.beans.value.ObservableMapValue}. If the diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/NumberExpressionBase.java b/modules/javafx.base/src/main/java/javafx/beans/binding/NumberExpressionBase.java index 3874ff82047..6069f0e175e 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/NumberExpressionBase.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/NumberExpressionBase.java @@ -49,6 +49,12 @@ */ public abstract class NumberExpressionBase implements NumberExpression { + /** + * Creates a default {@code NumberExpressionBase}. + */ + public NumberExpressionBase() { + } + /** * Returns an {@code NumberExpressionBase} that wraps a * {@link javafx.beans.value.ObservableNumberValue}. If the diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectBinding.java index 92a0721b3f6..43d8527241e 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectBinding.java @@ -66,6 +66,12 @@ public abstract class ObjectBinding extends ObjectExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code ObjectBinding}. + */ + public ObjectBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectExpression.java index 8ade0530f1b..092d49251bd 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/ObjectExpression.java @@ -49,6 +49,12 @@ public T getValue() { return get(); } + /** + * Creates a default {@code ObjectExpression}. + */ + public ObjectExpression() { + } + /** * Returns an {@code ObjectExpression} that wraps an * {@link javafx.beans.value.ObservableObjectValue}. If the diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/SetBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/SetBinding.java index 4ba6508a870..dcd68cef246 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/SetBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/SetBinding.java @@ -65,6 +65,12 @@ */ public abstract class SetBinding extends SetExpression implements Binding> { + /** + * Creates a default {@code SetBinding}. + */ + public SetBinding() { + } + private final SetChangeListener setChangeListener = new SetChangeListener() { @Override public void onChanged(Change change) { diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/SetExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/SetExpression.java index ae1afb0466d..6a5e56adb3f 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/SetExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/SetExpression.java @@ -57,6 +57,12 @@ */ public abstract class SetExpression implements ObservableSetValue { + /** + * Creates a default {@code SetExpression}. + */ + public SetExpression() { + } + private static final ObservableSet EMPTY_SET = new EmptyObservableSet(); private static class EmptyObservableSet extends AbstractSet implements ObservableSet { diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/StringBinding.java b/modules/javafx.base/src/main/java/javafx/beans/binding/StringBinding.java index d32e3c376a6..fab0e70281c 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/StringBinding.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/StringBinding.java @@ -65,6 +65,12 @@ public abstract class StringBinding extends StringExpression implements private BindingHelperObserver observer; private ExpressionHelper helper = null; + /** + * Creates a default {@code StringBinding}. + */ + public StringBinding() { + } + @Override public void addListener(InvalidationListener listener) { helper = ExpressionHelper.addListener(helper, this, listener); diff --git a/modules/javafx.base/src/main/java/javafx/beans/binding/StringExpression.java b/modules/javafx.base/src/main/java/javafx/beans/binding/StringExpression.java index f96f9183f45..c777fd30352 100644 --- a/modules/javafx.base/src/main/java/javafx/beans/binding/StringExpression.java +++ b/modules/javafx.base/src/main/java/javafx/beans/binding/StringExpression.java @@ -46,6 +46,12 @@ */ public abstract class StringExpression implements ObservableStringValue { + /** + * Creates a default {@code StringExpression}. + */ + public StringExpression() { + } + @Override public String getValue() { return get(); diff --git a/modules/javafx.controls/src/main/java/javafx/scene/control/Cell.java b/modules/javafx.controls/src/main/java/javafx/scene/control/Cell.java index f2774171af2..e448cd54c4c 100644 --- a/modules/javafx.controls/src/main/java/javafx/scene/control/Cell.java +++ b/modules/javafx.controls/src/main/java/javafx/scene/control/Cell.java @@ -575,6 +575,7 @@ public final BooleanProperty editableProperty() { **************************************************************************/ /** + * Starts an edit to the value of the cell. * Call this function to transition from a non-editing state into an editing * state, if the cell is editable. If this cell is already in an editing * state, it will stay in it. @@ -586,6 +587,7 @@ public void startEdit() { } /** + * Cancels an edit to the value of the cell. * Call this function to transition from an editing state into a non-editing * state, without saving any user input. */ @@ -596,11 +598,12 @@ public void cancelEdit() { } /** + * Commits an edit to the value of the cell. * Call this function when appropriate (based on the user interaction requirements * of your cell editing user interface) to do two things: * *
    - *
  1. Fire the appropriate events back to the backing UI control (e.g. + *
  2. Fire the appropriate events back to the backing UI control (e.g., * {@link ListView}). This will begin the process of pushing this edit * back to the relevant data source / property (although it does not * guarantee that this will be successful - that is dependent upon the @@ -611,12 +614,12 @@ public void cancelEdit() { * *

    In general there is no need to override this method in custom cell * implementations - it should be sufficient to simply call this method - * when appropriate (e.g. when the user pressed the Enter key, you may do something + * when appropriate (e.g., when the user pressed the Enter key, you may do something * like {@code cell.commitEdit(converter.fromString(textField.getText()));}

    * - * @param newValue The value as input by the end user, which should be + * @param newValue the value as input by the end user, which should be * persisted in the relevant way given the data source underpinning the - * user interface and the install edit commit handler of the UI control. + * user interface and the install edit commit handler of the UI control */ public void commitEdit(T newValue) { if (isEditing()) { diff --git a/modules/javafx.fxml/src/main/docs/javafx/fxml/doc-files/introduction_to_fxml.html b/modules/javafx.fxml/src/main/docs/javafx/fxml/doc-files/introduction_to_fxml.html index dc738eaf8b0..7819eec5d06 100644 --- a/modules/javafx.fxml/src/main/docs/javafx/fxml/doc-files/introduction_to_fxml.html +++ b/modules/javafx.fxml/src/main/docs/javafx/fxml/doc-files/introduction_to_fxml.html @@ -720,7 +720,7 @@

    Special handlers for collections a

    Collections and object properties cannot be listen to using setOnEvent() methods. For these reason, special handler methods need to be used. ObservableList, ObservableMap or ObservableSet - uses a special onChange attribute that points to a handler method with a ListChangeListner.Change, MapChangeListener.Change or SetChangeListener.Change parameter respectively. + uses a special onChange attribute that points to a handler method with a ListChangeListener.Change, MapChangeListener.Change or SetChangeListener.Change parameter, respectively.

     <VBox fx:controller="com.foo.MyController"
    diff --git a/modules/javafx.graphics/src/main/java/javafx/animation/Transition.java b/modules/javafx.graphics/src/main/java/javafx/animation/Transition.java
    index 78d1e207502..cc66a5502e9 100644
    --- a/modules/javafx.graphics/src/main/java/javafx/animation/Transition.java
    +++ b/modules/javafx.graphics/src/main/java/javafx/animation/Transition.java
    @@ -40,7 +40,7 @@
      * the implementation of a method {@link #interpolate(double)} which is the
      * called in each frame, while the {@code Transition} is running.
      * 

    - * In addition an extending class needs to set the duration of a single cycle + * In addition, an extending class needs to set the duration of a single cycle * with {@link Animation#setCycleDuration(javafx.util.Duration)}. This duration * is usually set by the user via a duration property (as in * {@link FadeTransition#durationProperty() duration}) for example. But it can also be calculated diff --git a/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java b/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java index 9b02628fe8e..8356cf6bac0 100644 --- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java +++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java @@ -48,8 +48,6 @@ import javafx.geometry.HPos; import javafx.util.Callback; - - /** * HBox lays out its children in a single horizontal row. * If the hbox has a border and/or padding set, then the contents will be laid @@ -168,13 +166,14 @@ public class HBox extends Pane { /** * Sets the horizontal grow priority for the child when contained by an hbox. - * If set, the hbox will use the priority to allocate additional space if the - * hbox is resized larger than it's preferred width. + * If set, the hbox will use the priority value to allocate additional space if the + * hbox is resized larger than its preferred width. * If multiple hbox children have the same horizontal grow priority, then the * extra space will be split evenly between them. * If no horizontal grow priority is set on a child, the hbox will never - * allocate it additional horizontal space if available. - * Setting the value to null will remove the constraint. + * allocate any additional horizontal space for that child. + *

    + * Setting the value to {@code null} will remove the constraint. * @param child the child of an hbox * @param value the horizontal grow priority for the child */ @@ -227,14 +226,14 @@ public static void clearConstraints(Node child) { ********************************************************************/ /** - * Creates an HBox layout with spacing = 0. + * Creates an {@code HBox} layout with {@code spacing = 0}. */ public HBox() { super(); } /** - * Creates an HBox layout with the specified spacing between children. + * Creates an {@code HBox} layout with the specified spacing between children. * @param spacing the amount of horizontal space between each child */ public HBox(double spacing) { @@ -243,8 +242,8 @@ public HBox(double spacing) { } /** - * Creates an HBox layout with spacing = 0. - * @param children The initial set of children for this pane. + * Creates an {@code HBox} layout with {@code spacing = 0}. + * @param children the initial set of children for this pane * @since JavaFX 8.0 */ public HBox(Node... children) { @@ -253,9 +252,9 @@ public HBox(Node... children) { } /** - * Creates an HBox layout with the specified spacing between children. + * Creates an {@code HBox} layout with the specified spacing between children. * @param spacing the amount of horizontal space between each child - * @param children The initial set of children for this pane. + * @param children the initial set of children for this pane * @since JavaFX 8.0 */ public HBox(double spacing, Node... children) { diff --git a/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java b/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java index 0f02eb1fea8..9eecfe7f30f 100644 --- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java +++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java @@ -154,16 +154,17 @@ public class VBox extends Pane { private static final String VGROW_CONSTRAINT = "vbox-vgrow"; /** - * Sets the vertical grow priority for the child when contained by an vbox. - * If set, the vbox will use the priority to allocate additional space if the - * vbox is resized larger than it's preferred height. + * Sets the vertical grow priority for the child when contained by a vbox. + * If set, the vbox will use the priority value to allocate additional space if the + * vbox is resized larger than its preferred height. * If multiple vbox children have the same vertical grow priority, then the * extra space will be split evenly between them. * If no vertical grow priority is set on a child, the vbox will never - * allocate it additional vertical space if available. - * Setting the value to null will remove the constraint. + * allocate any additional vertical space for that child. + *

    + * Setting the value to {@code null} will remove the constraint. * @param child the child of a vbox - * @param value the horizontal grow priority for the child + * @param value the vertical grow priority for the child */ public static void setVgrow(Node child, Priority value) { setConstraint(child, VGROW_CONSTRAINT, value); @@ -214,14 +215,14 @@ public static void clearConstraints(Node child) { ********************************************************************/ /** - * Creates a VBox layout with spacing = 0 and alignment at TOP_LEFT. + * Creates a {@code VBox} layout with {@code spacing = 0} and alignment at {@code TOP_LEFT}. */ public VBox() { super(); } /** - * Creates a VBox layout with the specified spacing between children. + * Creates a {@code VBox} layout with the specified spacing between children. * @param spacing the amount of vertical space between each child */ public VBox(double spacing) { @@ -230,8 +231,8 @@ public VBox(double spacing) { } /** - * Creates an VBox layout with spacing = 0. - * @param children The initial set of children for this pane. + * Creates a {@code VBox} layout with {@code spacing = 0}. + * @param children the initial set of children for this pane * @since JavaFX 8.0 */ public VBox(Node... children) { @@ -240,9 +241,9 @@ public VBox(Node... children) { } /** - * Creates an VBox layout with the specified spacing between children. - * @param spacing the amount of horizontal space between each child - * @param children The initial set of children for this pane. + * Creates a {@code VBox} layout with the specified spacing between children. + * @param spacing the amount of vertical space between each child + * @param children the initial set of children for this pane * @since JavaFX 8.0 */ public VBox(double spacing, Node... children) { diff --git a/modules/javafx.graphics/src/main/java/javafx/scene/text/Text.java b/modules/javafx.graphics/src/main/java/javafx/scene/text/Text.java index 6c1b4b4c32e..70b1bdf871a 100644 --- a/modules/javafx.graphics/src/main/java/javafx/scene/text/Text.java +++ b/modules/javafx.graphics/src/main/java/javafx/scene/text/Text.java @@ -795,13 +795,11 @@ public final ReadOnlyDoubleProperty baselineOffsetProperty() { /** * Specifies a requested font smoothing type: gray or LCD. - * - * The width of the bounding box is defined by the widest row. - * + *

    * Note: LCD mode doesn't apply in numerous cases, such as various * compositing modes, where effects are applied and very large glyphs. * - * @defaultValue FontSmoothingType.GRAY + * @defaultValue {@code FontSmoothingType.GRAY} * @since JavaFX 2.1 */ private ObjectProperty fontSmoothingType;