Interface InternalPickerWidget

All Known Implementing Classes:
DateSpinner3D, DateTimeSpinner3D, DurationSpinner3D, Spinner3D, TimeSpinner3D
public interface InternalPickerWidget

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.

  • Method Summary

    Modifier and Type
    Method
    Description
    Object
    getValue()
    The currently selected value.
    void
    setValue(Object value)
    Moves the selection to value.

  • Method Details

    • getValue

      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

      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: the new selection, in the type this implementation documents. A value outside the widget's range is clamped into it.