Dial QML Type

値を設定するために回転させる円形ダイヤル。詳細...

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

プロパティ

• angle : real
• endAngle : real (since 6.6)
• from : real
• handle : Item
• inputMode : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• position : real
• pressed : bool
• snapMode : enumeration
• startAngle : real (since 6.6)
• stepSize : real
• to : real
• value : real
• wrap : bool

信号

• moved() (since QtQuick.Controls 2.2 (Qt 5.9))
• wrapped(Dial.WrapDirection direction) (since 6.6)

方法

• void decrease()
• void increase()

詳細説明

ダイヤルは、ステレオや産業機器などの機器に見られる伝統的なダイヤルノブに似ています。これにより、ユーザは範囲内の値を指定できます。

ダイヤルの値は、value プロパティで設定します。範囲は、from とto プロパティで設定します。折り返しを有効または無効にするには、wrap プロパティを使用します。

文字盤はキーボードで操作できます。以下のアクションをサポートしています：

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

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

ダイヤルと 入力コントロールのカスタマイズも参照してください 。

プロパティのドキュメント

angle : real [read-only]

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

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

position,startAngle,endAngleも参照のこと 。

endAngle : real [since 6.6]

このプロパティは、ダイヤルの終了角度を度単位で保持する。

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

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

startAngle とangleも参照してください 。

from : real

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

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

handle : Item

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

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

文字盤のカスタマイズ」も参照してください 。

inputMode : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

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

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

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

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

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

live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

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

デフォルト値はtrue です。

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

valueも参照してください 。

position : real [read-only]

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

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

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

pressed : bool

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

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

Dial {
    Keys.onLeftPressed: {}
}

この場合、マウスを押したときだけtrue が押されます。

snapMode : enumeration

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

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

可能な値

stepSizeも参照してください 。

startAngle : real [since 6.6]

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

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

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

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

stepSize : real

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

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

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

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

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

to : real

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

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

value : real

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

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

wrap : bool

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

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

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

デフォルト値はfalse です。

シグナル・ドキュメント

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

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

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

[since 6.6] wrapped(Dial.WrapDirection direction)

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

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

メソッドの説明

void decrease()

値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ減少させる。

stepSizeも参照のこと 。

void increase()

値をstepSize 、またはstepSize が定義されていない場合は0.1 だけ増加させる。

stepSizeも参照のこと 。