Class TextInputDialog

java.lang.Object

com.googlecode.lanterna.gui2.AbstractBasePane<Window>

com.googlecode.lanterna.gui2.AbstractWindow

com.googlecode.lanterna.gui2.dialogs.DialogWindow

com.googlecode.lanterna.gui2.dialogs.TextInputDialog

All Implemented Interfaces:

BasePane, Composite, Window

public class TextInputDialog
extends DialogWindow

TextInputDialog is a modal text input dialog that prompts the user to enter a text string. The class supports validation and password masking. The builder class to help setup TextInputDialogs is TextInputDialogBuilder.

Nested Class Summary

Nested classes/interfaces inherited from class AbstractBasePane

AbstractBasePane.ContentHolder

Nested classes/interfaces inherited from interface Window

Window.Hint

Field Summary

Fields

Modifier and Type	Field	Description
private String	result
private final TextBox	textBox
private final TextInputDialogResultValidator	validator

Fields inherited from class AbstractBasePane

contentHolder, interactableLookupMap

Constructor Summary

Constructors

Constructor	Description
TextInputDialog(String title, String description, TerminalSize textBoxPreferredSize, String initialContent, TextInputDialogResultValidator validator, boolean password)

Method Summary

Modifier and Type	Method	Description
private void	onCancel()
private void	onOK()
String	showDialog(WindowBasedTextGUI textGUI)	Opens the dialog by showing it on the GUI and doesn't return until the dialog has been closed
static String	showDialog(WindowBasedTextGUI textGUI, String title, String description, String initialContent)	Shortcut for quickly showing a TextInputDialog
static BigInteger	showNumberDialog(WindowBasedTextGUI textGUI, String title, String description, String initialContent)	Shortcut for quickly showing a TextInputDialog that only accepts numbers
static String	showPasswordDialog(WindowBasedTextGUI textGUI, String title, String description, String initialContent)	Shortcut for quickly showing a TextInputDialog with password masking

Methods inherited from class AbstractWindow

addWindowListener, close, draw, fromGlobal, fromGlobalToContentRelative, fromGlobalToDecoratedRelative, getDecoratedSize, getHints, getPosition, getPostRenderer, getPreferredSize, getSize, getTextGUI, getTitle, handleInput, isVisible, removeWindowListener, setCloseWindowWithEscape, setContentOffset, setDecoratedSize, setFixedSize, setHints, setPosition, setSize, setTextGUI, setTitle, setVisible, setWindowPostRenderer, toGlobal, toGlobalFromContentRelative, toGlobalFromDecoratedRelative, waitUntilClosed

Methods inherited from class AbstractBasePane

addBasePaneListener, getBasePaneListeners, getComponent, getCursorPosition, getFocusedInteractable, getMenuBar, getTheme, invalidate, isInvalid, removeBasePaneListener, setComponent, setEnableDirectionBasedMovements, setFocusedInteractable, setFocusedInteractable, setMenuBar, setStrictFocusChange, setTheme

Methods inherited from class Object

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

Methods inherited from interface BasePane

getTheme, setEnableDirectionBasedMovements, setStrictFocusChange, setTheme

Methods inherited from interface Window

getBounds, getComponent, getCursorPosition, getFocusedInteractable, getMenuBar, invalidate, isInvalid, setComponent, setFocusedInteractable, setMenuBar

Field Details

textBox

private final TextBox textBox

validator

private final TextInputDialogResultValidator validator

result

private String result

Constructor Details

TextInputDialog

TextInputDialog(String title,
 String description,
 TerminalSize textBoxPreferredSize,
 String initialContent,
 TextInputDialogResultValidator validator,
 boolean password)

Method Details

onOK

private void onOK()

onCancel

private void onCancel()

showDialog

public String showDialog(WindowBasedTextGUI textGUI)

Description copied from class: DialogWindow

Opens the dialog by showing it on the GUI and doesn't return until the dialog has been closed

Overrides:

showDialog in class DialogWindow

Parameters:

textGUI - Text GUI to add the dialog to

Returns:

Depending on the DialogWindow implementation, by default null

showDialog

public static String showDialog(WindowBasedTextGUI textGUI,
 String title,
 String description,
 String initialContent)

Shortcut for quickly showing a TextInputDialog

Parameters:

textGUI - GUI to show the dialog on

title - Title of the dialog

description - Description of the dialog

initialContent - What content to place in the text box initially

Returns:

The string the user typed into the text box, or null if the dialog was cancelled

showNumberDialog

public static BigInteger showNumberDialog(WindowBasedTextGUI textGUI,
 String title,
 String description,
 String initialContent)

Shortcut for quickly showing a TextInputDialog that only accepts numbers

Parameters:

textGUI - GUI to show the dialog on

title - Title of the dialog

description - Description of the dialog

initialContent - What content to place in the text box initially

Returns:

The number the user typed into the text box, or null if the dialog was cancelled

showPasswordDialog

public static String showPasswordDialog(WindowBasedTextGUI textGUI,
 String title,
 String description,
 String initialContent)

Shortcut for quickly showing a TextInputDialog with password masking

Parameters:

textGUI - GUI to show the dialog on

title - Title of the dialog

description - Description of the dialog

initialContent - What content to place in the text box initially

Returns:

The string the user typed into the text box, or null if the dialog was cancelled