- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JSlider
-
- All Implemented Interfaces:
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
,SwingConstants
@JavaBean(defaultProperty="UI", description="A component that supports selecting a integer value from a range.") public class JSlider extends JComponent implements SwingConstants, Accessible
允许用户通过在有界间隔内滑动旋钮图形地选择值的组件。 旋钮始终位于与指定间隔内的整数值相匹配的点上。滑块可以显示主要的刻度线,以及主要刻度线之间的小刻度线。 刻度线之间的数值由
setMajorTickSpacing
和setMinorTickSpacing
控制。 刻度线的绘画由setPaintTicks
控制。滑块还可以沿滑块轨迹定期(或任意位置)打印文本标签。 标签绘画由
setLabelTable
和setPaintLabels
控制。有关更多信息和示例,请参阅“Java教程”中的“ How to Use Sliders ”一节。
警告: Swing不是线程安全的。 有关详细信息,请参阅Swing's Threading Policy 。
警告:此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始,支持所有JavaBeans的长期存储已被添加到
java.beans
包中。 请参阅XMLEncoder
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
JSlider.AccessibleJSlider
该类实现JSlider
类的可访问性支持。-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
-
-
Field Summary
Fields Modifier and Type Field 描述 protected ChangeEvent
changeEvent
由于事件的唯一(只读)状态是源属性,因此每个滑块实例只需要一个ChangeEvent
。protected ChangeListener
changeListener
changeListener(无后缀)是我们添加到滑块模型的侦听器。protected int
majorTickSpacing
主要刻度线之间的值的数量 - 分解小刻度线的较大的标记。protected int
minorTickSpacing
较小刻度线之间的值数 - 主刻度线之间发生的较小的标记。protected int
orientation
滑块是水平还是垂直默认为水平。protected BoundedRangeModel
sliderModel
处理滑块的数字最大值,最小值和当前位置值的数据模型。protected boolean
snapToTicks
如果为真,则旋钮(及其表示的数据值)将解析为用户放置旋钮的最靠近的刻度线。-
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
Fields inherited from interface 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
-
-
构造方法摘要
构造方法 Constructor 描述 JSlider()
创建一个水平滑块,范围为0到100,初始值为50。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)
创建具有指定方向和指定的最小值,最大值和初始值的滑块。JSlider(BoundedRangeModel brm)
使用指定的BoundedRangeModel创建水平滑块。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 void
addChangeListener(ChangeListener l)
向滑块添加一个ChangeListener。protected ChangeListener
createChangeListener()
想要从模型处理ChangeEvent
s的子ChangeEvent
可以覆盖此方法,以返回自定义ChangeListener
实现的实例。Hashtable<Integer,JComponent>
createStandardLabels(int increment)
创建一个Hashtable
的数字文本标签,从滑块最小值开始,并使用指定的增量。Hashtable<Integer,JComponent>
createStandardLabels(int increment, int start)
创建一个Hashtable
的数字文本标签,从指定的起始点开始,并使用指定的增量。protected void
fireStateChanged()
发送ChangeEvent
,其来源是这个JSlider
,所有ChangeListener
s已注册兴趣ChangeEvent
s。AccessibleContext
getAccessibleContext()
获取与此JSlider相关联的AccessibleContext。ChangeListener[]
getChangeListeners()
返回使用addChangeListener()添加到此JSlider的所有ChangeListener
的数组。int
getExtent()
从BoundedRangeModel
返回“extent”。boolean
getInverted()
如果滑块显示的值范围相反,则返回true,Dictionary
getLabelTable()
返回要在哪些值绘制哪些标签的字典。int
getMajorTickSpacing()
此方法返回主要的tick间距。int
getMaximum()
从BoundedRangeModel
返回滑块支持的BoundedRangeModel
。int
getMinimum()
从BoundedRangeModel
返回滑块支持的BoundedRangeModel
。int
getMinorTickSpacing()
此方法返回较小的刻度间距。BoundedRangeModel
getModel()
返回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
属性。boolean
imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
当图像发生变化时重新编辑组件。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)
设置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属性重置为当前外观的值。-
Methods inherited from class 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Methods inherited from class 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, transferFocusDownCycle, validate, validateTree
-
Methods inherited from class 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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
-
-
-
-
字段详细信息
-
sliderModel
protected BoundedRangeModel sliderModel
处理滑块的数字最大值,最小值和当前位置值的数据模型。
-
majorTickSpacing
protected int majorTickSpacing
主要刻度线之间的值的数量 - 分解小刻度线的较大的标记。
-
minorTickSpacing
protected int minorTickSpacing
较小刻度线之间的值数 - 主刻度线之间发生的较小的标记。- 另请参见:
-
setMinorTickSpacing(int)
-
snapToTicks
protected boolean snapToTicks
如果为真,则旋钮(及其表示的数据值)将解析为用户放置旋钮的最靠近的刻度线。 默认值为false。- 另请参见:
-
setSnapToTicks(boolean)
-
orientation
protected int orientation
滑块是水平还是垂直默认为水平。- 另请参见:
-
setOrientation(int)
-
changeListener
protected ChangeListener changeListener
changeListener(无后缀)是我们添加到滑块模型的侦听器。 这个监听器被初始化为从ChangeListener
返回的createChangeListener
,默认情况下只是将事件转发到直接添加到滑块的ChangeListener
(如果有的话)。
-
changeEvent
protected transient ChangeEvent changeEvent
由于事件的唯一(只读)状态是源属性,因此每个滑块实例只需要一个ChangeEvent
。 这里产生的事件的来源总是“这”。 事件首次在事件通知被触发时被懒惰地创建。- 另请参见:
-
fireStateChanged()
-
-
构造方法详细信息
-
JSlider
public JSlider()
创建一个水平滑块,范围为0到100,初始值为50。
-
JSlider
public JSlider(int orientation)
使用范围为0
至100
的指定方向创建滑块,初始值为50
。 方向可以是SwingConstants.VERTICAL
或SwingConstants.HORIZONTAL
。- 参数
-
orientation
- 滑块的方向 - 异常
-
IllegalArgumentException
- 如果方向不是VERTICAL
,HORIZONTAL
- 另请参见:
-
setOrientation(int)
-
JSlider
public JSlider(int min, int max)
使用指定的最小和最大值创建水平滑块,初始值等于最小加最大值的平均值。保存滑块数据的
BoundedRangeModel
可以处理由于在滑块上设置最小值和最大值而导致的任何问题。 有关详细信息,请参阅BoundedRangeModel
文档。- 参数
-
min
- 滑块的最小值 -
max
- 滑块的最大值 - 另请参见:
-
BoundedRangeModel
,setMinimum(int)
,setMaximum(int)
-
JSlider
public JSlider(int min, int max, int value)
使用指定的最小值,最大值和值创建水平滑块。保存滑块数据的
BoundedRangeModel
可以处理由于在滑块上设置最小值,初始值和最大值而导致的任何问题。 有关详细信息,请参阅BoundedRangeModel
文档。- 参数
-
min
- 滑块的最小值 -
max
- 滑块的最大值 -
value
- 滑块的初始值 - 另请参见:
-
BoundedRangeModel
,setMinimum(int)
,setMaximum(int)
,setValue(int)
-
JSlider
public JSlider(int orientation, int min, int max, int value)
创建具有指定方向和指定的最小值,最大值和初始值的滑块。 方向可以是SwingConstants.VERTICAL
或SwingConstants.HORIZONTAL
。保存滑块数据的
BoundedRangeModel
可以处理由于在滑块上设置最小值,初始值和最大值而导致的任何问题。 有关详细信息,请参阅BoundedRangeModel
文档。- 参数
-
orientation
- 滑块的方向 -
min
- 滑块的最小值 -
max
- 滑块的最大值 -
value
- 滑块的初始值 - 异常
-
IllegalArgumentException
- 如果方向不是VERTICAL
,HORIZONTAL
- 另请参见:
-
BoundedRangeModel
,setOrientation(int)
,setMinimum(int)
,setMaximum(int)
,setValue(int)
-
JSlider
public JSlider(BoundedRangeModel brm)
使用指定的BoundedRangeModel创建水平滑块。- 参数
-
brm
- 一个BoundedRangeModel
的滑块
-
-
方法详细信息
-
getUI
public SliderUI getUI()
获取实现此组件的L&F的UI对象。- 重写:
-
getUI
在JComponent
- 结果
- 实现Slider L&F的SliderUI对象
-
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the slider\'s LookAndFeel.") public void setUI(SliderUI ui)
设置实现该组件的L&F的UI对象。- 参数
-
ui
- SliderUI L&F对象 - 另请参见:
-
UIDefaults.getUI(javax.swing.JComponent)
-
updateUI
public void updateUI()
将UI属性重置为当前外观的值。- 重写:
-
updateUI
在JComponent
- 另请参见:
-
JComponent.updateUI()
-
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
返回呈现此组件的L&F类的名称。- 重写:
-
getUIClassID
在JComponent
- 结果
- “SliderUI”
- 另请参见:
-
JComponent.getUIClassID()
,UIDefaults.getUI(javax.swing.JComponent)
-
createChangeListener
protected ChangeListener createChangeListener()
想要从模型处理ChangeEvent
s的子ChangeEvent
可以覆盖这一点,以返回自定义ChangeListener
实现的实例。 默认ChangeListener
只需调用fireStateChanged
方法将ChangeEvent
s转发到直接添加到滑块的ChangeListener
。- 结果
-
一个新的
ChangeListener
的实例 - 另请参见:
-
changeListener
,fireStateChanged()
,ChangeListener
,BoundedRangeModel
-
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
@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
返回使用addChangeListener()添加到此JSlider的所有ChangeListener
的数组。- 结果
-
添加了所有的
ChangeListener
如果没有添加任何监听器,则为空数组 - 从以下版本开始:
- 1.4
-
fireStateChanged
protected void fireStateChanged()
发送ChangeEvent
,其来源是这个JSlider
,所有ChangeListener
s已注册兴趣ChangeEvent
s。 每次从模型接收到一个ChangeEvent
时都会调用此方法。事件实例在必要时创建,并存储在
changeEvent
。
-
getModel
public BoundedRangeModel getModel()
返回BoundedRangeModel
处理滑块的三个基本属性:最小值,最大值,值。- 结果
- 该组件的数据模型
- 另请参见:
-
setModel(javax.swing.BoundedRangeModel)
,BoundedRangeModel
-
setModel
@BeanProperty(description="The sliders BoundedRangeModel.") public void setModel(BoundedRangeModel newModel)
设置BoundedRangeModel
处理滑块的三个基本属性:最小值,最大值,值。尝试将
null
模型传递给此方法会导致未定义的行为,并且最有可能发生异常。- 参数
-
newModel
- 新的,non-null
BoundedRangeModel
要使用 - 另请参见:
-
getModel()
,BoundedRangeModel
-
getValue
public int getValue()
从BoundedRangeModel
返回滑块的当前值。- 结果
- 滑块的当前值
- 另请参见:
-
setValue(int)
,BoundedRangeModel.getValue()
-
setValue
@BeanProperty(bound=false, preferred=true, description="The sliders current value.") public void setValue(int n)
将滑块的当前值设置为n
。 该方法将新值转发到模型。数据模型(
BoundedRangeModel
一个实例)处理从分配错误值引起的任何数学问题。 有关详细信息,请参阅BoundedRangeModel
文档。如果新值与上一个值不同,则会通知所有更改侦听器。
-
getMinimum
public int getMinimum()
从BoundedRangeModel
返回滑块支持的BoundedRangeModel
。- 结果
- 模型的最小属性值
- 另请参见:
-
setMinimum(int)
,BoundedRangeModel.getMinimum()
-
setMinimum
@BeanProperty(preferred=true, description="The sliders minimum value.") public void setMinimum(int minimum)
将滑块的最小值设置为minimum
。 该方法将新的最小值转发到模型。数据模型(
BoundedRangeModel
一个实例)处理从分配错误值引起的任何数学问题。 有关详细信息,请参阅BoundedRangeModel
文档。如果新的最小值与先前的最小值不同,则会通知所有更改侦听器。
- 参数
-
minimum
- 新的最低限度 - 另请参见:
-
getMinimum()
,addChangeListener(javax.swing.event.ChangeListener)
,BoundedRangeModel.setMinimum(int)
-
getMaximum
public int getMaximum()
从BoundedRangeModel
返回滑块支持的BoundedRangeModel
。- 结果
- 模型的最大属性的值
- 另请参见:
-
setMaximum(int)
,BoundedRangeModel.getMaximum()
-
setMaximum
@BeanProperty(preferred=true, description="The sliders maximum value.") public void setMaximum(int maximum)
将滑块的最大值设置为maximum
。 此方法将新的最大值转发到模型。数据模型(
BoundedRangeModel
一个实例)处理从分配错误值引起的任何数学问题。 有关详细信息,请参阅BoundedRangeModel
文档。如果新的最大值与先前的最大值不同,则会通知所有更改侦听器。
- 参数
-
maximum
- 新的最大值 - 另请参见:
-
getMaximum()
,addChangeListener(javax.swing.event.ChangeListener)
,BoundedRangeModel.setMaximum(int)
-
getValueIsAdjusting
public boolean getValueIsAdjusting()
从模型返回valueIsAdjusting
属性。 有关如何使用的详细信息,请参阅setValueIsAdjusting
文档。- 结果
-
该模型的价值
valueIsAdjusting
属性 - 另请参见:
-
setValueIsAdjusting(boolean)
-
setValueIsAdjusting
@BeanProperty(bound=false, expert=true, description="True if the slider knob is being dragged.") public void setValueIsAdjusting(boolean b)
设置型号的valueIsAdjusting
属性。 当滑块拖动开始时,滑块外观实现应将此属性设置为false
当拖动结束时,应将其设置为true
。- 参数
-
b
-valueIsAdjusting
属性的新值 - 另请参见:
-
getValueIsAdjusting()
,BoundedRangeModel.setValueIsAdjusting(boolean)
-
getExtent
public int getExtent()
从BoundedRangeModel
返回“extent”。 这表示由旋钮“覆盖”的值的范围。- 结果
- 一个int代表程度
- 另请参见:
-
setExtent(int)
,BoundedRangeModel.getExtent()
-
setExtent
@BeanProperty(bound=false, expert=true, description="Size of the range covered by the knob.") public void setExtent(int extent)
通过旋钮设置“覆盖”范围的大小。 如果用户点击旋钮的任一侧,大多数外观和感觉实现将会将值改变该量。 该方法只是将新的范围值转发到模型。数据模型(
BoundedRangeModel
一个实例)处理从分配错误值引起的任何数学问题。 有关详细信息,请参阅BoundedRangeModel
文档。如果新的盘区值与以前的盘区值不同,则会通知所有更改监听器。
- 参数
-
extent
- 新的范围 - 另请参见:
-
getExtent()
,BoundedRangeModel.setExtent(int)
-
getOrientation
public int getOrientation()
返回此滑块的垂直或水平方向。- 结果
-
SwingConstants.VERTICAL
或SwingConstants.HORIZONTAL
- 另请参见:
-
setOrientation(int)
-
setOrientation
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JSlider.VERTICAL","JSlider.HORIZONTAL"}, description="Set the scrollbars orientation to either VERTICAL or HORIZONTAL.") public void setOrientation(int orientation)
将滑块的方向设置为SwingConstants.VERTICAL
或SwingConstants.HORIZONTAL
。- 参数
-
orientation
-HORIZONTAL
或VERTICAL
- 异常
-
IllegalArgumentException
- 如果方向不是VERTICAL
,HORIZONTAL
- 另请参见:
-
getOrientation()
-
setFont
public void setFont(Font font)
设置此组件的字体。- 重写:
-
setFont
在JComponent
- 参数
-
font
- 该组件所需的Font
- 从以下版本开始:
- 1.6
- 另请参见:
-
Component.getFont()
-
imageUpdate
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
当图像发生变化时重新编辑组件。 此imageUpdate
一个的方法ImageObserver
时调用关于哪些已经使用异步例程,如先前所请求的图像的详细信息drawImage
的方法Graphics
变得可用。 有关此方法及其参数的更多信息,请参阅imageUpdate
的定义。imageUpdate
方法在图像的更多比特可用的Component
递增地绘制组件上的图像。如果系统属性
awt.image.incrementaldraw
丢失或值为true
,则会逐步绘制图像。 如果系统属性具有任何其他值,则在完全加载映像之前,不会绘制图像。而且,如果增量绘图生效,系统属性值
awt.image.redrawrate
被解释为整数,以给出最大重绘速率(以毫秒为单位)。 如果系统属性丢失或不能被解释为整数,则重绘速率是每100ms一次。的解释
x
,y
,width
,并height
参数依赖于价值infoflags
说法。- Specified by:
-
imageUpdate
在接口ImageObserver
- 重写:
-
imageUpdate
在Component
- 参数
-
img
- 正在观察的图像 -
infoflags
- 有关详细信息,请参阅imageUpdate
-
x
- x坐标 -
y
- y坐标 -
w
- 宽度 -
h
- 高度 - 结果
-
false
如果infoflags指示图像被完全加载; 否则为true
。 - 从以下版本开始:
- 1.7
- 另请参见:
-
ImageObserver
,Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver)
,Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver)
,Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver)
,Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver)
,ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)
-
getLabelTable
public Dictionary getLabelTable()
返回要在哪些值绘制哪些标签的字典。- 结果
-
包含标签的
Dictionary
以及绘制它们的位置
-
setLabelTable
@BeanProperty(hidden=true, visualUpdate=true, description="Specifies what labels will be drawn for any given value.") public void setLabelTable(Dictionary labels)
用于指定在任何给定值下绘制什么标签。 键值对具有以下格式:{ Integer value, java.swing.JComponent label }
。生成标签表的简单方法是使用
createStandardLabels
方法。标签设置完成后,此方法将调用
updateLabelUIs()
。 请注意,仅当paintLabels
属性为true
,标签才会被true
。- 参数
-
labels
- 新的Dictionary
标签,或null
删除所有标签 - 另请参见:
-
createStandardLabels(int)
,getLabelTable()
,setPaintLabels(boolean)
-
updateLabelUIs
protected void updateLabelUIs()
通过在每个标签上调用updateUI
来更新标签表中标签的UI。 UI从当前的外观更新。 标签也设置为首选尺寸。
-
createStandardLabels
public Hashtable<Integer,JComponent> createStandardLabels(int increment)
创建一个Hashtable
的数字文本标签,从最小滑块开始,并使用指定的增量。 例如,如果您调用createStandardLabels( 10 )
并且滑块最小值为零,则将为值为createStandardLabels( 10 )
等创建标签。对于要在滑块上绘制的标签,返回的
Hashtable
必须传递到setLabelTable
,而setPaintLabels
必须设置为true
。有关返回的
Hashtable
的组成的更多详细信息,请参阅setLabelTable
文档。- 参数
-
increment
- 生成的散列表中的标签之间的距离 - 结果
-
一个新的
Hashtable
的标签 - 异常
-
IllegalArgumentException
- 如果increment
小于或等于零 - 另请参见:
-
setLabelTable(java.util.Dictionary)
,setPaintLabels(boolean)
-
createStandardLabels
public Hashtable<Integer,JComponent> createStandardLabels(int increment, int start)
创建一个Hashtable
的数字文本标签,从指定的起始点开始,并使用指定的增量。 例如,如果您调用createStandardLabels( 10, 2 )
,则将为值createStandardLabels( 10, 2 )
等创建标签。对于要在滑块上绘制的标签,返回的
Hashtable
必须传递到setLabelTable
,而setPaintLabels
必须设置为true
。有关返回的
Hashtable
的组成的更多详细信息,请参阅setLabelTable
文档。- 参数
-
increment
- 生成的散列表中的标签之间的距离 -
start
- 标签开始的值 - 结果
-
一个新的
Hashtable
的标签 - 异常
-
IllegalArgumentException
- 如果start
超出范围,或者如果increment
小于或等于零 - 另请参见:
-
setLabelTable(java.util.Dictionary)
,setPaintLabels(boolean)
-
getInverted
public boolean getInverted()
如果滑块显示的值范围相反,则返回true,- 结果
- 如果滑块值与其正常顺序相反,则为true
- 另请参见:
-
setInverted(boolean)
-
setInverted
@BeanProperty(visualUpdate=true, description="If true reverses the slider values from their normal order") public void setInverted(boolean b)
指定true以反转滑块所显示的值范围,并将false设置为正常顺序的值范围。 顺序取决于滑块的ComponentOrientation
属性。ComponentOrientation
值为LEFT_TO_RIGHT
正常(非倒置)水平滑块在右侧最大。ComponentOrientation
值为RIGHT_TO_LEFT
正常水平滑块在左侧最大。 正常的垂直滑块在顶部最大。 当滑块反转时,这些标签反转。默认情况下,此属性的值为
false
。- 参数
-
b
- true从正常顺序反转滑块值
-
getMajorTickSpacing
public int getMajorTickSpacing()
此方法返回主要的tick间距。 返回的数字表示每个主刻度线之间的距离(以值计算)。 如果您有一个范围从0到50的滑块,主刻度间距设置为10,您将获得以下值旁边的主要刻度:0,10,20,30,40,50。- 结果
- 主要刻度之间的值的数量
- 另请参见:
-
setMajorTickSpacing(int)
-
setMajorTickSpacing
@BeanProperty(visualUpdate=true, description="Sets the number of values between major tick marks.") public void setMajorTickSpacing(int n)
此方法设置主要的刻度间距。 传递的数字代表每个主要刻度线之间的距离,以值为单位。 如果您有一个范围从0到50的滑块,主刻度间距设置为10,您将获得以下值旁边的主要刻度:0,10,20,30,40,50。为了绘制主要刻度,
setPaintTicks
必须设置为true
。此方法也将为您设置标签表。 如果还没有标签表,并且主刻度间距为
> 0
,而getPaintLabels
返回true
,则将生成标准标签表(通过调用createStandardLabels
),其中标记为主标记。 对于上面的示例,您将获得文本标签:“0”,“10”,“20”,“30”,“40”,“50”。 然后通过调用setLabelTable
在滑块上设置标签表。- 参数
-
n
-majorTickSpacing
属性的新值 - 另请参见:
-
getMajorTickSpacing()
,setPaintTicks(boolean)
,setLabelTable(java.util.Dictionary)
,createStandardLabels(int)
-
getMinorTickSpacing
public int getMinorTickSpacing()
此方法返回较小的刻度间距。 返回的数字表示每个小标记之间的距离,以值为单位。 如果您有一个范围从0到50的滑块,并且小刻度间距设置为10,则将在以下值旁边获得次要刻度:0,10,20,30,40,50。- 结果
- 次要蜱之间的数值
- 另请参见:
-
getMinorTickSpacing()
-
setMinorTickSpacing
@BeanProperty(visualUpdate=true, description="Sets the number of values between minor tick marks.") public void setMinorTickSpacing(int n)
此方法设置较小的刻度间距。 传递的数字代表每个小刻度线之间的距离,以值计算。 如果您有一个范围从0到50的滑块,并且小刻度间距设置为10,则将在以下值旁边获得次要刻度:0,10,20,30,40,50。为了绘制小刻度,
setPaintTicks
必须设置为true
。- 参数
-
n
-minorTickSpacing
属性的新值 - 另请参见:
-
getMinorTickSpacing()
,setPaintTicks(boolean)
-
getSnapToTicks
public boolean getSnapToTicks()
如果旋钮(及其表示的数据值)解析为用户放置旋钮的最近刻度标记,则返回true。- 结果
- 如果值捕捉到最近的刻度线,则为true,否则为false
- 另请参见:
-
setSnapToTicks(boolean)
-
setSnapToTicks
@BeanProperty(description="If true snap the knob to the nearest tick mark.") public void setSnapToTicks(boolean b)
指定true使旋钮(及其代表的数据值)解析为用户放置旋钮位置的最近刻度。 默认情况下,此属性为false
。- 参数
-
b
- 将旋钮锁定到最近的刻度线 - 另请参见:
-
getSnapToTicks()
-
getPaintTicks
public boolean getPaintTicks()
告诉是否要勾画刻度线。- 结果
- 如果勾号勾画,则为true,否则为false
- 另请参见:
-
setPaintTicks(boolean)
-
setPaintTicks
@BeanProperty(visualUpdate=true, description="If true tick marks are painted on the slider.") public void setPaintTicks(boolean b)
确定刻印标记是否在滑块上绘制。 默认情况下,此属性为false
。- 参数
-
b
- 是否应b
刻度线 - 另请参见:
-
getPaintTicks()
-
getPaintTrack
public boolean getPaintTrack()
告诉曲目(滑块滑入的区域)是否要被绘制。- 结果
- 如果跟踪画是真的,否则为false
- 另请参见:
-
setPaintTrack(boolean)
-
setPaintTrack
@BeanProperty(visualUpdate=true, description="If true, the track is painted on the slider.") public void setPaintTrack(boolean b)
确定轨迹是否在滑块上绘制。 默认情况下,此属性为true
。 这是符合这种财产的外观和感觉,有些人可能会选择忽略它。- 参数
-
b
- 是否绘制滑块轨道 - 另请参见:
-
getPaintTrack()
-
getPaintLabels
public boolean getPaintLabels()
告诉标签是否要涂漆。- 结果
- 如果标签被绘制,则为true,否则为false
- 另请参见:
-
setPaintLabels(boolean)
-
setPaintLabels
@BeanProperty(visualUpdate=true, description="If true labels are painted on the slider.") public void setPaintLabels(boolean b)
确定标签是否涂在滑块上。此方法也将为您设置标签表。 如果还没有标签表,并且主刻度间距为
> 0
,则将生成标准标签表(通过调用createStandardLabels
),其中标记为主标记。 然后通过调用setLabelTable
在滑块上设置标签表。默认情况下,此属性为
false
。- 参数
-
b
- 是否绘制标签 - 另请参见:
-
getPaintLabels()
,getLabelTable()
,createStandardLabels(int)
-
paramString
protected String paramString()
返回此JSlider的字符串表示形式。 该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在JComponent
- 结果
- 这个JSlider的字符串表示形式。
-
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
获取与此JSlider相关联的AccessibleContext。 对于滑块,AccessibleContext采用AccessibleJSlider的形式。 如有必要,将创建一个新的AccessibleJSlider实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 重写:
-
getAccessibleContext
在Component
- 结果
- 一个AccessibleJSlider作为这个JSlider的AccessibleContext
-
-