JSlider (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
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

嵌套类摘要
`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 的水平滑块。

JSlider

public JSlider(int orientation)

创建一个范围在 0 到 100 之间并且初始值为 50 的指定方向的滑块。

JSlider

public JSlider(int min,
               int max)

用指定的最小值和最大值创建一个水平滑块，初始值等于最小值加上最大值的平均值。

JSlider

public JSlider(int min,
               int max,
               int value)

用指定的最小值、最大值和值创建一个水平滑块。

JSlider

public JSlider(int orientation,
               int min,
               int max,
               int value)

用指定的方向和指定的最小值、最大值以及初始值创建一个滑块。

抛出：: IllegalArgumentException - 如果方向不是 VERTICAL、HORIZONTAL 其中之一。
另请参见：: setOrientation(int), setMinimum(int), setMaximum(int), setValue(int)

JSlider

public JSlider(BoundedRangeModel brm)

使用指定的 BoundedRangeModel 创建一个水平滑块。

方法详细信息

getUI

public SliderUI getUI()

获取实现此组件 L&F 的 UI 对象。

返回：: 实现此 Slider L&F 的 SliderUI 对象

setUI

public void setUI(SliderUI ui)

设置实现此组件 L&F 的 UI 对象。

参数：: ui - SliderUI L&F 对象
另请参见：: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

从当前外观将 UI 属性重设为某个值。

覆盖：: 类 JComponent 中的 updateUI

另请参见：: JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回呈现此组件的 L&F 的类名。

覆盖：: 类 JComponent 中的 getUIClassID

返回：: 字符串 "SeparatorUI"
另请参见：: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener createChangeListener()

需要分别处理模型 ChangeEvents 的子类可能重写此方法，以返回其自己的 ChangeListener 实现。默认的 ChangeListener 仅将 ChangeEvents 转发给直接添加到滑块的 ChangeListeners。

另请参见：: fireStateChanged()

addChangeListener

public void addChangeListener(ChangeListener l)

将一个 ChangeListener 添加到滑块。

参数：: l - 要添加的 ChangeListener
另请参见：: fireStateChanged(), removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

从滑块中移除一个 ChangeListener。

参数：: l - 要移除的 ChangeListener
另请参见：: fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

返回一个通过 addChangeListener() 方法添加此 JSlider 的所有 ChangeListener 的数组。

返回：: 所有被添加的 ChangeListener；如果没有添加任何侦听器，则返回空数组。
从以下版本开始：: 1.4

fireStateChanged

protected void fireStateChanged()

发送一个其源为此 Slider 的 ChangeEvent 到每个侦听器。每次从模型中接收 ChangeEvent 时都要调用此方法。

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

getModel

public BoundedRangeModel getModel()

返回处理滑块三个基本属性（minimum、maximum、value）的数据模型。

另请参见：: setModel(javax.swing.BoundedRangeModel)

setModel

public void setModel(BoundedRangeModel newModel)

设置处理滑块三个基本属性（minimum、maximum、value）的模型。

另请参见：: getModel()

getValue

public int getValue()

返回滑块的值。

返回：: 模型值属性
另请参见：: setValue(int)

setValue

public void setValue(int n)

设置滑块的当前值。此方法仅把值转发给模型。

另请参见：: getValue()

getMinimum

public int getMinimum()

返回此滑块所支持的最小值。

返回：: 模型最小值属性的值
另请参见：: setMinimum(int)

setMinimum

public void setMinimum(int minimum)

设置模型最小值属性。

另请参见：: getMinimum(), BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

返回滑块所支持的最大值。

返回：: 模型最大值属性的值
另请参见：: setMaximum(int)

setMaximum

public void setMaximum(int maximum)

设置模型的最大值属性。

另请参见：: getMaximum(), BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

如果正在拖动滑块柄，则返回 true。

返回：: 模型 valueIsAdjusting 属性的值
另请参见：: setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

设置模型的 valueIsAdjusting 属性。滑块的外观实现应该在开始拖动时将此属性设置为 true，并在拖动结束时设为 false。当 valueIsAdjusting 为 true 时，滑块模型不会产生 ChangeEvent。

另请参见：: getValueIsAdjusting(), BoundedRangeModel.setValueIsAdjusting(boolean)

getExtent

public int getExtent()

返回“范围” -- 滑块所“覆盖”的值的范围。

返回：: 表示范围的一个整数
另请参见：: setExtent(int), BoundedRangeModel.getExtent()

setExtent

public void setExtent(int extent)

设置滑块所“覆盖”的范围的大小。如果用户单击滑块的任何一侧，大多数的外观实现将根据此数量而更改值。

另请参见：: getExtent(), BoundedRangeModel.setExtent(int)

getOrientation

public int getOrientation()

返回此滑块的垂直或者水平方向。

返回：: VERTICAL 或 HORIZONTAL
另请参见：: setOrientation(int)

setOrientation

public void setOrientation(int orientation)

将滚动条的方向设置为 VERTICAL 或者 HORIZONTAL。

抛出：: IllegalArgumentException - 如果方向不是 VERTICAL、HORIZONTAL 其中之一
另请参见：: getOrientation()

getLabelTable

public Dictionary getLabelTable()

返回哪些标签在哪些值处绘制的字典。

返回：: 包含标签及其绘制位置的 Dictionary。

setLabelTable

public void setLabelTable(Dictionary labels)

用于指定将在给定值处绘制哪个标签。键-值对有如下格式：{ Integer value, java.swing.JComponent label }。

另请参见：: createStandardLabels(int), getLabelTable()

updateLabelUIs

protected void updateLabelUIs()

根据当前外观将 UI 属性重设为某个值。

另请参见：: JComponent.updateUI()

createStandardLabels

public Hashtable createStandardLabels(int increment)

创建一个将从滑块最小值处开始并以指定增量绘制文本标签的哈希表。如果调用 createStandardLabels( 10 ) 并且滑块的最小值为 0，则它将把标签设置为 0、10、20、30，依此类推。

另请参见：: setLabelTable(java.util.Dictionary)

createStandardLabels

public Hashtable createStandardLabels(int increment,
                                      int start)

创建一个将从起点处开始并以指定增量绘制文本标签的哈希表。如果调用 createStandardLabels( 10, 2 ), 则它将把标签设置为 2、12、22、32，依此类推。

抛出：: IllegalArgumentException - 如果滑块标签起点超出范围或者标签增量小于或等于 0。
另请参见：: setLabelTable(java.util.Dictionary)

getInverted

public boolean getInverted()

如果滑块显示的值范围反转，则返回 true。

返回：: 如果滑块值相对其正常顺序是反转的，则返回 true
另请参见：: setInverted(boolean)

setInverted

public void setInverted(boolean b)

指定为 true，则反转滑块显示的值范围，指定为 false 则将值范围置为正常顺序。此顺序取决于滑块的 ComponentOrientation 属性。ComponentOrientation 值为 LEFT_TO_RIGHT 的正常（非反转）水平滑块最大值位于右边。ComponentOrientation 值为 RIGHT_TO_LEFT 的正常水平滑块最大值位于左边。正常的垂直滑块其最大值位于顶部。当滑块颠倒时，这些标签也反转。

参数：: b - 为 true 时从滑块正常顺序反转滑块值

getMajorTickSpacing

public int getMajorTickSpacing()

此方法返回主刻度标记的间隔。返回的数字表示在每个主刻度标记之间以值衡量的距离。如果您有一个范围从 0 到 50 的滑块并且主刻度标记间隔为 10，则您会发现主刻度标记在如下值旁边：0、10、20、30、40、50。

返回：: 主刻度标记之间的值的个数
另请参见：: setMajorTickSpacing(int)

setMajorTickSpacing

public void setMajorTickSpacing(int n)

此方法设置主刻度标记的间隔。传入的数字表示在每个主刻度标记之间以值衡量的距离。如果您有一个范围从 0 到 50 的滑块并且主刻度标记间隔为 10，则您会发现主刻度标记在如下值旁边：0、10、20、30、40、50。

另请参见：: getMajorTickSpacing()

getMinorTickSpacing

public int getMinorTickSpacing()

此方法返回次刻度标记的间隔。返回的数字表示在每个次刻度标记之间以值衡量的距离。如果您有一个范围从 0 到 50 的滑块并且次刻度标记间隔为 10，则您会发现次刻度标记在如下值旁边：0、10、20、30、40、50。

返回：: 次刻度标记之间的值的个数
另请参见：: getMinorTickSpacing()

setMinorTickSpacing

public void setMinorTickSpacing(int n)

此方法设置次刻度标记的间隔。传入的数字表示在每个次刻度标记之间以值衡量的距离。如果您有一个范围从 0 到 50 的滑块并且次刻度标记间隔为 10，则您会发现次刻度标记在如下值旁边：0、10、20、30、40、50。

另请参见：: getMinorTickSpacing()

getSnapToTicks

public boolean getSnapToTicks()

如果滑块（及其所表示的值）解析为最靠近用户放置滑块处的刻度标记的值，则返回为 true。

返回：: 如果值对齐最近的刻度标记，则返回 true；否则返回 false。
另请参见：: setSnapToTicks(boolean)

setSnapToTicks

public void setSnapToTicks(boolean b)

指定为 true，则滑块（及其所表示的值）解析为最靠近用户放置滑块处的刻度标记的值。

参数：: b - 为 true 则对齐滑块到最近的刻度标记
另请参见：: getSnapToTicks()

getPaintTicks

public boolean getPaintTicks()

通知是否绘制刻度标记。

返回：: 如果绘制刻度标记，则返回 true；否则返回 false
另请参见：: setPaintTicks(boolean)

setPaintTicks

public void setPaintTicks(boolean b)

确定是否在滑块上绘制刻度标记。

另请参见：: getPaintTicks()

getPaintTrack

public boolean getPaintTrack()

通知是否绘制滑道（滑块滑动的区域）。

返回：: 如果绘制滑道，则返回 true；否则返回 false
另请参见：: setPaintTrack(boolean)

setPaintTrack

public void setPaintTrack(boolean b)

确定是否在滑块上绘制滑道。

另请参见：: getPaintTrack()

getPaintLabels

public boolean getPaintLabels()

通知是否绘制标签。

返回：: 如果绘制标签，则返回 true；否则返回 false
另请参见：: setPaintLabels(boolean)

setPaintLabels

public void setPaintLabels(boolean b)

确定是否在滑块上绘制标签。

另请参见：: getPaintLabels()

paramString

protected String paramString()

返回表示此 JSlider 的一个字符串。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回字符串可能为空，但不可能为 null。

覆盖：: 类 JComponent 中的 paramString

返回：: 此 JSlider 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 JSlider 关联的 AccessibleContext。对于滑块，AccessibleContext 采取 AccessibleJSlider 的形式。必要时要创建新的 AccessibleJSlider 实例。

指定者：: 接口 Accessible 中的 getAccessibleContext
覆盖：: 类 JComponent 中的 getAccessibleContext

返回：: 充当此 JSlider 的 AccessibleContext 的 AccessibleJSlider

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

JSlider (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

javax.swing 类 JSlider

sliderModel

majorTickSpacing

minorTickSpacing

snapToTicks

orientation

changeListener

changeEvent

JSlider

JSlider

JSlider

JSlider

JSlider

JSlider

getUI

setUI

updateUI

getUIClassID

createChangeListener

addChangeListener

removeChangeListener

getChangeListeners

fireStateChanged

getModel

setModel

getValue

setValue

getMinimum

setMinimum

getMaximum

setMaximum

getValueIsAdjusting

setValueIsAdjusting

getExtent

setExtent

getOrientation

setOrientation

getLabelTable

setLabelTable

updateLabelUIs

createStandardLabels

createStandardLabels

getInverted

setInverted

getMajorTickSpacing

setMajorTickSpacing

getMinorTickSpacing

setMinorTickSpacing

getSnapToTicks

setSnapToTicks

getPaintTicks

setPaintTicks

getPaintTrack

setPaintTrack

getPaintLabels

setPaintLabels

paramString

getAccessibleContext

javax.swing
类 JSlider