RangeSlider QML Type

Dient zur Auswahl eines Wertebereichs durch Verschieben zweier Schieberegler entlang einer Leiste. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• crossingEnabled : bool (since QtQuick.Controls 6.12)
• effectiveFirstValue : real (since QtQuick.Controls 6.12)
• effectiveSecondValue : real (since QtQuick.Controls 6.12)
• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• handlesCrossed : bool (since QtQuick.Controls 6.12)
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

Signale

• void first.moved() (since QtQuick.Controls 2.5)
• void handlesCrossedChanged() (since QtQuick.Controls 6.12)
• void second.moved() (since QtQuick.Controls 2.5)

Methoden

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

Ausführliche Beschreibung

RangeSlider dient dazu, einen durch zwei Werte definierten Bereich auszuwählen, indem die beiden Schieberegler entlang einer Schiene verschoben werden.

Im folgenden Beispiel werden benutzerdefinierte Werte für ` from ` und ` to ` festgelegt und die Ausgangspositionen der Schieberegler ` first ` und ` second ` festgelegt:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

Um eine Aktion auszuführen, wenn sich der Wert eines bestimmten Schiebereglers ändert, verwenden Sie die folgende Syntax:

first.onMoved: console.log("first.value changed to " + first.value)

Die Eigenschaften „ first.position “ und „ second.position “ werden als Bruchteile der Größe des Steuerelements im Bereich von 0.0 - 1.0 ausgedrückt. Die Eigenschaften „ first.visualPosition “ und „ second.visualPosition “ sind identisch, außer dass sie in einer von rechts nach links laufenden Anwendung vertauscht sind. Die Eigenschaft „ visualPosition “ ist nützlich, um die Position der Schieberegler bei der Gestaltung von „RangeSlider“ festzulegen. Im obigen Beispiel entspricht „ first.visualPosition “ in einer von links nach rechts verlaufenden Anwendung dem Wert „ 0.24 “ und in einer von rechts nach links verlaufenden Anwendung dem Wert „ 0.76 “.

Informationen zu einem Schieberegler, mit dem der Benutzer einen einzelnen Wert auswählen kann, finden Sie unter Slider.

Siehe auch „Anpassen von RangeSlider, Eingabesteuerelementen und Fokusverwaltung“ unter Qt Quick Controls.

Dokumentation zu den Eigenschaften

crossingEnabled : bool [since QtQuick.Controls 6.12]

Diese Eigenschaft legt fest, ob sich die Schieberegler-Griffe überkreuzen dürfen.

Bei der Einstellung „ false “ (Standard) kann der erste Schieberegler nicht über den zweiten hinausbewegt werden und umgekehrt. Die Werte sind so eingeschränkt, dass für normale Bereiche gilt: „ first.value <= second.value “, und für invertierte Bereiche gilt: „ first.value >= second.value “.

Verwenden Sie die Eigenschaft „ handlesCrossed “, um zu erkennen, wann die Schieberegler ihre Positionen getauscht haben.

Der Standardwert ist „ false “.

Wenn das Überkreuzen deaktiviert ist und die Ziehpunkte überkreuzt wurden, werden die Werte der Ziehpunkte vertauscht.

Diese Eigenschaft wurde in QtQuick.Controls 6.12 eingeführt.

Siehe auch „ handlesCrossed “, „ first.value “ und „ second.value “.

effectiveFirstValue : real [read-only, since QtQuick.Controls 6.12]

Diese Eigenschaft enthält den Wert des Handles, das ursprünglich als „erstes“ Handle erstellt wurde, unabhängig davon, ob sich die Handles bereits gekreuzt haben.

Wenn „ crossingEnabled “ auf „ false “ gesetzt ist oder sich die Griffe nicht gekreuzt haben, entspricht dies dem Wert von „ first.value “. Wenn sich die Griffe gekreuzt haben, stellt dies den Wert des Griffs an der visuellen „ersten“ Position dar (ganz links bei horizontaler Ausrichtung, ganz unten bei vertikaler Ausrichtung).

Diese Eigenschaft wurde in QtQuick.Controls 6.12 eingeführt.

Siehe auch „ effectiveSecondValue“ , „ first.value “, „ handlesCrossed “ und „ crossingEnabled “.

effectiveSecondValue : real [read-only, since QtQuick.Controls 6.12]

Diese Eigenschaft enthält den Wert des Handles an der „zweiten“ Position im Bild (ganz rechts in horizontaler, ganz oben in vertikaler Ausrichtung).

Wenn „ crossingEnabled “ auf „ false “ gesetzt ist oder sich die Handles noch nicht gekreuzt haben, entspricht dies dem Wert von „ second.value “. Wenn sich die Handles gekreuzt haben, stellt dies den Wert des Handles an der visuell „zweiten“ Position dar (ganz rechts in horizontaler, ganz oben in vertikaler Ausrichtung).

Diese Eigenschaft wurde in QtQuick.Controls 6.12 eingeführt.

Siehe auch „ effectiveFirstValue“ , „ second.value “, „ handlesCrossed “ und „ crossingEnabled “.

first group

Siehe auch „ first.moved()“, „ first.increase()“ und „ first.decrease()“.

from : real

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

Siehe auch „ to “, „ first.value “ und „ second.value “.

handlesCrossed : bool [read-only, since QtQuick.Controls 6.12]

Diese Eigenschaft gibt an, ob sich die Handles gekreuzt haben.

Diese Eigenschaft ist nur relevant, wenn „ crossingEnabled “ auf „ true “ gesetzt ist. Wenn sich die Griffe kreuzen, tauschen sie ihre internen Rollen, um die semantische Bedeutung von „first“ und „second“ als untere bzw. obere Grenze beizubehalten.

Diese Eigenschaft kann verwendet werden, um visuelles Feedback zu geben, wenn sich die Ziehpunkte in einem gekreuzten Zustand befinden.

Diese Eigenschaft wurde in QtQuick.Controls 6.12 eingeführt.

Siehe auch ` crossingEnabled ` und ` handlesCrossedChanged()`.

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft gibt an, ob der Schieberegler horizontal ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch orientation.

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

Diese Eigenschaft gibt an, ob der Schieberegler während des Ziehens der jeweiligen Schieberegler-Griffe Live-Aktualisierungen für die Eigenschaften „ first.value “ und „ second.value “ bereitstellt.

Der Standardwert ist „ true “.

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

Siehe auch „ first.value “ und „ second.value “.

orientation : enumeration

Diese Eigenschaft gibt die Ausrichtung an.

Mögliche Werte:

Siehe auch horizontal und vertical.

second group

Siehe auch „ second.moved()“, „ second.increase()“ und „ second.decrease()“.

snapMode : enumeration

Diese Eigenschaft legt den Snap-Modus fest.

Der Snap-Modus bestimmt, wie sich die Schieberegler in Bezug auf die „ stepSize “ verhalten.

Mögliche Werte:

Visuelle Erläuterungen zu den verschiedenen Modi finden Sie in der Dokumentation zu „ snapMode “ unter Slider.

Siehe auch stepSize.

stepSize : real

Diese Eigenschaft gibt die Schrittweite an. Der Standardwert lautet 0.0.

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

to : real

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

Siehe auch „ from “, „ first.value “ und „ second.value “.

touchDragThreshold : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft legt den Schwellenwert (in logischen Pixeln) fest, ab dem ein Touch-Drag-Ereignis ausgelöst wird. Der Schwellenwert für das Ziehen mit der Maus bleibt davon unberührt. Der Standardwert lautet „ Application.styleHints.startDragDistance “.

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

Siehe auch QStyleHints.

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Diese Eigenschaft gibt an, ob der Schieberegler vertikal ist.

Diese Eigenschaft wurde in QtQuick.Controls 2.3 (Qt 5.10) eingeführt.

Siehe auch „ orientation “.

Signal-Dokumentation

Dieses Signal wird ausgelöst, wenn entweder der erste oder der zweite Griff vom Benutzer interaktiv per Berührung, Maus oder Tastatur verschoben wurde.

Diese Signale wurden in QtQuick.Controls 2.5 eingeführt.

Siehe auch first und second.

[since QtQuick.Controls 6.12] void handlesCrossedChanged()

Dieses Signal wird ausgelöst, wenn sich die Handles kreuzen, wodurch sich die Eigenschaft „ handlesCrossed “ ändert.

Dieses Signal wurde in QtQuick.Controls 6.12 eingeführt.

Siehe auch „ crossingEnabled “.

Methodendokumentation

void first.decrease()

Verringert den Wert des Handles um „ stepSize “ oder um „ 0.1 “, falls „ stepSize “ nicht definiert ist.

Siehe auch first.

void first.increase()

Erhöht den Wert des Handles um „ stepSize “ oder um „ 0.1 “, falls „ stepSize “ nicht definiert ist.

Siehe auch first.

void second.decrease()

Verringert den Wert des Handles um „ stepSize “ bzw. „ 0.1 “, falls „ stepSize “ nicht definiert ist.

Siehe auch second.

void second.increase()

Erhöht den Wert des Handles um „ stepSize “ oder um „ 0.1 “, falls „ stepSize “ nicht definiert ist.

Siehe auch second.

void setValues(real firstValue, real secondValue)

Setzt „ first.value “ und „ second.value “ mit den angegebenen Argumenten.

Wenn „ to “ größer ist als „ from “ und „ firstValue “ größer ist als „ secondValue “, wird „firstValue“ auf „secondValue“ begrenzt.

Ist „ from “ größer als „ to “ und „secondValue“ größer als „firstValue“, wird „secondValue“ auf „firstValue“ begrenzt.

Diese Funktion kann erforderlich sein, um den ersten und den zweiten Wert nach Abschluss der Steuerung festzulegen, da zwischen „firstValue“ und „secondValue“ eine zirkuläre Abhängigkeit besteht, die dazu führen kann, dass zugewiesene Werte gegenseitig begrenzt werden.

Siehe auch „ stepSize “.

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

Gibt den Wert für das angegebene ` position` zurück.

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

Siehe auch „ first.value“ , „ second.value “, „ first.position “, „ second.position “ und „ live “.