Dial QML Type

このプロパティは、ハンドルの時計回りの角度を度単位で保持する。

角度は12時の位置でゼロであり、startAngle からendAngle までの範囲である。

position,startAngle,endAngleも参照 。

このプロパティは、文字盤の終了角度を度単位で保持する。

これは文字盤の最大値、すなわちto のangle になります。endAngle は、startAngle より大きく、720 より小さく、startAngle + 360 度以下でなければなりません。

このプロパティはQt 6.6で導入されました。

endAngle およびangleも参照してください 。

このプロパティは、範囲の開始値を保持します。デフォルト値は0.0 です。

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

このプロパティは、ダイヤルのハンドルを保持します。

ハンドルは、ダイヤルの位置を視覚的に示すインジケータとして機能します。

ダイヤルのカスタマイズ」も参照して ください。

このプロパティは入力モードを保持します。

Dialは3つの入力モードをサポートしています：Dial.Circular Dial.Horizontal およびDial.Vertical 。円入力モードは絶対入力システムで動作し、ダイヤル内のカーソルの位置がその値を直接反映します。水平および垂直入力モードは、相対入力システムを使用し、カーソルの位置の変化が文字盤の値に「加算」されます。

次の画像は、さまざまな入力モードが動きを追跡する方向を示しています：

デフォルト値はDial.Circular です。

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

このプロパティは、ハンドルがドラッグされている間、ダイヤルがvalue プロパティのライブ更新を提供するかどうかを保持します。

デフォルト値はtrue です。

このプロパティは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

valueも参照してください 。

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

この位置は、コントロールの角度範囲（ハンドルが動かせる範囲）の分数として、0.0 - 1.0 の範囲で表されます。

value およびangleも参照のこと 。

このプロパティは、ダイヤルが押されているかどうかを保持する。

ダイヤルは、その上でマウスが押されるか、Qt.Key_Left などのキーが押されたままになると押されます。キーが押されたときに文字盤が押されないようにしたい場合（スタイル上の理由など）、Keys attached property ：

Dial {
    Keys.onLeftPressed: {}
}

この場合、pressed はマウス押下時にのみtrue となります。

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

スナップモードは、stepSize と連動し、ハンドルをダイヤルに沿った特定のポイントにスナップできるようにします。

可能な値

stepSizeも参照してください 。

このプロパティは、ダイアルの開始角度を度単位で保持します。

これは文字盤の最小値、すなわちfrom のangle になります。startAngle は、endAngle より小さく、-360 より大きく、endAngle - 360 度以上でなければなりません。

このプロパティは Qt 6.6 で導入されました。

endAngle およびangleも参照してください 。

このプロパティは、ステップサイズを保持します。

ステップサイズは、キーボードから操作されたときにダイヤルの値が増減する量を決定します。例えば、ステップサイズを0.2 とすると、文字盤の値は0.2 刻みで増減します。

ステップサイズは、snapMode がDial.NoSnap 以外の値に設定されている場合にのみ、タッチ操作とマウス操作に対して尊重されます。

デフォルト値は0.0 で、キーボード操作では0.1 が有効なステップサイズとなります。

snapMode 、increase()、decrease()も参照 。

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

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

このプロパティは、from -to の範囲の値を保持します。デフォルト値は0.0 です。

position およびlive も参照して ください。

このプロパティは、文字盤がドラッグされたときに折り返すかどうかを保持します。

たとえば、このプロパティがtrue に設定されている場合、ダイヤルをto の位置を超えてドラッグすると、ハンドルはfrom の位置に配置され、その逆も同様です：

このプロパティがfalse の場合、ダイヤルを from と to の値をまたいでドラッグすることはできません。

デフォルト値はfalse です。

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

このシグナルは QtQuick.Controls 2.2 (Qt 5.9) で導入されました。

このシグナルは、文字盤が折り返す、つまり最大値から最小値へ、またはその逆へ移動するときに発せられます。このシグナルは、wrap がtrue のときのみ発せられます。direction 引数は、全回転の方向を指定し、以下の引数のいずれかになります：

このシグナルは Qt 6.6 で導入されました。

stepSize 、またはstepSize が定義されていない場合は0.1 だけ値を減らします。

stepSizeも参照してください 。

stepSize 、またはstepSize が定義されていない場合は0.1 だけ値を増やします。

stepSizeも参照して ください。