クラスJSlider

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JSlider

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

ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

@JavaBean(defaultProperty="UI", description="A component that supports selecting a integer value from a range.") 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に適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追� されました。 XMLEncoderを参照してく� さい。

導入されたバージョン:

1.2

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

ネストされたクラス

修飾子と型	クラス	説明
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で宣言されたフィールド

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

インタフェース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

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JSlider()	範囲が0から100、初期値が50の水平スライダを作成します。
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)	方向、最小値、最大値、および初期値を指定して、スライダを作成します。
JSlider(BoundedRangeModel brm)	指定されたBoundedRangeModelを使って水平スライダを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addChangeListener(ChangeListener l)	スライダにChangeListenerを追� します。
protected ChangeListener	createChangeListener()	サブクラスが別の方法でモデルのChangeEventを処理する� �合は、このメソッドをオーバーライドしてChangeListenerのカスタ� 実装のインスタンスを返すことができます。
Hashtable<Integer, JComponent>	createStandardLabels(int increment)	スライダの最小値から開始し、指定された増分値を使用して、数値テキスト・ラベルを持つHashtableを作成します。
Hashtable<Integer, JComponent>	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プロパティを返します。
boolean	imageUpdate(Image img, int infoflags, int x, int y, int w, int h)	イメージが変更されたときにコンポーネントをふたたびペイントします。
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)	スライダの方向を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()	現在のルック・アンド・フィールからの値にUIプロパティをリセットします。

クラスjavax.swing.JComponentで宣言されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, 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, 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, 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, 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に初期化されます。これは、デフォルトでは、スライダに直接追� された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を使って水平スライダを作成します。

パラメータ:

brm - スライダのBoundedRangeModel

メソッドの詳細

getUI

public SliderUI getUI()

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

オーバーライド:

クラスJComponentのgetUI

戻り値:

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

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the slider's LookAndFeel.") public void setUI(SliderUI ui)

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

パラメータ:

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

関連� �目:

• UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在のルック・アンド・フィールからの値にUIプロパティをリセットします。

オーバーライド:

updateUI、クラスJComponent

関連� �目:

• JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJComponent

戻り値:

文字列"SliderUI"

関連� �目:

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

createChangeListener

protected ChangeListener createChangeListener()

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

戻り値:

新しい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

@BeanProperty(bound=false) 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

@BeanProperty(description="The sliders BoundedRangeModel.") public void setModel(BoundedRangeModel newModel)

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

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

パラメータ:

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

関連� �目:

• getModel()
• BoundedRangeModel

getValue

public int getValue()

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

戻り値:

スライダの現在値

関連� �目:

• setValue(int)
• BoundedRangeModel.getValue()

setValue

@BeanProperty(bound=false, preferred=true, description="The sliders current value.") 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

@BeanProperty(preferred=true, description="The sliders minimum value.") public void setMinimum(int minimum)

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

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

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

パラメータ:

minimum - 新しい最小値

関連� �目:

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

getMaximum

public int getMaximum()

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

戻り値:

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

関連� �目:

• setMaximum(int)
• BoundedRangeModel.getMaximum()

setMaximum

@BeanProperty(preferred=true, description="The sliders maximum value.") public void setMaximum(int maximum)

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

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

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

パラメータ:

maximum - 新しい最大値

関連� �目:

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

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

戻り値:

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

関連� �目:

• setValueIsAdjusting(boolean)

setValueIsAdjusting

@BeanProperty(bound=false, expert=true, description="True if the slider knob is being dragged.") public void setValueIsAdjusting(boolean b)

モデルのvalueIsAdjustingプロパティを設定します。 スライダのルック・アンド・フィールの実装は、ノブのドラッグが開始されるとこのプロパティをtrueに設定し、ドラッグが終了するとfalseに設定します。

パラメータ:

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

関連� �目:

• getValueIsAdjusting()
• BoundedRangeModel.setValueIsAdjusting(boolean)

getExtent

public int getExtent()

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

戻り値:

エクステントを表すint値

関連� �目:

• setExtent(int)
• BoundedRangeModel.getExtent()

setExtent

@BeanProperty(bound=false, expert=true, description="Size of the range covered by the knob.") public void setExtent(int extent)

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

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

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

パラメータ:

extent - 新しいエクステント

関連� �目:

• getExtent()
• BoundedRangeModel.setExtent(int)

getOrientation

public int getOrientation()

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

戻り値:

SwingConstants.VERTICALまたはSwingConstants.HORIZONTAL

関連� �目:

• setOrientation(int)

setOrientation

@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JSlider.VERTICAL","JSlider.HORIZONTAL"}, description="Set the scrollbars orientation to either VERTICAL or HORIZONTAL.") public void setOrientation(int orientation)

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

パラメータ:

orientation - HORIZONTALまたはVERTICAL

スロー:

IllegalArgumentException - 方向がVERTICAL、HORIZONTALのいずれでもない� �合

関連� �目:

• getOrientation()

setFont

public void setFont(Font font)

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

オーバーライド:

setFont、クラスJComponent

パラメータ:

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

導入されたバージョン:

1.6

関連� �目:

• Component.getFont()

imageUpdate

public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)

イメージが変更されたときにコンポーネントをふたたびペイントします。 ImageObserverのこのimageUpdateメソッドが呼び出されるのは、GraphicsのdrawImageメソッドなどの非同期ルーチンを使って、以前に要求されていたイメージについての詳細情� �が利用可能になったときです。 このメソッドとその引数についての詳細は、imageUpdateの定義を参照してく� さい。

ComponentのimageUpdateメソッドは、利用できるイメージのビットが多くなるにつれて、インクリメンタルにコンポーネント・イメージを描画します。

システ� ・プロパティawt.image.incrementaldrawがないか、trueの値を持つ� �合、イメージはインクリメンタルに描画されます。 システ� ・プロパティの値がほかの値である� �合は、イメージは全体がロードされてから描画されます。

また、インクリメンタルな描画が有効である� �合、システ� ・プロパティawt.image.redrawrateの値は、ミリ秒単位で最大の再描画レートを与える整数値として解釈されます。 システ� ・プロパティがないか、または整数値として解釈できない� �合、再描画レートは100ミリ秒ごとに1回になります。

x、y、width、およびheight引数の解釈は、infoflags引数の値によって異なります。

定義:

imageUpdate、インタフェースImageObserver

オーバーライド:

imageUpdate、クラスComponent

パラメータ:

img - 監視対象のイメージ

infoflags - 詳細は、imageUpdateを参照してく� さい

x - x座標

y - y座標

w - 幅

h - 高さ

戻り値:

イメージ全体がロードされることをinfoflagsが示す� �合はfalse、そうでない� �合はtrue。

導入されたバージョン:

1.7

関連� �目:

• ImageObserver
• Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver)
• Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver)
• Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver)
• Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver)
• ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

getLabelTable

public Dictionary getLabelTable()

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

戻り値:

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

setLabelTable

@BeanProperty(hidden=true, visualUpdate=true, description="Specifies what labels will be drawn for any given value.") 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は、現在のルック・アンド・フィールで更新されます。 ラベルは、その推奨サイズに設定されます。

関連� �目:

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

createStandardLabels

public Hashtable<Integer, JComponent> 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<Integer, JComponent> 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

@BeanProperty(visualUpdate=true, description="If true reverses the slider values from their normal order") 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の値の横に大目盛りが付けられます。

戻り値:

大目盛り間の値数

関連� �目:

• setMajorTickSpacing(int)

setMajorTickSpacing

@BeanProperty(visualUpdate=true, description="Sets the number of values between major tick marks.") public void setMajorTickSpacing(int n)

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

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

このメソッドは、自動的にラベル・テーブルの設定も行います。 ま� ラベル・テーブルが存在しない� �合で、大目盛りの間隔が> 0、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の値の横に大目盛りが付けられます。

戻り値:

小目盛り間の値数

関連� �目:

• getMinorTickSpacing()

setMinorTickSpacing

@BeanProperty(visualUpdate=true, description="Sets the number of values between minor tick marks.") public void setMinorTickSpacing(int n)

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

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

パラメータ:

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

関連� �目:

• getMinorTickSpacing()
• setPaintTicks(boolean)

getSnapToTicks

public boolean getSnapToTicks()

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

戻り値:

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

関連� �目:

• setSnapToTicks(boolean)

setSnapToTicks

@BeanProperty(description="If true snap the knob to the nearest tick mark.") public void setSnapToTicks(boolean b)

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

パラメータ:

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

関連� �目:

• getSnapToTicks()

getPaintTicks

public boolean getPaintTicks()

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

戻り値:

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

関連� �目:

• setPaintTicks(boolean)

setPaintTicks

@BeanProperty(visualUpdate=true, description="If true tick marks are painted on the slider.") public void setPaintTicks(boolean b)

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

パラメータ:

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

関連� �目:

• getPaintTicks()

getPaintTrack

public boolean getPaintTrack()

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

戻り値:

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

関連� �目:

• setPaintTrack(boolean)

setPaintTrack

@BeanProperty(visualUpdate=true, description="If true, the track is painted on the slider.") public void setPaintTrack(boolean b)

トラックがスライダでペイントされるかどうかを指定します。 デフォルトでは、このプロパティはtrueに設定されます。 このプロパティが受け付けられるかどうかはルック・アンド・フィールし� いであり、無視されることもあります。

パラメータ:

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

関連� �目:

• getPaintTrack()

getPaintLabels

public boolean getPaintLabels()

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

戻り値:

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

関連� �目:

• setPaintLabels(boolean)

setPaintLabels

@BeanProperty(visualUpdate=true, description="If true labels are painted on the slider.") public void setPaintLabels(boolean b)

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

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

デフォルトでは、このプロパティはfalseに設定されます。

パラメータ:

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

関連� �目:

• getPaintLabels()
• getLabelTable()
• createStandardLabels(int)

paramString

protected String paramString()

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

オーバーライド:

paramString、クラスJComponent

戻り値:

このJSliderの文字列表現。

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

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