Dial QML Type

Kreisförmige Skala, die gedreht wird, um einen Wert einzustellen. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Signale

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

Methoden

Detaillierte Beschreibung

Die Wählscheibe ähnelt einem traditionellen Drehknopf, wie man ihn bei Geräten wie Stereoanlagen oder Industrieanlagen findet. Er ermöglicht es dem Benutzer, einen Wert innerhalb eines Bereichs anzugeben.

Der Wert der Skala wird mit der Eigenschaft value festgelegt. Der Bereich wird mit den Eigenschaften from und to festgelegt. Um den Umbruch zu aktivieren oder zu deaktivieren, verwenden Sie die Eigenschaft wrap.

Das Zifferblatt kann mit einer Tastatur bedient werden. Es werden die folgenden Aktionen unterstützt:

AktionTaste
Verringern Sie value um stepSizeQt.Key_Left
Verringern von value um stepSizeQt.Key_Down
Setzen von value auf fromQt.Key_Home
value erhöhen um stepSizeQt.Key_Right
Erhöhen Sie value um stepSizeQt.Key_Up
Setzen Sie value auf toQt.Key_End

Das Zifferblatt unterstützt drei input modes: Dial.Circular, Dial.Horizontal und Dial.Vertical. Der kreisförmige Eingabemodus arbeitet mit einem absoluten Eingabesystem, bei dem die Position des Cursors innerhalb der Skala direkt den Wert widerspiegelt. Die horizontalen und vertikalen Eingabemodi verwenden ein relatives Eingabesystem, bei dem Änderungen der Cursorposition zum Wert der Skala "addiert" werden.

Die folgende Abbildung veranschaulicht die Richtungen, in die die verschiedenen Eingabemodi die Bewegung verfolgen:

Siehe auch Anpassen von Zifferblatt- und Eingabesteuerungen.

Eigenschaft Dokumentation

angle : real [read-only]

Diese Eigenschaft gibt den Uhrzeigersinnwinkel des Griffs in Grad an.

Der Winkel ist Null an der 12-Uhr-Position und der Bereich reicht von startAngle bis endAngle.

Siehe auch position, startAngle, und endAngle.


endAngle : real [since 6.6]

Diese Eigenschaft enthält den Endwinkel des Zifferblatts in Grad.

Dies ist der angle, den das Zifferblatt für seinen maximalen Wert hat, d.h. to. Der endAngle muss größer als startAngle, kleiner als 720 und kleiner oder gleich startAngle + 360 Grad sein.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch endAngle und angle.


from : real

Diese Eigenschaft enthält den Startwert für den Bereich. Der Standardwert ist 0.0.

Siehe auch to und value.


handle : Item

Diese Eigenschaft enthält den Griff der Skala.

Der Griff dient als visueller Indikator für die Position der Skala.

Siehe auch Zifferblatt anpassen.


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

Diese Eigenschaft enthält den Eingabemodus.

Dial unterstützt drei Eingabemodi: Dial.Circular, Dial.Horizontal und Dial.Vertical. Der kreisförmige Eingabemodus arbeitet mit einem absoluten Eingabesystem, bei dem die Position des Cursors innerhalb der Skala direkt den Wert widerspiegelt. Die horizontalen und vertikalen Eingabemodi verwenden ein relatives Eingabesystem, bei dem Änderungen der Cursorposition zum Wert der Skala "addiert" werden.

Die folgende Abbildung veranschaulicht die Richtungen, in die die verschiedenen Eingabemodi die Bewegung verfolgen:

Der Standardwert ist Dial.Circular.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.


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

Diese Eigenschaft legt fest, ob das Zifferblatt Live-Updates für die Eigenschaft value liefert, während der Griff gezogen wird.

Der Standardwert ist true.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch value.


position : real [read-only]

Diese Eigenschaft enthält die logische Position des Griffs.

Die Position wird als ein Bruchteil des Winkelbereichs des Steuerelements (der Bereich, in dem der Griff bewegt werden kann) im Bereich 0.0 - 1.0 ausgedrückt.

Siehe auch value und angle.


pressed : bool

Diese Eigenschaft gibt an, ob der Drehknopf gedrückt ist.

Der Drehknopf wird gedrückt, wenn entweder die Maus darüber gehalten wird oder eine Taste wie Qt.Key_Left gedrückt wird. Wenn Sie es vorziehen, dass das Zifferblatt bei Tastendruck nicht gedrückt wird (z. B. aus stilistischen Gründen), können Sie die Eigenschaft Keys attached property verwenden:

Dial {
    Keys.onLeftPressed: {}
}

Dies führt dazu, dass true nur bei Mausbetätigung gedrückt wird.


snapMode : enumeration

Diese Eigenschaft enthält den Einrastmodus.

Der Einrastmodus arbeitet mit stepSize zusammen, um den Griff an bestimmten Punkten entlang des Zifferblatts einrasten zu lassen.

Mögliche Werte:

KonstantBeschreibung
Dial.NoSnapDas Zifferblatt rastet nicht ein (Standard).
Dial.SnapAlwaysDas Zifferblatt rastet ein, während der Griff gezogen wird.
Dial.SnapOnReleaseDas Zifferblatt rastet nicht ein, während es gezogen wird, sondern erst, wenn der Griff losgelassen wird.

Siehe auch stepSize.


startAngle : real [since 6.6]

Diese Eigenschaft gibt den Startwinkel des Zifferblatts in Grad an.

Dies ist der angle, den die Skala für ihren Minimalwert haben wird, d.h. from. Der startAngle muss kleiner als endAngle, größer als -360 und größer oder gleich endAngle - 360 Grad sein.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch endAngle und angle.


stepSize : real

Diese Eigenschaft enthält die Schrittgröße.

Die Schrittweite bestimmt den Betrag, um den der Wert des Drehknopfes erhöht und verringert wird, wenn er über die Tastatur bedient wird. Eine Schrittweite von 0.2 führt beispielsweise dazu, dass der Wert des Drehknopfes in Schritten von 0.2 erhöht und erniedrigt wird.

Die Schrittweite wird bei Berührungs- und Mausinteraktion nur beachtet, wenn snapMode auf einen anderen Wert als Dial.NoSnap eingestellt ist.

Der Standardwert ist 0.0, was zu einer effektiven Schrittgröße von 0.1 für die Tastaturinteraktion führt.

Siehe auch snapMode, increase(), und decrease().


to : real

Diese Eigenschaft enthält den Endwert für den Bereich. Der Standardwert ist 1.0.

Siehe auch from und value.


value : real

Diese Eigenschaft enthält den Wert im Bereich from - to. Der Standardwert ist 0.0.

Siehe auch position und live.


wrap : bool

Diese Eigenschaft legt fest, ob das Zifferblatt beim Ziehen umbricht.

Wenn diese Eigenschaft beispielsweise auf true gesetzt ist, führt das Ziehen des Zifferblatts über die Position to hinaus dazu, dass der Griff an der Position from positioniert wird, und umgekehrt:

Wenn diese Eigenschaft auf false eingestellt ist, ist es nicht möglich, das Zifferblatt über die Werte von und bis zu ziehen.

Der Standardwert ist false.


Signal-Dokumentation

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

Dieses Signal wird ausgegeben, wenn das Zifferblatt vom Benutzer interaktiv bewegt wurde, entweder durch Berührung, Maus oder Tasten.

Hinweis: Der entsprechende Handler ist onMoved.

Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.


[since 6.6] wrapped(Dial.WrapDirection direction)

Dieses Signal wird ausgegeben, wenn die Skala umläuft, d. h. über den Maximalwert hinaus auf den Minimalwert geht oder umgekehrt. Es wird nur ausgegeben, wenn wrap true ist. Das Argument direction gibt die Richtung der vollen Drehung an und ist eines der folgenden Argumente:

KonstanteBeschreibung
Dial.ClockwiseDas Zifferblatt wird im Uhrzeigersinn gedreht.
Dial.CounterClockwiseDas Zifferblatt wird im Gegenuhrzeigersinn gedreht.

Hinweis: Der entsprechende Handler ist onWrapped.

Dieses Signal wurde in Qt 6.6 eingeführt.


Methode Dokumentation

void decrease()

Verringert den Wert um stepSize, oder 0.1, wenn stepSize nicht definiert ist.

Siehe auch stepSize.


void increase()

Erhöht den Wert um stepSize, bzw. 0.1, wenn stepSize nicht definiert ist.

Siehe auch stepSize.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.