Back to Qt.io
Contact Us Blog Download Qt

Slider QML Type

Dient zur Auswahl eines Wertes durch Schieben eines Griffs entlang einer Spur. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Signale

  • moved() (since QtQuick.Controls 2.2 (Qt 5.9))

Methoden

Ausführliche Beschreibung

Slider wird verwendet, um einen Wert durch Verschieben eines Griffs entlang einer Spur auszuwählen.

Im folgenden Beispiel werden die benutzerdefinierten Werte from, value und to festgelegt:

Slider {
    from: 1
    value: 25
    to: 100
}

Die Eigenschaft position wird als ein Bruchteil der Größe des Steuerelements im Bereich 0.0 - 1.0 ausgedrückt. Die Eigenschaft visualPosition ist die gleiche, außer dass sie in einer Rechts-nach-Links-Anwendung umgekehrt ist. Die Eigenschaft visualPosition ist nützlich für die Positionierung des Griffs beim Styling von Schiebereglern. Im obigen Beispiel wird visualPosition in einer Links-nach-Rechts-Anwendung zu 0.24 und 0.76 in einer Rechts-nach-Links-Anwendung.

Für einen Schieberegler, der es dem Benutzer ermöglicht, einen Bereich auszuwählen, indem er zwei Griffe bereitstellt, siehe RangeSlider.

Siehe auch Anpassen von Schiebereglern und Eingabesteuerelementen.

Eigenschaft Dokumentation

from : real

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

Siehe auch to und value.


handle : Item

Diese Eigenschaft enthält das Handle-Element.

Siehe auch Schieberegler 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 gibt die implizite Griffhöhe an.

Der Wert ist gleich handle ? handle.implicitHeight : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentHeight und implicitBackgroundHeight verwendet, um 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 Griffbreite.

Der Wert ist gleich handle ? handle.implicitWidth : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentWidth und implicitBackgroundWidth verwendet, um 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 legt fest, ob der Schieberegler Live-Updates für die Eigenschaft value liefert, während der Griff gezogen wird.

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 enthält die Ausrichtung.

Mögliche Werte:

KonstantBeschreibung
Qt.HorizontalHorizontal (Standard)
Qt.VerticalVertikal

Siehe auch horizontal und vertical.


position : real [read-only]

Diese Eigenschaft enthält die logische Position des 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 das Rechts-nach-Links-Verhältnis visualPosition verwendet werden.

Siehe auch value, visualPosition, und valueAt().


pressed : bool

Diese Eigenschaft gibt an, ob der Schieberegler durch Berührung, mit der Maus oder mit den Tasten gedrückt wird.


snapMode : enumeration

Diese Eigenschaft enthält den Einrastmodus.

Der Fangmodus bestimmt, wie sich der Schiebereglergriff in Bezug auf stepSize verhält.

Mögliche Werte:

KonstantBeschreibung
Slider.NoSnapDer Schieberegler rastet nicht ein (Standard).
Slider.SnapAlwaysDer Schieberegler rastet beim Ziehen des Griffs ein.
Slider.SnapOnReleaseDer Schieberegler rastet nicht ein, während er gezogen wird, sondern erst, wenn der Griff losgelassen wird.

In der folgenden Tabelle sind die verschiedenen Modi mit Animationen dargestellt. Die Bewegung des Mauszeigers und die stepSize (0.2) sind in jeder Animation identisch.
WertBeispiel
Slider.NoSnap

Slider.SnapAlways

Slider.SnapOnRelease

Siehe auch stepSize.


stepSize : real

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

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


to : real

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

Siehe auch from und 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.


value : real

Diese Eigenschaft enthält den Wert im Bereich from - to. Der Standardwert ist 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 enthält die visuelle Position des Griffs.

Die Position wird als Bruchteil der Größe des Steuerelements ausgedrückt, 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.

Siehe auch position.


Signal-Dokumentation

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

Dieses Signal wird ausgegeben, wenn der Schieberegler vom Benutzer interaktiv bewegt wurde, entweder durch Berührung, Maus, Rad oder Tasten.

Hinweis: Der entsprechende Handler ist onMoved.

Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.


Dokumentation der Methode

void decrease()

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

Siehe auch stepSize.


void increase()

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

Siehe auch stepSize.


[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)

Gibt den Wert für die angegebene position zurück.

Diese Methode wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Siehe auch value und position.


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