java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JSlider
public class JSlider
一个让用户以图形方式在有界区间内通过移动滑块来选择值的组件。
滑块可以显示主刻度标记以及主刻度之间的次刻度标记。刻度标记之间的值的个数由 setMajorTickSpacing
和 setMinorTickSpacing
来控制。刻度标记的绘制由 setPaintTicks
控制。
滑块也可以在固定时间间隔(或在任意位置)沿滑块刻度打印文本标签。标签的绘制由 setLabelTable
和 setPaintLabels
控制。
有关更多信息和示例,请参阅 The Java Tutorial 中的 How to Use Sliders 一节。
警告:Swing 不是线程安全的。有关更多信息,请参阅 Swing's Threading Policy。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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 ,因为该事件唯一(只读)的状态是源属性。 |
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() 返回处理滑块三个基本属性(minimum、maximum、value)的 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) 设置处理滑块三个基本属性(minimum、maximum、value)的 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 属性重设为某个值。 |