Slider QML Type
Dient zur Auswahl eines Werts durch Verschieben eines Schiebereglers entlang einer Schiene. Mehr...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Eigenschaften
- from : real
- handle : Item
- horizontal : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - implicitHandleHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitHandleWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - live : bool
(since QtQuick.Controls 2.2 (Qt 5.9)) - orientation : enumeration
- position : real
- pressed : bool
- snapMode : enumeration
- stepSize : real
- to : real
- touchDragThreshold : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - value : real
- vertical : bool
(since QtQuick.Controls 2.3 (Qt 5.10)) - visualPosition : real
Signale
- moved()
(since QtQuick.Controls 2.2 (Qt 5.9))
Methoden
Ausführliche Beschreibung
Der Schieberegler dient dazu, einen Wert durch Verschieben eines Schiebers entlang einer Schiene auszuwählen.
Im folgenden Beispiel werden benutzerdefinierte Werte für „ from “, „ value “ und „ to “ festgelegt:
Slider {
from: 1
value: 25
to: 100
}Die Eigenschaft „ position “ wird als Bruchteil der Größe des Steuerelements im Bereich von „ 0.0 - 1.0 “ angegeben. Die Eigenschaft „ visualPosition “ verhält sich genauso, ist jedoch in einer von rechts nach links laufenden Anwendung umgekehrt. Die Eigenschaft „ visualPosition “ ist nützlich, um den Schieberegler bei der Gestaltung des Sliders zu positionieren. Im obigen Beispiel entspricht „ visualPosition “ in einer von links nach rechts gerichteten Anwendung „ 0.24 “ und in einer von rechts nach links gerichteten Anwendung „ 0.76 “.
Informationen zu einem Schieberegler, bei dem der Benutzer mithilfe von zwei Schiebereglern einen Bereich auswählen kann, finden Sie unter RangeSlider.
Siehe auch „Anpassen von Schiebereglern und Eingabesteuerelementen“.
Dokumentation zu den Eigenschaften
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 das Handle-Element.
Siehe auch „Slider anpassen“.
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.
implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Diese Eigenschaft enthält die implizite Höhe des Handles.
Der Wert entspricht handle ? handle.implicitHeight : 0.
Sie wird in der Regel zusammen mit „ implicitContentHeight “ und „ implicitBackgroundHeight “ verwendet, um die „ implicitHeight “ zu berechnen.
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
Siehe auch implicitHandleWidth.
implicitHandleWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
Diese Eigenschaft enthält die implizite Handle-Breite.
Der Wert entspricht handle ? handle.implicitWidth : 0.
Sie wird typischerweise zusammen mit „ implicitContentWidth “ und „ implicitBackgroundWidth “ verwendet, um die „ implicitWidth “ zu berechnen.
Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.
Siehe auch implicitHandleHeight.
live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]
Diese Eigenschaft gibt an, ob der Schieberegler während des Ziehens des Schiebereglers 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 “ und „ valueAt()“.
orientation : enumeration
Diese Eigenschaft gibt die Ausrichtung an.
Mögliche Werte:
| Konstant | Beschreibung |
|---|---|
Qt.Horizontal | Horizontal (Standard) |
Qt.Vertical | Vertikal |
Siehe auch horizontal und vertical.
position : real [read-only]
Diese Eigenschaft gibt die logische Position des Schiebereglers an.
Die Position wird als Bruchteil der Größe des Steuerelements im Bereich 0.0 - 1.0 ausgedrückt. Zur Visualisierung eines Schiebereglers sollte stattdessen die rechts-nach-links-orientierte Eigenschaft „ visualPosition “ verwendet werden.
Siehe auch value, visualPosition und valueAt().
pressed : bool
Diese Eigenschaft gilt unabhängig davon, ob der Schieberegler per Touch, Maus oder Tastatur betätigt wird.
snapMode : enumeration
Diese Eigenschaft legt den Snap-Modus fest.
Der Einrastmodus bestimmt, wie sich der Schieberegler in Bezug auf die „ stepSize “ verhält.
Mögliche Werte:
| Konstant | Beschreibung |
|---|---|
Slider.NoSnap | Der Schieberegler rastet nicht ein (Standard). |
Slider.SnapAlways | Der Schieberegler rastet ein, während der Schieberegler gezogen wird. |
Slider.SnapOnRelease | Der Schieberegler rastet nicht während des Ziehens ein, sondern erst nach dem Loslassen des Griffs. |
In der folgenden Tabelle werden die verschiedenen Modi anhand von Animationen veranschaulicht. Die Bewegung des Mauszeigers und die „ stepSize “ (0.2) sind in jeder Animation identisch.
| Wert | Beispiel |
Slider.NoSnap | |
Slider.SnapAlways | |
Slider.SnapOnRelease |
Siehe auch stepSize.
stepSize : real
Diese Eigenschaft gibt die Schrittweite an. Der Standardwert lautet „ 0.0 “.
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 “.
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.
value : real
Diese Eigenschaft nimmt Werte im Bereich von from bis to an. Der Standardwert lautet 0.0.
Siehe auch position.
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.
visualPosition : real [read-only]
Diese Eigenschaft gibt die visuelle Position des Griffes an.
Die Position wird als Bruchteil der Größe des Steuerelements im Bereich 0.0 - 1.0 ausgedrückt. Wenn das Steuerelement auf „ mirrored “ gesetzt ist, entspricht der Wert 1.0 - position. Dadurch eignet sich der Wert für die Darstellung des Schiebereglers unter Berücksichtigung der Unterstützung für die Lesrichtung von rechts nach links.
Siehe auch position.
Signal-Dokumentation
[since QtQuick.Controls 2.2 (Qt 5.9)] moved()
Dieses Signal wird ausgelöst, wenn der Schieberegler vom Benutzer interaktiv bewegt wurde – sei es durch Berührung, Maus, Mausrad oder Tasten.
Hinweis: Der entsprechende Handler lautet „ onMoved “.
Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.
Methodendokumentation
void decrease()
Verringert den Wert um stepSize oder 0.1, falls stepSize nicht definiert ist.
Siehe auch stepSize.
void increase()
Erhöht den Wert um stepSize oder 0.1, falls stepSize nicht definiert ist.
Siehe auch stepSize.
[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)
Gibt den Wert für den angegebenen „ position “ zurück.
Diese Methode wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.
© 2026 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.
