モジュール javafx.controls
パッケージ javafx.scene.control

クラスSlider

  • すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable

    public class Slider
extends Control
    Sliderコントロールは、有効な数値の選択肢を連続範囲または離散範囲として表示し、ユーザーに値を選択させるために使用されます。 通常の視覚的表現では、トラックと、トラック内でドラッグされるノブまたはサムがあります。 Sliderは、オプションで様々なスライダ位置の値を示す目盛およびラベルを表示できます。

    スライダの3つの基本的な変数は、min、maxおよびvalueです。 valueは、常にminとmaxで定義された範囲内の番号でなければなりません。minは常にmax (minとmaxが等しいスライダは意味を持たない縮退ケースです)以下でなければなりません。minのデフォルトは0ですが、maxのデフォルトは100です。

    この最初の例では、範囲またはスパンが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)
        スライダの最小値、最大値および現在の値を指定してSliderコントロールを構築します。
        パラメータ:
        min - スライダの最小値
        max - スライダの最大値
        value - スライダの現在の値

    • メソッドの詳細

      • setMax

        public final void setMax​(double value)
        プロパティmaxの値を設定します。
        プロパティの説明:
        このSliderで表される最大値。 minを超える値である必要があります。

      • getMax

        public final double getMax​()
        プロパティmaxの値を取得します。
        プロパティの説明:
        このSliderで表される最大値。 minを超える値である必要があります。

      • setMin

        public final void setMin​(double value)
        プロパティminの値を設定します。
        プロパティの説明:
        このSliderで表される最小値。 max未満の値である必要があります。

      • getMin

        public final double getMin​()
        プロパティminの値を取得します。
        プロパティの説明:
        このSliderで表される最小値。 max未満の値である必要があります。

      • setValue

        public final void setValue​(double value)
        プロパティvalueの値を設定します。
        プロパティの説明:
        このSliderで表される現在の値。 この値は、常にminからmaxまでの間にある必要があります。 minまたはmaxが変更されたり、これ自体が変更されたために範囲外になる場合は、常に有効になるように固定されます。

      • getValue

        public final double getValue​()
        プロパティvalueの値を取得します。
        プロパティの説明:
        このSliderで表される現在の値。 この値は、常にminからmaxまでの間にある必要があります。 minまたはmaxが変更されたり、これ自体が変更されたために範囲外になる場合は、常に有効になるように固定されます。

      • valueProperty

        public final DoubleProperty valueProperty​()
        このSliderで表される現在の値。 この値は、常にminからmaxまでの間にある必要があります。 minまたはmaxが変更されたり、これ自体が変更されたために範囲外になる場合は、常に有効になるように固定されます。
        関連項目:
        getValue()、setValue(double)

      • setValueChanging

        public final void setValueChanging​(boolean value)
        プロパティvalueChangingの値を設定します。
        プロパティの説明:
        trueの場合、このSliderの現在の値を変更していることを示します。 値が変更されたことを通知します。 値が計算されると、falseにリセットされます。

      • isValueChanging

        public final boolean isValueChanging​()
        プロパティvalueChangingの値を取得します。
        プロパティの説明:
        trueの場合、このSliderの現在の値を変更していることを示します。 値が変更されたことを通知します。 値が計算されると、falseにリセットされます。

      • valueChangingProperty

        public final BooleanProperty valueChangingProperty​()
        trueの場合、このSliderの現在の値を変更していることを示します。 値が変更されたことを通知します。 値が計算されると、falseにリセットされます。
        関連項目:
        isValueChanging()、setValueChanging(boolean)

      • setOrientation

        public final void setOrientation​(Orientation value)
        プロパティorientationの値を設定します。
        プロパティの説明:
        Sliderの向きに水平または垂直を指定できます。

      • getOrientation

        public final Orientation getOrientation​()
        プロパティorientationの値を取得します。
        プロパティの説明:
        Sliderの向きに水平または垂直を指定できます。

      • setShowTickLabels

        public final void setShowTickLabels​(boolean value)
        プロパティshowTickLabelsの値を設定します。
        プロパティの説明:
        目盛のラベルを表示する必要があることを示します。 通常、Skin実装は、showTickMarksもtrueである場合にのみラベルを表示します。

      • isShowTickLabels

        public final boolean isShowTickLabels​()
        プロパティshowTickLabelsの値を取得します。
        プロパティの説明:
        目盛のラベルを表示する必要があることを示します。 通常、Skin実装は、showTickMarksもtrueである場合にのみラベルを表示します。

      • setShowTickMarks

        public final void setShowTickMarks​(boolean value)
        プロパティshowTickMarksの値を設定します。
        プロパティの説明:
        Skin実装が目盛を表示する必要があるかどうかを指定します。

      • isShowTickMarks

        public final boolean isShowTickMarks​()
        プロパティshowTickMarksの値を取得します。
        プロパティの説明:
        Skin実装が目盛を表示する必要があるかどうかを指定します。

      • setMajorTickUnit

        public final void setMajorTickUnit​(double value)
        プロパティmajorTickUnitの値を設定します。
        プロパティの説明:
        大目盛の間の単位距離。 たとえば、minが0でmaxが100、majorTickUnitが25の場合は、5つの目盛(位置0、位置25、位置50、位置75、最後は位置100)があります。

        この値は正の整数で、スパン未満の値にする必要があります。 範囲外の値を指定することは、基本的には目盛を無効にすることと同じです。

      • getMajorTickUnit

        public final double getMajorTickUnit​()
        プロパティmajorTickUnitの値を取得します。
        プロパティの説明:
        大目盛の間の単位距離。 たとえば、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の値を設定します。
        プロパティの説明:
        2つの大目盛の間に配置する小目盛の数。 この数は、正の整数またはゼロにする必要があります。 範囲外の値を指定すると、値がゼロの場合と同様に、小目盛が無効になります。

      • getMinorTickCount

        public final int getMinorTickCount​()
        プロパティminorTickCountの値を取得します。
        プロパティの説明:
        2つの大目盛の間に配置する小目盛の数。 この数は、正の整数またはゼロにする必要があります。 範囲外の値を指定すると、値がゼロの場合と同様に、小目盛が無効になります。

      • minorTickCountProperty

        public final IntegerProperty minorTickCountProperty​()
        2つの大目盛の間に配置する小目盛の数。 この数は、正の整数またはゼロにする必要があります。 範囲外の値を指定すると、値がゼロの場合と同様に、小目盛が無効になります。
        関連項目:
        getMinorTickCount()、setMinorTickCount(int)

      • setSnapToTicks

        public final void setSnapToTicks​(boolean value)
        プロパティsnapToTicksの値を設定します。
        プロパティの説明:
        Sliderのvalueを常に目盛に合せるかどうかを示します。 これは、目盛が表示されない場合でも有効です。

      • isSnapToTicks

        public final boolean isSnapToTicks​()
        プロパティsnapToTicksの値を取得します。
        プロパティの説明:
        Sliderのvalueを常に目盛に合せるかどうかを示します。 これは、目盛が表示されない場合でも有効です。

      • setLabelFormatter

        public final void setLabelFormatter​(StringConverter<Double> value)
        プロパティlabelFormatterの値を設定します。
        プロパティの説明:
        大目盛のラベルをフォーマットするための関数。 大目盛を表す数が関数に渡されます。 この関数が指定されていない場合、デフォルトの関数がSkin実装で使用されます。

      • getLabelFormatter

        public final StringConverter<Double> getLabelFormatter​()
        プロパティlabelFormatterの値を取得します。
        プロパティの説明:
        大目盛のラベルをフォーマットするための関数。 大目盛を表す数が関数に渡されます。 この関数が指定されていない場合、デフォルトの関数がSkin実装で使用されます。

      • setBlockIncrement

        public final void setBlockIncrement​(double value)
        プロパティblockIncrementの値を設定します。
        プロパティの説明:
        スライダのトラックがクリックされた場合にSliderを調整する量。 これは、キーを使用してスライダ位置を操作する場合に使用されます。 snapToTicksがtrueの場合、調整された値に最も近い目盛が使用されます。

      • getBlockIncrement

        public final double getBlockIncrement​()
        プロパティblockIncrementの値を取得します。
        プロパティの説明:
        スライダのトラックがクリックされた場合にSliderを調整する量。 これは、キーを使用してスライダ位置を操作する場合に使用されます。 snapToTicksがtrueの場合、調整された値に最も近い目盛が使用されます。

      • blockIncrementProperty

        public final DoubleProperty blockIncrementProperty​()
        スライダのトラックがクリックされた場合にSliderを調整する量。 これは、キーを使用してスライダ位置を操作する場合に使用されます。 snapToTicksがtrueの場合、調整された値に最も近い目盛が使用されます。
        関連項目:
        getBlockIncrement()、setBlockIncrement(double)

      • adjustValue

        public void adjustValue​(double newValue)
        newValueに合せてvalueを調整します。 valueは、minからmaxまでの間の実際の量です。 この関数ではsnapToTicksも考慮されることがadjustValueとsetValue間の主な違いとなります。 また、値がminとmaxの間の有効な数値であることが保証されます。注意: この機能は、主に新しいスキンまたはビヘイビアを実装する者が専門家によって使用されることを意図しています。 開発者や設計者がこの機能に直接アクセスするのは一般的ではありません。
        パラメータ:
        newValue - 新しい調整値

      • increment

        public void increment​()
        maxを上限として、値をblockIncrementずつ増やします。maxがmin以下の場合、このメソッドは何も行いません。

      • decrement

        public void decrement​()
        maxを上限として、値を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

      • getControlCssMetaData

        protected List<CssMetaData<? extends Styleable,?>> getControlCssMetaData​()
        オーバーライド:
        getControlCssMetaData 、クラス: Control
        戻り値:
        コントロールのCSSでスタイル設定可能なプロパティの変更不可能なリスト
        導入されたバージョン:
        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」