RangeSlider QML Type

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

Import Statement:	`import QtQuick.Controls`
Inherits:	Control

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
first.handle : Item
first.hovered : bool
first.implicitHandleHeight : real
first.implicitHandleWidth : real
first.position : real
first.pressed : bool
first.value : real
first.visualPosition : real

Eigenschaft	Beschreibung
Wert	Diese Eigenschaft enthält den Wert des ersten Handles im Bereich `from` - `to`. Wenn from größer ist als to, muss der Wert des ersten Handles größer sein als der zweite und umgekehrt. Der Standardwert ist `0.0`.
Handle	Diese Eigenschaft enthält das erste Handle-Element.
visualPosition	Diese Eigenschaft enthält die visuelle Position des ersten Handles. Die Position wird als Bruchteil der Größe des Steuerelements ausgedrückt und liegt im Bereich `0.0 - 1.0`. Wenn das Steuerelement mirrored ist, ist der Wert gleich `1.0 - position`. Dadurch eignet sich der Wert zur Visualisierung des Schiebereglers, wobei die Unterstützung von rechts nach links berücksichtigt wird.
Position	Diese Eigenschaft enthält die logische Position des ersten Griffs. Die Position wird als Bruchteil der Größe des Steuerelements ausgedrückt und liegt im Bereich `0.0 - 1.0`. Für die Visualisierung eines Schiebereglers sollte stattdessen die Rechts-nach-Links-Unterstützung visualPosition verwendet werden.
gedrückt	Diese Eigenschaft gibt an, ob der erste Griff entweder durch Berührung, Maus oder Tasten gedrückt wird.
schwebte	Diese Eigenschaft zeigt an, ob der erste Griff mit dem Mauszeiger bewegt wird. Diese Eigenschaft wurde in QtQuick.Controls 2.1 eingeführt.
implicitHandleWidth	Diese Eigenschaft enthält die implizite Breite des ersten Griffs. Diese Eigenschaft wurde eingeführt in QtQuick. Controls 2.5.
implicitHandleHeight	Diese Eigenschaft enthält die implizite Höhe des ersten Griffs. Diese Eigenschaft wurde in QtQuick.Controls 2.5 eingeführt.

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

from : real

Diese Eigenschaft enthält den Startwert 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-Updates für die Eigenschaften first.value und second.value liefert, 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 enthält die Ausrichtung.

Mögliche Werte:

Konstant	Beschreibung
`Qt.Horizontal`	Horizontal (Standard)
`Qt.Vertical`	Vertikal

Siehe auch horizontal und vertical.

second group
second.handle : Item
second.hovered : bool
second.implicitHandleHeight : real
second.implicitHandleWidth : real
second.position : real
second.pressed : bool
second.value : real
second.visualPosition : real

Eigenschaft	Beschreibung
Wert	Diese Eigenschaft enthält den Wert des zweiten Handles im Bereich `from` - `to`. Wenn from größer ist als to, muss der Wert des ersten Handles größer sein als der des zweiten und umgekehrt. Der Standardwert ist `0.0`.
Handle	Diese Eigenschaft enthält das zweite Handle-Element.
visualPosition	Diese Eigenschaft enthält die visuelle Position des zweiten Handles. Die Position wird als Bruchteil der Größe des Steuerelements ausgedrückt und liegt im Bereich `0.0 - 1.0`. Wenn das Steuerelement mirrored ist, ist der Wert gleich `1.0 - position`. Dadurch eignet sich der Wert für die Visualisierung des Schiebereglers, wobei die Unterstützung von rechts nach links berücksichtigt wird.
Position	Diese Eigenschaft enthält die logische Position des zweiten Griffs. Die Position wird als Bruchteil der Größe des Steuerelements ausgedrückt, im Bereich `0.0 - 1.0`. Für die Visualisierung eines Schiebereglers sollte stattdessen die Rechts-nach-Links-Unterstützung visualPosition verwendet werden.
gedrückt	Diese Eigenschaft gibt an, ob der zweite Griff entweder durch Berührung, Maus oder Tasten gedrückt wird.
schwebte	Diese Eigenschaft gibt an, ob der zweite Griff mit dem Mauszeiger bewegt wird. Diese Eigenschaft wurde in QtQuick.Controls 2.1 eingeführt.
implicitHandleWidth	Diese Eigenschaft enthält die implizite Breite des zweiten Griffs. Diese Eigenschaft wurde eingeführt in QtQuick. Controls 2.5.
implicitHandleHeight	Diese Eigenschaft enthält die implizite Höhe des zweiten Griffs. Diese Eigenschaft wurde in QtQuick.Controls 2.5 eingeführt.

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:

Konstant	Beschreibung
`RangeSlider.NoSnap`	Der Schieberegler rastet nicht ein (Standard).
`RangeSlider.SnapAlways`	Der Schieberegler rastet beim Ziehen des Griffs ein.
`RangeSlider.SnapOnRelease`	Der Schieberegler rastet nicht ein, während er gezogen wird, sondern erst, wenn der Griff losgelassen wird.

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 legt fest, ob der Schieberegler vertikal ist.

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

Siehe auch orientation.

Signal-Dokumentation

[since QtQuick.Controls 2.5] void first.moved()

[since QtQuick.Controls 2.5] void second.moved()

Dieses Signal wird ausgegeben, wenn entweder der erste oder der zweite Handle durch den Benutzer interaktiv bewegt wurde, entweder durch Berührung, Maus oder Tasten.

Dieses QML-Signal wurde in QtQuick.Controls 2.5 eingeführt.

Siehe auch first und second.

Dokumentation der Methode

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, bzw. 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.

© 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.