com.ur.urcap.api.domain.userinteraction.keyboard

Interface KeyboardNumberInput<T>

Type Parameters:

T - The (generic) type parameter for the interface representing the type of input data entered by the user via the virtual keypad. Relevant types are e.g. Integer and Double.

public interface KeyboardNumberInput<T>

Interface representing the virtual numeric keypad used for configuring it and requesting it to be displayed in PolyScope.

Method Summary

Modifier and Type	Method and Description
KeyboardNumberInput<T>	setErrorValidator(InputValidator<T> validator) Sets an input validator for the virtual numeric keypad.
KeyboardNumberInput<T>	setInitialValue(T initialValue) Sets the initial value which will be displayed when the virtual numeric keypad is shown.
void	show(JButton component, KeyboardInputCallback<T> callback) This method requests the virtual keypad to be shown
void	show(JLabel component, KeyboardInputCallback<T> callback) This method requests the virtual numeric keypad to be shown
void	show(JTextField component, KeyboardInputCallback<T> callback) This method requests the virtual numeric keypad to be shown

Method Detail

setErrorValidator

KeyboardNumberInput<T> setErrorValidator(InputValidator<T> validator)

Sets an input validator for the virtual numeric keypad. This validator will be used to validate the input entered by the user. Some standard validators are available in InputValidationFactory. Specifying an input validator is recommended, but optional.

In case InputValidator.isValid(Object) returns false, the accept button on the virtual keypad will be disabled and the error message from InputValidator.getMessage(Object) will be shown.

Parameters:

validator - the validator to be used to validate keypad user input.

Returns:

this KeyboardNumberInput object

Throws:

NullPointerException - in case the validator is null

setInitialValue

KeyboardNumberInput<T> setInitialValue(T initialValue)

Sets the initial value which will be displayed when the virtual numeric keypad is shown.

Parameters:

initialValue - the initial value for the virtual keypad

Returns:

this KeyboardNumberInput object

show

void show(JTextField component,
          KeyboardInputCallback<T> callback)

This method requests the virtual numeric keypad to be shown

Parameters:

component - the JTextField that will be used to define the screen position of the virtual keypad

callback - the callback to be used when the user exits the keypad by accepting or canceling the input.

Throws:

NullPointerException - in case any parameter is null

show

void show(JLabel component,
          KeyboardInputCallback<T> callback)

This method requests the virtual numeric keypad to be shown

Parameters:

component - the JLabel that will be used to define the screen position of the virtual keypad

callback - the callback to be used when the user exits the keypad by accepting or canceling the input.

Throws:

NullPointerException - in case any parameter is null

show

void show(JButton component,
          KeyboardInputCallback<T> callback)

This method requests the virtual keypad to be shown

Parameters:

component - the JButton that will be used to define the screen position of the virtual keypad

callback - the callback to be used when the user exits the keypad by accepting or canceling the input.

Throws:

NullPointerException - in case any parameter is null