JSlider
方法详细信息
-
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
。- 另请参见:
- addChangeListener(javax.swing.event.ChangeListener) , EventListenerList
-
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
文档。如果新值与先前值不同,则通知所有更改侦听器。
- 参数
-
n
- 新值 - 另请参见:
- getValue() , addChangeListener(javax.swing.event.ChangeListener) , BoundedRangeModel.setValue(int)
-
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从当前外观更新。 标签也设置为首选大小。- 另请参见:
- setLabelTable(java.util.Dictionary) , JComponent.updateUI()
-
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
推荐阅读