public interface InternalPickerWidget

Known subtypesDateSpinner3D, DateTimeSpinner3D, DurationSpinner3D, Spinner3D, TimeSpinner3D

The value contract every lightweight picker spinner implements, so Picker can drive any of them without knowing which one it holds.

A Picker in lightweight mode owns one of the *Spinner3D containers according to its type – date, time, date and time, duration or a plain string list – and moves a value in and out of it through this interface alone. Implementing it is what makes a container usable as the body of a picker.

The value’s runtime type is the implementation’s own: Date for DateSpinner3D, an int[] of hours and minutes for DurationSpinner3D, and so on. Each implementation documents what it expects; passing something else is a programming error rather than a recoverable condition.

This is public because the lightweight spinners are, and those are usable on their own – embedded in a form rather than shown in a picker dialog. The name is retained for source compatibility with the releases in which it was package private.

Methods

public abstract Object getValue()The currently selected value.
public abstract void setValue(Object value)Moves the selection to value.

Method details

getValue

public abstract Object getValue()
The currently selected value.

Returns

the selection, in whatever type this implementation documents; never null once the widget has been laid out

setValue

public abstract void setValue(Object value)

Moves the selection to value.

The widget scrolls to the new selection rather than jumping, when it is already on screen.

Parameters

value Object
the new selection, in the type this implementation documents. A value outside the widget’s range is clamped into it.