Slider QML Type
トラックに沿ってハンドルをスライドさせて値を選択するために使用します。詳細...
Import Statement: | import QtQuick.Controls |
Inherits: |
プロパティ
- 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))
方法
詳細説明
スライダーは、トラックに沿ってハンドルをスライドさせて値を選択するために使用されます。
以下の例では、カスタム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 を参照してください。
スライダーと 入力コントロールのカスタマイズも参照してください 。
プロパティの説明
handle : Item |
このプロパティはハンドル項目を保持します。
スライダーのカスタマイズも参照してください 。
horizontal : bool |
このプロパティは、スライダーが水平かどうかを保持します。
このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
orientationも参照して ください。
implicitHandleHeight : real |
このプロパティは、暗黙のハンドルの高さを保持します。
値はhandle ? handle.implicitHeight : 0
と同じです。
これは通常、implicitContentHeight およびimplicitBackgroundHeight とともに、implicitHeight を計算するために使用されます。
このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。
implicitHandleWidthも参照してください 。
implicitHandleWidth : real |
このプロパティは、暗黙のハンドル幅を保持します。
値はhandle ? handle.implicitWidth : 0
と等しくなります。
これは通常、implicitContentWidth およびimplicitBackgroundWidth とともに、implicitWidth を計算するために使用されます。
このプロパティは、QtQuick.Controls 2.5(Qt 5.12)で導入されました。
implicitHandleHeightも参照してください 。
live : bool |
orientation : enumeration |
position : real |
このプロパティは、ハンドルの論理位置を保持する。
位置は、コントロールのサイズに対する分数として表現され、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も参照 。
touchDragThreshold : real |
このプロパティは、タッチドラッグイベントが開始される閾値(論理ピクセル)を保持します。マウスドラッグのしきい値は影響を受けません。デフォルト値はApplication.styleHints.startDragDistance
です。
このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
QStyleHintsも参照してください 。
vertical : bool |
このプロパティは、スライダーが垂直かどうかを保持します。
このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
orientationも参照して ください。
visualPosition : real |
シグナル・ドキュメント
|
このシグナルは、タッチ、マウス、ホイール、キーのいずれかによって、スライダーがユーザーによってインタラクティブに動かされたときに発行されます。
注意: 対応するハンドラはonMoved
です。
このシグナルは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。
メソッドの説明
© 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.