RangeSlider QML Type

Dient zur Auswahl eines Wertebereichs durch Verschieben zweier Griffe entlang einer Spur. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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
• 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 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 wird verwendet, um einen durch zwei Werte spezifizierten Bereich auszuwählen, indem jeder Griff entlang einer Spur verschoben wird.

Im folgenden Beispiel werden die benutzerdefinierten Werte from und to eingestellt und die Anfangspositionen der Griffe first und second festgelegt:

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

Um eine Aktion auszuführen, wenn sich der Wert für einen bestimmten Handle ä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 0.0 - 1.0 ausgedrückt. Die Eigenschaften first.visualPosition und second.visualPosition sind die gleichen, außer dass sie in einer Rechts-nach-Links-Anwendung umgekehrt sind. Die Eigenschaft visualPosition ist nützlich für die Positionierung der Griffe beim Styling von RangeSlider. Im obigen Beispiel wird first.visualPosition in einer Links-nach-Rechts-Anwendung zu 0.24 und 0.76 in einer Rechts-nach-Links-Anwendung.

Für einen Schieberegler, mit dem der Benutzer einen einzelnen Wert auswählen kann, siehe Slider.

Siehe auch Anpassen von RangeSlider, Input Controls und Focus Management in Qt Quick Controls.

Dokumentation der Eigenschaft

first group

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

from : real

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

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

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 legt fest, ob der Schieberegler Live-Aktualisierungen für die Eigenschaften first.value und second.value bereitstellt, während die entsprechenden Griffe gezogen werden.

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 enthält den Fangmodus.

Der Fangmodus bestimmt, wie sich die Schiebereglergriffe in Bezug auf die stepSize verhalten.

Mögliche Werte:

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

Siehe auch stepSize.

stepSize : real

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

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

to : real

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

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

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

Diese Eigenschaft enthält den Schwellenwert (in logischen Pixeln), bei dem ein Touch-Drag-Ereignis ausgelöst wird. Der Schwellenwert für das Ziehen mit der Maus wird davon nicht beeinflusst. Der Standardwert ist 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 ausgegeben, wenn entweder der erste oder der zweite Handle vom Benutzer interaktiv bewegt wurde, entweder durch Berührung, Maus oder Tasten.

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

Siehe auch first und second.

Methoden-Dokumentation

void first.decrease()

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

Siehe auch first.

void first.increase()

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

Siehe auch first.

void second.decrease()

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

Siehe auch second.

void second.increase()

Erhöht den Wert des Handles um stepSize, oder 0.1, wenn 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 geklemmt.

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

Diese Funktion kann notwendig sein, um den ersten und zweiten Wert nach Abschluss der Kontrolle zu setzen, da zwischen firstValue und secondValue eine zirkuläre Abhängigkeit besteht, die dazu führen kann, dass zugewiesene Werte aneinander geklemmt werden.

Siehe auch stepSize.

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

Gibt den Wert für die 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.