| java.lang.Object
 com.jgoodies.binding.adapter.SpinnerAdapterFactory
| SpinnerAdapterFactory | | final public class SpinnerAdapterFactory (Code) | | A factory that vends
SpinnerModel implementations that are bound to
a ValueModel. Can be used to bind a ValueModel to instances of JSpinner.
To keep the ValueModel and SpinnerModel synchronized, this class listens
to changes in both sides and updates the other silently, i.e. without
firing a duplicate change event.
Constraints:
The ValueModel's type must be compatible with the type required by the
referenced SpinnerModel. For example a
SpinnerNumberModel requires
Number values.
Example:
// General Connection
ValueModel levelModel = new PropertyAdapter(settings, "level", true);
SpinnerModel spinnerModel = new SpinnerNumberModel(9, 5, 10, 1);
Object defaultValue = new Integer(9);
SpinnerAdapterFactory.connect(spinnerModel, levelModel, defaultValue);
JSpinner levelSpinner = new JSpinner(spinnerModel);
// Short Form
ValueModel levelModel = new PropertyAdapter(settings, "level", true);
SpinnerNumberModel spinnerModel =
SpinnerAdapterFactory.createNumberAdapter(levelModel, 5, 10, 1);
JSpinner levelSpinner = new JSpinner(spinnerModel);
author:
Karsten Lentzsch
version:
$Revision: 1.10 $
See Also: ValueModel
See Also: SpinnerModel
See Also: javax.swing.JSpinner
since:
1.1 |
| Method Summary | |
| public static void | connect(SpinnerModel spinnerModel, ValueModel valueModel, Object defaultValue)
Connects the given ValueModel and SpinnerModel
by synchronizing their values. | | public static SpinnerDateModel | createDateAdapter(ValueModel valueModel, Date defaultDate)
Creates and returns a SpinnerDateModel bound to the given
valueModel. | | public static SpinnerDateModel | createDateAdapter(ValueModel valueModel, Date defaultDate, Comparable<Date> start, Comparable<Date> end, int calendarField)
Creates and returns a SpinnerDateModel that represents a sequence
of dates and is bound to the given valueModel.
The dates are between start and end. | | public static SpinnerNumberModel | createNumberAdapter(ValueModel valueModel, int defaultValue, int minValue, int maxValue, int stepSize)
Creates and returns a
SpinnerNumberModel that is connected to
the given
ValueModel and that honors the specified minimum,
maximum and step values. | | public static SpinnerNumberModel | createNumberAdapter(ValueModel valueModel, Number defaultValue, Comparable<? extends Number> minValue, Comparable<? extends Number> maxValue, Number stepSize)
Creates and returns a
SpinnerNumberModel that is connected to
the given
ValueModel and that honors the specified minimum,
maximum and step values. |
| connect | | public static void connect(SpinnerModel spinnerModel, ValueModel valueModel, Object defaultValue)(Code) | | Connects the given ValueModel and SpinnerModel
by synchronizing their values.
Parameters:
spinnerModel - the underlying SpinnerModel implementation
Parameters:
valueModel - provides a value
Parameters:
defaultValue - the value used if the valueModel's value is null
throws:
NullPointerException - if the spinnerModel, valueModel or defaultValue is null |
| createDateAdapter | | public static SpinnerDateModel createDateAdapter(ValueModel valueModel, Date defaultDate)(Code) | | Creates and returns a SpinnerDateModel bound to the given
valueModel. The calendarField
is equal to Calendar.DAY_OF_MONTH; there are no
start/end limits.
Parameters:
valueModel - a Date typed model that holds the spinner value
Parameters:
defaultDate - the date used if the valueModel's value is null a SpinnerDateModel bound to the givenvalueModel without start and end limits usingCalendar.DAY_OF_MONTH as calendar field
throws:
NullPointerException - if the valueModel or defaultDate is null |
| createDateAdapter | | public static SpinnerDateModel createDateAdapter(ValueModel valueModel, Date defaultDate, Comparable<Date> start, Comparable<Date> end, int calendarField)(Code) | | Creates and returns a SpinnerDateModel that represents a sequence
of dates and is bound to the given valueModel.
The dates are between start and end. The
nextValue and previousValue methods
compute elements of the sequence by advancing or reversing
the current date value by the
calendarField time unit. For a precise description
of what it means to increment or decrement a Calendar
field, see the add method in
java.util.Calendar.
The start and end parameters can be
null to indicate that the range doesn't have an
upper or lower bound. If value or
calendarField is null, or if both
start and end are specified and
minimum > maximum then an
IllegalArgumentException is thrown.
Similarly if (minimum <= value <= maximum) is false,
an IllegalArgumentException is thrown.
This method has not been tested.
Parameters:
valueModel - a Date typed model that holds the spinner value
Parameters:
defaultDate - the date used if the valueModel's value is null
Parameters:
start - the first date in the sequence or null
Parameters:
end - the last date in the sequence or null
Parameters:
calendarField - one of Calendar.ERACalendar.YEARCalendar.MONTHCalendar.WEEK_OF_YEARCalendar.WEEK_OF_MONTHCalendar.DAY_OF_MONTHCalendar.DAY_OF_YEARCalendar.DAY_OF_WEEKCalendar.DAY_OF_WEEK_IN_MONTHCalendar.AM_PMCalendar.HOURCalendar.HOUR_OF_DAYCalendar.MINUTECalendar.SECONDCalendar.MILLISECOND
a SpinnerDateModel bound to the givenvalueModel using the specified start and end datesand calendar field.
throws:
NullPointerException - if the valueModel or defaultDate is null
throws:
IllegalArgumentException - if calendarField isn't valid,or if the following expression isfalse: (start <= value <= end).
See Also: java.util.Calendar
See Also: Date |
| createNumberAdapter | | public static SpinnerNumberModel createNumberAdapter(ValueModel valueModel, int defaultValue, int minValue, int maxValue, int stepSize)(Code) | | Creates and returns a
SpinnerNumberModel that is connected to
the given
ValueModel and that honors the specified minimum,
maximum and step values.
Parameters:
valueModel - an Integer typed model that holds the spinner value
Parameters:
defaultValue - the number used if the valueModel's value is null
Parameters:
minValue - the lower bound of the spinner number
Parameters:
maxValue - the upper bound of the spinner number
Parameters:
stepSize - used to increment and decrement the current value a SpinnerNumberModel that is connected to the givenValueModel
throws:
NullPointerException - if the valueModel is null |
| createNumberAdapter | | public static SpinnerNumberModel createNumberAdapter(ValueModel valueModel, Number defaultValue, Comparable<? extends Number> minValue, Comparable<? extends Number> maxValue, Number stepSize)(Code) | | Creates and returns a
SpinnerNumberModel that is connected to
the given
ValueModel and that honors the specified minimum,
maximum and step values.
Parameters:
valueModel - a Number typed model that holds the spinner value
Parameters:
defaultValue - the number used if the valueModel's value is null
Parameters:
minValue - the lower bound of the spinner number
Parameters:
maxValue - the upper bound of the spinner number
Parameters:
stepSize - used to increment and decrement the current value a SpinnerNumberModel that is connected to the givenValueModel
throws:
NullPointerException - if the valueModel or defaultValue is null |
|
|