JavaTM Platform
Standard Ed. 6

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

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

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

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

詳細と使用例については、「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)
          方向を指定して、範囲が 0100、初期値が 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)
方向を指定して、範囲が 0100、初期値が 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 に設定するべきです。スライダモデルは、valueIsAdjustingtrue の場合、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 などの値のラベルが作成されます。

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

返される 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 などの値のラベルが作成されます。

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

返される 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_RIGHTComponentOrientation 値を持った逆変換されていない通常の水平スライダの最大値は右側にあります。RIGHT_TO_LEFTComponentOrientation 値を持った通常の水平スライダの最大値は左側にあります。通常の垂直スライダの最大値は一番上にあります。このラベルはスライダが変換されると順序が逆になります。

このプロパティーのデフォルト値は 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.

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

このメソッドは、自動的にラベルテーブルの設定も行います。まだラベルテーブルが存在しない場合で、大目盛りの間隔が ゼロより大きくgetPaintLabelstrue を返す場合は、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.

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

パラメータ:
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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。