JavaTM 2
Platform
Std.  Ed.  v1. 4.0

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 이후, 모든 JavaBeansTM 의 장기간의 운용 서포트는 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
          모델이 SpinnerListModelJSpinner 용의 에디터입니다.
static class JSpinner.NumberEditor
          모델이 SpinnerNumberModelJSpinner 용의 에디터입니다.
 
클래스 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 에 의해 불려 갑니다. 또, 에디터를 사용하는 것으로써, 유저는 순차 순서의 요소를 직접 입력하는 것이 가능하게 됩니다. 에디터는 modelChangeEvents 를 대기해, 표시하는 값이 모델의 값과 동기 하도록(듯이) 유지할 필요가 있습니다.

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

파라미터:
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 - 현재 편집되고 있는 값을 확정할 수 없었던 경우

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.