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

シグナル・ドキュメント

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