Dial QML Type

Ein rundes Einstellrad, das gedreht wird, um einen Wert einzustellen. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

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()

Ausführliche Beschreibung

Das Drehfeld ähnelt einem herkömmlichen Drehknopf, wie er an Geräten wie Stereoanlagen oder Industrieanlagen zu finden ist. Es ermöglicht dem Benutzer, einen Wert innerhalb eines Bereichs festzulegen.

Der Wert des Drehreglers wird mit der Eigenschaft „ value “ festgelegt. Der Bereich wird mit den Eigenschaften „ from “ und „ to “ festgelegt. Um das Umschalten zu aktivieren oder zu deaktivieren, verwenden Sie die Eigenschaft „ wrap “.

Das Drehfeld lässt sich über die Tastatur bedienen. Es unterstützt die folgenden Aktionen:

input modesDas Drehfeld 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 des Drehfelds direkt dessen Wert widerspiegelt. Die horizontalen und vertikalen Eingabemodi verwenden ein relatives Eingabesystem, bei dem Änderungen der Cursorposition zum Wert des Drehfelds „hinzugerechnet“ werden.

Die folgende Abbildung veranschaulicht die Richtungen, in denen die verschiedenen Eingabemodi Bewegungen erfassen:

Siehe auch „Anpassen von Drehreglern und Eingabesteuerelementen“.

Dokumentation zu den Eigenschaften

angle : real [read-only]

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

Der Winkel beträgt Null in der 12-Uhr-Position und der Wertebereich reicht von startAngle bis endAngle.

Siehe auch position, startAngle und endAngle.

endAngle : real [since 6.6]

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

Dies ist der „ angle “, den das Drehfeld bei seinem Maximalwert einnimmt, d. h. „ to “. Der „endAngle“ muss größer als der „ startAngle “, kleiner als 720 und kleiner oder gleich dem „ startAngle “ + 360 Grad sein.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch startAngle und angle.

from : real

Diese Eigenschaft enthält den Startwert für den Bereich. Der Standardwert lautet „ 0.0 “.

Siehe auch „ to “ und „ value “.

handle : Item

Diese Eigenschaft enthält den Handle des Drehreglers.

Der Griff dient als visuelle Anzeige für die Position des Drehreglers.

Siehe auch „Zifferblatt anpassen“.

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

Diese Eigenschaft enthält den Eingabemodus.

Das Einstellrad 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 des Einstellrads direkt dessen Wert widerspiegelt. Die horizontalen und vertikalen Eingabemodi verwenden ein relatives Eingabesystem, bei dem Änderungen der Cursorposition zum Wert des Einstellrads „hinzugerechnet“ werden.

Die folgende Abbildung veranschaulicht die Richtungen, in denen die verschiedenen Eingabemodi Bewegungen erfassen:

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 gibt an, ob das Drehfeld während des Ziehens des Griffs Live-Aktualisierungen für die Eigenschaft „ value “ bereitstellt.

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 gibt die logische Position des Griffs an.

Die Position wird als Bruchteil des Winkelbereichs des Steuerelements (der Bereich, innerhalb dessen 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 das Scrollrad gedrückt wird.

Das Drehfeld wird gedrückt, wenn entweder die Maustaste darüber gedrückt wird oder eine Taste wie „ Qt.Key_Left “ gedrückt gehalten wird. Wenn Sie nicht möchten, dass das Drehfeld beim Drücken von Tasten gedrückt wird (beispielsweise aus gestalterischen Gründen), können Sie die Eigenschaft „ Keys attached property “ verwenden:

Dial {
    Keys.onLeftPressed: {}
}

Dadurch wird „pressed“ nur noch bei Mausklicks auf „ true “ gesetzt.

snapMode : enumeration

Diese Eigenschaft legt den Rastmodus fest.

Der Einrastmodus arbeitet mit dem „ stepSize “ zusammen, damit der Griff an bestimmten Punkten entlang des Drehreglers einrasten kann.

Mögliche Werte:

Siehe auch „ stepSize “.

startAngle : real [since 6.6]

Diese Eigenschaft enthält den Startwinkel des Drehreglers in Grad.

Dies ist der „ angle “, den das Drehfeld als Minimalwert annimmt, d. h. „ from “. Der „startAngle“ muss kleiner als der „ endAngle “, größer als -360 und größer oder gleich dem „ endAngle “ minus 360 Grad sein.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch endAngle und angle.

stepSize : real

Diese Eigenschaft gibt die Schrittweite an.

Die Schrittweite bestimmt den Betrag, um den der Wert des Drehreglers bei der Interaktion über die Tastatur erhöht oder verringert wird. Bei einer Schrittweite von beispielsweise „ 0.2 “ wird der Wert des Drehreglers in Schritten von „ 0.2 “ erhöht bzw. verringert.

Die Schrittweite wird bei der Interaktion per Touch oder Maus nur dann berücksichtigt, wenn „ snapMode “ auf einen anderen Wert als „ Dial.NoSnap “ gesetzt ist.

Der Standardwert ist ` 0.0`, was bei der Tastaturbedienung zu einer effektiven Schrittweite von ` 0.1 ` führt.

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

to : real

Diese Eigenschaft enthält den Endwert des Bereichs. Der Standardwert lautet „ 1.0 “.

Siehe auch „ from “ und „ value “.

value : real

Diese Eigenschaft nimmt Werte im Bereich von from bis to an. Der Standardwert lautet 0.0.

Siehe auch position und live.

wrap : bool

Diese Eigenschaft legt fest, ob der Regler beim Ziehen umspringt.

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

Wenn diese Eigenschaft auf „ false “ gesetzt ist, kann der Regler nicht über die Start- und Endwerte hinausgezogen werden.

Der Standardwert ist „ false “.

Signal-Dokumentation

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

Dieses Signal wird ausgelöst, wenn der Regler vom Benutzer interaktiv per Berührung, Maus oder Tastenbewegung verschoben wurde.

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 der Drehregler eine volle Umdrehung vollführt, d. h. von seinem Maximalwert zum Minimalwert wechselt oder umgekehrt. Es wird nur ausgegeben, wenn „ wrap “ auf „ true “ gesetzt ist. Das Argument „ direction “ legt die Richtung der vollen Umdrehung fest und kann einen der folgenden Werte annehmen:

Dieses Signal wurde in Qt 6.6 eingeführt.

Methodendokumentation

void decrease()

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

Siehe auch stepSize.

void increase()

Erhöht den Wert um stepSize oder um 0.1, falls stepSize nicht definiert ist.

Siehe auch stepSize.