- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JPanel
-
- javax.swing.JSpinner.DefaultEditor
-
- All Implemented Interfaces:
- ImageObserver, LayoutManager, MenuContainer, PropertyChangeListener, Serializable, EventListener, Accessible, ChangeListener
- Direct Known Subclasses:
- JSpinner.DateEditor, JSpinner.ListEditor, JSpinner.NumberEditor
- Enclosing class:
- JSpinner
public static class JSpinner.DefaultEditor extends JPanel implements ChangeListener, PropertyChangeListener, LayoutManager
A simple base class for more specialized editors that displays a read-only view of the model's current value with aJFormattedTextField
. Subclasses can configure theJFormattedTextField
to create an editor that's appropriate for the type of model they support and they may want to override thestateChanged
andpropertyChanged
methods, which keep the model and the text field in sync.This class defines a
dismiss
method that removes the editorsChangeListener
from theJSpinner
that it's part of. ThesetEditor
method knows aboutDefaultEditor.dismiss
, so if the developer replaces an editor that's derived fromJSpinner.DefaultEditor
itsChangeListener
connection back to theJSpinner
will be removed. However after that, it's up to the developer to manage their editor listeners. Similarly, if a subclass overridescreateEditor
, it's up to the subclasser to deal with their editor subsequently being replaced (withsetEditor
). We expect that in most cases, and in editor installed withsetEditor
or created by acreateEditor
override, will not be replaced anyway.This class is the
LayoutManager
for it's singleJFormattedTextField
child. By default the child is just centered with the parents insets.- Since:
- 1.4
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanel
-
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
-
Field Summary
-
Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
-
Constructor Summary
Constructors Constructor and Description JSpinner.DefaultEditor(JSpinner spinner)
Constructs an editor component for the specifiedJSpinner
.
-
Method Summary
Methods Modifier and Type Method and Description void
addLayoutComponent(String name, Component child)
ThisLayoutManager
method does nothing.void
commitEdit()
Pushes the currently edited value to theSpinnerModel
.void
dismiss(JSpinner spinner)
Disconnectthis
editor from the specifiedJSpinner
.int
getBaseline(int width, int height)
Returns the baseline.Component.BaselineResizeBehavior
getBaselineResizeBehavior()
Returns an enum indicating how the baseline of the component changes as the size changes.JSpinner
getSpinner()
Returns theJSpinner
ancestor of this editor ornull
if none of the ancestors are aJSpinner
.JFormattedTextField
getTextField()
Returns theJFormattedTextField
child of this editor.void
layoutContainer(Container parent)
Resize the one (and only) child to completely fill the area within the parents insets.Dimension
minimumLayoutSize(Container parent)
Returns the minimum size of first (and only) child plus the size of the parents insets.Dimension
preferredLayoutSize(Container parent)
Returns the preferred size of first (and only) child plus the size of the parents insets.void
propertyChange(PropertyChangeEvent e)
Called by theJFormattedTextField
PropertyChangeListener
.void
removeLayoutComponent(Component child)
ThisLayoutManager
method does nothing.void
stateChanged(ChangeEvent e)
This method is called when the spinner's model's state changes.-
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
-
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
-
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
-
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
Constructor Detail
-
JSpinner.DefaultEditor
public JSpinner.DefaultEditor(JSpinner spinner)
Constructs an editor component for the specifiedJSpinner
. ThisDefaultEditor
is it's own layout manager and it is added to the spinner'sChangeListener
list. The constructor creates a singleJFormattedTextField
child, initializes it's value to be the spinner model's current value and adds it tothis
DefaultEditor
.- Parameters:
spinner
- the spinner whose modelthis
editor will monitor- See Also:
getTextField()
,JSpinner.addChangeListener(javax.swing.event.ChangeListener)
-
-
Method Detail
-
dismiss
public void dismiss(JSpinner spinner)
Disconnectthis
editor from the specifiedJSpinner
. By default, this method removes itself from the spinnersChangeListener
list.- Parameters:
spinner
- theJSpinner
to disconnect this editor from; the same spinner as was passed to the constructor.
-
getSpinner
public JSpinner getSpinner()
Returns theJSpinner
ancestor of this editor ornull
if none of the ancestors are aJSpinner
. Typically the editor's parent is aJSpinner
however subclasses ofJSpinner
may override the thecreateEditor
method and insert one or more containers between theJSpinner
and it's editor.- Returns:
JSpinner
ancestor;null
if none of the ancestors are aJSpinner
- See Also:
JSpinner.createEditor(javax.swing.SpinnerModel)
-
getTextField
public JFormattedTextField getTextField()
Returns theJFormattedTextField
child of this editor. By default the text field is the first and only child of editor.- Returns:
- the
JFormattedTextField
that gives the user access to theSpinnerDateModel's
value. - See Also:
getSpinner()
,JSpinner.getModel()
-
stateChanged
public void stateChanged(ChangeEvent e)
This method is called when the spinner's model's state changes. It sets thevalue
of the text field to the current value of the spinners model.- Specified by:
stateChanged
in interfaceChangeListener
- Parameters:
e
- theChangeEvent
whose source is theJSpinner
whose model has changed.- See Also:
getTextField()
,JSpinner.getValue()
-
propertyChange
public void propertyChange(PropertyChangeEvent e)
Called by theJFormattedTextField
PropertyChangeListener
. When the"value"
property changes, which implies that the user has typed a new number, we set the value of the spinners model.This class ignores
PropertyChangeEvents
whose source is not theJFormattedTextField
, so subclasses may safely makethis
DefaultEditor
aPropertyChangeListener
on other objects.- Specified by:
propertyChange
in interfacePropertyChangeListener
- Parameters:
e
- thePropertyChangeEvent
whose source is theJFormattedTextField
created by this class.- See Also:
getTextField()
-
addLayoutComponent
public void addLayoutComponent(String name, Component child)
ThisLayoutManager
method does nothing. We're only managing a single child and there's no support for layout constraints.- Specified by:
addLayoutComponent
in interfaceLayoutManager
- Parameters:
name
- ignoredchild
- ignored
-
removeLayoutComponent
public void removeLayoutComponent(Component child)
ThisLayoutManager
method does nothing. There isn't any per-child state.- Specified by:
removeLayoutComponent
in interfaceLayoutManager
- Parameters:
child
- ignored
-
preferredLayoutSize
public Dimension preferredLayoutSize(Container parent)
Returns the preferred size of first (and only) child plus the size of the parents insets.- Specified by:
preferredLayoutSize
in interfaceLayoutManager
- Parameters:
parent
- the Container that's managing the layout- Returns:
- the preferred dimensions to lay out the subcomponents of the specified container.
- See Also:
LayoutManager.minimumLayoutSize(java.awt.Container)
-
minimumLayoutSize
public Dimension minimumLayoutSize(Container parent)
Returns the minimum size of first (and only) child plus the size of the parents insets.- Specified by:
minimumLayoutSize
in interfaceLayoutManager
- Parameters:
parent
- the Container that's managing the layout- Returns:
- the minimum dimensions needed to lay out the subcomponents of the specified container.
- See Also:
LayoutManager.preferredLayoutSize(java.awt.Container)
-
layoutContainer
public void layoutContainer(Container parent)
Resize the one (and only) child to completely fill the area within the parents insets.- Specified by:
layoutContainer
in interfaceLayoutManager
- Parameters:
parent
- the container to be laid out
-
commitEdit
public void commitEdit() throws ParseException
Pushes the currently edited value to theSpinnerModel
.The default implementation invokes
commitEdit
on theJFormattedTextField
.- Throws:
ParseException
- if the edited value is not legal
-
getBaseline
public int getBaseline(int width, int height)
Returns the baseline.- Overrides:
getBaseline
in classJComponent
- Parameters:
width
- the width to get the baseline forheight
- the height to get the baseline for- Returns:
- the baseline or < 0 indicating there is no reasonable baseline
- Throws:
IllegalArgumentException
- if width or height is < 0- Since:
- 1.6
- See Also:
JComponent.getBaseline(int,int)
,JComponent.getBaselineResizeBehavior()
-
getBaselineResizeBehavior
public Component.BaselineResizeBehavior getBaselineResizeBehavior()
Returns an enum indicating how the baseline of the component changes as the size changes.- Overrides:
getBaselineResizeBehavior
in classJComponent
- Returns:
- an enum indicating how the baseline changes as the component size changes
- Throws:
NullPointerException
- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/swing/jspinner.defaulteditor.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.