Fluent-Qt

Basiseingabe

RangeSlider Bereichsschieberegler

Zwei Ziehpunkte entlang einer Spur verschieben, um eine untere und obere Grenze festzulegen.

Beispiel

RangeSlider Bereichsschieberegler: Bereichsschieberegler mit Live-Werten

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));
        });

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 Thumb

Identifiziert einen der beiden Schieberegler-Griffe.

  • Lower
  • Upper

Methoden

Qt::Orientation orientation() const

Ausrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.

void setOrientation(Qt::Orientation orientation)

Ausrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.

int minimum() const

Kleinster auswählbarer Wert.

void setMinimum(int minimum)

Kleinster auswählbarer Wert.

int maximum() const

Größ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() const

Visuelle untere Position; weicht nur beim Ziehen ohne tracking von lowerValue ab.

int upperPosition() const

Visuelle obere Position; weicht nur beim Ziehen ohne tracking von upperValue ab.

int minimumRange() const

Kleinster 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() const

Schrittweite für Pfeiltasten.

void setSingleStep(int step)

Schrittweite für Pfeiltasten.

int pageStep() const

Schrittweite für Bild auf und Bild ab.

void setPageStep(int step)

Schrittweite für Bild auf und Bild ab.

QSlider::TickPosition tickPosition() const

Position 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() const

Teilstrichabstand 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() const

Ob 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() const

Schieberegler-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() const

Ob ein Schiebereglergriff gezogen wird.

QPoint thumbCenter(Thumb thumb) const

Mittelpunkt des Schiebereglers in Widget-Koordinaten für Layout und Barrierefreiheit.

Eigenschaften

Qt::Orientation orientation

Ausrichtung der Spur; vertikale Schieberegler platzieren das Minimum unten.

Lesen orientation()Schreiben setOrientation()Benachrichtigung orientationChanged()
int minimum

Kleinster auswählbarer Wert.

Lesen minimum()Schreiben setMinimum()Benachrichtigung rangeChanged()
int maximum

Größter auswählbarer Wert.

Lesen maximum()Schreiben setMaximum()Benachrichtigung rangeChanged()
int lowerValue

Übernommener unterer Wert.

Lesen lowerValue()Schreiben setLowerValue()Benachrichtigung lowerValueChanged()
int upperValue

Übernommener oberer Wert.

Lesen upperValue()Schreiben setUpperValue()Benachrichtigung upperValueChanged()
int minimumRange

Kleinster zulässiger Abstand zwischen den beiden Werten; bei 0 können sich die Griffe berühren.

Lesen minimumRange()Schreiben setMinimumRange()Benachrichtigung minimumRangeChanged()
int singleStep

Schrittweite für Pfeiltasten.

Lesen singleStep()Schreiben setSingleStep()Benachrichtigung singleStepChanged()
int pageStep

Schrittweite für Bild auf und Bild ab.

Lesen pageStep()Schreiben setPageStep()Benachrichtigung pageStepChanged()
QSlider::TickPosition tickPosition

Position der Teilstriche; Teilstriche erscheinen, wenn sich der Zeiger über dem Steuerelement befindet.

Lesen tickPosition()Schreiben setTickPosition()Benachrichtigung tickPositionChanged()
int tickInterval

Teilstrichabstand in Werten; 0 leitet ihn wie bei QSlider aus den Schritten ab.

Lesen tickInterval()Schreiben setTickInterval()Benachrichtigung tickIntervalChanged()
bool tracking

Ob Werte schon beim Ziehen übernommen werden; bei false erfolgt die Übernahme beim Loslassen.

Lesen hasTracking()Schreiben setTracking()Benachrichtigung trackingChanged()
Thumb activeThumb

Schieberegler-Griff, der Tastatureingaben empfängt und über dem anderen gezeichnet wird.

Lesen activeThumb()Schreiben setActiveThumb()Benachrichtigung activeThumbChanged()

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 Theme

Globales visuelles Theme zum Auflösen von Design-Tokens.

  • Light = 0
  • Dark = 1
  • HighContrast = 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() const

Löst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.

bool effectiveThemeUsesDarkAppearance() const

Gibt 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() const

Gibt die festgelegten Überschreibungen dieses Elements zurück.

void clearThemeOverrides()

Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.

const Colors& themeColorsRef() const

Kopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.

Material::AcrylicToken themeAcrylic() const

Material-, Höhenstufen- und adaptive Layout-Tokens.

QColor themeBackdrop(bool active) const

Backdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.

virtual void onThemeUpdated()

Wird nach einer Änderung des globalen Themes aufgerufen.

Typen und Aliase

struct Colors

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

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