Back to Qt.io
Contact Us Blog Download Qt

RangeSlider QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

プロパティ

信号

方法

詳細説明

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、入力コントロール、およびフォーカス管理のカスタマイズも参照してください 。

Property ドキュメント

first group

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 -to の範囲内の最初のハンドルの値を保持します。

from がto より大きい場合、最初のハンドルの値は2番目のハンドルより大きくなければならず、逆も同様である。

デフォルト値は0.0 です。

ハンドルこのプロパティは最初のハンドル項目を保持する。
ビジュアル位置このプロパティは、最初のハンドルの視覚的位置を保持する。

この位置はコントロールのサイズに対する分数で表され、0.0 - 1.0 の範囲である。コントロールがmirrored の場合、値は1.0 - position と等しくなる。 これは、右から左へのサポートを考慮した、スライダーの視覚化に適した値となる。

位置このプロパティは、最初のハンドルの論理位置を保持する。

位置はコントロールのサイズに対する分数で表され、0.0 - 1.0 の範囲である。スライダーを視覚化する場合は、右から左への対応を考慮したvisualPosition を代わりに使用する必要があります。

押されたこのプロパティは、最初のハンドルがタッチ、マウス、キーのいずれかで押されているかどうかを保持します。
hoveredこのプロパティは、最初のハンドルがホバーされているかどうかを保持します。このプロパティはQtQuick.Controls 2.1 で導入されました。
implicitHandleWidthこのプロパティは、最初のハンドルの暗黙の幅を保持する。このプロパティはQtQuick.Controls 2.5 で導入されました。
implicitHandleHeightこのプロパティは、最初のハンドルの暗黙の高さを保持します。このプロパティはQtQuick.Controls 2.5 で導入されました。

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

このプロパティは向きを保持します。

可能な値

定数説明
Qt.Horizontal水平（デフォルト）
Qt.Vertical垂直

horizontal およびverticalも参照 。


second group

second.handle : Item

second.hovered : bool

second.implicitHandleHeight : real

second.implicitHandleWidth : real

second.position : real

second.pressed : bool

second.value : real

second.visualPosition : real

プロパティ説明
値このプロパティは、2番目のハンドルの値をfrom -to の範囲で保持する。

from がto より大きい場合、最初のハンドルの値は2番目のハンドルより大きくなければならず、逆も同様です。

デフォルト値は0.0 です。

ハンドルこのプロパティは2番目のハンドル項目を保持する。
ビジュアル位置このプロパティは、2番目のハンドルの視覚的位置を保持する。

位置はコントロールのサイズに対する分数で表され、0.0 - 1.0 の範囲である。コントロールがmirrored の場合、値は1.0 - position と等しくなる。 このため、右から左へのサポートを考慮したスライダーの視覚化に適した値となる。

位置このプロパティは、2番目のハンドルの論理位置を保持する。

位置はコントロールのサイズに対する分数で表され、0.0 - 1.0 の範囲である。スライダーを視覚化する場合は、右から左への対応を考慮したvisualPosition を代わりに使用する必要があります。

押されたこのプロパティは、2番目のハンドルがタッチ、マウス、キーのいずれかで押されているかどうかを保持します。
hoveredこのプロパティは、2番目のハンドルがホバーされているかどうかを保持します。このプロパティはQtQuick.Controls 2.1 で導入されました。
implicitHandleWidthこのプロパティは、2番目のハンドルの暗黙の幅を保持する。このプロパティはQtQuick.Controls 2.5 で導入されました。
implicitHandleHeightこのプロパティは、2番目のハンドルの暗黙の高さを保持します。このプロパティはQtQuick.Controls 2.5 で導入されました。

second.moved(),second.increase(),second.decrease()も参照 。


snapMode : enumeration

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

スナップ・モードは、スライダー・ハンドルがstepSize に対してどのように動作するかを決定します。

可能な値

定数説明
RangeSlider.NoSnapスライダーはスナップしません（デフォルト）。
RangeSlider.SnapAlwaysハンドルがドラッグされている間、スライダーはスナップします。
RangeSlider.SnapOnReleaseスライダーはドラッグされている間はスナップせず、ハンドルが離された後にのみスナップする。

様々なモードの視覚的な説明については、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 も参照して ください。


シグナルのドキュメント

[since QtQuick.Controls 2.5] void first.moved()

[since QtQuick.Controls 2.5] void second.moved()

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

このQMLシグナルは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も参照してください 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.