Class TextInputDialog

java.lang.Object

javafx.scene.control.Dialog<String>

javafx.scene.control.TextInputDialog

All Implemented Interfaces:

EventTarget

public class TextInputDialog
extends Dialog<String>

A dialog that shows a text input control to the user.

Since:

JavaFX 8u40

See Also:

• Dialog

Property Summary

Properties declared in class Dialog

contentText, dialogPane, graphic, headerText, height, onCloseRequest, onHidden, onHiding, onShowing, onShown, resizable, resultConverter, result, showing, title, width, x, y

Type	Property	Description
final StringProperty	contentText	A property representing the content text for the dialog pane.
final ObjectProperty<DialogPane>	dialogPane	The root node of the dialog, the DialogPane contains all visual elements shown in the dialog.
final ObjectProperty<Node>	graphic	The dialog graphic, presented either in the header, if one is showing, or to the left of the content.
final StringProperty	headerText	A property representing the header text for the dialog pane.
final ReadOnlyDoubleProperty	height	Property representing the height of the dialog.
final ObjectProperty<EventHandler<DialogEvent>>	onCloseRequest	Called when there is an external request to close this Dialog.
final ObjectProperty<EventHandler<DialogEvent>>	onHidden	Called just after the Dialog has been hidden.
final ObjectProperty<EventHandler<DialogEvent>>	onHiding	Called just prior to the Dialog being hidden.
final ObjectProperty<EventHandler<DialogEvent>>	onShowing	Called just prior to the Dialog being shown.
final ObjectProperty<EventHandler<DialogEvent>>	onShown	Called just after the Dialog is shown.
final BooleanProperty	resizable	Represents whether the dialog is resizable.
final ObjectProperty<Callback<ButtonType, String>>	resultConverter	API to convert the ButtonType that the user clicked on into a result that can be returned via the result property.
final ObjectProperty<String>	result	A property representing what has been returned from the dialog.
final ReadOnlyBooleanProperty	showing	Represents whether the dialog is currently showing.
final StringProperty	title	Return the titleProperty of the dialog.
final ReadOnlyDoubleProperty	width	Property representing the width of the dialog.
final ReadOnlyDoubleProperty	x	The horizontal location of this Dialog.
final ReadOnlyDoubleProperty	y	The vertical location of this Dialog.

Constructor Summary

Constructors

Constructor	Description
TextInputDialog()	Creates a new TextInputDialog without a default value entered into the dialog TextField.
TextInputDialog(String defaultValue)	Creates a new TextInputDialog with the default value entered into the dialog TextField.

Method Summary

Modifier and Type	Method	Description
final String	getDefaultValue()	Returns the default value that was specified in the constructor.
final TextField	getEditor()	Returns the TextField used within this dialog.

Methods declared in class Dialog

addEventFilter, addEventHandler, buildEventDispatchChain, close, contentTextProperty, dialogPaneProperty, getContentText, getDialogPane, getGraphic, getHeaderText, getHeight, getModality, getOnCloseRequest, getOnHidden, getOnHiding, getOnShowing, getOnShown, getOwner, getResult, getResultConverter, getTitle, getWidth, getX, getY, graphicProperty, headerTextProperty, heightProperty, hide, initModality, initOwner, initStyle, isResizable, isShowing, onCloseRequestProperty, onHiddenProperty, onHidingProperty, onShowingProperty, onShownProperty, removeEventFilter, removeEventHandler, resizableProperty, resultConverterProperty, resultProperty, setContentText, setDialogPane, setGraphic, setHeaderText, setHeight, setOnCloseRequest, setOnHidden, setOnHiding, setOnShowing, setOnShown, setResizable, setResult, setResultConverter, setTitle, setWidth, setX, setY, show, showAndWait, showingProperty, titleProperty, widthProperty, xProperty, yProperty

Modifier and Type	Method	Description
final <E extends Event> void	addEventFilter(EventType<E> eventType, EventHandler<? super E> eventFilter)	Registers an event filter for this target.
final <E extends Event> void	addEventHandler(EventType<E> eventType, EventHandler<? super E> eventHandler)	Registers an event handler for this target.
EventDispatchChain	buildEventDispatchChain(EventDispatchChain tail)	Construct an event dispatch chain for this target.
final void	close()	Closes this Dialog.
final StringProperty	contentTextProperty()	A property representing the content text for the dialog pane.
final ObjectProperty<DialogPane>	dialogPaneProperty()	The root node of the dialog, the DialogPane contains all visual elements shown in the dialog.
final String	getContentText()	Returns the currently-set content text for this DialogPane.
final DialogPane	getDialogPane()	Gets the value of the dialogPane property.
final Node	getGraphic()	Gets the value of the graphic property.
final String	getHeaderText()	Returns the currently-set header text for this DialogPane.
final double	getHeight()	Returns the height of the dialog.
final Modality	getModality()	Retrieves the modality attribute for this dialog.
final EventHandler<DialogEvent>	getOnCloseRequest()	Gets the value of the onCloseRequest property.
final EventHandler<DialogEvent>	getOnHidden()	Gets the value of the onHidden property.
final EventHandler<DialogEvent>	getOnHiding()	Gets the value of the onHiding property.
final EventHandler<DialogEvent>	getOnShowing()	Gets the value of the onShowing property.
final EventHandler<DialogEvent>	getOnShown()	Gets the value of the onShown property.
final Window	getOwner()	Retrieves the owner Window for this dialog, or null for an unowned dialog.
final String	getResult()	Gets the value of the result property.
final Callback<ButtonType, String>	getResultConverter()	Gets the value of the resultConverter property.
final String	getTitle()	Return the title of the dialog.
final double	getWidth()	Returns the width of the dialog.
final double	getX()	Gets the value of the x property.
final double	getY()	Gets the value of the y property.
final ObjectProperty<Node>	graphicProperty()	The dialog graphic, presented either in the header, if one is showing, or to the left of the content.
final StringProperty	headerTextProperty()	A property representing the header text for the dialog pane.
final ReadOnlyDoubleProperty	heightProperty()	Property representing the height of the dialog.
final void	hide()	Hides this Dialog.
final void	initModality(Modality modality)	Specifies the modality for this dialog.
final void	initOwner(Window window)	Specifies the owner Window for this dialog, or null for a top-level, unowned dialog.
final void	initStyle(StageStyle style)	Specifies the style for this dialog.
final boolean	isResizable()	Returns whether or not the dialog is resizable.
final boolean	isShowing()	Returns whether or not the dialog is showing.
final ObjectProperty<EventHandler<DialogEvent>>	onCloseRequestProperty()	Called when there is an external request to close this Dialog.
final ObjectProperty<EventHandler<DialogEvent>>	onHiddenProperty()	Called just after the Dialog has been hidden.
final ObjectProperty<EventHandler<DialogEvent>>	onHidingProperty()	Called just prior to the Dialog being hidden.
final ObjectProperty<EventHandler<DialogEvent>>	onShowingProperty()	Called just prior to the Dialog being shown.
final ObjectProperty<EventHandler<DialogEvent>>	onShownProperty()	Called just after the Dialog is shown.
final <E extends Event> void	removeEventFilter(EventType<E> eventType, EventHandler<? super E> eventFilter)	Unregisters a previously registered event filter from this target.
final <E extends Event> void	removeEventHandler(EventType<E> eventType, EventHandler<? super E> eventHandler)	Unregisters a previously registered event handler from this target.
final BooleanProperty	resizableProperty()	Represents whether the dialog is resizable.
final ObjectProperty<Callback<ButtonType, String>>	resultConverterProperty()	API to convert the ButtonType that the user clicked on into a result that can be returned via the result property.
final ObjectProperty<String>	resultProperty()	A property representing what has been returned from the dialog.
final void	setContentText(String contentText)	Sets the string to show in the dialog content area.
final void	setDialogPane(DialogPane value)	Sets the value of the dialogPane property.
final void	setGraphic(Node graphic)	Sets the dialog graphic, which will be displayed either in the header, if one is showing, or to the left of the content.
final void	setHeaderText(String headerText)	Sets the string to show in the dialog header area.
final void	setHeight(double height)	Sets the height of the dialog.
final void	setOnCloseRequest(EventHandler<DialogEvent> value)	Sets the value of the onCloseRequest property.
final void	setOnHidden(EventHandler<DialogEvent> value)	Sets the value of the onHidden property.
final void	setOnHiding(EventHandler<DialogEvent> value)	Sets the value of the onHiding property.
final void	setOnShowing(EventHandler<DialogEvent> value)	Sets the value of the onShowing property.
final void	setOnShown(EventHandler<DialogEvent> value)	Sets the value of the onShown property.
final void	setResizable(boolean resizable)	Sets whether the dialog can be resized by the user.
final void	setResult(String value)	Sets the value of the result property.
final void	setResultConverter(Callback<ButtonType, String> value)	Sets the value of the resultConverter property.
final void	setTitle(String title)	Change the Title of the dialog.
final void	setWidth(double width)	Sets the width of the dialog.
final void	setX(double x)	Sets the value of the x property.
final void	setY(double y)	Sets the value of the y property.
final void	show()	Shows the dialog but does not wait for a user response (in other words, this brings up a non-blocking dialog).
final Optional<String>	showAndWait()	Shows the dialog and waits for the user response (in other words, brings up a blocking dialog, with the returned value the users input).
final ReadOnlyBooleanProperty	showingProperty()	Represents whether the dialog is currently showing.
final StringProperty	titleProperty()	Return the titleProperty of the dialog.
final ReadOnlyDoubleProperty	widthProperty()	Property representing the width of the dialog.
final ReadOnlyDoubleProperty	xProperty()	The horizontal location of this Dialog.
final ReadOnlyDoubleProperty	yProperty()	The vertical location of this Dialog.

Methods declared in class Object

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

Constructor Details

TextInputDialog

public TextInputDialog()

Creates a new TextInputDialog without a default value entered into the dialog TextField.

TextInputDialog

public TextInputDialog(String defaultValue)

Creates a new TextInputDialog with the default value entered into the dialog TextField.

Parameters:

defaultValue - the default value entered into the dialog

Method Details

getEditor

public final TextField getEditor()

Returns the TextField used within this dialog.

Returns:

the TextField used within this dialog

getDefaultValue

public final String getDefaultValue()

Returns the default value that was specified in the constructor.

Returns:

the default value that was specified in the constructor