javax.swing

Класс SpinnerDateModel

java.lang. Объект

javax.swing. AbstractSpinnerModel

javax.swing. SpinnerDateModel

Все Реализованные Интерфейсы:

Сериализуемый, SpinnerModel

public class SpinnerDateModel
extends AbstractSpinnerModel
implements Serializable

A SpinnerModel для последовательностей Dates. Верхние и нижние границы последовательности определяются вызванными свойствами start и end и размер увеличения или уменьшения, вычисленного nextValue и previousValue методы определяются вызванным свойством calendarField. start и end свойства могут быть null указать, что у последовательности нет никакого более низкого или верхнего предела.

Значение calendarField свойство должно быть одним из java.util.Calendar константы, которые определяют поле в пределах a Calendar. getNextValue и getPreviousValue методы изменяют дату вперед или назад этим количеством. Например, если calendarField Calendar.DAY_OF_WEEK, тогда nextValue производит a Date это спустя 24 часа после тока value, и previousValue производит a Date это 24 часами ранее.

Юридические значения для calendarField :

• Calendar.ERA
• Calendar.YEAR
• Calendar.MONTH
• Calendar.WEEK_OF_YEAR
• Calendar.WEEK_OF_MONTH
• Calendar.DAY_OF_MONTH
• Calendar.DAY_OF_YEAR
• Calendar.DAY_OF_WEEK
• Calendar.DAY_OF_WEEK_IN_MONTH
• Calendar.AM_PM
• Calendar.HOUR
• Calendar.HOUR_OF_DAY
• Calendar.MINUTE
• Calendar.SECOND
• Calendar.MILLISECOND

Однако некоторый UIs может установить calendarField прежде, чем передать редактирование, чтобы вращать поле под курсором. Если Вы только хотите, чтобы одно поле вращалось, можно разделить на подклассы и проигнорировать вызовы setCalendarField.

Эта модель наследовала a ChangeListener. ChangeListeners уведомляются всякий раз, когда модели value, calendarField, start, или end изменения свойств.

С тех пор:

1.4

См. Также:

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerNumberModel, Calendar.add(int, int)

Полевая Сводка

Поля, наследованные от class javax.swing. AbstractSpinnerModel

listenerList

Сводка конструктора

Конструкторы

Конструктор и Описание
SpinnerDateModel() Конструкции a SpinnerDateModel чья начальная буква value текущая дата, calendarField равно Calendar.DAY_OF_MONTH, и для которого есть нет start/end пределы.
SpinnerDateModel(Date value, Comparable start, Comparable end, int calendarField) Создает a SpinnerDateModel это представляет последовательность дат между start и end.

Сводка метода

Модификатор и Тип	Метод и Описание
int	getCalendarField() Возвраты Calendar поле, которое добавляется к или вычитается из nextValue и previousValue методы.
Дата	getDate() Возвращает текущий элемент в этой последовательности Dates.
Сопоставимый	getEnd() Возвращает последнее Date в последовательности.
Объект	getNextValue() Возвращает следующее Date в последовательности, или null если следующая дата после end.
Объект	getPreviousValue() Возвращает предыдущее Date в последовательности, или null если предыдущая дата прежде start.
Сопоставимый	getStart() Возвращает первое Date в последовательности.
Объект	getValue() Возвращает текущий элемент в этой последовательности Dates.
void	setCalendarField(int calendarField) Изменяет размер изменения значения даты, вычисленного nextValue и previousValue методы.
void	setEnd(Comparable end) Изменяет верхний предел для Dates в этой последовательности.
void	setStart(Comparable start) Изменяет более низкий предел для Дат в этой последовательности.
void	setValue(Object value) Устанавливает ток Date для этой последовательности.

Методы, наследованные от class javax.swing. AbstractSpinnerModel

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

SpinnerDateModel

public SpinnerDateModel(Date value,
                        Comparable start,
                        Comparable end,
                        int calendarField)

Создает a SpinnerDateModel это представляет последовательность дат между start и end. nextValue и previousValue методы вычисляют элементы последовательности, совершенствуясь или инвертируя текущую дату value calendarField единица измерения времени. Для точного описания того, что это означает постепенно увеличивать или постепенно уменьшать a Calendar field, см. add метод в java.util.Calendar.

start и end параметры могут быть null указать, что у диапазона нет верхней или нижней границы. Если value или calendarField null, или если оба start и end определяются и mininum > maximum тогда IllegalArgumentException бросается. Так же, если (minimum <= value <= maximum) ложь, IllegalArgumentException бросается.

Параметры:

value - ток (нет null) значение модели

start - первая дата в последовательности или null

end - последняя дата в последовательности или null

calendarField - один из

• Calendar.ERA
• Calendar.YEAR
• Calendar.MONTH
• Calendar.WEEK_OF_YEAR
• Calendar.WEEK_OF_MONTH
• Calendar.DAY_OF_MONTH
• Calendar.DAY_OF_YEAR
• Calendar.DAY_OF_WEEK
• Calendar.DAY_OF_WEEK_IN_MONTH
• Calendar.AM_PM
• Calendar.HOUR
• Calendar.HOUR_OF_DAY
• Calendar.MINUTE
• Calendar.SECOND
• Calendar.MILLISECOND

Броски:

IllegalArgumentException - если value или calendarField null, если calendarField не допустимо, или если следующее выражение является ложью: (start <= value <= end).

См. Также:

Calendar.add(int, int), setValue(java.lang.Object), setStart(java.lang.Comparable), setEnd(java.lang.Comparable), setCalendarField(int)

SpinnerDateModel

public SpinnerDateModel()

Конструкции a SpinnerDateModel чья начальная буква value текущая дата, calendarField равно Calendar.DAY_OF_MONTH, и для которого есть нет start/end пределы.

Деталь метода

setStart

public void setStart(Comparable start)

Изменяет более низкий предел для Дат в этой последовательности. Если start null, тогда нет никакого более низкого предела. Никакая проверка границ не делается здесь: новое значение запуска может лишить законной силы (start <= value <= end) инвариант осуществляется конструкторами. Это должно упростить обновление модели. Естественно нужно гарантировать, что инвариант является истиной прежде, чем вызвать nextValue, previousValue, или setValue методы.

Обычно это свойство является a Date однако возможно использовать a Comparable с a compareTo метод для Дат. Например start мог бы быть экземпляр class как это:

 MyStartDate implements Comparable {
     long t = 12345;
     public int compareTo(Date d) {
            return (t < d.getTime() ? -1 : (t == d.getTime() ? 0 : 1));
     }
     public int compareTo(Object o) {
            return compareTo((Date)o);
     }
 }
 

Note that the above example will throw a ClassCastException if the Object passed to compareTo(Object) is not a Date.

This method fires a ChangeEvent if the start has changed.

Parameters:

start - defines the first date in the sequence

See Also:

getStart(), setEnd(java.lang.Comparable), AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getStart

public Comparable getStart()

Returns the first Date in the sequence.

Returns:

the value of the start property

See Also:

setStart(java.lang.Comparable)

setEnd

public void setEnd(Comparable end)

Changes the upper limit for Dates in this sequence. If start is null, then there is no upper limit. No bounds checking is done here: the new start value may invalidate the (start <= value <= end) invariant enforced by the constructors. This is to simplify updating the model. Naturally, one should ensure that the invariant is true before calling the nextValue, previousValue, or setValue methods.

Typically this property is a Date however it's possible to use Comparable with a compareTo method for Dates. See setStart for an example.

This method fires a ChangeEvent if the end has changed.

Parameters:

end - defines the last date in the sequence

See Also:

getEnd(), setStart(java.lang.Comparable), AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getEnd

public Comparable getEnd()

Returns the last Date in the sequence.

Returns:

the value of the end property

See Also:

setEnd(java.lang.Comparable)

setCalendarField

public void setCalendarField(int calendarField)

Changes the size of the date value change computed by the nextValue and previousValue methods. The calendarField parameter must be one of the Calendar field constants like Calendar.MONTH or Calendar.MINUTE. The nextValue and previousValue methods simply move the specified Calendar field forward or backward by one unit with the Calendar.add method. You should use this method with care as some UIs may set the calendarField before commiting the edit to spin the field under the cursor. If you only want one field to spin you can subclass and ignore the setCalendarField calls.

Parameters:

calendarField - one of

• Calendar.ERA
• Calendar.YEAR
• Calendar.MONTH
• Calendar.WEEK_OF_YEAR
• Calendar.WEEK_OF_MONTH
• Calendar.DAY_OF_MONTH
• Calendar.DAY_OF_YEAR
• Calendar.DAY_OF_WEEK
• Calendar.DAY_OF_WEEK_IN_MONTH
• Calendar.AM_PM
• Calendar.HOUR
• Calendar.HOUR_OF_DAY
• Calendar.MINUTE
• Calendar.SECOND
• Calendar.MILLISECOND

This method fires a ChangeEvent if the calendarField has changed.

See Also:

getCalendarField(), getNextValue(), getPreviousValue(), Calendar.add(int, int), AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getCalendarField

public int getCalendarField()

Returns the Calendar field that is added to or subtracted from by the nextValue and previousValue methods.

Returns:

the value of the calendarField property

See Also:

setCalendarField(int)

getNextValue

public Object getNextValue()

Returns the next Date in the sequence, or null if the next date is after end.

Specified by:

getNextValue in interface SpinnerModel

Returns:

the next Date in the sequence, or null if the next date is after end.

See Also:

SpinnerModel.getNextValue(), getPreviousValue(), setCalendarField(int)

getPreviousValue

public Object getPreviousValue()

Returns the previous Date in the sequence, or null if the previous date is before start.

Specified by:

getPreviousValue in interface SpinnerModel

Returns:

the previous Date in the sequence, or null if the previous date is before start

See Also:

SpinnerModel.getPreviousValue(), getNextValue(), setCalendarField(int)

getDate

public Date getDate()

Returns the current element in this sequence of Dates. This method is equivalent to (Date)getValue.

Returns:

the value property

See Also:

setValue(java.lang.Object)

getValue

public Object getValue()

Returns the current element in this sequence of Dates.

Specified by:

getValue in interface SpinnerModel

Returns:

the value property

See Also:

setValue(java.lang.Object), getDate()

setValue

public void setValue(Object value)

Sets the current Date for this sequence. If value is null, an IllegalArgumentException is thrown. No bounds checking is done here: the new value may invalidate the (start <= value < end) invariant enforced by the constructors. Naturally, one should ensure that the (start <= value <= maximum) invariant is true before calling the nextValue, previousValue, or setValue methods.

This method fires a ChangeEvent if the value has changed.

Specified by:

setValue in interface SpinnerModel

Parameters:

value - the current (non null) Date for this sequence

Throws:

IllegalArgumentException - if value is null or not a Date

See Also:

getDate(), getValue(), AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)