C
Dial QML Type
値を設定するために回転させる円形ダイヤル。詳細...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt Quick Ultralite 1.0 |
| Inherits: |
- 継承されたメンバを含む、すべてのメンバの一覧
- ダイヤルはInput Controls に含まれます。
列挙
プロパティ
- angle : real
- from : real
- handle : Item
- inputMode : InputMode
- live : bool
- position : real
- snapMode : SnapMode
- stepSize : real
- to : real
- value : real
- wrap : bool
信号
- moved()
詳細説明
ダイヤルは、ステレオや産業機器などの機器に見られる伝統的なダイヤルノブに似ています。これにより、ユーザは範囲内の値を指定できます。
ダイヤルの値は、value プロパティを使用して設定します。範囲は、from とto プロパティを使用して設定します。折り返しを有効または無効にするには、wrap プロパティを使用します。
ダイヤルは3つのinput modes:Dial.Circular 、Dial.Horizontal 、Dial.Vertical をサポートしています。円形入力モードは絶対入力システムで動作し、ダイヤル内のカーソルの位置がその値を直接反映します。水平および垂直入力モードでは、相対入力システムを使用し、カーソルの位置の変化が文字盤の値に「加算」されます。
次の図は、さまざまな入力モードが動きを追跡する方向を示しています：
入力コントロールと コントロールのスタイリングも参照のこと 。
列挙のドキュメント
InputMode
この列挙型は入力モードのリストを提供する。
Dialは以下の入力モードをサポートしています：
| 定数 | 説明 |
|---|---|
Dial.Circular | 円入力モードは、絶対入力システムで動作し、文字盤内のカーソルの位置がその値を直接反映する。 |
Dial.Horizontal | horizontalinput モードは相対入力システムを使用し、カーソル位置の変更はダイアルの値に追加されます。 |
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 。
snapMode : SnapMode [default]
このプロパティはスナップモードを保持します。
スナップモードはstepSize と連動し、ハンドルをダイヤルに沿った特定のポイントにスナップできるようにします。
stepSizeも参照してください 。
stepSize : real
このプロパティは、ステップサイズを保持する。
ステップサイズは、キーボードで操作したときに文字盤の値が増減する量を決定します。例えば、ステップサイズを0.2 とすると、文字盤の値は0.2 刻みで増減します。
ステップサイズは、snapMode がDial.NoSnap 以外の値に設定されている場合にのみ、タッチ操作とマウス操作に対して尊重されます。
デフォルト値は0.0 で、キーボード操作時の有効なステップサイズは0.1 となる。
snapModeも参照 。
to : real
このプロパティは範囲の終了値を保持する。デフォルト値は1.0 です。
value : real
このプロパティは、from -to の範囲の値を保持する。デフォルト値は0.0 です。
wrap : bool
このプロパティは、文字盤がドラッグされたときに折り返すかどうかを保持する。
例えば、このプロパティがtrue に設定されている場合、文字盤をto の位置を越えてドラッグすると、ハンドルはfrom の位置に移動し、その逆も同様です：
このプロパティがfalse の場合、from と to の値をまたいで文字盤をドラッグすることはできません。
デフォルト値はfalse です。
シグナル・ドキュメント
moved()
このシグナルは、文字盤がタッチ、マウス、キーのいずれかによってユーザーによってインタラクティブに動かされたときに発せられる。
注意: 対応するハンドラはonMoved です。
