javax.swing

クラスJSpinner

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JSpinner

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

public class JSpinner
extends JComponent
implements Accessible

ユーザーが、順序付けられたシーケンスから数またはオブジェクトを選択できるようにする単一行の入力フィールドです。通常、スピナーはシーケンスの要素間を移動するための小さな矢印ボタンのペアを提供します。キーボードの上/下矢印キーでも要素間を自由に移動できます。ユーザーがスピナーに直接(有効な)値を入力することもできます。コンボボックスは類似の機能を提供しますが、重要なデータを覆い隠してしまうドロップ・ダウン・リストを必要としないため、スピナーの方が好まれる場合があります。

JSpinnerのシーケンスの値は、SpinnerModelによって定義されます。modelは、コンストラクタの引数として指定し、modelプロパティを使用して変更できます。一部の共通の型として、SpinnerListModel、SpinnerNumberModel、およびSpinnerDateModelなどのSpinnerModelクラスが提供されます。

JSpinnerは、モデルの現在の要素または値を表示し、変更することもできるeditorと呼ばれる単一の子コンポーネントを持ちます。エディタは、JSpinnerのコンストラクタによって作成され、editorプロパティによって変更できます。JSpinnerのエディタは、ChangeEventを待機することにより、モデルとの同期を維持します。ユーザーがeditorによって表示された値を変更すると、modelの値とeditorの値が異なってしまう可能性があります。modelの値がエディタの値と同じかどうかを確認するには、commitEditメソッドを使用します。次に例を示します。

   try {
       spinner.commitEdit();
   }
   catch (ParseException pe) {{
       // Edited value is invalid, spinner.getValue() will return
       // the last valid value, you could revert the spinner to show that:
       JComponent editor = spinner.getEditor()
       if (editor instanceof DefaultEditor) {
           ((DefaultEditor)editor).getTextField().setValue(spinner.getValue();
       }
       // reset the value to some known value:
       spinner.setValue(fallbackValue);
       // or treat the last valid value as the current, in which
       // case you don't need to do anything.
   }
   return spinner.getValue();
 

スピナーの使用方法の詳細と例については、『The Java Tutorial』の「How to Use Spinners」を参照してください。

警告: Swingはスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beansパッケージに追加されています。XMLEncoderを参照してください。

導入されたバージョン:

1.4

関連項目:

SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerNumberModel, SpinnerDateModel, JFormattedTextField

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	JSpinner.AccessibleJSpinner AccessibleJSpinnerは、JSpinnerクラスのアクセシビリティ・サポートを実装しています。
static class	JSpinner.DateEditor モデルがSpinnerDateModelであるJSpinnerのエディタです。
static class	JSpinner.DefaultEditor JFormattedTextFieldを使用してモデルの現在の値の読取り専用ビューを表示する、より特殊なエディタの単純な基底クラスです。
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.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

クラス javax.swing.JComponentから継承されたフィールド

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

クラス java.awt.Componentから継承されたフィールド

accessibleContext, 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) 指定されたモデルのスピナーを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	addChangeListener(ChangeListener listener) リスナーを、モデルへの変更が行われるたびに通知されるリストに追加します。
void	commitEdit() 現在編集されている値をSpinnerModelにコミットします。
protected JComponent	createEditor(SpinnerModel model) このメソッドは、シーケンスの現在の値を表示するJComponentを作成するために、コンストラクタによって呼び出されます。
protected void	fireStateChanged() このJSpinnerをソースとするChangeEventを各ChangeListenerに送信します。
AccessibleContext	getAccessibleContext() JSpinnerのAccessibleContextを取得します。
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() モデルの現在の値を返します。通常、この値はeditorによって表示されます。
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) モデルの現在の値を変更します。通常、この値はeditorによって表示されます。
void	updateUI() 現在のLook & Feelからの値を持つUIプロパティをリセットします。

クラス javax.swing.JComponentから継承されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, 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, paramString, 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

クラス 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

クラス 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

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

JSpinner

public JSpinner(SpinnerModel model)

指定されたモデルのスピナーを構築します。スピナーは、前/次ボタンのセットと、そのモデル用の適切なエディタを持ちます。

例外:

NullPointerException - モデルがnullの場合

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)クラスの名前の構築に使用された接頭辞を返します。このクラスは、このコンポーネントを描画するのに使用されます。

オーバーライド:

getUIClassID 、クラス: JComponent

戻り値:

SpinnerUIの文字列

関連項目:

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

updateUI

public void updateUI()

現在のLook & Feelからの値を持つUIプロパティをリセットします。

オーバーライド:

updateUI 、クラス: JComponent

関連項目:

UIManager.getUI(javax.swing.JComponent)

createEditor

protected JComponent createEditor(SpinnerModel model)

このメソッドは、シーケンスの現在の値を表示するJComponentを作成するために、コンストラクタによって呼び出されます。また、エディタを使用することにより、ユーザーはシーケンスの要素を直接入力することが可能になります。エディタはmodelのChangeEventsを待機し、表示する値がモデルの値と同期するように維持する必要があります。

サブクラスは、このメソッドをオーバーライドして、新しい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によって表示されます。ユーザーがeditorによって表示された値を変更すると、modelの値とeditorの値が異なってしまう可能性があります。この問題の対処方法の例については、クラス・レベルのjavadocを参照してください。

このメソッドは単にmodelに委譲されます。これは次と同等です。

 getModel().getValue()
 

関連項目:

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

setValue

public void setValue(Object value)

モデルの現在の値を変更します。通常、この値はeditorによって表示されます。SpinnerModelの実装が指定された値をサポートしていない場合は、IllegalArgumentExceptionがスローされます。

このメソッドは単にmodelに委譲されます。これは次と同等です。

 getModel().setValue(value)
 

例外:

IllegalArgumentException - valueが正当でない場合

関連項目:

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

getNextValue

public Object getNextValue()

getValue()によって返されたオブジェクトの後にあるシーケンスのオブジェクトを返します。シーケンスの終点に到達した場合、nullを返します。このメソッドを呼び出しても、valueには影響しません。

このメソッドは単にmodelに委譲されます。これは次と同等です。

 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に委譲されます。これは次と同等です。

 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 - 現在編集されている値が確定できなかった場合。

getAccessibleContext

public AccessibleContext getAccessibleContext()

JSpinnerのAccessibleContextを取得します。

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Component

戻り値:

JSpinnerのAccessibleContext

導入されたバージョン:

1.5