|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.swing.AbstractSpinnerModel
javax.swing.SpinnerDateModel
public class SpinnerDateModel
A date model used by the JSpinner
component. This implements a
spinner model for dates, rotating a calendar field such as month, year,
day, week, hour, minute.
Field Summary |
---|
Fields inherited from class javax.swing.AbstractSpinnerModel |
---|
listenerList |
Constructor Summary | |
---|---|
SpinnerDateModel()
Constructs a SpinnerDateModel using the current date,
no start or end limit, and Calendar.DAY_OF_MONTH as the calendar
field. |
|
SpinnerDateModel(Date value,
Comparable start,
Comparable end,
int calendarField)
Constructs a SpinnerDateModel with the specified value, lower
and upper bounds, and which spins the specified calendar field. |
Method Summary | |
---|---|
int |
getCalendarField()
Returns the Calendar field used to calculate the previous and
next dates in the sequence. |
Date |
getDate()
Returns the current date/time. |
Comparable |
getEnd()
Returns the upper limit on the date/time value, or null if
there is no maximum date/time. |
Object |
getNextValue()
Returns the next date in the sequence, or null if the
next date is past the upper limit (if one is specified). |
Object |
getPreviousValue()
Returns the previous date in the sequence, or null if the
previous date is prior to the lower limit (if one is specified). |
Comparable |
getStart()
Returns the lower limit on the date/time value, or null if
there is no minimum date/time. |
Object |
getValue()
Returns the current date in the sequence (this method returns the same as getDate() ). |
void |
setCalendarField(int calendarField)
Sets the date field to change when calculating the next and previous values. |
void |
setEnd(Comparable end)
Sets the upper limit for the date/time value and, if the new limit is different to the old limit, sends a ChangeEvent to all registered
listeners. |
void |
setStart(Comparable start)
Sets the lower limit for the date/time value and, if the new limit is different to the old limit, sends a ChangeEvent to all registered
listeners. |
void |
setValue(Object value)
Sets the current date and, if the new value is different to the old value, sends a ChangeEvent to all registered listeners. |
Methods inherited from class javax.swing.AbstractSpinnerModel |
---|
addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SpinnerDateModel()
SpinnerDateModel
using the current date,
no start or end limit, and Calendar.DAY_OF_MONTH
as the calendar
field.
public SpinnerDateModel(Date value, Comparable start, Comparable end, int calendarField)
SpinnerDateModel
with the specified value, lower
and upper bounds, and which spins the specified calendar field.
The start
and end
limits must have a
compareTo
method that supports instances of Date
, but
do not themselves need to be instances of Date
(although typically
they are).
value
- the initial value/date (null
not permitted).start
- a constraint that specifies the earliest permitted date
value, or null
for no lower limit.end
- a constraint that specifies the latest permitted date value,
or null
for no upper limit.calendarField
- the Calendar
field to spin,
(Calendar.ZONE_OFFSET and Calendar.DST_OFFSET are invalid)Method Detail |
---|
public int getCalendarField()
Calendar
field used to calculate the previous and
next dates in the sequence.
public Date getDate()
null
).getValue()
public Comparable getStart()
null
if
there is no minimum date/time.
setStart(Comparable)
public Comparable getEnd()
null
if
there is no maximum date/time.
setEnd(Comparable)
public Object getValue()
getDate()
).
getValue
in interface SpinnerModel
null
).public Object getNextValue()
null
if the
next date is past the upper limit (if one is specified). The current date
is not changed.
getNextValue
in interface SpinnerModel
null
if the current value is
the latest date represented by the model.getEnd()
public Object getPreviousValue()
null
if the
previous date is prior to the lower limit (if one is specified). The
current date is not changed.
getPreviousValue
in interface SpinnerModel
null
if the current value is
the earliest date represented by the model.getStart()
public void setCalendarField(int calendarField)
Calendar
field, excluding
Calendar.ZONE_OFFSET
and Calendar.DST_OFFSET
.
calendarField
- the calendar field to set.
IllegalArgumentException
- if calendarField
is not
a valid code.public void setStart(Comparable start)
ChangeEvent
to all registered
listeners. A null
value is interpreted as "no lower limit".
No check is made to ensure that the current date/time is on or after the
new lower limit - the caller is responsible for ensuring that this
relationship holds. In addition, the caller should ensure that
start
is Serializable
.
start
- the new lower limit for the date/time value
(null
permitted).public void setEnd(Comparable end)
ChangeEvent
to all registered
listeners. A null
value is interpreted as "no upper limit".
No check is made to ensure that the current date/time is on or before the
new upper limit - the caller is responsible for ensuring that this
relationship holds. In addition, the caller should ensure that
end
is Serializable
.
end
- the new upper limit for the date/time value (null
permitted).public void setValue(Object value)
ChangeEvent
to all registered listeners.
setValue
in interface SpinnerModel
value
- the new date (null
not permitted, must be an
instance of Date
).
IllegalArgumentException
- if value
is not an instance
of Date
.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |