org.eclipse.fx.ui.preferences.page

Class FieldEditor<T>

java.lang.Object

javafx.scene.Node

javafx.scene.Parent

javafx.scene.layout.Region

org.eclipse.fx.ui.preferences.page.FieldEditor<T>

All Implemented Interfaces:

javafx.css.Styleable, javafx.event.EventTarget

Direct Known Subclasses:

BooleanFieldEditor, ColorFieldEditor, FloatFieldEditor, IntegerFieldEditor, RadioGroupFieldEditor, StringFieldEditor

public abstract class FieldEditor<T>
extends javafx.scene.layout.Region

Field Summary

Fields

Modifier and Type	Field and Description
protected javafx.collections.ObservableList<java.util.function.Function<? super T,Status>>	validationFunctions

Fields inherited from class javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Fields inherited from class javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Constructor Summary

Constructors

Constructor and Description
FieldEditor(java.lang.String name)
FieldEditor(java.lang.String name, java.lang.String label)

Method Summary

Modifier and Type	Method and Description
protected javafx.beans.binding.ObjectExpression<Status>	createStatusBinding() Create the status binding for this field editor.
boolean	displayLabel() If true, the preference page will be responsible for displaying the label for this field editor.
protected abstract void	doLoad()
protected abstract void	doPersist()
protected abstract void	doRestoreDefaults()
javafx.beans.binding.StringExpression	errorMessage()
java.lang.String	getLabel()
Memento	getMemento()
protected java.lang.String	getName()
abstract javafx.beans.value.ObservableValue<T>	getValue() Return the value of this field editor.
javafx.beans.property.StringProperty	labelProperty()
protected void	layoutChildren() By default, give all available width and height to the children.
void	load()
void	persist()
Subscription	registerStatusValidator(java.util.function.Function<? super T,Status> validationFunction) Add a validation function to this field editor.
Subscription	registerValidator(java.util.function.Function<? super T,java.lang.String> validationFunction) Add a validation function to this field editor.
void	restoreDefaults()
protected void	setDefault(boolean isDefault)
void	setLabel(java.lang.String label)
void	setMemento(Memento memento)
javafx.beans.binding.ObjectExpression<Status>	statusProperty() Return the observable Status property for this editor's value.

Methods inherited from class javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, getBackground, getBorder, getClassCssMetaData, getCssMetaData, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, impl_computeContains, impl_computeGeomBounds, impl_computeLayoutBounds, impl_createPeer, impl_notifyLayoutBoundsChanged, impl_pickNodeLocal, impl_updatePeer, insetsProperty, isCacheShape, isCenterShape, isResizable, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapSize, snapSpace, snapToPixelProperty, widthProperty

Methods inherited from class javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getImpl_traversalEngine, getManagedChildren, getStylesheets, impl_getAllParentStylesheets, impl_processCSS, impl_processMXNode, impl_traversalEngineProperty, isNeedsLayout, layout, lookup, needsLayoutProperty, queryAccessibleAttribute, requestLayout, requestParentLayout, setImpl_traversalEngine, setNeedsLayout, updateBounds

Methods inherited from class javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, containsBounds, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, hasProperties, hoverProperty, idProperty, impl_clearDirty, impl_computeIntersects, impl_cssGetCursorInitialValue, impl_cssGetFocusTraversableInitialValue, impl_findStyles, impl_geomChanged, impl_getLeafTransform, impl_getMatchingStyles, impl_getPeer, impl_getPivotX, impl_getPivotY, impl_getPivotZ, impl_getStyleMap, impl_hasTransforms, impl_intersects, impl_intersectsBounds, impl_isDirty, impl_isDirtyEmpty, impl_isShowMnemonics, impl_isTreeVisible, impl_layoutBoundsChanged, impl_markDirty, impl_pickNode, impl_processCSS, impl_reapplyCSS, impl_setShowMnemonics, impl_setStyleMap, impl_showMnemonicsProperty, impl_syncPeer, impl_transformsChanged, impl_traverse, impl_treeVisibleProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

validationFunctions

protected final javafx.collections.ObservableList<java.util.function.Function<? super T,Status>> validationFunctions

Constructor Detail

FieldEditor

public FieldEditor(java.lang.String name,
                   java.lang.String label)

FieldEditor

public FieldEditor(java.lang.String name)

Method Detail

createStatusBinding

protected javafx.beans.binding.ObjectExpression<Status> createStatusBinding()

Create the status binding for this field editor. The default is computed by applying the validation functions to the current value upon value change.

Subclasses should override this method if they need to update the status independently from a value change (Typically, if the new user input doesn't result in a valid new value, thus can't trigger a value change).

layoutChildren

protected void layoutChildren()

By default, give all available width and height to the children. If more than one child is present in this field editor, subclasses should provide custom layout.

Overrides:

layoutChildren in class javafx.scene.Parent

setMemento

public void setMemento(Memento memento)

getMemento

public Memento getMemento()

getName

protected java.lang.String getName()

setDefault

protected void setDefault(boolean isDefault)

load

public final void load()

persist

public final void persist()

restoreDefaults

public final void restoreDefaults()

doLoad

protected abstract void doLoad()

doPersist

protected abstract void doPersist()

doRestoreDefaults

protected abstract void doRestoreDefaults()

errorMessage

public javafx.beans.binding.StringExpression errorMessage()

labelProperty

public final javafx.beans.property.StringProperty labelProperty()

getLabel

public final java.lang.String getLabel()

setLabel

public final void setLabel(java.lang.String label)

getValue

public abstract javafx.beans.value.ObservableValue<T> getValue()

Return the value of this field editor. This will be used to automatically manage setDefault(boolean).

displayLabel

public boolean displayLabel()

If true, the preference page will be responsible for displaying the label for this field editor.

Subclasses that need to control how their label should be displayed should override this method and return false.

statusProperty

public javafx.beans.binding.ObjectExpression<Status> statusProperty()

Return the observable Status property for this editor's value.

Returns:

registerStatusValidator

public Subscription registerStatusValidator(java.util.function.Function<? super T,Status> validationFunction)

Add a validation function to this field editor. The validation function accepts a value and produces a Status.

Parameters:

validationFunction - A Function taking a value as a parameter, and returning a Status

Returns:

A Subscription to unregister the validation function

registerValidator

public Subscription registerValidator(java.util.function.Function<? super T,java.lang.String> validationFunction)

Add a validation function to this field editor. The validation function accepts a value and produces an error message as a String, or null if the value is valid.

This is a simplified version of registerStatusValidator(Function): a null or empty message corresponds to Status#ok(), whereas a non-empty message corresponds to an Error status, with a default error code an no exception.

Parameters:

validationFunction - A Function taking a value as a parameter, and returning a String error message, or null if the value is valid.

Returns:

A Subscription to unregister the validation function

See Also:

registerStatusValidator(Function)