Back to Qt.io
Contact Us Blog Download Qt
このページでは

C

Slider QML Type

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

Import Statement: import QtQuick.Controls
Since: Qt Quick Ultralite 1.0
Inherits:

Control

列挙型

プロパティ

シグナル

方法

詳細説明

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

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

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

position プロパティは、コントロールのサイズに対する割合として指定され、その範囲は0.0 - 1.0 です。visualPosition は、スライダーのスタイル設定時にハンドルの位置を指定するのに役立ちます。

「コントロールのスタイル設定」および「入力コントロール」も参照してください 。

列挙型のドキュメント

SnapMode

選択可能なスライダーのスナップモードの一覧を表示します。

定数説明
Slider.NoSnapスライダーはスナップしません（デフォルト）。
Slider.SnapAlwaysハンドルをドラッグしている間、スライダーはスナップします。
Slider.SnapOnReleaseドラッグ中はスナップしませんが、ハンドルを離すとスナップします。

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

from : real

このプロパティには、範囲の開始値が格納されます。デフォルト値は `0.0` です。

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

handle : Item

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

「コントロールのスタイル設定」も参照してください 。

horizontal : bool [read-only]

このプロパティは、スライダーが水平であるかどうかにかかわらず有効です。

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

orientation : Qt::Orientation

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

「 horizontal 」および「vertical 」も参照してください 。

position : real [read-only]

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

この位置は、コントロールのサイズに対する割合として表され、範囲は0.0 - 1.0 となります。

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

pressed : bool

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

snapMode : SnapMode

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

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

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

Slider.SnapAlways

Slider.SnapOnRelease

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

stepSize : real

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

to : real

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

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

value : real

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

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

vertical : bool [read-only]

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

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

visualPosition : real [read-only]

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

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

シグナルのドキュメント

moved()

このシグナルは、ユーザーがスライダーをインタラクティブに動かしたときに発火します。

注： 対応するハンドラは `onMoved` です。

メソッドのドキュメント

real valueAt(real position)

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

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

特定のQtライセンスの下で利用可能です。
詳細はこちら。