Slider QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

プロパティ

信号

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

方法

詳細説明

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

以下の例では、カスタムfromvalueto の値が設定されています:

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

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

可能な値:

定数説明
Qt.Horizontal水平(デフォルト)
Qt.Vertical垂直

horizontal およびverticalも参照


position : real [read-only]

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

位置は、コントロールのサイズに対する分数として表現され、0.0 - 1.0 の範囲となります。スライダを視覚化するためには、右から左を意識したvisualPosition を代わりに使うべきである。

value,visualPosition,valueAt()も参照してください


pressed : bool

このプロパティは、スライダーがタッチ、マウス、キーのいずれかで押されたかを保持します。


snapMode : enumeration

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

スナップモードは、スライダーハンドルがstepSize に対してどのように動作するかを決定します。

可能な値

定数説明
Slider.NoSnapスライダーはスナップしません(デフォルト)。
Slider.SnapAlwaysハンドルがドラッグされている間、スライダーはスナップします。
Slider.SnapOnReleaseスライダーはドラッグされている間はスナップせず、ハンドルが離された後にスナップします。

次の表では、さまざまなモードをアニメーションで説明しています。マウスカーソルの動きとstepSize (0.2) は各アニメーションで同じです。

Slider.NoSnap

Slider.SnapAlways

Slider.SnapOnRelease

stepSizeも参照


stepSize : real

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

snapModeincrease()、および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()

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

注意: 対応するハンドラはonMoved です。

このシグナルは 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も参照してください


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.