Dial QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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

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

Methoden

• void decrease()
• void increase()

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 unterstützt die folgenden Aktionen:

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.

Dokumentation der Eigenschaften

angle : real [read-only]

Diese Eigenschaft gibt den Winkel des Griffs im Uhrzeigersinn in Grad an.

Der Winkel ist Null an der 12-Uhr-Position und der Bereich liegt zwischen startAngle und endAngle.

Siehe auch position, startAngle, und endAngle.

endAngle : real [since 6.6]

Diese Eigenschaft enthält den Endwinkel der Skala in Grad.

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

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch startAngle und angle.

from : real

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

Siehe auch to und value.

handle : Item

Diese Eigenschaft umfasst den Griff des Zifferblatts.

Der Griff dient als visueller Indikator für die Position des Zifferblatts.

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-Aktualisierungen für die Eigenschaft value bereitstellt, 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 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 bewegt wird oder eine Taste wie Qt.Key_Left gedrückt wird. Wenn Sie es vorziehen, dass der Drehknopf nicht bei Tastendruck gedrückt wird (z. B. aus Gründen des Stylings), 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 Fangmodus arbeitet mit stepSize zusammen, um den Griff an bestimmten Punkten entlang des Zifferblatts einrasten zu lassen.

Mögliche Werte:

Siehe auch stepSize.

startAngle : real [since 6.6]

Diese Eigenschaft enthält den Startwinkel der Skala in Grad.

Dies ist der angle, den die Skala für ihren Minimalwert haben wird, d.h. from. Der Startwinkel muss kleiner als der endAngle, größer als -360 und größer oder gleich dem 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 Schrittweite.

Die Schrittweite bestimmt den Betrag, um den der Wert des Drehknopfes erhöht und verringert wird, wenn er über die Tastatur bedient wird. Bei einer Schrittgröße von 0.2 erhöht und verringert sich der Wert des Drehschalters beispielsweise in Schritten von 0.2.

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.

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 ihren Maximalwert hinaus auf ihren 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:

Dieses Signal wurde in Qt 6.6 eingeführt.

Dokumentation der Methode

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, oder 0.1, wenn stepSize nicht definiert ist.

Siehe auch stepSize.