javax.swing
클래스 JSpinner

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Container 
              |
              +--javax.swing.JComponent 
                    |
                    +--javax.swing.JSpinner

모든 구현 인터페이스:

ImageObserver , MenuContainer , Serializable

public class JSpinner

extends JComponent

유저가, 순서 붙일 수 있었던 순차 순서로부터 수 또는 오브젝트를 선택할 수 있게 하는 단일행의 입력 필드입니다. 통상, 스피나-는 순차 순서의 요소간을 이동하기 위한 작은 화살표 버튼의 페어를 제공합니다. 키보드상/하 커서 키에서도 요소간을 자유롭게 이동할 수 있습니다. 유저가 스피나-에 직접 (유효한) 치를 입력할 수도 있습니다. combobox는 유사한 기능을 제공합니다만, 중요한 데이터를 덮어 가려 버리는 드롭 다운 리스트를 필요로 하지 않기 때문에, 스피나-(분)편이 선호되는 경우가 있습니다.

JSpinner 의 순차 순서의 값은 SpinnerModel 에 의해 정의됩니다. model 는 constructor 의 인수로서 지정해,model 프로퍼티를 사용해 변경할 수 있습니다. 일부의 공통 타입으로서SpinnerListModel,SpinnerNumberModel, 및 SpinnerDateModel 등의 SpinnerModel 클래스가 제공됩니다.

JSpinner 는 모델의 현재의 요소 또는 「값」을 표시해, 변경도 취급하는 단일의 아이 컴퍼넌트를 가집니다. 이것은 editor 로 불립니다. 에디터는 JSpinner 의 constructor 에 의해 작성되어editor 프로퍼티에 의해 변경할 수 있습니다. JSpinner 의 에디터는 ChangeEvent 를 대기하는 것으로써, 모델과의 동기를 유지합니다.

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 서포트는 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK 버젼 1.4 이후, 모든 JavaBeans^TM 의 장기간의 운용 서포트는 java.beans 패키지에 추가되고 있습니다. 자세한 것은 XMLEncoder 를 참조해 주세요.

도입된 버젼:

1.4

관련 항목:

SpinnerModel , AbstractSpinnerModel , SpinnerListModel , SpinnerNumberModel , SpinnerDateModel , JFormattedTextField

중첩된 클래스의 개요

static class	JSpinner.DateEditor 모델을 SpinnerDateModel 로 하는 JSpinner 용의 에디터입니다.
static class	JSpinner.DefaultEditor 특수한 에디터용의 간단한 base class입니다.
static class	JSpinner.ListEditor 모델이 SpinnerListModel 의 JSpinner 용의 에디터입니다.
static class	JSpinner.NumberEditor 모델이 SpinnerNumberModel 의 JSpinner 용의 에디터입니다.

클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스

JComponent.AccessibleJComponent

클래스 java.awt. Container 을 상속받은 중첩된 클래스

Container.AccessibleAWTContainer

클래스 java.awt. Component 을 상속받은 중첩된 클래스

Component.AccessibleAWTComponent , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 javax.swing. JComponent 에서 상속받은 필드

accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW

클래스 java.awt. Component 에서 상속받은 필드

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 에서 상속받은 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자의 개요

JSpinner ()
초기치가 0 으로 최소치 또는 최대치의 제한이 없는 Integer SpinnerNumberModel 를 가지는 스피나-를 구축합니다.

JSpinner (SpinnerModel model)
다음에 진행되는 및 앞으로 돌아가는 버튼의 페어와 SpinnerModel 용의 에디터를 가지는 완전한 스피나-를 구축합니다.

메소드의 개요

void	addChangeListener (ChangeListener listener) 청취자를, 모델에의 변경을 할 때마다 통지되는 리스트에 추가합니다.
void	commitEdit () 현재 편집되고 있는 값을 SpinnerModel 에 확정합니다.
protected JComponent	createEditor (SpinnerModel model) 이 메소드는 순차 순서의 현재의 값을 표시하는 JComponent 를 작성하기 위해서, constructor 에 의해 불려 갑니다.
protected void	fireStateChanged () 이 JSpinner 의 소스를 보관 유지하는 ChangeEvent 를 각 ChangeListener 에 송신합니다.
ChangeListener []	getChangeListeners () addChangeListener()를 사용해, 이 JSpinner 에 추가된 모든 ChangeListener 의 배열을 돌려줍니다.
JComponent	getEditor () 모델의 값을 표시해, 변경도 할 수 있는 컴퍼넌트를 돌려줍니다.
SpinnerModel	getModel () 이 스피나-의 값의 순차 순서를 정의하는 SpinnerModel 돌려줍니다.
Object	getNextValue () getValue() 에 의해 돌려주어진 오브젝트의 뒤에 있는 순차 순서의 오브젝트를 돌려줍니다.
Object	getPreviousValue () getValue() 에 의해 돌려주어진 오브젝트의 전에 있는 순차 순서의 오브젝트를 돌려줍니다.
SpinnerUI	getUI () 이 컴퍼넌트를 표현 하는 Look & Feel (L&F) 오브젝트를 돌려줍니다.
String	getUIClassID () Look & Feel (L&F) 클래스의 이름의 구축에 사용된 접두사를 돌려줍니다.
Object	getValue () 모델의 현재의 값을 돌려줍니다.
void	removeChangeListener (ChangeListener listener) 이 스피나-로부터 ChangeListener 를 삭제합니다.
void	setEditor (JComponent editor) SpinnerModel 의 현재의 값을 표시하는 JComponent 를 변경합니다.
void	setModel (SpinnerModel model) 이 스피나-의 값을 나타내는 모델을 변경합니다.
void	setUI (SpinnerUI ui) 이 컴퍼넌트를 표현 하는 Look & Feel (L&F) 오브젝트를 설정합니다.
void	setValue (Object value) 모델의 현재의 값을 변경합니다.
void	updateUI () 현재의 Look & Feel 로부터의 값을 가지는 UI 프로퍼티를 리셋트 합니다.

클래스 javax.swing. JComponent 에서 상속받은 메소드

addAncestorListener , addNotify , addPropertyChangeListener , addPropertyChangeListener , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getAccessibleContext , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getGraphics , getHeight , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPreferredSize , getPropertyChangeListeners , getPropertyChangeListeners , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isPreferredSizeSet , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , paramString , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removePropertyChangeListener , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFont , setForeground , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update

클래스 java.awt. Container 에서 상속받은 메소드

add , add , add , add , add , addContainerListener , addImpl , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

클래스 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 , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , 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 , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , repaint , repaint , repaint , resize , resize , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setFocusable , setFocusTraversalKeysEnabled , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus , transferFocusUpCycle

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

JSpinner

public JSpinner(SpinnerModel  model)

다음에 진행되는 및 앞으로 돌아가는 버튼의 페어와 SpinnerModel 용의 에디터를 가지는 완전한 스피나-를 구축합니다.

JSpinner

public JSpinner()

초기치가 0 으로 최소치 또는 최대치의 제한이 없는 Integer SpinnerNumberModel 를 가지는 스피나-를 구축합니다.

메소드의 상세

getUI

public SpinnerUI  getUI()

이 컴퍼넌트를 표현 하는 Look & Feel (L&F) 오브젝트를 돌려줍니다.

반환값:

이 컴퍼넌트를 표현 하는 SpinnerUI 오브젝트

setUI

public void setUI(SpinnerUI  ui)

이 컴퍼넌트를 표현 하는 Look & Feel (L&F) 오브젝트를 설정합니다.

파라미터:

ui - SpinnerUI L&F 오브젝트

관련 항목:

UIDefaults.getUI(javax.swing.JComponent)

getUIClassID

public String  getUIClassID()

Look & Feel (L&F) 클래스의 이름의 구축에 사용된 접두사를 돌려줍니다. 이 클래스는 이 컴퍼넌트를 표현 하는데 사용됩니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

SpinnerUI 의 캐릭터 라인

관련 항목:

JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

현재의 Look & Feel 로부터의 값을 가지는 UI 프로퍼티를 리셋트 합니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

UIManager.getUI(javax.swing.JComponent)

createEditor

protected JComponent  createEditor(SpinnerModel  model)

이 메소드는 순차 순서의 현재의 값을 표시하는 JComponent 를 작성하기 위해서, constructor 에 의해 불려 갑니다. 또, 에디터를 사용하는 것으로써, 유저는 순차 순서의 요소를 직접 입력하는 것이 가능하게 됩니다. 에디터는 model 의 ChangeEvents 를 대기해, 표시하는 값이 모델의 값과 동기 하도록(듯이) 유지할 필요가 있습니다.

서브 클래스는 이 메소드를 오버라이드(override) 해, 새로운 SpinnerModel 클래스의 서포트를 추가합니다. 또, 여기서 작성된 에디터를, 단지 setEditor 메소드와 옮겨놓을 수도 있습니다. 모델 타입으로부터 에디터에의 디폴트의 매핑은 다음과 같습니다.

• SpinnerNumberModel =< JSpinner.NumberEditor
• SpinnerDateModel =< JSpinner.DateEditor
• SpinnerListModel =< JSpinner.ListEditor
• 상기 이외 =< JSpinner.DefaultEditor

파라미터:

model - getModel 의 값

반환값:

순차 순서의 현재의 값을 표시하는 컴퍼넌트

관련 항목:

getModel() , setEditor(javax.swing.JComponent)

setModel

public void setModel(SpinnerModel  model)

이 스피나-의 값을 나타내는 모델을 변경합니다. 에디터의 프로퍼티가 명시적으로 설정되어 있지 않은 경우, 에디터의 프로퍼티는 "model" PropertyChangeEvent 가 방아쇠 된 후에 암묵중으로 설정됩니다. 에디터의 프로퍼티는 다음과 같이 createEditor 에 의해 돌려주어진 값으로 설정됩니다.

 setEditor(createEditor(model));

파라미터:

model - 새로운 SpinnerModel

예외:

IllegalArgumentException - 모델이 null 의 경우

관련 항목:

getModel() , getEditor() , setEditor(javax.swing.JComponent)

getModel

public SpinnerModel  getModel()

이 스피나-의 값의 순차 순서를 정의하는 SpinnerModel 돌려줍니다.

반환값:

모델의 프로퍼티의 값

관련 항목:

setModel(javax.swing.SpinnerModel)

getValue

public Object  getValue()

모델의 현재의 값을 돌려줍니다. 통상, 이 값은 editor 에 의해 표시됩니다.

이 메소드는 단지 model 에 delegate 됩니다. 이것은 다음의 경우와 동등합니다.

 getModel(). getValue()

관련 항목:

setValue(java.lang.Object) , SpinnerModel.getValue()

setValue

public void setValue(Object  value)

모델의 현재의 값을 변경합니다. 통상, 이 값은 editor 에 의해 표시됩니다. SpinnerModel 의 구현이 지정된 값을 서포트하지 않는 경우는 IllegalArgumentException 가 슬로우 됩니다.

이 메소드는 단지 model 에 delegate 됩니다. 이것은 다음의 경우와 동등합니다.

 getModel(). setValue(value)

예외:

IllegalArgumentException - value 를 사용할 수 없는 경우

관련 항목:

getValue() , SpinnerModel.setValue(java.lang.Object)

getNextValue

public Object  getNextValue()

getValue() 에 의해 돌려주어진 오브젝트의 뒤에 있는 순차 순서의 오브젝트를 돌려줍니다. 순차 순서의 종점에 도달했을 경우,null 를 돌려줍니다. 이 메소드의 호출은 value 에 영향을 주지 않습니다.

이 메소드는 단지 model 에 delegate 됩니다. 이것은 다음의 경우와 동등합니다.

 getModel(). getNextValue()

반환값:

다음의 정당한 값, 또는 그것이 존재하지 않는 경우는 null

관련 항목:

getValue() , getPreviousValue() , SpinnerModel.getNextValue()

addChangeListener

public void addChangeListener(ChangeListener  listener)

청취자를, 모델에의 변경을 할 때마다 통지되는 리스트에 추가합니다. ChangeListeners 에 송신된 ChangeEvents 의 소스는 이 JSpinner 입니다. 모델의 치환은 Jspinner 에 직접 추가된 청취자에게 영향을 주지 않는 것에도 주의해 주세요. 어플리케이션은 청취자를 모델로 직접 추가할 수 있습니다. 이 경우는 이벤트의 소스는 SpinnerModel 가 됩니다.

파라미터:

listener - 추가하는 ChangeListener

관련 항목:

removeChangeListener(javax.swing.event.ChangeListener) , getModel()

removeChangeListener

public void removeChangeListener(ChangeListener  listener)

이 스피나-로부터 ChangeListener 을 삭제합니다.

파라미터:

listener - 삭제하는 ChangeListener

관련 항목:

fireStateChanged() , addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener [] getChangeListeners()

addChangeListener()를 사용해, 이 JSpinner 에 추가된 모든 ChangeListener 의 배열을 돌려줍니다.

반환값:

추가된 모든 ChangeListener, 또는 청취자가 추가되어 있지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

fireStateChanged

protected void fireStateChanged()

이 JSpinner 의 소스를 보관 유지하는 ChangeEvent 를 각 ChangeListener 에 송신합니다. ChangeListener 가 스피나-에 추가되고 있는 경우, 모델로부터 ChangeEvent 를 받을 때마다, 이 메소드가 불려 갑니다.

관련 항목:

addChangeListener(javax.swing.event.ChangeListener) , removeChangeListener(javax.swing.event.ChangeListener) , EventListenerList

getPreviousValue

public Object  getPreviousValue()

getValue() 에 의해 돌려주어진 오브젝트의 전에 있는 순차 순서의 오브젝트를 돌려줍니다. 순차 순서의 종점에 도달했을 경우,null 를 돌려줍니다. 이 메소드의 호출은 value 에 영향을 주지 않습니다.

이 메소드는 단지 model 에 delegate 됩니다. 이것은 다음의 경우와 동등합니다.

 getModel(). getPreviousValue()

반환값:

이전의 정당한 값, 또는 그것이 존재하지 않는 경우는 null

관련 항목:

getValue() , getNextValue() , SpinnerModel.getPreviousValue()

setEditor

public void setEditor(JComponent  editor)

SpinnerModel 의 현재의 값을 표시하는 JComponent 를 변경합니다. 이 메소드에 의해, 낡은 에디터가 모델로부터 떼어내져 새로운 에디터가 접속됩니다. 이것은 낡은 에디터의 ChangeListener 를 모델 또는 스피나-자체로부터 삭제해, 새로운 에디터의 변경 청취자를 추가하는 것을 의미합니다.

파라미터:

editor - 새로운 에디터

예외:

IllegalArgumentException - 에디터가 null 의 경우

관련 항목:

getEditor() , createEditor(javax.swing.SpinnerModel) , getModel()

getEditor

public JComponent  getEditor()

모델의 값을 표시해, 변경도 할 수 있는 컴퍼넌트를 돌려줍니다.

반환값:

모델의 값을 표시해, 변경도 할 수 있는 컴퍼넌트

관련 항목:

setEditor(javax.swing.JComponent) , createEditor(javax.swing.SpinnerModel)

commitEdit

public void commitEdit()
                throws ParseException 

현재 편집되고 있는 값을 SpinnerModel 에 확정합니다.

에디터가 DefaultEditor 의 인스턴스의 경우, 에디터에 전송 되었을 때는 호출을 실시해, 그 이외 때는 아무것도 처리를 실시하지 않습니다.

예외:

ParseException - 현재 편집되고 있는 값을 확정할 수 없었던 경우