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、Input Controls、Focus Managementのカスタマイズも参照してください 。

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

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 : qreal [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も参照して ください。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。