Java javax.swing 类 JSlider（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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
   
   
   
   

一个让用户以图形方式在有界区间内通过移动滑块来选择值的组件。滑块可以显示主刻度标记和次刻度标记。刻度标记中间的值的个数由 setMajorTickSpacing 和 setMinorTickSpacing 来控制。

有关详细信息和示例，请参阅《The Java Tutorial》中的 How to Use Sliders 一节。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 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 属性重设为某个值。

 

从类 javax.swing.JComponent 继承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, 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, setFont, 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（无前缀）是我们添加到 Slider 模型的侦听器。默认情况下，此侦听器仅把事件转发给直接添加到滑块的多个 ChangeListener（如果有）。

另请参见：

addChangeListener(javax.swing.event.ChangeListener), createChangeListener()

---

changeEvent

protected transient ChangeEvent changeEvent

一个滑块实例仅需要一个 ChangeEvent，因为该事件惟一（只读）的状态是源属性。这里生成的事件源总是 "this"。该事件是在第一次激发某个事件通知时以延迟方式创建的。

另请参见：

fireStateChanged()

构造方法详细信息

JSlider

public JSlider()

创建一个范围在 0 到 100 之间并且初始值为 50 的水平滑块。