C
Dial QML Type
値を設定するために回転させる円形のダイヤル。詳細...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt Quick Ultralite 1.0 |
| Inherits: |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- ダイアルは入力コントロールの一部です。
列挙型
プロパティ
- angle : real
- from : real
- handle : Item
- inputMode : InputMode
- live : bool
- position : real
- snapMode : SnapMode
- stepSize : real
- to : real
- value : real
- wrap : bool
信号
- moved()
詳細説明
「Dial」は、ステレオや産業用機器などに搭載されている従来のダイヤルノブに似ています。これにより、ユーザーは範囲内の値を指定することができます。
ダイヤルの値は、value プロパティを使用して設定します。範囲は、from およびto プロパティを使用して設定します。ラップの有効化または無効化には、wrap プロパティを使用します。
Dialは3つのinput modes をサポートしています：Dial.Circular 、Dial.Horizontal 、およびDial.Vertical 。円形入力モードは絶対入力システムを採用しており、ダイアル内のカーソルの位置がその値を直接反映します。水平および垂直入力モードは相対入力システムを採用しており、カーソルの位置の変化がダイアルの値に「加算」されます。
次の画像は、各入力モードが動きを追跡する方向を示しています：
「入力コントロール」および「コントロールのスタイル設定」も参照してください 。
列挙型に関するドキュメント
InputMode
この列挙型は、入力モードの一覧を提供します。
Dialは以下の入力モードをサポートしています：
| 定数 | 説明 |
|---|---|
Dial.Circular | 円形入力モードは絶対入力システムに基づいて動作し、ダイアル内のカーソルの位置がその値を直接反映します。 |
Dial.Horizontal | 水平入力モードは相対入力システムを使用し、カーソル位置の変化がダイアルの値に加算されます。 |
Dial.Vertical | Dial.Horizontal と同様に、垂直入力モードも相対入力システムを使用してカーソル位置の変化を取得します。 |
SnapMode
スナップモードの一覧を表示します。
| 定数 | 説明 |
|---|---|
Dial.NoSnap | ダイヤルはスナップしません。 |
Dial.SnapAlways | ハンドルをドラッグしている間、ダイアルはスナップします。 |
Dial.SnapOnRelease | ドラッグ中はスナップしませんが、ハンドルを離すとスナップします。 |
プロパティのドキュメント
angle : real [read-only]
このプロパティは、ハンドルの角度を保持します。
範囲は-140 度から140 度です。
positionも参照してください 。
from : real
このプロパティには、範囲の開始値が格納されます。デフォルト値は `0.0` です。
handle : Item
このプロパティには、ダイヤルのハンドルが格納されます。
このハンドルは、ダイヤルの位置を示す視覚的な指標として機能します。
「コントロールのスタイル設定」も参照してください 。
inputMode : InputMode [default]
このプロパティは、入力モードを保持します。
次の図は、各入力モードが動きを追跡する方向を示しています：
デフォルト値はDial.Circular です。
live : bool
このプロパティは、ハンドルをドラッグしている間、ダイヤルがvalue プロパティに対してリアルタイムの更新を行うかどうかを指定します。
既定値は `true` です。
「value」も参照してください 。
position : real [read-only]
このプロパティは、ハンドルの論理的な位置を保持します。
この位置は、コントロールの角度範囲（ハンドルを移動できる範囲）に対する割合として表され、その値は0.0 - 1.0 です。
「 value 」および「angle 」も参照してください 。
snapMode : SnapMode [default]
このプロパティはスナップモードを保持します。
スナップモードは、stepSize と連携して、ハンドルがダイヤル上の特定のポイントにスナップするように機能します。
「stepSize」も参照してください 。
stepSize : real
このプロパティはステップサイズを保持します。
ステップサイズは、キーボードを介して操作された際に、ダイヤルの値が増減する量を決定します。たとえば、ステップサイズを0.2 に設定すると、ダイヤルの値は0.2 ずつ増減します。
ステップサイズは、snapMode がDial.NoSnap 以外の値に設定されている場合にのみ、タッチおよびマウス操作に対して適用されます。
デフォルト値は `0.0` であり、これによりキーボード操作時の有効なステップサイズは `0.1 ` となります。
「snapMode」も参照してください 。
to : real
このプロパティは、範囲の終了値を保持します。デフォルト値は `1.0` です。
「 from 」および「value 」も参照してください 。
value : real
このプロパティの値は、from ～to の範囲内です。デフォルト値は0.0 です。
「 position 」および「live 」も参照してください 。
wrap : bool
このプロパティは、ダイヤルをドラッグした際に巻き戻るかどうかを指定します。
たとえば、このプロパティが `true` に設定されている場合、ダイヤルを `to ` の位置を超えてドラッグすると、ハンドルは `from ` の位置に移動し、その逆も同様です。
このプロパティがfalse に設定されている場合、ダイアルを「from」値と「to」値の間をドラッグすることはできません。
デフォルト値はfalse です。
シグナル・ドキュメント
moved()
このシグナルは、ユーザーがタッチ、マウス、またはキー操作によってダイアルをインタラクティブに移動させたときに発生します。
注： 対応するハンドラは onMoved です。
特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。
