Slider QML Type

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

Import Statement:	`import QtQuick.Controls`
Inherits:	Control

継承されたメンバーを含む全メンバーのリスト

プロパティ

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 : qreal (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

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

可能な値：

定数	説明
`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 。

snapMode 、increase()、およびdecrease() も参照。

to : real

このプロパティは、範囲の終了値を保持します。既定値は1.0 です。

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

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

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。