RangeSlider QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• crossingEnabled : bool (since QtQuick.Controls 6.12)
• effectiveFirstValue : real (since QtQuick.Controls 6.12)
• effectiveSecondValue : real (since QtQuick.Controls 6.12)
• 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
• handlesCrossed : bool (since QtQuick.Controls 6.12)
• 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 handlesCrossedChanged() (since QtQuick.Controls 6.12)
• 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 コントロール』の「RangeSlider、入力コントロール、およびフォーカス管理のカスタマイズ」も参照してください 。

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

crossingEnabled : bool [since QtQuick.Controls 6.12]

このプロパティは、スライダーのハンドルが互いに交差できるかどうかを決定します。

false （デフォルト）の場合、最初のハンドルは 2 番目のハンドルを越えて移動できず、その逆も同様です。値は、通常の範囲では `first.value <=second.value `、反転範囲では `first.value >=second.value ` となるように制限されます。

ハンドルの位置が入れ替わったことを検出するには、handlesCrossed プロパティを使用します。

デフォルト値はfalse です。

交差が無効になっている場合、ハンドルが交差していたときは、ハンドルの値が入れ替わります。

このプロパティは QtQuick.Controls 6.12 で導入されました。

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

effectiveFirstValue : real [read-only, since QtQuick.Controls 6.12]

このプロパティには、ハンドルが交差したかどうかに関係なく、当初「最初の」ハンドルとして作成されたハンドルの値が保持されます。

crossingEnabled がfalse の場合、またはハンドルが交差していない場合は、これはfirst.value に等しくなります。ハンドルが交差している場合、これは視覚的な「最初」の位置（水平方向では最左端、垂直方向では最下端）にあるハンドルの値を表します。

このプロパティは、QtQuick.Controls 6.12で導入されました。

effectiveSecondValue 、first.value 、handlesCrossed 、およびcrossingEnabledも参照してください 。

effectiveSecondValue : real [read-only, since QtQuick.Controls 6.12]

このプロパティは、視覚的な「2番目」の位置（水平方向では最右端、垂直方向では最上部）にあるハンドルの値を保持します。

crossingEnabled がfalse の場合、またはハンドルが交差していない場合、これはsecond.value と等しくなります。ハンドルが交差している場合、これは視覚的な「2番目」の位置（水平方向では右端、垂直方向では最上部）にあるハンドルの値を表します。

このプロパティは、QtQuick.Controls 6.12で導入されました。

effectiveFirstValue 、second.value 、handlesCrossed 、およびcrossingEnabledも参照してください 。

first group

関連項目: first.moved()、first.increase()、およびfirst.decrease()を参照してください 。

from : real

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

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

handlesCrossed : bool [read-only, since QtQuick.Controls 6.12]

このプロパティは、ハンドル同士が交差しているかどうかを表します。

このプロパティは、crossingEnabled がtrue の場合にのみ関連します。ハンドルが交差すると、下限と上限という「1番目」と「2番目」の意味を保持するために、それぞれの内部ロールが入れ替わります。

このプロパティは、ハンドルが交差している状態にあるときに視覚的なフィードバックを提供するために使用できます。

このプロパティは、QtQuick.Controls 6.12で導入されました。

crossingEnabled およびhandlesCrossedChanged()も参照してください 。

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

[since QtQuick.Controls 6.12] void handlesCrossedChanged()

このシグナルは、ハンドル同士が交差した際に発生し、handlesCrossed プロパティが変更されます。

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

「crossingEnabled」も参照してください 。

メソッドのドキュメント

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 の間には循環依存関係があり、割り当てられた値が互いにクリップされてしまう可能性があるため、この関数は、コントロールの処理が完了した後に firstValue と secondValue を設定するために必要になる場合があります。

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