javax.swing
クラス JSlider

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JSlider

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

ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

public class JSlider
extends JComponent
implements SwingConstants, Accessible

ユーザーが指定された区間内でノブをスライドすることによりグラフィカルに値を選択できるようにするコンポーネントです。

スライダは、大目盛りと、その間の小目盛りの両方を表示できます。目盛り間の値数は setMajorTickSpacing と setMinorTickSpacing で決定できます。目盛りがペイントされるかどうかは、setPaintTicks で制御されます。

スライダは、テキストラベルをスライダのトラックに沿って一定の間隔で (または任意の位置に) 表示することもできます。ラベルがペイントされるかどうかは、setLabelTable と setPaintLabels で制御されます。

詳細と使用例については、「The Java Tutorial」の「How to Use Sliders」を参照してください。

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

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

入れ子のクラスの概要

protected class

JSlider.AccessibleJSlider このクラスは JSlider クラス用のアクセシビリティーサポートを実装しています。

クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース

JComponent.AccessibleJComponent

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected ChangeEvent	changeEvent ChangeEvent の唯一の状態 (読み取り専用) はソースプロパティーなので、スライダのインスタンスに必要なこのイベントは 1 つだけです。
protected ChangeListener	changeListener changeListener (接尾辞なし) はスライダのモデルに追加するリスナーです。
protected int	majorTickSpacing 大目盛り間の値数です。
protected int	minorTickSpacing 小目盛り間の値数です。
protected int	orientation スライダが水平であるか垂直であるかを示します。
protected BoundedRangeModel	sliderModel スライダの数値の最大値、最小値、および現在位置の値を処理するデータモデルです。
protected boolean	snapToTicks true の場合、ノブ (およびノブが表すデータ値) は、ユーザーがノブを置いた位置にもっとも近い目盛りに置かれます。

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

インタフェース javax.swing.SwingConstants から継承されたフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

インタフェース java.awt.image.ImageObserver から継承されたフィールド

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

コンストラクタの概要

JSlider()
範囲が 0 〜 100、初期値が 50 の水平スライダを作成します。

JSlider(BoundedRangeModel brm)
指定された BoundedRangeModel を使って水平スライダを作成します。

JSlider(int orientation)
方向を指定して、範囲が 0 〜 100、初期値が 50 のスライダを作成します。

JSlider(int min, int max)
最小値と最大値の合計を平均した値に等しい初期値を持つ、指定された最小値および最大値を使って、水平スライダを作成します。

JSlider(int min, int max, int value)
最小値、最大値、および初期値を指定して、水平スライダを作成します。

JSlider(int orientation, int min, int max, int value)
方向、最小値、最大値、および初期値を指定して、スライダを作成します。

メソッドの概要

void	addChangeListener(ChangeListener l) スライダに ChangeListener を追加します。
protected ChangeListener	createChangeListener() サブクラスが別の方法でモデルの ChangeEvent を処理する場合は、このメソッドをオーバーライドして独自の ChangeListener の実装のインスタンスを返すことができます。
Hashtable	createStandardLabels(int increment) スライダの最小値から開始し、指定された増分値を使用して、数値テキストラベルの Hashtable を作成します。
Hashtable	createStandardLabels(int increment, int start) 指定された始点から開始し、指定された増分値を使用して、数値テキストラベルの Hashtable を作成します。
protected void	fireStateChanged() この JSlider をソースとする ChangeEvent を、ChangeEvent の通知を受ける登録をしているすべての ChangeListener に送信します。
AccessibleContext	getAccessibleContext() この JSlider に関連した AccessibleContext を返します。
ChangeListener[]	getChangeListeners() addChangeListener() を使用して、この JSlider に追加されたすべての ChangeListener の配列を返します。
int	getExtent() BoundedRangeModel の「エクステント」を返します。
boolean	getInverted() スライダーに表示される値の範囲が通常とは逆になる場合は true を返します。
Dictionary	getLabelTable() どのラベルをどの値に描画するかを決めるのに使うディクショナリを返します。
int	getMajorTickSpacing() 大目盛りの間隔を返します。
int	getMaximum() BoundedRangeModel のスライダによってサポートされている最大値を返します。
int	getMinimum() BoundedRangeModel のスライダによってサポートされている最小値を返します。
int	getMinorTickSpacing() 小目盛りの間隔を返します。
BoundedRangeModel	getModel() スライダの 3 つの基本プロパティーである、最小値、最大値、および初期値を処理する BoundedRangeModel を返します。
int	getOrientation() このスライダの垂直または水平の方向を返します。
boolean	getPaintLabels() ラベルがペイントされるかどうかを示します。
boolean	getPaintTicks() 目盛りがペイントされるかどうかを示します。
boolean	getPaintTrack() トラック (スライダがスライドする領域) がペイントされるかどうかを示します。
boolean	getSnapToTicks() ノブ (およびノブが表すデータ値) が、ユーザーがノブを置いた位置にもっとも近い目盛りに置かれる場合に、true を返します。
SliderUI	getUI() コンポーネントの L&F を実装する UI オブジェクトを返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
int	getValue() BoundedRangeModel のスライダの現在値を返します。
boolean	getValueIsAdjusting() モデルの valueIsAdjusting プロパティーを返します。
protected String	paramString() この JSlider の文字列表現を返します。
void	removeChangeListener(ChangeListener l) スライダから ChangeListener を削除します。
void	setExtent(int extent) ノブによって「カバー」される範囲のサイズを設定します。
void	setFont(Font font) このコンポーネントのフォントを設定します。
void	setInverted(boolean b) スライダに表示する値の範囲を通常とは逆にする場合は true を指定し、通常の順序にするには false を指定します。
void	setLabelTable(Dictionary labels) 任意の指定された値にどのラベルが描画されるかを指定するときに使用します。
void	setMajorTickSpacing(int n) 大目盛りの間隔を設定します。
void	setMaximum(int maximum) スライダの最大値を maximum に設定します。
void	setMinimum(int minimum) スライダの最小値を minimum に設定します。
void	setMinorTickSpacing(int n) 小目盛りの間隔を設定します。
void	setModel(BoundedRangeModel newModel) スライダの 3 つの基本プロパティーである、最小値、最大値、および初期値を処理する BoundedRangeModel を設定します。
void	setOrientation(int orientation) スライダの方向を newOrientation (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) に設定します。
void	setPaintLabels(boolean b) ラベルがスライダでペイントされるかどうかを指定します。
void	setPaintTicks(boolean b) 目盛りがスライダでペイントされるかどうかを指定します。
void	setPaintTrack(boolean b) トラックがスライダでペイントされるかどうかを指定します。
void	setSnapToTicks(boolean b) true を指定すると、ノブ (およびノブが表すデータ値) はユーザーがノブを置いた位置にもっとも近い目盛りに置かれます。
void	setUI(SliderUI ui) コンポーネントの L&F を実装する UI オブジェクトを設定します。
void	setValue(int n) スライダの現在値を n に設定します。
void	setValueIsAdjusting(boolean b) モデルの valueIsAdjusting プロパティーを設定します。
protected void	updateLabelUIs() ラベルテーブル内の各ラベルに対して updateUI を呼び出すことにより、これらのラベルの UI を更新します。
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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, 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, 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, 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, hide, 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, transferFocusUpCycle

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

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

フィールドの詳細

sliderModel

protected BoundedRangeModel sliderModel

スライダの数値の最大値、最小値、および現在位置の値を処理するデータモデルです。

majorTickSpacing

protected int majorTickSpacing

大目盛り間の値数です。大目盛りは小目盛りに分割されます。

minorTickSpacing

protected int minorTickSpacing

小目盛り間の値数です。小目盛りは大目盛りの間に表示されます。

関連項目:

setMinorTickSpacing(int)

snapToTicks

protected boolean snapToTicks

true の場合、ノブ (およびノブが表すデータ値) は、ユーザーがノブを置いた位置にもっとも近い目盛りに置かれます。デフォルトは false です。

関連項目:

setSnapToTicks(boolean)

orientation

protected int orientation

スライダが水平であるか垂直であるかを示します。デフォルトは水平です。

関連項目:

setOrientation(int)

changeListener

protected ChangeListener changeListener

changeListener (接尾辞なし) はスライダのモデルに追加するリスナーです。リスナーは、createChangeListener から返される ChangeListener に初期化されます。createChangeListener は、デフォルトでは、スライダに直接追加された ChangeListener がある場合に、それに対してイベントを転送するだけです。

関連項目:

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

changeEvent

protected transient ChangeEvent changeEvent

ChangeEvent の唯一の状態 (読み取り専用) はソースプロパティーなので、スライダのインスタンスに必要なこのイベントは 1 つだけです。ここで生成されたイベントのソースは、常に「this」です。はじめてイベント通知がトリガーされたときに、イベントは遅れて作成されます。

関連項目:

fireStateChanged()

コンストラクタの詳細

JSlider

public JSlider()

範囲が 0 〜 100、初期値が 50 の水平スライダを作成します。

JSlider

public JSlider(int orientation)

方向を指定して、範囲が 0 〜 100、初期値が 50 のスライダを作成します。方向は、SwingConstants.VERTICAL または SwingConstants.HORIZONTAL になります。

パラメータ:

orientation - スライダの方向

例外:

IllegalArgumentException - 方向が VERTICAL または HORIZONTAL のどちらでもない場合

関連項目:

setOrientation(int)

JSlider

public JSlider(int min,
               int max)

最小値と最大値の合計を平均した値に等しい初期値を持つ、指定された最小値および最大値を使って、水平スライダを作成します。

スライダの最小値および最大値として設定された値が適切でないために問題が発生した場合は、スライダのデータを保持する BoundedRangeModel がその問題を処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

パラメータ:

min - スライダの最小値

max - スライダの最大値

関連項目:

BoundedRangeModel, setMinimum(int), setMaximum(int)

JSlider

public JSlider(int min,
               int max,
               int value)

最小値、最大値、および初期値を指定して、水平スライダを作成します。

スライダの最小値、初期値、および最大値として設定された値が適切でないために問題が発生した場合は、スライダのデータを保持する BoundedRangeModel がその問題を処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

パラメータ:

min - スライダの最小値

max - スライダの最大値

value - スライダの初期値

関連項目:

BoundedRangeModel, setMinimum(int), setMaximum(int), setValue(int)

JSlider

public JSlider(int orientation,
               int min,
               int max,
               int value)

方向、最小値、最大値、および初期値を指定して、スライダを作成します。方向は、SwingConstants.VERTICAL または SwingConstants.HORIZONTAL になります。

スライダの最小値、初期値、および最大値として設定された値が適切でないために問題が発生した場合は、スライダのデータを保持する BoundedRangeModel がその問題を処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

パラメータ:

orientation - スライダの方向

min - スライダの最小値

max - スライダの最大値

value - スライダの初期値

例外:

IllegalArgumentException - 方向が VERTICAL または HORIZONTAL のどちらでもない場合

関連項目:

BoundedRangeModel, setOrientation(int), setMinimum(int), setMaximum(int), setValue(int)

JSlider

public JSlider(BoundedRangeModel brm)

指定された BoundedRangeModel を使って水平スライダを作成します。

メソッドの詳細

getUI

public SliderUI getUI()

コンポーネントの L&F を実装する UI オブジェクトを返します。

戻り値:

スライダの L&F を実装する SliderUI オブジェクト

setUI

public void setUI(SliderUI ui)

コンポーネントの L&F を実装する UI オブジェクトを設定します。

パラメータ:

ui - SliderUI L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

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

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

SliderUI

関連項目:

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

createChangeListener

protected ChangeListener createChangeListener()

サブクラスが別の方法でモデルの ChangeEvent を処理する場合は、このメソッドをオーバーライドして独自の ChangeListener の実装のインスタンスを返すことができます。デフォルトの ChangeListener は、単純に fireStateChanged メソッドを呼び出すことにより、ChangeEvent を、スライダに直接追加された ChangeListener に転送します。

関連項目:

changeListener, fireStateChanged(), ChangeListener, BoundedRangeModel

addChangeListener

public void addChangeListener(ChangeListener l)

スライダに ChangeListener を追加します。

パラメータ:

l - 追加する ChangeListener

関連項目:

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

スライダから ChangeListener を削除します。

パラメータ:

l - 削除する ChangeListener

関連項目:

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

getChangeListeners

public ChangeListener[] getChangeListeners()

addChangeListener() を使用して、この JSlider に追加されたすべての ChangeListener の配列を返します。

戻り値:

追加されたすべての ChangeListener。リスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

fireStateChanged

protected void fireStateChanged()

この JSlider をソースとする ChangeEvent を、ChangeEvent の通知を受ける登録をしているすべての ChangeListener に送信します。このメソッドは、モデルから ChangeEvent を受信するたびに呼び出されます。

必要に応じてイベントインスタンスが作成され、changeEvent に格納されます。

関連項目:

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

getModel

public BoundedRangeModel getModel()

スライダの 3 つの基本プロパティーである、最小値、最大値、および初期値を処理する BoundedRangeModel を返します。

戻り値:

このコンポーネントのデータモデル

関連項目:

setModel(javax.swing.BoundedRangeModel), BoundedRangeModel

setModel

public void setModel(BoundedRangeModel newModel)

スライダの 3 つの基本プロパティーである、最小値、最大値、および初期値を処理する BoundedRangeModel を設定します。

このメソッドに null モデルを渡そうとすると、不確定な動作が生じ、さらに多くの場合は例外が発生します。

パラメータ:

newModel - 使用する null 以外の 新しい BoundedRangeModel

関連項目:

getModel(), BoundedRangeModel

getValue

public int getValue()

BoundedRangeModel のスライダの現在値を返します。

戻り値:

スライダの現在値

関連項目:

setValue(int), BoundedRangeModel.getValue()

setValue

public void setValue(int n)

スライダの現在値を n に設定します。このメソッドはモデルに新しい値を転送します。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

新しい値が以前の値と異なる場合は、すべての変更リスナーが通知されます。

パラメータ:

n - 新しい値

関連項目:

getValue(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setValue(int)

getMinimum

public int getMinimum()

BoundedRangeModel のスライダによってサポートされている最小値を返します。

戻り値:

モデルの最小値プロパティーの値

関連項目:

setMinimum(int), BoundedRangeModel.getMinimum()

setMinimum

public void setMinimum(int minimum)

スライダの最小値を minimum に設定します。このメソッドはモデルに新しい最小値を転送します。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

新しい最小値が以前の最小値と異なる場合は、すべての変更リスナーが通知を受け取ります。

パラメータ:

n - 新しい最小値

関連項目:

getMinimum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

BoundedRangeModel のスライダによってサポートされている最大値を返します。

戻り値:

モデルの最大値プロパティーの値

関連項目:

setMaximum(int), BoundedRangeModel.getMaximum()

setMaximum

public void setMaximum(int maximum)

スライダの最大値を maximum に設定します。このメソッドはモデルに新しい最大値を転送します。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

新しい最大値が以前の最大値と異なる場合は、すべての変更リスナーが通知を受け取ります。

パラメータ:

n - 新しい最大値

関連項目:

getMaximum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

モデルの valueIsAdjusting プロパティーを返します。詳しい使用方法については、setValueIsAdjusting のドキュメントを参照してください。

戻り値:

モデルの valueIsAdjusting プロパティーの値

関連項目:

setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

モデルの valueIsAdjusting プロパティーを設定します。スライダの Look & Feel の実装は、ノブのドラッグが開始されたときにこのプロパティーを true に設定し、ドラッグが終了したときに false に設定するべきです。スライダモデルは、valueIsAdjusting が true の場合、ChangeEvent を生成しません。

パラメータ:

b - valueIsAdjusting プロパティーの新しい値

関連項目:

getValueIsAdjusting(), BoundedRangeModel.setValueIsAdjusting(boolean)

getExtent

public int getExtent()

BoundedRangeModel の「エクステント」を返します。これは、ノブによって「カバー」される値の範囲を表します。

戻り値:

エクステントを表す int 値

関連項目:

setExtent(int), BoundedRangeModel.getExtent()

setExtent

public void setExtent(int extent)

ノブによって「カバー」される範囲のサイズを設定します。ほとんどの Look & Feel の実装は、ユーザーがノブのどちらかの側をクリックした場合に、この量ごとで値を変更します。このメソッドはモデルに新しいエクステント値を転送するだけです。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

新しいエクステント値が以前のエクステント値と異なる場合は、すべての変更リスナーが通知を受け取ります。

パラメータ:

extent - 新しいエクステント

関連項目:

getExtent(), BoundedRangeModel.setExtent(int)

getOrientation

public int getOrientation()

このスライダの垂直または水平の方向を返します。

戻り値:

SwingConstants.VERTICAL または SwingConstants.HORIZONTAL

関連項目:

setOrientation(int)

setOrientation

public void setOrientation(int orientation)

スライダの方向を newOrientation (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) に設定します。

パラメータ:

orientation - HORIZONTAL または VERTICAL

例外:

IllegalArgumentException - 方向が VERTICAL または HORIZONTAL のどちらでもない場合

関連項目:

getOrientation()

setFont

public void setFont(Font font)

このコンポーネントのフォントを設定します。

オーバーライド:

クラス JComponent 内の setFont

パラメータ:

font - このコンポーネントに指定する Font

導入されたバージョン:

1.6

関連項目:

Component.getFont()

getLabelTable

public Dictionary getLabelTable()

どのラベルをどの値に描画するかを決めるのに使うディクショナリを返します。

戻り値:

ラベルとラベルの描画先が格納されている Dictionary

setLabelTable

public void setLabelTable(Dictionary labels)

任意の指定された値にどのラベルが描画されるかを指定するときに使用します。キーと値のペアは、{ Integer value, java.swing.JComponent label } という形式です。

標準の値ラベルテーブルは、createStandardLabels メソッドを使用すると簡単に作成できます。

ラベルの設定が完了すると、このメソッドは updateLabelUIs() を呼び出します。ラベルがペイントされるのは、paintLabels プロパティーが true の場合だけである点に注意してください。

パラメータ:

labels - 新しいラベルの Dictionary。すべてのラベルを削除する場合は null

関連項目:

createStandardLabels(int), getLabelTable(), setPaintLabels(boolean)

updateLabelUIs

protected void updateLabelUIs()

ラベルテーブル内の各ラベルに対して updateUI を呼び出すことにより、これらのラベルの UI を更新します。UI は、現在の Look & Feel で更新されます。ラベルは、その推奨サイズに設定されます。

関連項目:

setLabelTable(java.util.Dictionary), JComponent.updateUI()

createStandardLabels

public Hashtable createStandardLabels(int increment)

スライダの最小値から開始し、指定された増分値を使用して、数値テキストラベルの Hashtable を作成します。たとえば、createStandardLabels( 10 ) を呼び出す場合で、スライダの最小値が 0 の場合は、0、10、20、30 などの値のラベルが作成されます。

スライダにラベルを描画するためには、返された Hashtable を setLabelTable に渡し、setPaintLabels を true に設定します。

返される Hashtable の設定の詳細は、setLabelTable のドキュメントを参照してください。

パラメータ:

increment - 生成されたハッシュテーブル内のラベルの間隔

戻り値:

ラベルの新しい Hashtable

例外:

IllegalArgumentException - increment がゼロ以下の場合

関連項目:

setLabelTable(java.util.Dictionary), setPaintLabels(boolean)

createStandardLabels

public Hashtable createStandardLabels(int increment,
                                      int start)

指定された始点から開始し、指定された増分値を使用して、数値テキストラベルの Hashtable を作成します。たとえば、createStandardLabels( 10, 2 ) を呼び出した場合、2、12、22、32 などの値のラベルが作成されます。

スライダにラベルを描画するためには、返された Hashtable を setLabelTable に渡し、setPaintLabels を true に設定します。

返される Hashtable の設定の詳細は、setLabelTable のドキュメントを参照してください。

パラメータ:

increment - 生成されたハッシュテーブル内のラベルの間隔

start - ラベルが始まる位置の値

戻り値:

ラベルの新しい Hashtable

例外:

IllegalArgumentException - start が範囲外であるか、increment がゼロ以下である場合

関連項目:

setLabelTable(java.util.Dictionary), setPaintLabels(boolean)

getInverted

public boolean getInverted()

スライダーに表示される値の範囲が通常とは逆になる場合は true を返します。

戻り値:

スライダの値が通常の順序と逆の場合は true

関連項目:

setInverted(boolean)

setInverted

public void setInverted(boolean b)

スライダに表示する値の範囲を通常とは逆にする場合は true を指定し、通常の順序にするには false を指定します。順序はスライダの ComponentOrientation プロパティーにより異なります。LEFT_TO_RIGHT の ComponentOrientation 値を持った逆変換されていない通常の水平スライダの最大値は右側にあります。RIGHT_TO_LEFT の ComponentOrientation 値を持った通常の水平スライダの最大値は左側にあります。通常の垂直スライダの最大値は一番上にあります。このラベルはスライダが変換されると順序が逆になります。

このプロパティーのデフォルト値は false です。

パラメータ:

b - スライダの値を通常の順序と逆にする場合は true

getMajorTickSpacing

public int getMajorTickSpacing()

大目盛りの間隔を返します。返される数値は、値を単位とした、各大目盛り間の距離を表します。範囲が 0 〜 50 のスライダで、大目盛りの間隔が 10 に設定されている場合は、0、10、20、30、40、50 の値の横に大目盛りが付けられます。 0, 10, 20, 30, 40, 50.

戻り値:

大目盛り間の値数

関連項目:

setMajorTickSpacing(int)

setMajorTickSpacing

public void setMajorTickSpacing(int n)

大目盛りの間隔を設定します。渡される数値は、値を単位とした、各大目盛り間の距離を表します。範囲が 0 〜 50 のスライダで、大目盛りの間隔が 10 に設定されている場合は、0、10、20、30、40、50 の値の横に大目盛りが付けられます。 0, 10, 20, 30, 40, 50.

大目盛りをペイントする場合は、setPaintTicks を true に設定してください。

このメソッドは、自動的にラベルテーブルの設定も行います。まだラベルテーブルが存在しない場合で、大目盛りの間隔が ゼロより大きく、getPaintLabels が true を返す場合は、createStandardLabels の呼び出しにより、大目盛りのラベルで標準ラベルテーブルが生成されます。たとえば上記の例の場合、テキストラベル「0」、「10」、「20」、「30」、「40」、「50」を取得します。続いて、setLabelTable の呼び出しにより、スライダ上にラベルテーブルが設定されます。

パラメータ:

n - majorTickSpacing プロパティーの新しい値

関連項目:

getMajorTickSpacing(), setPaintTicks(boolean), setLabelTable(java.util.Dictionary), createStandardLabels(int)

getMinorTickSpacing

public int getMinorTickSpacing()

小目盛りの間隔を返します。返される数値は、値を単位とした、各小目盛り間の距離を表します。範囲が 0 〜 50 のスライダで、小目盛りの間隔が 10 に設定されている場合は、0、10、20、30、40、50 の値の横に小目盛りが付けられます。 0, 10, 20, 30, 40, 50.

戻り値:

小目盛り間の値数

関連項目:

getMinorTickSpacing()

setMinorTickSpacing

public void setMinorTickSpacing(int n)

小目盛りの間隔を設定します。渡される数値は、値を単位とした、各小目盛りの間の距離を表します。範囲が 0 〜 50 のスライダで、小目盛りの間隔が 10 に設定されている場合は、0、10、20、30、40、50 の値の横に小目盛りが付けられます。 0, 10, 20, 30, 40, 50.

小目盛りをペイントする場合は、setPaintTicks を true に設定してください。

パラメータ:

n - minorTickSpacing プロパティーの新しい値

関連項目:

getMinorTickSpacing(), setPaintTicks(boolean)

getSnapToTicks

public boolean getSnapToTicks()

ノブ (およびノブが表すデータ値) が、ユーザーがノブを置いた位置にもっとも近い目盛りに置かれる場合に、true を返します。

戻り値:

値がもっとも近い目盛りに留まる場合は true、そうでない場合は false

関連項目:

setSnapToTicks(boolean)

setSnapToTicks

public void setSnapToTicks(boolean b)

true を指定すると、ノブ (およびノブが表すデータ値) はユーザーがノブを置いた位置にもっとも近い目盛りに置かれます。このプロパティーのデフォルトは false です。

パラメータ:

b - ノブがもっとも近い目盛りに留まる場合は true

関連項目:

getSnapToTicks()

getPaintTicks

public boolean getPaintTicks()

目盛りがペイントされるかどうかを示します。

戻り値:

目盛りがペイントされている場合は true、そうでない場合は false

関連項目:

setPaintTicks(boolean)

setPaintTicks

public void setPaintTicks(boolean b)

目盛りがスライダでペイントされるかどうかを指定します。このプロパティーのデフォルトは false です。

パラメータ:

b - 目盛りをペイントするかどうか

関連項目:

getPaintTicks()

getPaintTrack

public boolean getPaintTrack()

トラック (スライダがスライドする領域) がペイントされるかどうかを示します。

戻り値:

トラックがペイントされている場合は true、そうでない場合は false

関連項目:

setPaintTrack(boolean)

setPaintTrack

public void setPaintTrack(boolean b)

トラックがスライダでペイントされるかどうかを指定します。このプロパティーのデフォルトは true です。

パラメータ:

b - スライダのトラックをペイントするかどうか

関連項目:

getPaintTrack()

getPaintLabels

public boolean getPaintLabels()

ラベルがペイントされるかどうかを示します。

戻り値:

ラベルがペイントされている場合は true、そうでない場合は false

関連項目:

setPaintLabels(boolean)

setPaintLabels

public void setPaintLabels(boolean b)

ラベルがスライダでペイントされるかどうかを指定します。

このメソッドは、自動的にラベルテーブルの設定も行います。まだラベルテーブルが存在しない場合で、大目盛りの間隔が ゼロより大きい 場合は、createStandardLabels の呼び出しにより、大目盛りのラベルで標準ラベルテーブルが生成されます。続いて、setLabelTable の呼び出しにより、スライダ上にラベルテーブルが設定されます。

このプロパティーのデフォルトは false です。

パラメータ:

b - ラベルをペイントするかどうか

関連項目:

getPaintLabels(), getLabelTable(), createStandardLabels(int)

paramString

protected String paramString()

この JSlider の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JSlider の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JSlider に関連した AccessibleContext を返します。スライダの場合、AccessibleContext は AccessibleJSlider の形式を取ります。必要に応じて新規の AccessibleJSlider インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

この JSlider の AccessibleContext として 機能する AccessibleJSlider