java.lang.Object
javax.swing.plaf.ComponentUI
javax.swing.plaf.SpinnerUI
javax.swing.plaf.basic.BasicSpinnerUI
- Direct Known Subclasses:
SynthSpinnerUI
The default Spinner UI delegate.
- Since:
- 1.4
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected JComponentThis method is called by installUI to get the editor component of theJSpinner.protected LayoutManagerCreates aLayoutManagerthat manages theeditor,nextButton, andpreviousButtonchildren of the JSpinner.protected ComponentCreates an increment button, i.e. component that replaces the spinner value with the object returned byspinner.getNextValue.protected ComponentCreates a decrement button, i.e. component that replaces the spinner value with the object returned byspinner.getPreviousValue.protected PropertyChangeListenerCreates aPropertyChangeListenerthat can be added to the JSpinner itself.static ComponentUIReturns a new instance of BasicSpinnerUI.intgetBaseline(JComponent c, int width, int height) Returns the baseline.Returns an enum indicating how the baseline of the component changes as the size changes.protected voidInitialize theJSpinnerborder,foreground, andbackground, properties based on the corresponding "Spinner.*" properties from defaults table.protected voidInstalls the keyboard Actions onto the JSpinner.protected voidInitializesPropertyChangeListenerwith a shared object that delegates interesting PropertyChangeEvents to protected methods.protected voidInstalls the necessary listeners on the next button,c, to update theJSpinnerin response to a user gesture.protected voidInstalls the necessary listeners on the previous button,c, to update theJSpinnerin response to a user gesture.voidCallsinstallDefaults,installListeners, and then adds the components returned bycreateNextButton,createPreviousButton, andcreateEditor.protected voidreplaceEditor(JComponent oldEditor, JComponent newEditor) Called by thePropertyChangeListenerwhen theJSpinnereditor property changes.protected voidSets theJSpinner'slayout manager to null.protected voidRemoves thePropertyChangeListeneradded by installListeners.voidCallsuninstallDefaults,uninstallListeners, and then removes all of the spinners children.Methods declared in class javax.swing.plaf.ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, getPreferredSize, paint, update
-
Field Details
-
spinner
The spinner that we're a UI delegate for. Initialized by theinstallUImethod, and reset to null byuninstallUI.- See Also:
-
-
Constructor Details
-
BasicSpinnerUI
public BasicSpinnerUI()Constructs aBasicSpinnerUI.
-
-
Method Details
-
createUI
Returns a new instance of BasicSpinnerUI. SpinnerListUI delegates are allocated one per JSpinner.- Parameters:
c- the JSpinner (not used)- Returns:
- a new BasicSpinnerUI object
- See Also:
-
installUI
CallsinstallDefaults,installListeners, and then adds the components returned bycreateNextButton,createPreviousButton, andcreateEditor.- Overrides:
installUIin classComponentUI- Parameters:
c- the JSpinner- See Also:
-
uninstallUI
CallsuninstallDefaults,uninstallListeners, and then removes all of the spinners children.- Overrides:
uninstallUIin classComponentUI- Parameters:
c- the JSpinner (not used)- See Also:
-
installListeners
protected void installListeners()InitializesPropertyChangeListenerwith a shared object that delegates interesting PropertyChangeEvents to protected methods.This method is called by
installUI.- See Also:
-
uninstallListeners
protected void uninstallListeners()Removes thePropertyChangeListeneradded by installListeners.This method is called by
uninstallUI.- See Also:
-
installDefaults
protected void installDefaults()Initialize theJSpinnerborder,foreground, andbackground, properties based on the corresponding "Spinner.*" properties from defaults table. TheJSpinnerslayout is set to the value returned bycreateLayout. This method is called byinstallUI.- See Also:
-
uninstallDefaults
protected void uninstallDefaults()Sets theJSpinner'slayout manager to null. This method is called byuninstallUI.- See Also:
-
installNextButtonListeners
Installs the necessary listeners on the next button,c, to update theJSpinnerin response to a user gesture.- Parameters:
c- Component to install the listeners on- Throws:
NullPointerException- ifcis null.- Since:
- 1.5
- See Also:
-
installPreviousButtonListeners
Installs the necessary listeners on the previous button,c, to update theJSpinnerin response to a user gesture.- Parameters:
c- Component to install the listeners on.- Throws:
NullPointerException- ifcis null.- Since:
- 1.5
- See Also:
-
createLayout
Creates aLayoutManagerthat manages theeditor,nextButton, andpreviousButtonchildren of the JSpinner. These three children must be added with a constraint that identifies their role: "Editor", "Next", and "Previous". The default layout manager can handle the absence of any of these children.- Returns:
- a LayoutManager for the editor, next button, and previous button.
- See Also:
-
createPropertyChangeListener
Creates aPropertyChangeListenerthat can be added to the JSpinner itself. Typically, this listener will call replaceEditor when the "editor" property changes, since it's theSpinnerUI'sresponsibility to add the editor to the JSpinner (and remove the old one). This method is called byinstallListeners.- Returns:
- A PropertyChangeListener for the JSpinner itself
- See Also:
-
createPreviousButton
Creates a decrement button, i.e. component that replaces the spinner value with the object returned byspinner.getPreviousValue. By default thepreviousButtonis aJButton. If the decrement button is not needed this method should returnnull.- Returns:
- a component that will replace the spinner's value with the
previous value in the sequence, or
null - See Also:
-
createNextButton
Creates an increment button, i.e. component that replaces the spinner value with the object returned byspinner.getNextValue. By default thenextButtonis aJButton. If the increment button is not needed this method should returnnull.- Returns:
- a component that will replace the spinner's value with the
next value in the sequence, or
null - See Also:
-
createEditor
This method is called by installUI to get the editor component of theJSpinner. By default it just returnsJSpinner.getEditor(). Subclasses can overridecreateEditorto return a component that contains the spinner's editor or null, if they're going to handle adding the editor to theJSpinnerin aninstallUIoverride.Typically this method would be overridden to wrap the editor with a container with a custom border, since one can't assume that the editors border can be set directly.
The
replaceEditormethod is called when the spinners editor is changed withJSpinner.setEditor. If you've overridden this method, then you'll probably want to overridereplaceEditoras well.- Returns:
- the JSpinners editor JComponent, spinner.getEditor() by default
- See Also:
-
replaceEditor
Called by thePropertyChangeListenerwhen theJSpinnereditor property changes. It's the responsibility of this method to remove the old editor and add the new one. By default this operation is just:spinner.remove(oldEditor); spinner.add(newEditor, "Editor");
The implementation ofreplaceEditorshould be coordinated with thecreateEditormethod.- Parameters:
oldEditor- an old instance of editornewEditor- a new instance of editor- See Also:
-
installKeyboardActions
protected void installKeyboardActions()Installs the keyboard Actions onto the JSpinner.- Since:
- 1.5
-
getBaseline
Returns the baseline.- Overrides:
getBaselinein classComponentUI- Parameters:
c-JComponentbaseline is being requested forwidth- the width to get the baseline forheight- the height to get the baseline for- Returns:
- baseline or a value < 0 indicating there is no reasonable baseline
- Throws:
NullPointerException- ifcisnullIllegalArgumentException- if width or height is < 0- Since:
- 1.6
- See Also:
-
getBaselineResizeBehavior
Returns an enum indicating how the baseline of the component changes as the size changes.- Overrides:
getBaselineResizeBehaviorin classComponentUI- Parameters:
c-JComponentto return baseline resize behavior for- Returns:
- an enum indicating how the baseline changes as the component size changes
- Throws:
NullPointerException- ifcisnull- Since:
- 1.6
- See Also:
-