Fluent-Qt

Textfelder

NumberBox Zahlenfeld

Ein numerisches Eingabefeld mit Drehfeldschaltflächen und Unterstützung für Inline-Ausdrücke.

Beispiel

NumberBox Zahlenfeld: Wert durch Ziehen anpassen

Verwendung

Wert durch Ziehen anpassen

Ziehen Sie am Griff für eine Live-Vorschau. Shift ermöglicht feine Anpassungen; Escape stellt den Ausgangswert wieder her.

#include <FluentQt/TextFields.h>
using namespace fluent::textfields;

auto* number = new NumberBox(this);
number->setObjectName("scrubNumber");
number->setAccessibleName("Rotation angle");
number->setHeader("Rotation angle");
number->setRange(-180, 180);
number->setValue(30);
number->setScrubbingEnabled(true);
number->setScrubSensitivity(0.5);
number->setDisplayPrecision(1);
number->setFixedWidth(260);

fluent::textfields::NumberBox

Erbt von LineEdit

Numerisches LineEdit mit Wertgrenzen, Ausdrucksauswertung und Drehfeld-Schaltflächen.

Konstruktoren

Enumerationen

Methoden

double value() const

Aktueller vom Eingabefeld übernommener Zahlenwert.

void setValue(double value)

Aktueller vom Eingabefeld übernommener Zahlenwert.

double minimum() const

Untergrenze zur Begrenzung eingegebener und schrittweise geänderter Werte.

void setMinimum(double minimum)

Untergrenze zur Begrenzung eingegebener und schrittweise geänderter Werte.

double maximum() const

Obergrenze zum Begrenzen eingegebener und schrittweise geänderter Werte.

void setMaximum(double maximum)

Obergrenze zum Begrenzen eingegebener und schrittweise geänderter Werte.

double smallChange() const

Schrittweite für einen Klick auf eine Drehfeld-Schaltfläche oder einen kleinen Tastaturschritt.

void setSmallChange(double change)

Schrittweite für einen Klick auf eine Drehfeld-Schaltfläche oder einen kleinen Tastaturschritt.

double largeChange() const

Schrittweite für große Tastaturschritte.

void setLargeChange(double change)

Schrittweite für große Tastaturschritte.

QString header() const

Optionaler Beschriftungstext über der numerischen Eingabezeile.

void setHeader(const QString& header)

Optionaler Beschriftungstext über der numerischen Eingabezeile.

bool acceptsExpression() const

Ob eingegebene arithmetische Ausdrücke vor der Übernahme ausgewertet werden.

void setAcceptsExpression(bool accepts)

Ob eingegebene arithmetische Ausdrücke vor der Übernahme ausgewertet werden.

SpinButtonPlacementMode spinButtonPlacementMode() const

Platzierungsmodus für ausgeblendete, kompakte oder Inline-Drehfeld-Schaltflächen.

void setSpinButtonPlacementMode(SpinButtonPlacementMode mode)

Platzierungsmodus für ausgeblendete, kompakte oder Inline-Drehfeld-Schaltflächen.

QSize spinButtonSize() const

Größe externer Spin-Schaltflächen.

void setSpinButtonSize(const QSize& size)

Größe externer Spin-Schaltflächen.

QSize inlineSpinButtonSize() const

Größe integrierter Spin-Schaltflächen.

void setInlineSpinButtonSize(const QSize& size)

Größe integrierter Spin-Schaltflächen.

int spinButtonRightMargin() const

Rechtsseitiger Abstand zwischen Inline-Spin-Schaltflächen und dem Rahmen.

void setSpinButtonRightMargin(int margin)

Rechtsseitiger Abstand zwischen Inline-Spin-Schaltflächen und dem Rahmen.

int compactSpinButtonReservedWidth() const

Für kompakte Spin-Schaltflächen im Eingabefeld reservierte Breite.

void setCompactSpinButtonReservedWidth(int width)

Für kompakte Spin-Schaltflächen im Eingabefeld reservierte Breite.

int spinButtonSpacing() const

Abstand zwischen benachbarten Spin-Schaltflächen.

void setSpinButtonSpacing(int spacing)

Abstand zwischen benachbarten Spin-Schaltflächen.

int spinButtonTextGap() const

Abstand zwischen Textinhalt und integrierter Spin-Button-Darstellung.

void setSpinButtonTextGap(int gap)

Abstand zwischen Textinhalt und integrierter Spin-Button-Darstellung.

int spinButtonIconSize() const

Glyphengröße für die Pfeilsymbole der Drehfeld-Schaltflächen.

void setSpinButtonIconSize(int size)

Glyphengröße für die Pfeilsymbole der Drehfeld-Schaltflächen.

int displayPrecision() const

Anzahl der Nachkommastellen bei der Formatierung des Werts.

void setDisplayPrecision(int precision)

Anzahl der Nachkommastellen bei der Formatierung des Werts.

double formatStep() const

Schrittweite zur Normalisierung der Anzeigerundung nach Wertänderungen.

void setFormatStep(double step)

Schrittweite zur Normalisierung der Anzeigerundung nach Wertänderungen.

bool isScrubbingEnabled() const

Aktiviert den separaten horizontalen Ziehgriff; die Textauswahl bleibt unverändert.

void setScrubbingEnabled(bool enabled)

Aktiviert den separaten horizontalen Ziehgriff; die Textauswahl bleibt unverändert.

double scrubSensitivity() const

Werteinheiten pro logischem Pixel; muss endlich und positiv sein.

void setScrubSensitivity(double sensitivity)

Werteinheiten pro logischem Pixel; muss endlich und positiv sein.

bool isScrubbing() const

Ob aktuell ein Ziehvorgang aktiv ist.

QRect scrubHandleRect() const

Logische Griffgeometrie, leer im deaktivierten Zustand.

void cancelScrub()

Setzt einen aktiven Ziehvorgang zurück, einschließlich eines anfangs leeren Werts.

void commitInput()

Parst und übernimmt den aktuellen Text anhand von Grenzwerten und Ausdrucksregeln.

Eigenschaften

double value

Aktueller vom Eingabefeld übernommener Zahlenwert.

Lesen value()Schreiben setValue()Benachrichtigung valueChanged()
double minimum

Untergrenze zur Begrenzung eingegebener und schrittweise geänderter Werte.

Lesen minimum()Schreiben setMinimum()Benachrichtigung minimumChanged()
double maximum

Obergrenze zum Begrenzen eingegebener und schrittweise geänderter Werte.

Lesen maximum()Schreiben setMaximum()Benachrichtigung maximumChanged()
double smallChange

Schrittweite für einen Klick auf eine Drehfeld-Schaltfläche oder einen kleinen Tastaturschritt.

Lesen smallChange()Schreiben setSmallChange()Benachrichtigung smallChangeChanged()
double largeChange

Schrittweite für große Tastaturschritte.

Lesen largeChange()Schreiben setLargeChange()Benachrichtigung largeChangeChanged()
QString header

Optionaler Beschriftungstext über der numerischen Eingabezeile.

Lesen header()Schreiben setHeader()Benachrichtigung headerChanged()
bool acceptsExpression

Ob eingegebene arithmetische Ausdrücke vor der Übernahme ausgewertet werden.

Lesen acceptsExpression()Schreiben setAcceptsExpression()Benachrichtigung acceptsExpressionChanged()
SpinButtonPlacementMode spinButtonPlacementMode

Platzierungsmodus für ausgeblendete, kompakte oder Inline-Drehfeld-Schaltflächen.

Lesen spinButtonPlacementMode()Schreiben setSpinButtonPlacementMode()Benachrichtigung spinButtonPlacementModeChanged()
QSize spinButtonSize

Größe externer Spin-Schaltflächen.

Lesen spinButtonSize()Schreiben setSpinButtonSize()Benachrichtigung spinButtonSizeChanged()
QSize inlineSpinButtonSize

Größe integrierter Spin-Schaltflächen.

Lesen inlineSpinButtonSize()Schreiben setInlineSpinButtonSize()Benachrichtigung inlineSpinButtonSizeChanged()
int spinButtonRightMargin

Rechtsseitiger Abstand zwischen Inline-Spin-Schaltflächen und dem Rahmen.

Lesen spinButtonRightMargin()Schreiben setSpinButtonRightMargin()Benachrichtigung spinButtonRightMarginChanged()
int compactSpinButtonReservedWidth

Für kompakte Spin-Schaltflächen im Eingabefeld reservierte Breite.

Lesen compactSpinButtonReservedWidth()Schreiben setCompactSpinButtonReservedWidth()Benachrichtigung compactSpinButtonReservedWidthChanged()
int spinButtonSpacing

Abstand zwischen benachbarten Spin-Schaltflächen.

Lesen spinButtonSpacing()Schreiben setSpinButtonSpacing()Benachrichtigung spinButtonSpacingChanged()
int spinButtonTextGap

Abstand zwischen Textinhalt und integrierter Spin-Button-Darstellung.

Lesen spinButtonTextGap()Schreiben setSpinButtonTextGap()Benachrichtigung spinButtonTextGapChanged()
int spinButtonIconSize

Glyphengröße für die Pfeilsymbole der Drehfeld-Schaltflächen.

Lesen spinButtonIconSize()Schreiben setSpinButtonIconSize()Benachrichtigung spinButtonIconSizeChanged()
int displayPrecision

Anzahl der Nachkommastellen bei der Formatierung des Werts.

Lesen displayPrecision()Schreiben setDisplayPrecision()Benachrichtigung displayPrecisionChanged()
double formatStep

Schrittweite zur Normalisierung der Anzeigerundung nach Wertänderungen.

Lesen formatStep()Schreiben setFormatStep()Benachrichtigung formatStepChanged()
bool scrubbingEnabled

Aktiviert den separaten horizontalen Ziehgriff; die Textauswahl bleibt unverändert.

Lesen isScrubbingEnabled()Schreiben setScrubbingEnabled()Benachrichtigung scrubbingEnabledChanged()
double scrubSensitivity

Werteinheiten pro logischem Pixel; muss endlich und positiv sein.

Lesen scrubSensitivity()Schreiben setScrubSensitivity()Benachrichtigung scrubSensitivityChanged()
bool scrubbing

Ob aktuell ein Ziehvorgang aktiv ist.

Lesen isScrubbing()Benachrichtigung scrubbingChanged()

Signale

void valueChanged(double value)

Aktueller vom Eingabefeld übernommener Zahlenwert.

void minimumChanged(double minimum)

Untergrenze zur Begrenzung eingegebener und schrittweise geänderter Werte.

void maximumChanged(double maximum)

Obergrenze zum Begrenzen eingegebener und schrittweise geänderter Werte.

void smallChangeChanged(double change)

Schrittweite für einen Klick auf eine Drehfeld-Schaltfläche oder einen kleinen Tastaturschritt.

void largeChangeChanged(double change)

Schrittweite für große Tastaturschritte.

void headerChanged()

Optionaler Beschriftungstext über der numerischen Eingabezeile.

void acceptsExpressionChanged(bool accepts)

Ob eingegebene arithmetische Ausdrücke vor der Übernahme ausgewertet werden.

void spinButtonPlacementModeChanged(SpinButtonPlacementMode mode)

Platzierungsmodus für ausgeblendete, kompakte oder Inline-Drehfeld-Schaltflächen.

void spinButtonSizeChanged(const QSize& size)

Größe externer Spin-Schaltflächen.

void inlineSpinButtonSizeChanged(const QSize& size)

Größe integrierter Spin-Schaltflächen.

void spinButtonRightMarginChanged(int margin)

Rechtsseitiger Abstand zwischen Inline-Spin-Schaltflächen und dem Rahmen.

void compactSpinButtonReservedWidthChanged(int width)

Für kompakte Spin-Schaltflächen im Eingabefeld reservierte Breite.

void spinButtonSpacingChanged(int spacing)

Abstand zwischen benachbarten Spin-Schaltflächen.

void spinButtonTextGapChanged(int gap)

Abstand zwischen Textinhalt und integrierter Spin-Button-Darstellung.

void spinButtonIconSizeChanged(int size)

Glyphengröße für die Pfeilsymbole der Drehfeld-Schaltflächen.

void displayPrecisionChanged(int precision)

Anzahl der Nachkommastellen bei der Formatierung des Werts.

void formatStepChanged(double step)

Schrittweite zur Normalisierung der Anzeigerundung nach Wertänderungen.

void scrubbingEnabledChanged(bool enabled)

Aktiviert den separaten horizontalen Ziehgriff; die Textauswahl bleibt unverändert.

void scrubSensitivityChanged(double sensitivity)

Werteinheiten pro logischem Pixel; muss endlich und positiv sein.

void scrubbingChanged(bool scrubbing)

Ob aktuell ein Ziehvorgang aktiv ist.

void scrubStarted(double initialValue)

Wird gesendet, wenn ein Ziehvorgang zur Wertanpassung beginnt; valueChanged() meldet weiterhin laufende Änderungen.

void scrubFinished(double initialValue, double finalValue, bool canceled)

Wird gesendet, wenn ein Ziehvorgang zur Wertanpassung endet; bei Abbruch wird zuerst initialValue wiederhergestellt.

Geschützte Elemente

Methoden

Geerbt von fluent::textfields::LineEdit

Methoden

QMargins contentMargins() const

Inhaltsränder um den Text (horizontale Werte schließen den internen Texteinzug von Qt ein).

void setContentMargins(const QMargins& margins)

Inhaltsränder um den Text (horizontale Werte schließen den internen Texteinzug von Qt ein).

Typography::FontRole fontRole() const

Fluent-Typography-Voreinstellung für Text.

void setFontRole(Typography::FontRole role)

Fluent-Typography-Voreinstellung für Text.

bool isClearButtonEnabled() const

Ob die nachgestellte Löschen-Schaltfläche aktiviert ist.

void setClearButtonEnabled(bool enabled)

Ob die nachgestellte Löschen-Schaltfläche aktiviert ist.

int clearButtonSize() const

Größe der Löschen-Schaltfläche, standardmäßig 24 logische Pixel.

void setClearButtonSize(int size)

Größe der Löschen-Schaltfläche, standardmäßig 24 logische Pixel.

QPoint clearButtonOffset() const

Pixelversatz für die Löschen-Schaltfläche.

void setClearButtonOffset(const QPoint& offset)

Pixelversatz für die Löschen-Schaltfläche.

int focusedBorderWidth() const

Untere Rahmenbreite im fokussierten Zustand.

void setFocusedBorderWidth(int width)

Untere Rahmenbreite im fokussierten Zustand.

int unfocusedBorderWidth() const

Untere Rahmenbreite im nicht fokussierten Zustand; standardmäßig null (keine Unterstreichung).

void setUnfocusedBorderWidth(int width)

Untere Rahmenbreite im nicht fokussierten Zustand; standardmäßig null (keine Unterstreichung).

bool isFrameVisible() const

Ob LineEdit seinen Eingaberahmen und die Fokus-Unterstreichung zeichnet.

void setFrameVisible(bool visible)

Ob LineEdit seinen Eingaberahmen und die Fokus-Unterstreichung zeichnet.

void setTrailingText(const QString& text)

Zeigt ein Klartext-Suffix am hinteren Rand an und ersetzt ein vorhandenes nachgestelltes Widget.

bool setTrailingWidget(QWidget* widget, WidgetOwnership ownership)

Setzt ein benutzerdefiniertes nachgestelltes Widget und legt die Bereinigung über WidgetOwnership fest (lehnt sich selbst oder Vorfahren ab). Vor dem Wechsel des Eigentumsmodus takeTrailingWidget() aufrufen.

QWidget* takeTrailingWidget()

Entfernt das nachgestellte Widget und gibt es zur Verwaltung oder Löschung durch den Aufrufer zurück.

void releaseTrailingWidget()

Entfernt das nachgestellte Widget und bereinigt es gemäß seinem WidgetOwnership-Modus.

Eigenschaften

QMargins contentMargins

Inhaltsränder um den Text (horizontale Werte schließen den internen Texteinzug von Qt ein).

Lesen contentMargins()Schreiben setContentMargins()Benachrichtigung contentMarginsChanged()
Typography::FontRole fontRole

Fluent-Typography-Voreinstellung für Text.

Lesen fontRole()Schreiben setFontRole()Benachrichtigung fontRoleChanged()
bool clearButtonEnabled

Ob die nachgestellte Löschen-Schaltfläche aktiviert ist.

Lesen isClearButtonEnabled()Schreiben setClearButtonEnabled()Benachrichtigung clearButtonEnabledChanged()
int clearButtonSize

Größe der Löschen-Schaltfläche, standardmäßig 24 logische Pixel.

Lesen clearButtonSize()Schreiben setClearButtonSize()Benachrichtigung clearButtonSizeChanged()
QPoint clearButtonOffset

Pixelversatz für die Löschen-Schaltfläche.

Lesen clearButtonOffset()Schreiben setClearButtonOffset()Benachrichtigung clearButtonOffsetChanged()
int focusedBorderWidth

Untere Rahmenbreite im fokussierten Zustand.

Lesen focusedBorderWidth()Schreiben setFocusedBorderWidth()Benachrichtigung focusedBorderWidthChanged()
int unfocusedBorderWidth

Untere Rahmenbreite im nicht fokussierten Zustand; standardmäßig null (keine Unterstreichung).

Lesen unfocusedBorderWidth()Schreiben setUnfocusedBorderWidth()Benachrichtigung unfocusedBorderWidthChanged()
bool frameVisible

Ob LineEdit seinen Eingaberahmen und die Fokus-Unterstreichung zeichnet.

Lesen isFrameVisible()Schreiben setFrameVisible()Benachrichtigung frameVisibleChanged()
QString trailingText
Lesen trailingText()Schreiben setTrailingText()Benachrichtigung trailingTextChanged()
QWidget* trailingWidget
Lesen trailingWidget()Benachrichtigung trailingWidgetChanged()
fluent::WidgetOwnership trailingWidgetOwnership
Lesen trailingWidgetOwnership()Benachrichtigung trailingWidgetOwnershipChanged()
QString clearButtonAccessibleName
Lesen clearButtonAccessibleName()Schreiben setClearButtonAccessibleName()Benachrichtigung clearButtonAccessibleNameChanged()
Qt::FocusPolicy clearButtonFocusPolicy
Lesen clearButtonFocusPolicy()Schreiben setClearButtonFocusPolicy()Benachrichtigung clearButtonFocusPolicyChanged()

Signale

void contentMarginsChanged()

Inhaltsränder um den Text (horizontale Werte schließen den internen Texteinzug von Qt ein).

void fontRoleChanged()

Fluent-Typography-Voreinstellung für Text.

void clearButtonEnabledChanged()

Ob die nachgestellte Löschen-Schaltfläche aktiviert ist.

void clearButtonSizeChanged()

Größe der Löschen-Schaltfläche, standardmäßig 24 logische Pixel.

void clearButtonOffsetChanged()

Pixelversatz für die Löschen-Schaltfläche.

void focusedBorderWidthChanged()

Untere Rahmenbreite im fokussierten Zustand.

void unfocusedBorderWidthChanged()

Untere Rahmenbreite im nicht fokussierten Zustand; standardmäßig null (keine Unterstreichung).

void frameVisibleChanged()

Ob LineEdit seinen Eingaberahmen und die Fokus-Unterstreichung zeichnet.

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: QLineEdit