Basiseingabe
RangeSlider Bereichsschieberegler
Zwei Ziehpunkte entlang einer Spur verschieben, um eine untere und obere Grenze festzulegen.
Beispiel
Die Eigenschaftsvorschau konnte nicht geladen werden. Wählen Sie „Eigenschaftsvorschau“, um es erneut zu versuchen.

Verwendung
Bereichsschieberegler mit Live-Werten
Legen Sie Grenzen mit setRange() und beide Endpunkte mit setValues() fest; valuesChanged sendet beim Ziehen das aktive Intervall (bei einem Mindestabstand von 0 können sich die Ziehpunkte berühren). Teilstriche erscheinen beim Daraufzeigen entlang der Spur.
#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;
auto* layout = new QVBoxLayout(this);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(8);
auto* slider = new RangeSlider(Qt::Horizontal, this);
slider->setAccessibleName("Price range");
slider->setRange(0, 100);
slider->setValues(20, 64);
slider->setMaximumWidth(260);
auto* status = new Label("Range: 20 to 64", this);
layout->addWidget(slider);
layout->addWidget(status);
connect(slider, &RangeSlider::valuesChanged,
status, [status](int lower, int upper) {
status->setText(QString("Range: %1 to %2").arg(lower).arg(upper));
});import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QVBoxLayout
layout = QVBoxLayout(root)
layout.setContentsMargins(0, 0, 0, 0)
layout.setSpacing(8)
slider = fluentqt.RangeSlider(Qt.Orientation.Horizontal)
slider.setAccessibleName('Price range')
slider.setRange(0, 100)
slider.setValues(20, 64)
slider.setMaximumWidth(260)
status = fluentqt.Label('Range: 20 to 64')
slider.valuesChanged.connect(
lambda lower, upper: status.setText(f"Range: {lower} to {upper}")
)
layout.addWidget(slider)
layout.addWidget(status)API
DeklarationKeine passenden API-Elemente.
fluent::basicinput::RangeSlider
Erbt von QWidget · FluentElement · QMLPlus
Fluent-Schieberegler mit zwei Reglern zur Auswahl eines unteren und oberen Werts.
Konstruktoren
Destruktoren
Enumerationen
enum class ThumbIdentifiziert einen der beiden Schieberegler-Griffe.
LowerUpper
Methoden
Qt::Orientation orientation() constAusrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.
void setOrientation(Qt::Orientation orientation)Ausrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.
int minimum() constKleinster auswählbarer Wert.
void setMinimum(int minimum)Kleinster auswählbarer Wert.
int maximum() constGrößter auswählbarer Wert.
void setMaximum(int maximum)Größter auswählbarer Wert.
void setRange(int minimum, int maximum)Setzt beide Grenzen; ein Maximum unterhalb des Minimums wird auf das Minimum gesetzt.
int lowerValue() constÜbernommener unterer Wert.
void setLowerValue(int value)Übernommener unterer Wert.
int upperValue() constÜbernommener oberer Wert.
void setUpperValue(int value)Übernommener oberer Wert.
void setValues(int lower, int upper)Setzt beide Werte gleichzeitig, sortiert sie und wendet minimumRange an.
int lowerPosition() constVisuelle untere Position; weicht nur beim Ziehen ohne tracking von lowerValue ab.
int upperPosition() constVisuelle obere Position; weicht nur beim Ziehen ohne tracking von upperValue ab.
int minimumRange() constKleinster zulässiger Abstand zwischen den beiden Werten; bei 0 können sich die Griffe berühren.
void setMinimumRange(int range)Kleinster zulässiger Abstand zwischen den beiden Werten; bei 0 können sich die Griffe berühren.
int singleStep() constSchrittweite für Pfeiltasten.
void setSingleStep(int step)Schrittweite für Pfeiltasten.
int pageStep() constSchrittweite für Bild auf und Bild ab.
void setPageStep(int step)Schrittweite für Bild auf und Bild ab.
QSlider::TickPosition tickPosition() constPosition der Teilstriche; Teilstriche erscheinen, wenn sich der Zeiger über dem Steuerelement befindet.
void setTickPosition(QSlider::TickPosition position)Position der Teilstriche; Teilstriche erscheinen, wenn sich der Zeiger über dem Steuerelement befindet.
int tickInterval() constTeilstrichabstand in Werten; 0 leitet ihn wie bei QSlider aus den Schritten ab.
void setTickInterval(int interval)Teilstrichabstand in Werten; 0 leitet ihn wie bei QSlider aus den Schritten ab.
bool hasTracking() constOb Werte schon beim Ziehen übernommen werden; bei false erfolgt die Übernahme beim Loslassen.
void setTracking(bool enabled)Ob Werte schon beim Ziehen übernommen werden; bei false erfolgt die Übernahme beim Loslassen.
Thumb activeThumb() constSchieberegler-Griff, der Tastatureingaben empfängt und über dem anderen gezeichnet wird.
void setActiveThumb(Thumb thumb)Schieberegler-Griff, der Tastatureingaben empfängt und über dem anderen gezeichnet wird.
bool isSliderDown() constOb ein Schiebereglergriff gezogen wird.
QPoint thumbCenter(Thumb thumb) constMittelpunkt des Schiebereglers in Widget-Koordinaten für Layout und Barrierefreiheit.
Eigenschaften
Qt::Orientation orientationAusrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.
Lesenorientation()SchreibensetOrientation()BenachrichtigungorientationChanged()int minimumKleinster auswählbarer Wert.
Lesenminimum()SchreibensetMinimum()BenachrichtigungrangeChanged()int maximumGrößter auswählbarer Wert.
Lesenmaximum()SchreibensetMaximum()BenachrichtigungrangeChanged()int lowerValueÜbernommener unterer Wert.
LesenlowerValue()SchreibensetLowerValue()BenachrichtigunglowerValueChanged()int upperValueÜbernommener oberer Wert.
LesenupperValue()SchreibensetUpperValue()BenachrichtigungupperValueChanged()int minimumRangeKleinster zulässiger Abstand zwischen den beiden Werten; bei 0 können sich die Griffe berühren.
LesenminimumRange()SchreibensetMinimumRange()BenachrichtigungminimumRangeChanged()int singleStepSchrittweite für Pfeiltasten.
LesensingleStep()SchreibensetSingleStep()BenachrichtigungsingleStepChanged()int pageStepSchrittweite für Bild auf und Bild ab.
LesenpageStep()SchreibensetPageStep()BenachrichtigungpageStepChanged()QSlider::TickPosition tickPositionPosition der Teilstriche; Teilstriche erscheinen, wenn sich der Zeiger über dem Steuerelement befindet.
LesentickPosition()SchreibensetTickPosition()BenachrichtigungtickPositionChanged()int tickIntervalTeilstrichabstand in Werten; 0 leitet ihn wie bei QSlider aus den Schritten ab.
LesentickInterval()SchreibensetTickInterval()BenachrichtigungtickIntervalChanged()bool trackingOb Werte schon beim Ziehen übernommen werden; bei false erfolgt die Übernahme beim Loslassen.
LesenhasTracking()SchreibensetTracking()BenachrichtigungtrackingChanged()Thumb activeThumbSchieberegler-Griff, der Tastatureingaben empfängt und über dem anderen gezeichnet wird.
LesenactiveThumb()SchreibensetActiveThumb()BenachrichtigungactiveThumbChanged()
Signale
void orientationChanged(Qt::Orientation orientation)Ausrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.
void rangeChanged(int minimum, int maximum)Kleinster auswählbarer Wert.
void lowerValueChanged(int value)Übernommener unterer Wert.
void upperValueChanged(int value)Übernommener oberer Wert.
void valuesChanged(int lower, int upper)Wird einmalig gesendet, nachdem sich einer der übernommenen Werte geändert hat.
void minimumRangeChanged(int range)Kleinster zulässiger Abstand zwischen den beiden Werten; bei 0 können sich die Griffe berühren.
void singleStepChanged(int step)Schrittweite für Pfeiltasten.
void pageStepChanged(int step)Schrittweite für Bild auf und Bild ab.
void tickPositionChanged(QSlider::TickPosition position)Position der Teilstriche; Teilstriche erscheinen, wenn sich der Zeiger über dem Steuerelement befindet.
void tickIntervalChanged(int interval)Teilstrichabstand in Werten; 0 leitet ihn wie bei QSlider aus den Schritten ab.
void trackingChanged(bool enabled)Ob Werte schon beim Ziehen übernommen werden; bei false erfolgt die Übernahme beim Loslassen.
void activeThumbChanged(Thumb thumb)Schieberegler-Griff, der Tastatureingaben empfängt und über dem anderen gezeichnet wird.
void sliderPressed()Wird gesendet, wenn ein Zeigerdruck einen Ziehvorgang startet.
void sliderMoved(int lower, int upper)Wird gesendet, wenn sich eine gezogene Position bewegt, unabhängig davon, ob tracking aktiviert ist.
void sliderReleased()Wird einmalig beim Beenden des Ziehens gesendet, nachdem die endgültigen Werte übernommen wurden.
Geschützte Elemente
Methoden
Geerbt von fluent::FluentElement
Enumerationen
enum ThemeGlobales visuelles Theme zum Auflösen von Design-Tokens.
Light = 0Dark = 1HighContrast = 2
Methoden
static void setTheme(Theme theme)Aktualisiert das globale Theme und benachrichtigt aktive FluentElement-Instanzen.
static void setThemeDeferred(Theme theme)Plant eine gebündelte Theme-Aktualisierung mit Priorität für sichtbare Elemente, ohne die aktuelle Interaktion zu blockieren.
static Theme currentTheme()Gibt das aktuell aktive globale Design zurück.
static bool themeUsesDarkAppearance(Theme theme)Gibt zurück, ob ein Theme Chrome und Material-Tokens auf dunklem Hintergrund verwendet.
static void refreshTheme()Sendet das aktuelle Theme nach einer Änderung von Design-Tokens erneut, um ein Neuzeichnen auszulösen.
static int themeGeneration()Monotoner Zähler zur Veraltungsprüfung, der bei jedem Designwechsel erhöht wird.
Theme effectiveTheme() constLöst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.
bool effectiveThemeUsesDarkAppearance() constGibt zurück, ob das effektive Theme dieses Elements Chrome auf dunklem Hintergrund verwendet.
bool setThemeOverrides(const QJsonObject& overrides)Ersetzt die selektiven Farb-, Radius- und Schrift-Token-Überschreibungen dieses Elements.
QJsonObject themeOverrides() constGibt die festgelegten Überschreibungen dieses Elements zurück.
void clearThemeOverrides()Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.
const Colors& themeColorsRef() constKopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.
Material::AcrylicToken themeAcrylic() constMaterial-, Höhenstufen- und adaptive Layout-Tokens.
QColor themeBackdrop(bool active) constBackdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.
virtual void onThemeUpdated()Wird nach einer Änderung des globalen Themes aufgerufen.
Typen und Aliase
struct ColorsAn Komponenten zurückgegebene Design-Token-Snapshots.
Geerbt von fluent::QMLPlus
Methoden
AnchorLayout::Anchors* anchors()Gibt veränderbare Anker für den QWidget-Host zurück.
void setState(const QString& name)Wendet einen registrierten Zustand anhand seines Namens an oder stellt den Standardzustand wieder her, wenn @p name leer ist. Unbekannte Namen werden ignoriert, und bestehende Bindungen werden beim Verlassen des Zustands wieder aufgenommen.
void addState(const QMLState& state)Registriert oder ersetzt eine benannte Zustandsdefinition; das Ersetzen des aktiven Zustands wendet diesen sofort an.
void evaluateStates()Wertet Zustandsbedingungen in Registrierungsreihenfolge neu aus und aktiviert den ersten Treffer oder den Standardzustand, wenn keiner zutrifft. Wird auch automatisch bei Benachrichtigungen abhängiger Eigenschaften ausgeführt; abgeleitete Zustände mit extend erben Änderungen der Vorgänger, sofern keine Zyklen vorliegen oder Vorgänger fehlen.
QMLPlusRuntime* runtime()Gibt den bei Bedarf erstellten Zustandsbeobachter im Besitz dieses Hosts zurück.
void setAnchors(const AnchorLayout::Anchors& anchors)Ersetzt alle Host-Anker und macht das übergeordnete Layout ungültig.
void resetAnchors()Löscht alle Host-Anker und invalidiert das übergeordnete Layout.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Bindet @p sourceProp von @p source über PropertyBinder::bind() an @p targetProp dieses QWidget-Hosts.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installiert eine verwaltete direkte Bindung auf diesem QWidget-Host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installiert einen C++-Ausdruck mit expliziten Abhängigkeiten auf diesem QWidget-Host.
void addTransition(const StateTransition& transition)Registriert einen Zustandsübergang in Prioritätsreihenfolge.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Setzt die Standardanimation, die beim Schreiben von @p propertyName über writeProperty() oder eine Bindung verwendet wird. Explizite StateTransition-Regeln haben Vorrang; direkte C++-Setter-Aufrufe werden nicht animiert.
void clearBehavior(const char* propertyName)Entfernt die Standardanimation für zukünftige verwaltete Schreibvorgänge.
bool writeProperty(const char* propertyName, const QVariant& value)Schreibt eine Host-Eigenschaft über Behavior, ohne deren Bindung zu entfernen.
Qt-Basisklassendokumentation: QWidget