|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JSlider
public class JSlider
一个让用户以图形方式在有界区间内通过移动滑块来选择值的组件。滑块可以显示主刻度标记和次刻度标记。刻度标记中间的值的个数由 setMajorTickSpacing
和 setMinorTickSpacing
来控制。
有关详细信息和示例,请参阅《The Java Tutorial》中的 How to Use Sliders 一节。
警告:此类的序列化对象与以后的 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.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
protected ChangeEvent |
changeEvent
一个滑块实例仅需要一个 ChangeEvent ,因为该事件惟一(只读)的状态是源属性。 |
protected ChangeListener |
changeListener
changeListener(无前缀)是我们添加到 Slider 模型的侦听器。 |
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()
需要分别处理模型 ChangeEvents 的子类可能重写此方法,以返回其自己的 ChangeListener 实现。 |
Hashtable |
createStandardLabels(int increment)
创建一个将从滑块最小值处开始并以指定增量绘制文本标签的哈希表。 |
Hashtable |
createStandardLabels(int increment,
int start)
创建一个将从起点处开始并以指定增量绘制文本标签的哈希表。 |
protected void |
fireStateChanged()
发送一个其源为此 Slider 的 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()
返回处理滑块三个基本属性(minimum、maximum、value)的数据模型。 |
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)
设置处理滑块三个基本属性(minimum、maximum、value)的模型。 |
void |
setOrientation(int orientation)
将滚动条的方向设置为 VERTICAL 或者 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)
设置滑块的当前值。 |
void |
setValueIsAdjusting(boolean b)
设置模型的 valueIsAdjusting 属性。 |
protected void |
updateLabelUIs()
根据当前外观将 UI 属性重设为某个值。 |
void |
updateUI()
从当前外观将 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
,因为该事件惟一(只读)的状态是源属性。这里生成的事件源总是 "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
- 如果滑块标签起点超出范围或者标签增量小于或等于 0。setLabelTable(java.util.Dictionary)
public boolean getInverted()
setInverted(boolean)
public void setInverted(boolean b)
ComponentOrientation
属性。ComponentOrientation
值为 LEFT_TO_RIGHT
的正常(非反转)水平滑块最大值位于右边。ComponentOrientation
值为 RIGHT_TO_LEFT
的正常水平滑块最大值位于左边。正常的垂直滑块其最大值位于顶部。当滑块颠倒时,这些标签也反转。
b
- 为 true 时从滑块正常顺序反转滑块值public 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
- 为 true 则对齐滑块到最近的刻度标记getSnapToTicks()
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 Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。