Dial QML Type
Kreisförmige Skala, die gedreht wird, um einen Wert einzustellen. Mehr...
Import Statement: | import QtQuick.Controls |
Inherits: |
Eigenschaften
- 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
Signale
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:
Aktion | Taste |
---|---|
Verringern Sie value um stepSize | Qt.Key_Left |
Verringern von value um stepSize | Qt.Key_Down |
Setzen von value auf from | Qt.Key_Home |
value erhöhen um stepSize | Qt.Key_Right |
Erhöhen Sie value um stepSize | Qt.Key_Up |
Setzen Sie value auf to | Qt.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 |
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 |
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 |
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 |
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 |
position : real |
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:
Konstant | Beschreibung |
---|---|
Dial.NoSnap | Das Zifferblatt rastet nicht ein (Standard). |
Dial.SnapAlways | Das Zifferblatt rastet ein, während der Griff gezogen wird. |
Dial.SnapOnRelease | Das Zifferblatt rastet nicht ein, während es gezogen wird, sondern erst, wenn der Griff losgelassen wird. |
Siehe auch stepSize.
startAngle : real |
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.
to : real |
value : real |
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
|
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.
|
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:
Konstante | Beschreibung |
---|---|
Dial.Clockwise | Das Zifferblatt wird im Uhrzeigersinn gedreht. |
Dial.CounterClockwise | Das Zifferblatt wird im Gegenuhrzeigersinn gedreht. |
Hinweis: Der entsprechende Handler ist onWrapped
.
Dieses Signal wurde in Qt 6.6 eingeführt.
Methode Dokumentation
void decrease() |
void increase() |
© 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.