|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JSlider
ユーザが指定された区間内でノブをスライドすることによりグラフィカルに値を選択できるようにするコンポーネントです。スライダは、大目盛りと、その間の小目盛りの両方を表示できます。目盛り間の値数は setMajorTickSpacing
と setMinorTickSpacing
で決めることができます。
詳細と例については、「The Java Tutorial」の「How to Use Sliders」を参照してください。標準の Look & Feel (L&F) 表現でこのコンポーネントが使うキーボードのキーについては、「JSlider
のキー割り当て」を参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeansTM の長期間の運用サポートは、java.beans
パッケージに追加されています。詳細は、XMLEncoder
を参照してください。
入れ子クラスの概要 | |
protected class |
JSlider.AccessibleJSlider
このクラスは JSlider クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.JComponent から継承した入れ子クラス |
|
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
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 |
createStandardLabels(int increment,
int start)
指定された始点から開始して、指定された増分値を使ってテキストのラベルを描画するハッシュテーブルを作成します。 |
protected void |
fireStateChanged()
ソースがこのスライダである ChangeEvent を各リスナーに送ります。 |
AccessibleContext |
getAccessibleContext()
この JSlider に関連した AccessibleContext を返します。 |
ChangeListener[] |
getChangeListeners()
addChangeListener() を使用して、この JSlider に追加されたすべての ChangeListener の配列を返します。 |
int |
getExtent()
ノブによって「カバー」される値の範囲を返します。 |
boolean |
getInverted()
スライダーに表示される値の範囲が通常とは逆になる場合は true を返します。 |
Dictionary |
getLabelTable()
どのラベルをどの値に描画するかを決めるのに使うディクショナリを返します。 |
int |
getMajorTickSpacing()
大目盛りの間隔を返します。 |
int |
getMaximum()
スライダによってサポートされている最大値を返します。 |
int |
getMinimum()
スライダによってサポートされている最小値を返します。 |
int |
getMinorTickSpacing()
小目盛りの間隔を返します。 |
BoundedRangeModel |
getModel()
スライダの 3 つの基本プロパティである、最小値、最大値、および初期値を処理するデータモデルを返します。 |
int |
getOrientation()
このスライダの垂直または水平の方向を返します。 |
boolean |
getPaintLabels()
ラベルがペイントされるかどうかを示します。 |
boolean |
getPaintTicks()
目盛りがペイントされるかどうかを示します。 |
boolean |
getPaintTrack()
トラック (スライダがスライドする領域) がペイントされるかどうかを示します。 |
boolean |
getSnapToTicks()
ノブ (およびノブが表すデータ値) が、ユーザがノブを置いた位置にもっとも近い目盛りに置かれる場合に、true を返します。 |
SliderUI |
getUI()
コンポーネントの L&F を実装する UI オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。 |
int |
getValue()
スライダの値を返します。 |
boolean |
getValueIsAdjusting()
スライダのノブがドラッグされている場合に true を返します。 |
protected String |
paramString()
この JSlider の文字列表現を返します。 |
void |
removeChangeListener(ChangeListener l)
スライダから ChangeListener を削除します。 |
void |
setExtent(int extent)
ノブによって「カバー」される範囲のサイズを設定します。 |
void |
setInverted(boolean b)
スライダーに表示する値の範囲を通常とは逆にする場合は true を指定し、通常の順序にするには false を指定します。 |
void |
setLabelTable(Dictionary labels)
任意の指定された値にどのラベルが描画されるかを指定するときに使います。 |
void |
setMajorTickSpacing(int n)
大目盛りの間隔を設定します。 |
void |
setMaximum(int maximum)
モデルの最大値プロパティを設定します。 |
void |
setMinimum(int minimum)
モデルの最小値プロパティを設定します。 |
void |
setMinorTickSpacing(int n)
小目盛りの間隔を設定します。 |
void |
setModel(BoundedRangeModel newModel)
スライダの 3 つの基本プロパティである、最小値、最大値、および初期値を処理するデータモデルを設定します。 |
void |
setOrientation(int orientation)
スクロールバーの方向を垂直または水平のどちらかに設定します。 |
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)
スライダの現在値を設定します。 |
void |
setValueIsAdjusting(boolean b)
モデルの valueIsAdjusting プロパティを設定します。 |
protected void |
updateLabelUIs()
現在の Look & Feel からの値に UI プロパティをリセットします。 |
void |
updateUI()
現在の Look & Feel からの値を持つ UI プロパティをリセットします。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
protected BoundedRangeModel sliderModel
protected int majorTickSpacing
protected int minorTickSpacing
setMinorTickSpacing(int)
protected boolean snapToTicks
setSnapToTicks(boolean)
protected int orientation
setOrientation(int)
protected ChangeListener changeListener
addChangeListener(javax.swing.event.ChangeListener)
,
createChangeListener()
protected transient ChangeEvent changeEvent
ChangeEvent
の唯一の状態 (読み取り専用) はソースプロパティなので、スライダのインスタンスに必要なこのイベントは 1 つだけです。生成されるイベントのソースは、常に this です。初めてイベント通知がトリガされたときに、イベントは遅れて作成されます。
fireStateChanged()
コンストラクタの詳細 |
public JSlider()
public JSlider(int orientation)
public JSlider(int min, int max)
public JSlider(int min, int max, int value)
public JSlider(int orientation, int min, int max, int value)
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合setOrientation(int)
,
setMinimum(int)
,
setMaximum(int)
,
setValue(int)
public JSlider(BoundedRangeModel brm)
メソッドの詳細 |
public SliderUI getUI()
public void setUI(SliderUI ui)
ui
- SliderUI L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
protected ChangeListener createChangeListener()
fireStateChanged()
public void addChangeListener(ChangeListener l)
l
- 追加する ChangeListenerfireStateChanged()
,
removeChangeListener(javax.swing.event.ChangeListener)
public void removeChangeListener(ChangeListener l)
l
- 削除する ChangeListenerfireStateChanged()
,
addChangeListener(javax.swing.event.ChangeListener)
public ChangeListener[] getChangeListeners()
ChangeListener
の配列を返します。
ChangeListener
、またはリスナーが追加されていない場合は空の配列protected void fireStateChanged()
addChangeListener(javax.swing.event.ChangeListener)
,
EventListenerList
public BoundedRangeModel getModel()
setModel(javax.swing.BoundedRangeModel)
public void setModel(BoundedRangeModel newModel)
getModel()
public int getValue()
setValue(int)
public void setValue(int n)
getValue()
public int getMinimum()
setMinimum(int)
public void setMinimum(int minimum)
getMinimum()
,
BoundedRangeModel.setMinimum(int)
public int getMaximum()
setMaximum(int)
public void setMaximum(int maximum)
getMaximum()
,
BoundedRangeModel.setMaximum(int)
public boolean getValueIsAdjusting()
setValueIsAdjusting(boolean)
public void setValueIsAdjusting(boolean b)
getValueIsAdjusting()
,
BoundedRangeModel.setValueIsAdjusting(boolean)
public int getExtent()
setExtent(int)
,
BoundedRangeModel.getExtent()
public void setExtent(int extent)
getExtent()
,
BoundedRangeModel.setExtent(int)
public int getOrientation()
setOrientation(int)
public void setOrientation(int orientation)
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合getOrientation()
public Dictionary getLabelTable()
Dictionary
public void setLabelTable(Dictionary labels)
{ Integer value, java.swing.JComponent label }
という形式です。
createStandardLabels(int)
,
getLabelTable()
protected void updateLabelUIs()
JComponent.updateUI()
public Hashtable createStandardLabels(int increment)
createStandardLabels( 10 )
を呼び出し、スライダの最小値が 0 の場合は、0、10、20、30 などの値のラベルが作成されます。
setLabelTable(java.util.Dictionary)
public Hashtable createStandardLabels(int increment, int start)
createStandardLabels( 10, 2 )
を呼び出した場合は、2、12、22、32 などの値のラベルが作成されます。
IllegalArgumentException
- スライダーの始点が範囲外またはラベルの増分値がゼロ以下の場合setLabelTable(java.util.Dictionary)
public boolean getInverted()
setInverted(boolean)
public void setInverted(boolean b)
ComponentOrientation
プロパティにより異なります。LEFT_TO_RIGHT
の ComponentOrientation
値を持った逆変換されていない通常の水平スライダーの最大値は右側にあります。RIGHT_TO_LEFT
の ComponentOrientation
値を持った通常の水平スライダーの最大値は左側にあります。通常の垂直スライダーの最大値は一番上にあります。このラベルはスライダーが変換されると順序が逆になります。
b
- スライダの値を通常の順序と逆にする場合は truepublic int getMajorTickSpacing()
setMajorTickSpacing(int)
public void setMajorTickSpacing(int n)
getMajorTickSpacing()
public int getMinorTickSpacing()
getMinorTickSpacing()
public void setMinorTickSpacing(int n)
getMinorTickSpacing()
public boolean getSnapToTicks()
setSnapToTicks(boolean)
public void setSnapToTicks(boolean b)
b
- ノブがもっとも近い目盛りに留まる場合は truegetSnapToTicks()
public boolean getPaintTicks()
setPaintTicks(boolean)
public void setPaintTicks(boolean b)
getPaintTicks()
public boolean getPaintTrack()
setPaintTrack(boolean)
public void setPaintTrack(boolean b)
getPaintTrack()
public boolean getPaintLabels()
setPaintLabels(boolean)
public void setPaintLabels(boolean b)
getPaintLabels()
protected String paramString()
null
にはなりません。
JComponent
内の paramString
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.