org.jminor.javafx.framework.ui

Class FXUiUtil

java.lang.Object

org.jminor.javafx.framework.ui.FXUiUtil

public final class FXUiUtil
extends java.lang.Object

A factory class for UI related things.

Method Summary

Modifier and Type	Method and Description
static boolean	confirm(java.lang.String message) Displays a confirmation dialog
static boolean	confirm(java.lang.String headerText, java.lang.String message) Displays a confirmation dialog
static boolean	confirm(java.lang.String title, java.lang.String headerText, java.lang.String message) Displays a confirmation dialog
static javafx.scene.control.TextField	createBigDecimalField(Property property, FXEntityEditModel editModel) Instantiates a TextField for BigDecimal values, based on the given property and linked to the given edit model
static javafx.scene.control.TextField	createBigDecimalField(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a TextField for BigDecimal values, based on the given property and linked to the given edit model
static StringValue<java.math.BigDecimal>	createBigDecimalValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for BigDecimal values, based on the given property and linked to the given text field
static Value<java.lang.Boolean>	createBooleanValue(javafx.scene.control.CheckBox checkBox) Instantiates a Value instance based on the value of the given CheckBox
static javafx.scene.control.CheckBox	createCheckBox() Instantiates a new CheckBox instance
static javafx.scene.control.CheckBox	createCheckBox(Property property, FXEntityEditModel editModel) Instantiates a CheckBox based on the given property, linked to the given edit model
static javafx.scene.control.CheckBox	createCheckBox(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a CheckBox based on the given property, linked to the given edit model
static javafx.scene.control.CheckBox	createCheckBox(State state) Instantiates a CheckBox based on the given State instance
static javafx.scene.control.CheckBox	createCheckBox(StateObserver enabledState) Instantiates a new CheckBox instance
static javafx.scene.control.Control	createControl(Property property, EntityConnectionProvider connectionProvider) Instantiates a Control based on the given property.
static javafx.scene.control.DatePicker	createDatePicker()
static javafx.scene.control.DatePicker	createDatePicker(Property property, FXEntityEditModel editModel) Instantiates a DatePicker based on the given property and linked to the given edit model
static javafx.scene.control.DatePicker	createDatePicker(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a DatePicker based on the given property and linked to the given edit model
static javafx.scene.control.DatePicker	createDatePicker(StateObserver enabledState)
static StringValue<java.time.LocalDate>	createDateValue(Property property, javafx.scene.control.DatePicker picker) Instantiates a StringValue for LocalDate values, based on the given property and linked to the given text field
static javafx.scene.control.TextField	createDoubleField(Property property, FXEntityEditModel editModel) Instantiates a TextField for Double values, based on the given property and linked to the given edit model
static javafx.scene.control.TextField	createDoubleField(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a TextField for Double values, based on the given property and linked to the given edit model
static StringValue<java.lang.Double>	createDoubleValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for Double values, based on the given property and linked to the given text field
static Value<Entity>	createEntityValue(javafx.scene.control.ComboBox<Entity> comboBox) Instantiates a Value instance based on the given ComboBox
static javafx.scene.control.ComboBox<Entity>	createForeignKeyComboBox(ForeignKeyProperty foreignKeyProperty, FXEntityEditModel editModel) Instantiates a ComboBox based on the given property and linked to the given edit model
static javafx.scene.control.TextField	createIntegerField(Property property, FXEntityEditModel editModel) Instantiates a TextField for Integer values, based on the given property and linked to the given edit model
static javafx.scene.control.TextField	createIntegerField(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a TextField for Integer values, based on the given property and linked to the given edit model
static StringValue<java.lang.Integer>	createIntegerValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for Integer values, based on the given property and linked to the given text field
static javafx.scene.control.TextField	createLongField(Property property, FXEntityEditModel editModel) Instantiates a TextField for Long values, based on the given property and linked to the given edit model
static javafx.scene.control.TextField	createLongField(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a TextField for Long values, based on the given property and linked to the given edit model
static StringValue<java.lang.Long>	createLongValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for Long values, based on the given property and linked to the given text field
static EntityLookupField	createLookupField(ForeignKeyProperty foreignKeyProperty, FXEntityEditModel editModel) Instantiates a EntityLookupField based on the given property and linked to the given edit model
static StringValue<java.lang.String>	createStringValue(javafx.scene.control.TextField textField) Instantiates a StringValue based on the given text field
static javafx.scene.control.TextField	createTextField(Property property) Instantiates a TextField based on the given property
static javafx.scene.control.TextField	createTextField(Property property, FXEntityEditModel editModel) Instantiates a TextField based on the given property, linked to the given edit model
static javafx.scene.control.TextField	createTextField(Property property, FXEntityEditModel editModel, StateObserver enabledState) Instantiates a TextField based on the given property, linked to the given edit model
static javafx.scene.control.TextField	createTextField(Property property, StateObserver enabledState) Instantiates a TextField based on the given property
static StringValue<java.time.LocalDateTime>	createTimestampValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for LocalDateTime values, based on the given property and linked to the given text field
static StringValue<java.time.LocalTime>	createTimeValue(Property property, javafx.scene.control.TextField textField) Instantiates a StringValue for LocalTime values, based on the given property and linked to the given text field
static javafx.scene.control.ToggleButton	createToggleButton(State state) Instantiates a ToggleButton based on the given State instance
static Value	createValue(Property property, javafx.scene.control.Control control, java.lang.Object defaultValue) Instantiates a Value instance based on the given property, linked to the given control
static javafx.scene.control.ComboBox<Item>	createValueListComboBox(ValueListProperty valueListProperty, FXEntityEditModel editModel) Instantiates a ComboBox based on the values of the given property and linked to the given edit model
static javafx.collections.ObservableList<Item>	createValueListComboBoxModel(ValueListProperty property) Instantiates a ObservableList containing the Items associated with the given value list property
static <T> T	getParentOfType(javafx.scene.Node node, java.lang.Class<T> clazz) Finds and returns the first parent of node of the given type
static void	link(javafx.beans.property.BooleanProperty property, StateObserver stateObserver) Links the given boolean property to the given state observer, so that changes is one are reflected in the other
static <T> T	selectValue(java.util.List<T> values) Displays a dialog for selecting one of the given values
static <T> java.util.List<T>	selectValues(java.util.List<T> values) Displays a dialog for selecting one or more of the given values
static <T> java.util.List<T>	selectValues(java.util.List<T> values, boolean single) Displays a dialog for selecting one or more of the given values
static void	setClipboard(java.lang.String string) Sets the given string as the system clipboard value
static void	showExceptionDialog(java.lang.Throwable exception) Displays an exception dialog for the given exception
static User	showLoginDialog(java.lang.String applicationTitle, User defaultUser, javafx.scene.image.ImageView icon) Displays a login dialog

Methods inherited from class java.lang.Object

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

Method Detail

selectValue

public static <T> T selectValue(java.util.List<T> values)

Displays a dialog for selecting one of the given values

Type Parameters:

T - the type of values

Parameters:

values - the values from which to choose

Returns:

the selected value

Throws:

CancelException - in case the user cancels the operation

selectValues

public static <T> java.util.List<T> selectValues(java.util.List<T> values)

Displays a dialog for selecting one or more of the given values

Type Parameters:

T - the type of values

Parameters:

values - the values from which to choose

Returns:

the selected values

Throws:

CancelException - in case the user cancels the operation

selectValues

public static <T> java.util.List<T> selectValues(java.util.List<T> values,
                                                 boolean single)

Displays a dialog for selecting one or more of the given values

Type Parameters:

T - the type of values

Parameters:

values - the values from which to choose

single - if true then only a single value can be selected

Returns:

the selected values

Throws:

CancelException - in case the user cancels the operation

setClipboard

public static void setClipboard(java.lang.String string)

Sets the given string as the system clipboard value

Parameters:

string - the string to add to the clipboard

confirm

public static boolean confirm(java.lang.String message)

Displays a confirmation dialog

Parameters:

message - the message to display

Returns:

true if confirmed

confirm

public static boolean confirm(java.lang.String headerText,
                              java.lang.String message)

Displays a confirmation dialog

Parameters:

headerText - the dialog header text

message - the message to display

Returns:

true if confirmed

confirm

public static boolean confirm(java.lang.String title,
                              java.lang.String headerText,
                              java.lang.String message)

Displays a confirmation dialog

Parameters:

title - the dialog title

headerText - the dialog header text

message - the message to display

Returns:

true if confirmed

createValue

public static Value createValue(Property property,
                                javafx.scene.control.Control control,
                                java.lang.Object defaultValue)

Instantiates a Value instance based on the given property, linked to the given control

Parameters:

property - the property

control - the control

defaultValue - the default to set after instantiation

Returns:

the Value instance

createEntityValue

public static Value<Entity> createEntityValue(javafx.scene.control.ComboBox<Entity> comboBox)

Instantiates a Value instance based on the given ComboBox

Parameters:

comboBox - the combo box on which to base the value

Returns:

the Value instance

createToggleButton

public static javafx.scene.control.ToggleButton createToggleButton(State state)

Instantiates a ToggleButton based on the given State instance

Parameters:

state - the state on which to base the toggle button

Returns:

a ToggleButton based on the given state

createCheckBox

public static javafx.scene.control.CheckBox createCheckBox(State state)

Instantiates a CheckBox based on the given State instance

Parameters:

state - the state on which to base the check box

Returns:

a CheckBox based on the given state

createControl

public static javafx.scene.control.Control createControl(Property property,
                                                         EntityConnectionProvider connectionProvider)

Instantiates a Control based on the given property.

Parameters:

property - the property

connectionProvider - the EntityConnectionProvider instance to use

Returns:

a Control based on the given property

createCheckBox

public static javafx.scene.control.CheckBox createCheckBox(Property property,
                                                           FXEntityEditModel editModel)

Instantiates a CheckBox based on the given property, linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a CheckBox based on the given property and edit model

createCheckBox

public static javafx.scene.control.CheckBox createCheckBox(Property property,
                                                           FXEntityEditModel editModel,
                                                           StateObserver enabledState)

Instantiates a CheckBox based on the given property, linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the check box

Returns:

a CheckBox based on the given property and edit model

createBooleanValue

public static Value<java.lang.Boolean> createBooleanValue(javafx.scene.control.CheckBox checkBox)

Instantiates a Value instance based on the value of the given CheckBox

Parameters:

checkBox - the check box on which to base the value

Returns:

a Value based on the given check box

createTextField

public static javafx.scene.control.TextField createTextField(Property property,
                                                             FXEntityEditModel editModel)

Instantiates a TextField based on the given property, linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a TextField based on the given property

createTextField

public static javafx.scene.control.TextField createTextField(Property property,
                                                             FXEntityEditModel editModel,
                                                             StateObserver enabledState)

Instantiates a TextField based on the given property, linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField based on the given property

createStringValue

public static StringValue<java.lang.String> createStringValue(javafx.scene.control.TextField textField)

Instantiates a StringValue based on the given text field

Parameters:

textField - the text field

Returns:

a StringValue based on the given text field

createLongField

public static javafx.scene.control.TextField createLongField(Property property,
                                                             FXEntityEditModel editModel)

Instantiates a TextField for Long values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a TextField for Long values, based on the given property

createLongField

public static javafx.scene.control.TextField createLongField(Property property,
                                                             FXEntityEditModel editModel,
                                                             StateObserver enabledState)

Instantiates a TextField for Long values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField for Long values, based on the given property

createLongValue

public static StringValue<java.lang.Long> createLongValue(Property property,
                                                          javafx.scene.control.TextField textField)

Instantiates a StringValue for Long values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for Long values, based on the given property

createIntegerField

public static javafx.scene.control.TextField createIntegerField(Property property,
                                                                FXEntityEditModel editModel)

Instantiates a TextField for Integer values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a TextField for Integer values, based on the given property

createIntegerField

public static javafx.scene.control.TextField createIntegerField(Property property,
                                                                FXEntityEditModel editModel,
                                                                StateObserver enabledState)

Instantiates a TextField for Integer values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField for Integer values, based on the given property

createIntegerValue

public static StringValue<java.lang.Integer> createIntegerValue(Property property,
                                                                javafx.scene.control.TextField textField)

Instantiates a StringValue for Integer values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for Integer values, based on the given property

createDoubleField

public static javafx.scene.control.TextField createDoubleField(Property property,
                                                               FXEntityEditModel editModel)

Instantiates a TextField for Double values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a TextField for Double values, based on the given property

createDoubleField

public static javafx.scene.control.TextField createDoubleField(Property property,
                                                               FXEntityEditModel editModel,
                                                               StateObserver enabledState)

Instantiates a TextField for Double values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField for Double values, based on the given property

createBigDecimalField

public static javafx.scene.control.TextField createBigDecimalField(Property property,
                                                                   FXEntityEditModel editModel)

Instantiates a TextField for BigDecimal values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a TextField for BigDecimal values, based on the given property

createBigDecimalField

public static javafx.scene.control.TextField createBigDecimalField(Property property,
                                                                   FXEntityEditModel editModel,
                                                                   StateObserver enabledState)

Instantiates a TextField for BigDecimal values, based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField for BigDecimal values, based on the given property

createDoubleValue

public static StringValue<java.lang.Double> createDoubleValue(Property property,
                                                              javafx.scene.control.TextField textField)

Instantiates a StringValue for Double values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for Double values, based on the given property

createBigDecimalValue

public static StringValue<java.math.BigDecimal> createBigDecimalValue(Property property,
                                                                      javafx.scene.control.TextField textField)

Instantiates a StringValue for BigDecimal values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for BigDecimal values, based on the given property

createDatePicker

public static javafx.scene.control.DatePicker createDatePicker(Property property,
                                                               FXEntityEditModel editModel)

Instantiates a DatePicker based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

Returns:

a DatePicker based on the given property

createDatePicker

public static javafx.scene.control.DatePicker createDatePicker(Property property,
                                                               FXEntityEditModel editModel,
                                                               StateObserver enabledState)

Instantiates a DatePicker based on the given property and linked to the given edit model

Parameters:

property - the property

editModel - the edit model

enabledState - the State instance controlling the enabled state of the date picker

Returns:

a DatePicker based on the given property

createDateValue

public static StringValue<java.time.LocalDate> createDateValue(Property property,
                                                               javafx.scene.control.DatePicker picker)

Instantiates a StringValue for LocalDate values, based on the given property and linked to the given text field

Parameters:

property - the property

picker - the date picker

Returns:

a StringValue for LocalDate values, based on the given property

createTimestampValue

public static StringValue<java.time.LocalDateTime> createTimestampValue(Property property,
                                                                        javafx.scene.control.TextField textField)

Instantiates a StringValue for LocalDateTime values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for LocalDateTime values, based on the given property

createTimeValue

public static StringValue<java.time.LocalTime> createTimeValue(Property property,
                                                               javafx.scene.control.TextField textField)

Instantiates a StringValue for LocalTime values, based on the given property and linked to the given text field

Parameters:

property - the property

textField - the text field

Returns:

a StringValue for LocalTime values, based on the given property

link

public static void link(javafx.beans.property.BooleanProperty property,
                        StateObserver stateObserver)

Links the given boolean property to the given state observer, so that changes is one are reflected in the other

Parameters:

property - the boolean property

stateObserver - the state observer

createLookupField

public static EntityLookupField createLookupField(ForeignKeyProperty foreignKeyProperty,
                                                  FXEntityEditModel editModel)

Instantiates a EntityLookupField based on the given property and linked to the given edit model

Parameters:

foreignKeyProperty - the foreign key property

editModel - the edit model

Returns:

a EntityLookupField based on the given property

createForeignKeyComboBox

public static javafx.scene.control.ComboBox<Entity> createForeignKeyComboBox(ForeignKeyProperty foreignKeyProperty,
                                                                             FXEntityEditModel editModel)

Instantiates a ComboBox based on the given property and linked to the given edit model

Parameters:

foreignKeyProperty - the foreign key property

editModel - the edit model

Returns:

a ComboBox based on the given property

createValueListComboBox

public static javafx.scene.control.ComboBox<Item> createValueListComboBox(ValueListProperty valueListProperty,
                                                                          FXEntityEditModel editModel)

Instantiates a ComboBox based on the values of the given property and linked to the given edit model

Parameters:

valueListProperty - the property

editModel - the edit model

Returns:

a ComboBox based on the values of the given property

createCheckBox

public static javafx.scene.control.CheckBox createCheckBox()

Instantiates a new CheckBox instance

Returns:

the check box

createCheckBox

public static javafx.scene.control.CheckBox createCheckBox(StateObserver enabledState)

Instantiates a new CheckBox instance

Parameters:

enabledState - the State instance controlling the enabled state of the check box

Returns:

the check box

createValueListComboBoxModel

public static javafx.collections.ObservableList<Item> createValueListComboBoxModel(ValueListProperty property)

Instantiates a ObservableList containing the Items associated with the given value list property

Parameters:

property - the property

Returns:

a ObservableList containing the Items associated with the given value list property

createTextField

public static javafx.scene.control.TextField createTextField(Property property)

Instantiates a TextField based on the given property

Parameters:

property - the property

Returns:

a TextField based on the given property

createTextField

public static javafx.scene.control.TextField createTextField(Property property,
                                                             StateObserver enabledState)

Instantiates a TextField based on the given property

Parameters:

property - the property

enabledState - the State instance controlling the enabled state of the text field

Returns:

a TextField based on the given property

createDatePicker

public static javafx.scene.control.DatePicker createDatePicker()

Returns:

a DatePicker instance

createDatePicker

public static javafx.scene.control.DatePicker createDatePicker(StateObserver enabledState)

Parameters:

enabledState - the State instance controlling the enabled state of the date picker

Returns:

a DatePicker instance

showLoginDialog

public static User showLoginDialog(java.lang.String applicationTitle,
                                   User defaultUser,
                                   javafx.scene.image.ImageView icon)

Displays a login dialog

Parameters:

applicationTitle - the title to display

defaultUser - the default user to display in the dialog

icon - the icon, if any

Returns:

a User instance based on the values found in the dialog

Throws:

CancelException - in case the user cancels the operation

showExceptionDialog

public static void showExceptionDialog(java.lang.Throwable exception)

Displays an exception dialog for the given exception

Parameters:

exception - the exception to display

getParentOfType

public static <T> T getParentOfType(javafx.scene.Node node,
                                    java.lang.Class<T> clazz)

Finds and returns the first parent of node of the given type

Type Parameters:

T - the type of the parent

Parameters:

node - the child node

clazz - the type to find

Returns:

the parent, or null if none is found