jslider java_JSlider

方法详细信息

getUI public SliderUI getUI()

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

重写：

结果

实现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对象。

updateUI public void updateUI()

将UI属性重置为当前外观的值。

createChangeListener protected ChangeListener createChangeListener()

想要以不同方式处理模型中的ChangeEvent的子类可以覆盖它以返回自定义ChangeListener实现的实例。

默认值ChangeListener只需调用fireStateChanged方法将ChangeEvent转发到已直接添加到滑块的ChangeListener 。

addChangeListener public void addChangeListener​(ChangeListener l)

将ChangeListener添加到滑块。

removeChangeListener public void removeChangeListener​(ChangeListener l)

从滑块中删除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

返回处理滑块的三个基本属性的

BoundedRangeModel ：minimum，maximum，value。

setModel @BeanProperty(description="The sliders BoundedRangeModel.")

public void setModel​(BoundedRangeModel newModel)

设置处理滑块的三个基本属性的BoundedRangeModel ：最小值，最大值，值。

尝试将null模型传递给此方法会导致未定义的行为，并且很可能是异常。

参数

newModel - 新的，

non-null

BoundedRangeModel使用

另请参见：

getValue public int getValue()

从

BoundedRangeModel返回滑块的当前值。

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 @BeanProperty(preferred=true,

description="The sliders minimum value.")

public void setMinimum​(int minimum)

将滑块的最小值设置为minimum 。

此方法将新的最小值转发给模型。

数据模型( BoundedRangeModel的实例)处理因分配错误值而产生的任何数学问题。 有关详细信息，请参阅BoundedRangeModel文档。

如果新的最小值与先前的最小值不同，则通知所有更改侦听器。

getMaximum public int getMaximum()

返回

BoundedRangeModel滑块支持的

BoundedRangeModel 。

setMaximum @BeanProperty(preferred=true,

description="The sliders maximum value.")

public void setMaximum​(int maximum)

将滑块的最大值设置为maximum 。

此方法将新的最大值转发给模型。

数据模型( BoundedRangeModel的实例)处理因分配错误值而产生的任何数学问题。 有关详细信息，请参阅BoundedRangeModel文档。

如果新的最大值与先前的最大值不同，则会通知所有更改侦听器。

getValueIsAdjusting public boolean getValueIsAdjusting()

从模型返回valueIsAdjusting属性。

有关如何使用它的详细信息，请参阅setValueIsAdjusting文档。

结果

模型的值

valueIsAdjusting属性

另请参见：

setValueIsAdjusting @BeanProperty(bound=false,

expert=true,

description="True if the slider knob is being dragged.")

public void setValueIsAdjusting​(boolean b)

设置模型的valueIsAdjusting属性。

滑块的外观实现应将此属性设置为true一开始拖动滑块时，并false拖动结束时。

getExtent public int getExtent()

返回BoundedRangeModel中的“范围”。

这表示旋钮“覆盖”的值范围。

setExtent @BeanProperty(bound=false,

expert=true,

description="Size of the range covered by the knob.")

public void setExtent​(int extent)

设置旋钮“覆盖”范围的大小。

如果用户点击旋钮的任一侧，大多数外观和感觉实现都会将该值更改为此数量。

此方法只是将新范围值转发给模型。

数据模型( BoundedRangeModel的实例)处理因分配错误值而产生的任何数学问题。 有关详细信息，请参阅BoundedRangeModel文档。

如果新范围值与先前范围值不同，则会通知所有更改侦听器。

getOrientation public int getOrientation()

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

结果

SwingConstants.VERTICAL或

SwingConstants.HORIZONTAL

另请参见：

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

异常

VERTICAL

HORIZONTAL

另请参见：

setFont public void setFont​(Font font)

设置此组件的字体。

重写：

参数

font - 此组件所需的

Font

从以下版本开始：

1.6

另请参见：

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说法。

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方法。

请注意，仅当paintLabels属性为true才会绘制标签。

updateLabelUIs protected void updateLabelUIs()

通过在每个标签上调用updateUI来更新标签表中标签的UI。

UI从当前外观更新。

标签也设置为首选大小。

createStandardLabels public Hashtable createStandardLabels​(int increment)

创建一个Hashtable的数字文本标签，从最小滑块开始，并使用指定的增量。

例如，如果调用createStandardLabels( 10 )并且滑块最小值为零，则将为值createStandardLabels( 10 )等创建标签。

有关滑块上绘制的标签，返回Hashtable必须传递到setLabelTable ，并setPaintLabels必须设置为true 。

有关返回的Hashtable更多详细信息，请参阅setLabelTable文档。

createStandardLabels public Hashtable createStandardLabels​(int increment,

int start)

创建一个Hashtable的数字文本标签，从指定的起始点开始，并使用指定的增量。

例如，如果您调用createStandardLabels( 10, 2 ) ，则将为值createStandardLabels( 10, 2 )等创建标签。

有关滑块上绘制的标签，返回Hashtable必须传递到setLabelTable ，并setPaintLabels必须设置为true 。

有关返回的Hashtable更多详细信息，请参阅setLabelTable文档。

参数

increment - 生成的哈希表中标签之间的距离

start - 标签开始的值

结果

一个新的

Hashtable标签

异常

start超出范围，或者

increment小于或等于零

另请参见：

getInverted public boolean getInverted()

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

结果

如果滑块值与正常顺序相反，则为true

另请参见：

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 @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在滑块上设置标签表。

getMinorTickSpacing public int getMinorTickSpacing()

此方法返回次要刻度线间距。

返回的数字表示每个次要刻度标记之间的距离(以值为单位)。

如果您的滑块范围为0到50且次要刻度线间距设置为10，则您将在以下值旁边获得次要刻度：0,10,20,30,40,50。

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 。

getSnapToTicks public boolean getSnapToTicks()

如果旋钮(及其表示的数据值)解析为用户放置旋钮的旁边最近的刻度线，则返回true。

结果

如果值捕捉到最接近的刻度线，则返回true，否则返回false

另请参见：

setSnapToTicks @BeanProperty(description="If true snap the knob to the nearest tick mark.")

public void setSnapToTicks​(boolean b)

指定true会使旋钮(及其表示的数据值)解析为用户放置旋钮的位置旁边最近的刻度线。

默认情况下，此属性为false 。

参数

b - 如果将旋钮捕捉到最近的刻度线，

b true

另请参见：

getPaintTicks public boolean getPaintTicks()

告知是否要绘制刻度线。

结果

如果刻有刻度线，则为true，否则为false

另请参见：

setPaintTicks @BeanProperty(visualUpdate=true,

description="If true tick marks are painted on the slider.")

public void setPaintTicks​(boolean b)

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

默认情况下，此属性为false 。

参数

b - 是否应涂上刻度线

另请参见：

getPaintTrack public boolean getPaintTrack()

判断是否要绘制轨道(滑块滑入的区域)。

结果

如果描绘了轨道，则为true，否则为false

另请参见：

setPaintTrack @BeanProperty(visualUpdate=true,

description="If true, the track is painted on the slider.")

public void setPaintTrack​(boolean b)

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

默认情况下，此属性为true 。

尊重这个属性取决于外观和感觉，有些人可能会选择忽略它。

参数

b - 是否绘制滑块轨道

另请参见：

getPaintLabels public boolean getPaintLabels()

判断是否要绘制标签。

结果

如果标签被绘制，则为true，否则为false

另请参见：

setPaintLabels @BeanProperty(visualUpdate=true,

description="If true labels are painted on the slider.")

public void setPaintLabels​(boolean b)

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

此方法还将为您设置标签表。 如果还没有标签表，并且主刻度线间距为> 0 ，则将生成标准标签表(通过调用createStandardLabels )，标签位于主刻度标记处。 然后通过调用setLabelTable在滑块上设置标签表。

默认情况下，此属性为false 。

paramString protected String paramString()

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

此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。

返回的字符串可能为空，但可能不是null 。

重写：

结果

此JSlider的字符串表示形式。

getAccessibleContext @BeanProperty(bound=false)

public AccessibleContext getAccessibleContext()

获取与此JSlider关联的AccessibleContext。

对于滑块，AccessibleContext采用AccessibleJSlider的形式。

如有必要，将创建一个新的AccessibleJSlider实例。

Specified by:

重写：

结果

一个AccessibleJSlider，用作此JSlider的AccessibleContext