Module  javafx.controls
软件包  javafx.scene.control

Class Slider

  • All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable 

    public class Slider
extends Control
    滑块控件用于显示连续或离散的有效数字选项范围，并允许用户与控件进行交互。 它通常在视觉上表示为具有在轨道内拖动的“轨道”和“旋钮”或“拇指”。 滑块可以选择显示刻度线和标签，指示不同的滑块位置值。

    滑块的三个基本变量是min ， max ，并value 。 value应始终是由min和max定义的范围内的max 。 min应始终小于或等于max （尽管其min和max相等的滑块是没有任何意义的退化情况）。 min默认为0，而max默认为100。

    此第一个示例创建一个滑块，其范围或span从0变为1，其值默认为.5： 

      import javafx.scene.control.Slider;

 Slider slider = new Slider(0, 1, 0.5);

    下一个示例显示一个带有自定义刻度线和刻度线标签的滑块，也从0到1： 

      import javafx.scene.control.Slider;

 Slider slider = new Slider(0, 1, 0.5);
 slider.setShowTickMarks(true);
 slider.setShowTickLabels(true);
 slider.setMajorTickUnit(0.25f);
 slider.setBlockIncrement(0.1f);
    从以下版本开始：
    JavaFX 2.0

    • 构造方法详细信息

      • Slider

        public Slider​()
        创建一个默认的Slider实例。

      • Slider

        public Slider​(double min,
              double max,
              double value)
        使用指定的滑块最小值，最大值和当前值值构造滑块控件。
        参数
        min - 滑块最小值
        max - 滑块最大值
        value - 滑块当前值

    • 方法详细信息

      • setMax

        public final void setMax​(double value)
        设置属性max的值。
        Property description:
        由此滑块表示的最大值。 这个值必须大于min 。

      • getMax

        public final double getMax​()
        获取最大值的属性值。
        Property description:
        由此滑块表示的最大值。 这个值必须大于min 。

      • setMin

        public final void setMin​(double value)
        设置属性的值min。
        Property description:
        由此滑块表示的最小值。 这个值必须小于max 。

      • getMin

        public final double getMin​()
        获取属性的值min。
        Property description:
        由此滑块表示的最小值。 这个值必须小于max 。

      • setValue

        public final void setValue​(double value)
        设置属性值的值。
        Property description:
        由此滑块表示的当前值。 该值必须始终在min和max之间。 如果由于min或max发生变化或由于本身发生变化而导致的限制，则将被夹紧以始终保持有效。

      • getValue

        public final double getValue​()
        获取属性值的值。
        Property description:
        由此滑块表示的当前值。 该值必须始终在min和max之间。 如果由于min或max发生变化或由于本身发生变化而超出范围，则将被夹紧以始终保持有效。

      • valueProperty

        public final DoubleProperty valueProperty​()
        由此滑块表示的当前值。 该值必须始终在min和max之间。 如果由于min或max发生变化或由于自身被更改而超出范围，则将被钳制以始终保持有效。
        另请参见：
        getValue() ， setValue(double)

      • setValueChanging

        public final void setValueChanging​(boolean value)
        设置属性valueChanging的值。
        Property description:
        当为true时，表示此滑块的当前值正在更改。 它提供了值正在改变的通知。 一旦计算了值，它将重置为false。

      • isValueChanging

        public final boolean isValueChanging​()
        获取属性valueChanging的值。
        Property description:
        当为true时，表示此滑块的当前值正在更改。 它提供了值正在改变的通知。 一旦计算了值，它将重置为false。

      • valueChangingProperty

        public final BooleanProperty valueChangingProperty​()
        当为true时，表示此滑块的当前值正在更改。 它提供了值正在改变的通知。 一旦计算了值，它将重置为false。
        另请参见：
        isValueChanging() ， setValueChanging(boolean)

      • setOrientation

        public final void setOrientation​(Orientation value)
        设置属性方向的值。
        Property description:
        Slider的方向可以是水平还是垂直。

      • getOrientation

        public final Orientation getOrientation​()
        获取属性方向的值。
        Property description:
        Slider的方向可以是水平还是垂直。

      • setShowTickLabels

        public final void setShowTickLabels​(boolean value)
        设置属性showTickLabels的值。
        Property description:
        表示应该显示刻度线的标签。 通常， Skin实现只会显示标签，如果showTickMarks也为真。

      • isShowTickLabels

        public final boolean isShowTickLabels​()
        获取属性showTickLabels的值。
        Property description:
        表示应该显示刻度线的标签。 通常Skin实现只会显示标签，如果showTickMarks也是真的。

      • setShowTickMarks

        public final void setShowTickMarks​(boolean value)
        设置属性showTickMarks的值。
        Property description:
        指定Skin实现是否应显示刻度线。

      • isShowTickMarks

        public final boolean isShowTickMarks​()
        获取属性showTickMarks的值。
        Property description:
        指定Skin实现是否应显示刻度线。

      • setMajorTickUnit

        public final void setMajorTickUnit​(double value)
        设置属性majorTickUnit的值。
        Property description:
        主要刻度线之间的单位距离。 例如，如果27069963989363是0，而max是100，而majorTickUnit是25，那么将有5个刻度线：一个在位置0，一个在位置25，一个在位置50，一个在位置75，最后一个一个在位置100。

        该值应为正值，应为小于跨度的值。 超出范围值与禁用刻度线基本相同。

      • getMajorTickUnit

        public final double getMajorTickUnit​()
        获取属性majorTickUnit的值。
        Property description:
        主要刻度线之间的单位距离。 例如，如果min为0且max为100，而majorTickUnit为25，那么将出现5个刻度线：一个在位置0，一个在位置25，一个在位置50，一个在位置75，最后一个位置一个在位置100。

        该值应为正值，应为小于跨度的值。 超出范围值与禁用刻度线基本相同。

      • majorTickUnitProperty

        public final DoubleProperty majorTickUnitProperty​()
        主要刻度线之间的单位距离。 例如，如果min为0且max是100和majorTickUnit为25，然后将有5刻度标记：一个在位置0，一个在位置25，一个在位置50，一个在位置75和最终一个在位置100。

        该值应为正值，应为小于跨度的值。 超出范围值与禁用刻度线基本相同。

        另请参见：
        getMajorTickUnit() ， setMajorTickUnit(double)

      • setMinorTickCount

        public final void setMinorTickCount​(int value)
        设置属性minorTickCount的值。
        Property description:
        任何两个主要蜱之间的次要蜱的数量。 这个数字应该是正数或零。 超出范围值将禁用禁用次要tick，值为零。

      • getMinorTickCount

        public final int getMinorTickCount​()
        获取属性minorTickCount的值。
        Property description:
        任何两个主要蜱之间的次要蜱的数量。 这个数字应该是正数或零。 超出范围值将禁用禁用次要tick，值为零。

      • minorTickCountProperty

        public final IntegerProperty minorTickCountProperty​()
        任何两个主要蜱之间的次要蜱的数量。 这个数字应该是正数或零。 超出范围值将禁用禁用次要tick，值为零。
        另请参见：
        getMinorTickCount() ， setMinorTickCount(int)

      • setSnapToTicks

        public final void setSnapToTicks​(boolean value)
        设置属性snapToTicks的值。
        Property description:
        指示Slider的Slider应始终与刻度线对齐。 即使没有显示刻度线，也是如此。

      • isSnapToTicks

        public final boolean isSnapToTicks​()
        获取属性snapToTicks的值。
        Property description:
        指示Slider的Slider应始终与刻度线对齐。 即使没有显示刻度线，也是如此。

      • setLabelFormatter

        public final void setLabelFormatter​(StringConverter<Double> value)
        设置属性labelFormatter的值。
        Property description:
        用于格式化主要刻度的标签的功能。 表示主要刻度的数字将被传递给该功能。 如果未指定此功能，则Skin实现将使用默认功能。

      • getLabelFormatter

        public final StringConverter<Double> getLabelFormatter​()
        获取属性labelFormatter的值。
        Property description:
        用于格式化主要刻度的标签的功能。 表示主要刻度的数字将被传递给该功能。 如果未指定此功能，则Skin实现将使用默认功能。

      • setBlockIncrement

        public final void setBlockIncrement​(double value)
        设置属性blockIncrement的值。
        Property description:
        如果点击滑块的轨道，则调整滑块的量。 当使用键操作滑块位置时使用。 如果snapToTicks为真，那么将使用最接近调整值的刻度标记。

      • getBlockIncrement

        public final double getBlockIncrement​()
        获取属性blockIncrement的值。
        Property description:
        如果点击滑块的轨道，则调整滑块的量。 当使用键操作滑块位置时使用。 如果snapToTicks为真，那么将使用最接近调整值的刻度标记。

      • adjustValue

        public void adjustValue​(double newValue)
        调整value匹配newValue 。 value是min和max之间的实际数额。 这个功能也考虑到了snapToTicks ，这是adjustValue和setValue之间的主要区别。 它还确保该值是最小和最大值之间的一些有效数字。 注意：此功能主要由专家使用，主要由实施新皮肤或行为的人员使用。 开发人员或设计师直接访问此功能并不常见。
        参数
        newValue - 新调整值

      • increment

        public void increment​()
        将值增加blockIncrement ，以最大值 如果max小于或等于min，则此方法不执行任何操作。

      • decrement

        public void decrement​()
        将值减少blockIncrement ，以最大值为单位。 如果max小于或等于min，则此方法不执行任何操作。

      • createDefaultSkin

        protected Skin<?> createDefaultSkin​()
        为此控件创建一个新的默认皮肤实例。 如果没有通过CSS -fx-skin提供皮肤或者在具有setSkin(...)的子类中显式设置，则会调用此控件创建皮肤。
        重写：
        createDefaultSkin在 Control
        结果
        此控件的默认皮肤的新实例。 如果为null，则控件将没有皮肤，除非由css提供。

      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        结果
        与此类相关联的CssMetaData可能包括其类的CssMetaData。
        从以下版本开始：
        JavaFX 8.0

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        该方法由辅助技术调用以请求属性的值。

        子类通常覆盖此方法来实现特定角色所需的属性。
        如果未处理特定属性，则必须调用超类实现。

        重写：
        queryAccessibleAttribute中的 Control
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见：
        AccessibleAttribute

      • executeAccessibleAction

        public void executeAccessibleAction​(AccessibleAction action,
                                    Object... parameters)
        该方法由辅助技术调用，请求执行由参数指示的动作。

        此方法通常被子类覆盖，以实现特定角色所需的操作。
        如果未处理特定操作，则必须调用超类实现。

        重写：
        executeAccessibleAction在 Control
        参数
        action - 执行的动作
        parameters - 可选参数列表
        另请参见：
        AccessibleAction