Slider QML Type

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

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

プロパティ

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

信号

• moved() (since QtQuick.Controls 2.2 (Qt 5.9))

方法

• void decrease()
• void increase()
• real valueAt(real position) (since QtQuick.Controls 2.1 (Qt 5.8))

詳細な説明

スライダーは、トラックに沿ってハンドルをスライドさせることで値を選択するために使用されます。

以下の例では、from 、value 、およびto の各値にカスタム値が設定されています。

Slider {
    from: 1
    value: 25
    to: 100
}

position プロパティは、コントロールのサイズに対する割合として指定され、その範囲は0.0 - 1.0 です。visualPosition プロパティも同様ですが、右から左へのアプリケーションでは順序が逆になります。visualPosition は、Sliderのスタイル設定時にハンドルの位置を指定するのに役立ちます。上記の例では、visualPosition は、左から右へのアプリケーションでは0.24 となり、右から左へのアプリケーションでは0.76 となります。

2つのハンドルを用意してユーザーが範囲を選択できるスライダーについては、RangeSlider を参照してください。

「スライダーおよび 入力コントロールのカスタマイズ」も参照してください 。

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

from : real

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

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

handle : Item

このプロパティには、ハンドル項目が格納されます。

「スライダーのカスタマイズ」も参照してください 。

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

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

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

orientationも参照してください 。

implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙的なハンドルの高さを保持します。

この値は、handle ? handle.implicitHeight : 0 に等しくなります。

これは通常、implicitContentHeight およびimplicitBackgroundHeight と組み合わせて、implicitHeight を計算するために使用されます。

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

implicitHandleWidthも参照してください 。

implicitHandleWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティには、暗黙的なハンドルの幅が格納されます。

その値は `handle ? handle.implicitWidth : 0` に等しい。

これは通常、implicitContentWidth およびimplicitBackgroundWidth と組み合わせて、implicitWidth を計算するために使用されます。

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

implicitHandleHeightも参照してください 。

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

このプロパティは、ハンドルをドラッグしている間、スライダーがvalue プロパティに対してリアルタイム更新を行うかどうかを示します。

デフォルト値は `true` です。

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

「 value 」および「valueAt()」も参照してください 。

orientation : enumeration

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

取り得る値：

関連項目: horizontal およびvertical 。

position : real [read-only]

このプロパティは、ハンドルの論理的な位置を保持します。

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

value 、visualPosition 、およびvalueAt()も参照してください 。

pressed : bool

このプロパティは、スライダーがタッチ、マウス、またはキーのいずれによって押されたかに関係なく有効です。

snapMode : enumeration

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

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

設定可能な値：

次の表では、さまざまなモードがアニメーションで説明されています。各アニメーションにおいて、マウスカーソルの動きとstepSize （0.2 ）は同一です。

値	例
Slider.NoSnap
Slider.SnapAlways
Slider.SnapOnRelease

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

stepSize : real

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

「 snapMode 」、「increase()」、および「decrease()」も参照してください 。

to : real

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

「 from 」および「value 」も参照してください 。

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

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

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

QStyleHintsも参照してください 。

value : real

このプロパティの値は、from ～to の範囲になります。デフォルト値は0.0 です。

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

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

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

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

orientationも参照してください 。

visualPosition : real [read-only]

このプロパティは、ハンドルの表示上の位置を保持します。

位置は、コントロールのサイズに対する割合として、0.0 - 1.0 の範囲で表されます。コントロールがmirrored の場合、値は1.0 - position となります。これにより、右から左への表示に対応しつつ、スライダーを視覚化するのに適した値となります。

positionも参照してください 。

Signalのドキュメント

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

このシグナルは、ユーザーがタッチ、マウス、ホイール、またはキー操作のいずれかによってスライダーをインタラクティブに移動させたときに発火します。

このシグナルは、QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

メソッドのドキュメント

void decrease()

stepSize が定義されていない場合、値をstepSize または0.1 だけ減少させます。

stepSizeも参照してください 。

void increase()

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

stepSizeも参照してください 。

[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)

指定されたposition の値を返します。

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

value およびpositionも参照してください 。