- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JSlider
-
- 实现的所有接口
-
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开始,
java.beans
软件包中添加了对所有JavaBeansjava.beans
长期存储的支持。 请参阅XMLEncoder
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
JSlider.AccessibleJSlider
此类实现JSlider
类的可访问性支持。-
嵌套类/接口声明在类 javax.swing.JComponent
JComponent.AccessibleJComponent
-
嵌套类/接口声明在类 java.awt.Container
Container.AccessibleAWTContainer
-
-
字段汇总
字段 变量和类型 字段 描述 protected ChangeEvent
changeEvent
每个滑块实例只需要一个ChangeEvent
因为事件的唯一(只读)状态是源属性。protected ChangeListener
changeListener
changeListener(无后缀)是我们添加到滑块模型的侦听器。protected int
majorTickSpacing
主刻度标记之间的值的数量 - 打破次刻度标记的较大标记。protected int
minorTickSpacing
次刻度标记之间的值数 - 主刻度标记之间出现的较小标记。protected int
orientation
滑块是水平还是垂直默认为水平。protected BoundedRangeModel
sliderModel
处理滑块的数字最大值,最小值和当前位置值的数据模型。protected boolean
snapToTicks
如果为true,则旋钮(及其表示的数据值)将解析为用户放置旋钮的位置旁边最近的刻度线。-
声明的属性在类 javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
声明的属性在类 java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields declared in 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
-
-
构造方法摘要
构造方法 构造器 描述 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创建水平滑块。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
addChangeListener(ChangeListener l)
将ChangeListener添加到滑块。protected ChangeListener
createChangeListener()
想要以不同方式处理模型ChangeEvent
的子类可以重写此方法以返回自定义ChangeListener
实现的实例。Hashtable<Integer,JComponent>
createStandardLabels(int increment)
创建一个Hashtable
的数字文本标签,从最小滑块开始,并使用指定的增量。Hashtable<Integer,JComponent>
createStandardLabels(int increment, int start)
创建一个Hashtable
的数字文本标签,从指定的起始点开始,并使用指定的增量。protected void
fireStateChanged()
发送ChangeEvent
,其源为此JSlider
,所有ChangeListener
已在注册兴趣小号ChangeEvent
秒。AccessibleContext
getAccessibleContext()
获取与此JSlider关联的AccessibleContext。ChangeListener[]
getChangeListeners()
返回使用addChangeListener()添加到此JSlider的所有ChangeListener
的数组。int
getExtent()
从BoundedRangeModel
返回“范围”。boolean
getInverted()
如果为滑块显示的值范围反转,则返回true,Dictionary
getLabelTable()
返回要在哪些值处绘制的标签的字典。int
getMajorTickSpacing()
此方法返回主刻度线间距。int
getMaximum()
返回BoundedRangeModel
滑块支持的BoundedRangeModel
。int
getMinimum()
返回BoundedRangeModel
滑块支持的BoundedRangeModel
。int
getMinorTickSpacing()
此方法返回次要刻度线间距。BoundedRangeModel
getModel()
返回处理滑块的三个基本属性的BoundedRangeModel
: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()
从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属性重置为当前外观的值。-
声明方法的类 javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, 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
-
声明方法的类 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
-
声明方法的类 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, 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, hide, 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
-
-
-
-
字段详细信息
-
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(无后缀)是我们添加到滑块模型的侦听器。 此侦听器初始化为从ChangeListener
返回的createChangeListener
,默认情况下,只将事件转发到ChangeListener
s(如果有)直接添加到滑块。
-
changeEvent
protected transient ChangeEvent changeEvent
每个滑块实例只需要一个ChangeEvent
因为事件的唯一(只读)状态是源属性。 这里生成的事件源始终是“this”。 第一次触发事件通知时,会延迟创建该事件。- 另请参见:
-
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
的子类可以覆盖它以返回自定义ChangeListener
实现的实例。 默认值ChangeListener
只需调用fireStateChanged
方法将ChangeEvent
转发到已直接添加到滑块的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
已在注册兴趣小号ChangeEvent
秒。 每次从模型接收到ChangeEvent
时,都会调用此方法。必要时创建事件实例,并将其存储在
changeEvent
。
-
getModel
public BoundedRangeModel getModel()
返回处理滑块的三个基本属性的BoundedRangeModel
:minimum,maximum,value。- 结果
- 此组件的数据模型
- 另请参见:
-
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
属性。 滑块的外观实现应将此属性设置为true
一开始拖动滑块时,并false
拖动结束时。- 参数
-
b
-valueIsAdjusting
属性的新值 - 另请参见:
-
getValueIsAdjusting()
,BoundedRangeModel.setValueIsAdjusting(boolean)
-
getExtent
public int getExtent()
返回BoundedRangeModel
中的“范围”。 这表示旋钮“覆盖”的值范围。- 结果
- 表示范围的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
方法是使用createStandardLabels
方法。设置标签后,此方法将调用
updateLabelUIs()
。 请注意,仅当paintLabels
属性为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
- 如果从正常顺序反转滑块值,b
true
-
getMajorTickSpacing
public int getMajorTickSpacing()
此方法返回主刻度线间距。 返回的数字表示每个主刻度标记之间的距离(以值为单位)。 如果您有一个范围为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
- 如果将旋钮捕捉到最近的刻度线,b
true - 另请参见:
-
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
- 是否应涂上刻度线 - 另请参见:
-
getPaintTicks()
-
getPaintTrack
public boolean getPaintTrack()
判断是否要绘制轨道(滑块滑入的区域)。- 结果
- 如果描绘了轨道,则为true,否则为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
-
-