このページでは

C

Dial QML Type

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

Import Statement: import QtQuick.Controls
Since: Qt Quick Ultralite 1.0
Inherits:

Control

列挙

プロパティ

信号

詳細説明

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

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

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

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

円形、水平、垂直入力モード。

入力コントロールと コントロールのスタイリングも参照のこと

列挙型ドキュメント

InputMode

この列挙型は入力モードのリストを提供する。

Dialは以下の入力モードをサポートしています:

定数説明
Dial.Circular円入力モードは絶対入力システムで動作し、文字盤内のカーソルの位置が直接その値を反映する。
Dial.Horizontalhorizontalinput モードは相対入力システムを使用し、カーソル位置の変更はダイアルの値に追加されます。
Dial.VerticalDial.Horizontal と同様に、垂直入力モードは、相対入力システムを使用して、カーソル位置の変化を取得する。

SnapMode

スナップモードのリストを提供する。

定数説明
Dial.NoSnapダイヤルはスナップしない。
Dial.SnapAlwaysハンドルがドラッグされている間、文字盤はスナップする。
Dial.SnapOnRelease文字盤はドラッグされている間はスナップしないが、ハンドルが離された後にスナップする。

プロパティの説明

angle : real [read-only]

このプロパティはハンドルの角度を保持します。

範囲は-140 度から140 度までです。

positionも参照してください


from : real

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

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


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 刻みで増減します。

ステップサイズは、snapModeDial.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 ライセンスの下で利用可能です。
詳細はこちら。