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

Signal ドキュメント

moved()

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

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

メソッドのドキュメント

real valueAt(real position)

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

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

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