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

一个让用户以图形方式在有界区间内通过移动滑块来选择值的组件。

滑块可以显示主刻度标记以及主刻度之间的次刻度标记。刻度标记之间的值的个数由 setMajorTickSpacingsetMinorTickSpacing 来控制。刻度标记的绘制由 setPaintTicks 控制。

滑块也可以在固定时间间隔(或在任意位置)沿滑块刻度打印文本标签。标签的绘制由 setLabelTablesetPaintLabels 控制。

有关更多信息和示例,请参阅 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  classJSlider.AccessibleJSlider
          此类实现 JSlider 类的可访问性支持。
 
从类 javax.swing.JComponent 继承的嵌套类/接口
JComponent.AccessibleJComponent
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
protected  ChangeEventchangeEvent
          一个滑块实例仅需要一个 ChangeEvent,因为该事件唯一(只读)的状态是源属性。
protected  ChangeListenerchangeListener
          changeListener(无前缀)是添加到滑块模型的侦听器。
protected  intmajorTickSpacing
          主刻度标记(分解次刻度标记的较大标记)之间的值的个数。
protected  intminorTickSpacing
          次刻度标记(出现在主刻度标记之间的较小标记)之间的值的个数。
protected  intorientation
          滑块方向是水平还是垂直的。
protected  BoundedRangeModelsliderModel
          处理滑块的数字最大值、最小值和当前位置值的数据模型。
protected  booleansnapToTicks
          如果为 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)
          使用指定的方向创建一个滑块,范围在 0100 之间并且初始值为 50
JSlider(int min, int max)
          使用指定的最小值和最大值创建一个水平滑块,初始值等于最小值加上最大值的平均值。
JSlider(int min, int max, int value)
          用指定的最小值、最大值和初始值创建一个水平滑块。
JSlider(int orientation, int min, int max, int value)
          用指定的方向和指定的最小值、最大值以及初始值创建一个滑块。
 
方法摘要
 voidaddChangeListener(ChangeListener l)
          将一个 ChangeListener 添加到滑块。
protected  ChangeListenercreateChangeListener()
          想要以不同方式处理模型的 ChangeEvent 的子类可以重写此方法,以返回自定义 ChangeListener 实现的实例。
 HashtablecreateStandardLabels(int increment)
          创建一个数字文本标签的 Hashtable,从滑块最小值处开始并使用指定的增量。
 HashtablecreateStandardLabels(int increment, int start)
          创建一个数字文本标签的 Hashtable,从指定起始点处开始并使用指定的增量。
protected  voidfireStateChanged()
          将一个其源为此 JSliderChangeEvent 发送到所有需要 ChangeEvent 的已注册 ChangeListener
 AccessibleContextgetAccessibleContext()
          获取与此 JSlider 关联的 AccessibleContext。
 ChangeListener[]getChangeListeners()
          返回一个通过 addChangeListener() 方法添加此 JSlider 的所有 ChangeListener 的数组。
 intgetExtent()
          从 BoundedRangeModel 返回“范围”。
 booleangetInverted()
          如果滑块显示的值范围反转,则返回 true。
 DictionarygetLabelTable()
          返回哪些标签在哪些值处绘制的字典。
 intgetMajorTickSpacing()
          此方法返回主刻度标记的间隔。
 intgetMaximum()
          从 BoundedRangeModel 返回滑块所支持的最大值。
 intgetMinimum()
          从 BoundedRangeModel 返回滑块所支持的最小值。
 intgetMinorTickSpacing()
          此方法返回次刻度标记的间隔。
 BoundedRangeModelgetModel()
          返回处理滑块三个基本属性(minimum、maximum、value)的 BoundedRangeModel
 intgetOrientation()
          返回此滑块的垂直或者水平方向。
 booleangetPaintLabels()
          告知是否绘制标签。
 booleangetPaintTicks()
          告知是否绘制刻度标记。
 booleangetPaintTrack()
          告知是否绘制滑道(滑块滑动的区域)。
 booleangetSnapToTicks()
          如果滑块(及其所表示的值)解析为最靠近用户放置滑块处的刻度标记的值,则返回为 true。
 SliderUIgetUI()
          获取实现此组件 L&F 的 UI 对象。
 StringgetUIClassID()
          返回呈现此组件的 L&F 的类名。
 intgetValue()
          从 BoundedRangeModel 返回滑块的当前值。
 booleangetValueIsAdjusting()
          从模型返回 valueIsAdjusting 属性。
protected  StringparamString()
          返回此 JSlider 的字符串表示形式。
 voidremoveChangeListener(ChangeListener l)
          从滑块中移除一个 ChangeListener。
 voidsetExtent(int extent)
          设置滑块所“覆盖”的范围的大小。
 voidsetFont(Font font)
          设置此组件的字体。
 voidsetInverted(boolean b)
          指定为 true,则反转滑块显示的值范围,指定为 false 则将值范围置为正常顺序。
 voidsetLabelTable(Dictionary labels)
          用于指定将在给定值处绘制哪个标签。
 voidsetMajorTickSpacing(int n)
          此方法设置主刻度标记的间隔。
 voidsetMaximum(int maximum)
          将滑块的最大值设置为 maximum
 voidsetMinimum(int minimum)
          将滑块的最小值设置为 minimum
 voidsetMinorTickSpacing(int n)
          此方法设置次刻度标记的间隔。
 voidsetModel(BoundedRangeModel newModel)
          设置处理滑块三个基本属性(minimum、maximum、value)的 BoundedRangeModel
 voidsetOrientation(int orientation)
          将滑块的方向设置为 SwingConstants.VERTICALSwingConstants.HORIZONTAL
 voidsetPaintLabels(boolean b)
          确定是否在滑块上绘制标签。
 voidsetPaintTicks(boolean b)
          确定是否在滑块上绘制刻度标记。
 voidsetPaintTrack(boolean b)
          确定是否在滑块上绘制滑道。
 voidsetSnapToTicks(boolean b)
          指定为 true,则滑块(及其所表示的值)解析为最靠近用户放置滑块处的刻度标记的值。
 voidsetUI(SliderUI ui)
          设置实现此组件 L&F 的 UI 对象。
 voidsetValue(int n)
          将滑块的当前值设置为 n
 voidsetValueIsAdjusting(boolean b)
          设置模型的 valueIsAdjusting 属性。
protected  voidupdateLabelUIs()
          通过在每个标签上调用 updateUI 更新标签表中标签的 UI。
 voidupdateUI()
          根据当前外观将 UI 属性重设为某个值。
 
从类 javax.swing.JComponent 继承的方法
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, 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(无前缀)是添加到滑块模型的侦听器。此侦听器被初始化为从 createChangeListener 返回的 ChangeListener,默认情况下,ChangeListener 仅将事件转发给直接添加到该滑块的 ChangeListener(如果有)。

另请参见:
addChangeListener(javax.swing.event.ChangeListener), createChangeListener()