Класс JSpinner.DefaultEditor

public static class JSpinner.DefaultEditor
extends JPanel
implements ChangeListener, PropertyChangeListener, LayoutManager

Простой базовый класс для более специализированных редакторов, который отображает только для чтения текущее значение модели с JFormattedTextField. Подклассы могут настроить JFormattedTextField для создания редактора, подходящего для типа модели, которую они поддерживают, и могут переопределить методы stateChanged и propertyChanged, которые синхронизируют модель и текстовое поле.

Этот класс определяет метод dismiss, который удаляет редакторов ChangeListener из JSpinner, частью которого он является. Метод setEditor знает о DefaultEditor.dismiss, поэтому, если разработчик заменяет редактор, производный от JSpinner.DefaultEditor, его ChangeListener соединение с JSpinner будет удалено. Однако после этого разработчик должен управлять своими слушателями редактора. Аналогично, если подкласс переопределяет createEditor, то подкласс должен справиться с последующей заменой своего редактора (с setEditor). Ожидается, что в большинстве случаев, и в редакторе, установленным с помощью setEditor или созданным путём переопределения createEditor, не будет заменяться.

Этот класс является LayoutManager для своего единственного JFormattedTextField потомка. По умолчанию потомок просто центрируется с отступами родителя.

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

DefaultEditor

public DefaultEditor(JSpinner spinner)

Создает компонент редактора для указанного JSpinner. Этот компонент является собственным менеджером макета и добавляется в список ChangeListener спиннера. Конструктор создаёт единственного дочернего элемента, инициализирует его значение текущим значением модели спиннера и добавляет его к this DefaultEditor.

Параметры:

spinner - спиннер, модель которого this отслеживает редактор

См. также:

getTextField(), JSpinner.addChangeListener(javax.swing.event.ChangeListener)

Методы

dismiss

public void dismiss(JSpinner spinner)

Отсоединяет редактор this от указанного JSpinner. По умолчанию этот метод удаляет себя из списка ChangeListener спиннера.

Параметры:

spinner - спиннер, от которого необходимо отсоединить редактор; тот же спиннер, что и переданный в конструктор.

getSpinner

public JSpinner getSpinner()

Возвращает родительский элемент JSpinner этого редактора или null, если ни один из родительских элементов не является JSpinner. Обычно родителем редактора является JSpinner, однако подклассы JSpinner могут переопределить метод createEditor и вставить один или несколько контейнеров между JSpinner и редактором.

Возвращает:

JSpinner родительский элемент; null если ни один из родительских элементов не является JSpinner

См. также:

JSpinner.createEditor(javax.swing.SpinnerModel)

getTextField

public JFormattedTextField getTextField()

Возвращает дочерний элемент JFormattedTextField этого редактора. По умолчанию текстовое поле является первым и единственным дочерним элементом редактора.

Возвращает:

текстовое поле, предоставляющее пользователю доступ к значению SpinnerDateModel's.

См. также:

getSpinner(), JSpinner.getModel()

stateChanged

public void stateChanged(ChangeEvent e)

Этот метод вызывается, когда состояние модели спиннера изменяется. Он устанавливает значение value текстового поля на текущее значение модели спиннера.

Определяется в:

stateChanged в интерфейсе ChangeListener

Параметры:

e - событие ChangeEvent, источник которого — JSpinner, модель которого изменилась.

См. также:

getTextField(), JSpinner.getValue()

propertyChange

public void propertyChange(PropertyChangeEvent e)

Определяется в:

propertyChange в интерфейсе PropertyChangeListener

Параметры:

e - событие PropertyChangeEvent, источник которого — JFormattedTextField созданный этим классом.

См. также:

getTextField()

addLayoutComponent

public void addLayoutComponent(String name,
                               Component child)

Этот метод LayoutManager ничего не делает. Мы управляем только одним дочерним элементом, и поддержка ограничений макета отсутствует.

Определяется в:

addLayoutComponent в интерфейсе LayoutManager

Параметры:

name - игнорируется

child - игнорируется

removeLayoutComponent

public void removeLayoutComponent(Component child)

Этот LayoutManager метод ничего не делает. Нет состояния на элемент по элементу.

Определяется в:

removeLayoutComponent в интерфейсе LayoutManager

Параметры:

child - игнорируется

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)

Возвращает предпочтительный размер первого (и единственного) дочернего элемента плюс отступы родителя.

Определяется в:

preferredLayoutSize в интерфейсе LayoutManager

Параметры:

parent - контейнер, управляющий макетом

Возвращает:

предпочтительные размеры для выкладки подкомпонентов указанного контейнера.

См. также:

LayoutManager.minimumLayoutSize(java.awt.Container)

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)

Возвращает минимальный размер первого (и единственного) дочернего элемента плюс отступы родителя.

Определяется в:

minimumLayoutSize в интерфейсе LayoutManager

Параметры:

parent - контейнер, управляющий макетом

Возвращает:

минимальные размеры, необходимые для выкладки подкомпонентов указанного контейнера.

См. также:

LayoutManager.preferredLayoutSize(java.awt.Container)

layoutContainer

public void layoutContainer(Container parent)

Изменяет размер единственного дочернего элемента, чтобы полностью заполнить область внутри отступов родителя.

Определяется в:

layoutContainer в интерфейсе LayoutManager

Параметры:

parent - контейнер, который нужно выложить

commitEdit

public void commitEdit()
                throws ParseException

Исключения:

ParseException - если изменённое значение некорректно

getBaseline

public int getBaseline(int width,
                       int height)

Возвращает линию основания.

Переопределяет:

getBaseline в классе JComponent

Параметры:

width - ширина для получения линии основания

height - высота для получения линии основания

Возвращает:

линия основания или < 0, указывающее отсутствие разумной линии основания

Исключения:

IllegalArgumentException - если ширина или высота < 0

С:

1.6

См. также:

JComponent.getBaseline(int,int), JComponent.getBaselineResizeBehavior()

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior()

Возвращает перечисление, указывающее, как линия основания компонента изменяется при изменении размера.

Переопределяет:

getBaselineResizeBehavior в классе JComponent

Возвращает:

перечисление, указывающее, как изменяется линия основания при изменении размера компонента

Исключения:

NullPointerException

С:

1.6

См. также:

JComponent.getBaseline(int, int)