RangeSlider QML Type

トラックに沿って2つのハンドルをスライドさせ、値の範囲を選択するために使用します。詳細...

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

信号

• void first.moved() (since QtQuick.Controls 2.5)
• void second.moved() (since QtQuick.Controls 2.5)

方法

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

詳細説明

RangeSliderはトラックに沿って各ハンドルをスライドさせることにより、2つの値で指定された範囲を選択するために使用されます。

以下の例では、from とto のカスタム値が設定され、first とsecond ハンドルの初期位置が設定されています：

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

特定のハンドルの値が変更されたときにアクションを実行するには、次の構文を使用します：

first.onMoved: console.log("first.value changed to " + first.value)

first.position とsecond.position プロパティは、コントロールのサイズの分数として表現され、その範囲は0.0 - 1.0 。first.visualPosition とsecond.visualPosition プロパティは同じですが、右から左へのアプリケーションでは逆になります。visualPosition はRangeSliderのスタイリング時にハンドルの位置を決めるのに便利です。上の例では、first.visualPosition は左から右へのアプリケーションでは0.24 になり、右から左へのアプリケーションでは0.76 になります。

ユーザーが単一の値を選択できるスライダーについては、Slider を参照してください。

Qt Quick Controls のRangeSlider、入力コントロール、およびフォーカス管理のカスタマイズも参照してください 。

プロパティのドキュメント

first group

first.moved()、first.increase()、first.decrease()も参照のこと 。

from : real

このプロパティは範囲の開始値を保持する。デフォルト値は0.0 です。

to 、first.value 、second.valueも参照してください 。

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティは、スライダーが水平かどうかを保持します。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

orientationも参照してください 。

live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

このプロパティは、それぞれのハンドルがドラッグされている間、スライダーがfirst.value とsecond.value プロパティのライブ更新を提供するかどうかを保持します。

デフォルト値はtrue です。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

first.value およびsecond.valueも参照してください 。

orientation : enumeration

このプロパティは方向を保持する。

可能な値

horizontal およびverticalも参照 。

second group

second.moved()、second.increase()、second.decrease()も参照のこと 。

snapMode : enumeration

このプロパティはスナップモードを保持します。

スナップモードは、stepSize に対するスライダーハンドルの振る舞いを決定します。

可能な値

様々なモードの視覚的な説明については、Slider のsnapMode ドキュメントを参照してください。

stepSizeも参照してください 。

stepSize : real

このプロパティはステップサイズを保持する。デフォルト値は0.0 である。

snapMode 、first.increase()、first.decrease()も参照のこと 。

to : real

このプロパティは範囲の終了値を保持する。デフォルト値は1.0 です。

from 、first.value 、second.valueも参照してください 。

touchDragThreshold : real [since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、タッチドラッグイベントが開始される閾値（論理ピクセル）を保持する。マウスドラッグのしきい値は影響を受けません。デフォルト値はApplication.styleHints.startDragDistance です。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

QStyleHintsも参照してください 。

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティは、スライダーが垂直かどうかを保持します。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

orientationも参照してください 。

シグナルのドキュメント

このシグナルは、1つ目と2つ目のハンドルのいずれかが、タッチ、マウス、キーのいずれかによってユーザーによってインタラクティブに動かされたときに発せられます。

これらのシグナルはQtQuick.Controls 2.5で導入されました。

first およびsecondも参照してください 。

メソッドのドキュメント

void first.decrease()

ハンドルの値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ減らします。

firstも参照のこと 。

void first.increase()

ハンドルの値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ増やします。

firstも参照のこと 。

void second.decrease()

ハンドルの値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ減らします。

secondも参照のこと 。

void second.increase()

ハンドルの値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ増やします。

secondも参照のこと 。

void setValues(real firstValue, real secondValue)

与えられた引数でfirst.value とsecond.value を設定する。

to がfrom より大きく、firstValue がsecondValue より大きい場合、 firstValue は secondValue にクランプされる。

from がto より大きく、secondValue が firstValue より大きい場合、secondValue は firstValue にクランプされる。

firstValueとsecondValueの間には循環依存関係があり、割り当てられた値が互いにクランプされる可能性があるため、この関数は、制御が完了した後に第1値と第2値を設定するために必要な場合がある。

stepSizeも参照のこと 。

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

与えられたposition の値を返します。

このメソッドは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

first.value,second.value,first.position,second.position,liveも参照してください 。