Diagramme
Sparkline Mini-Trendlinie
Eine kompakte Trendlinie ohne Achsen, ideal für Karten und Tabellen.
Beispiel
Die Eigenschaftsvorschau konnte nicht geladen werden. Wählen Sie „Eigenschaftsvorschau“, um es erneut zu versuchen.

Verwendung
Aktueller Trend
Mit einer kleinen festen Größe verwenden und Daten über setModel() binden. Da keine sichtbare Textbeschriftung vorhanden ist, empfiehlt sich ein barrierefreier Name über setAccessibleName().
#include <FluentQt/Charts.h>
using namespace fluent::charts;
auto* chart = new Sparkline(this);
chart->setObjectName("chartPresentation");
chart->setFixedSize(220, 56);
chart->setAccessibleName("Recent trend");
auto* model = new ChartModel(chart);
model->setName("Primary");
model->setPoints({{0, 20}, {1, 26}, {2, 22}, {3, 32}, {4, 28}, {5, 36}, {6, 33}, {7, 42}, {8, 38}, {9, 47}, {10, 42}, {11, 50}});
chart->setModel(model);import fluentqt
from PySide6.QtCore import QPointF
chart = fluentqt.Sparkline()
chart.setObjectName("chartPresentation")
chart.setFixedSize(220, 56)
chart.setAccessibleName("Recent trend")
model = fluentqt.ChartModel(chart)
model.setName("Primary")
values = [20, 26, 22, 32, 28, 36, 33, 42, 38, 47, 42, 50]
model.setPoints([QPointF(i, y) for i, y in enumerate(values)])
chart.setModel(model)API
DeklarationKeine passenden API-Elemente.
fluent::charts::Sparkline
Erbt von ChartView
Kompaktes Sparkline-Diagramm-Widget auf Basis eines ChartModel.
Konstruktoren
Geerbt von fluent::charts::ChartView
Enumerationen
enum ChartTypeLineAreaBarHorizontalBarPieDonutScatterSparkline
Methoden
void setModel(ChartModel* model)Setzt ein einzelnes Diagrammmodell (weiterhin vom Aufrufer verwaltet); nullptr zum Leeren übergeben.
bool addSeries(ChartModel* model)Fügt ein Reihenmodell hinzu (bis zu 32, vom Aufrufer verwaltet); Duplikate werden ignoriert. Pie und Donut rendern nur seriesModel(0); für diese Typen ist setModel() vorzuziehen.
void setChartType(ChartType type)Ändert den Diagrammtyp einer generischen ChartView; dedizierte Unterklassen behalten einen festen Typ.
QString valueSuffix() constEinheitensuffix für Wertanzeigen (z. B. " ms" oder "%").
void setValueSuffix(const QString& suffix)Einheitensuffix für Wertanzeigen (z. B. " ms" oder "%").
bool isLoading() constZeigt einen Ladezustand an, während Daten extern vorbereitet werden.
void setLoading(bool loading)Zeigt einen Ladezustand an, während Daten extern vorbereitet werden.
void setYRange(double minimum, double maximum)Setzt einen endlichen, steigenden Y-Bereich (z. B. [0, 100]); ungültige Bereiche werden ignoriert.
void setMaximumPointCount(int count)Setzt das Budget für abgetastete Punkte in [512, 65536], begrenzt durch die Breite des Ansichtsfensters.
void setMaximumFrameRate(int rate)Drosselt Modellaktualisierungen auf [1, 60] Hz; ausgeblendete Diagramme pausieren Aktualisierungen.
void setXRange(double minimum, double maximum)Setzt einen endlichen, steigenden X-Bereich; ungültige Bereiche werden ignoriert.
void setCurrentPoint(int series, int row)Verschiebt den Datencursor auf eine Datenreihenzeile; -1 zum Löschen übergeben.
int renderedPointCount() constAnzahl der abgetasteten Punkte aus dem letzten Zeichendurchgang.
QImage exportImage(double scale = 1.0)Exportiert das Diagrammbild im angegebenen Skalierungsfaktor (ohne Hover-Cursor oder Fokusrahmen); im GUI-Thread aufrufen.
QByteArray exportPng(double scale = 1.0)Kodiert exportImage() als PNG-Bytes und gibt bei einem Fehler ein leeres Ergebnis zurück.
QByteArray exportCsv(bool visibleRangeOnly = false) constExportiert rohe Modellzeilen als UTF-8-CSV (Spalten: series, name, x, y, label, unit); im GUI-Thread aufrufen. Mit visibleRangeOnly = true lassen sich kartesische Diagramme auf den aktuellen X-Bereich beschränken.
void copyImage(double scale = 1.0)Kopiert das Diagramm-PNG in die Zwischenablage und sendet imageCopied().
void copyData(bool visibleRangeOnly = false)Kopiert exportierte CSV-Zeilen in die Zwischenablage und sendet dataCopied(). Muss im GUI-Thread aufgerufen werden (Aufrufe außerhalb dieses Threads senden dataCopied(false)).
Eigenschaften
ChartType chartType- Lesen
chartType()SchreibensetChartType()BenachrichtigungchartTypeChanged() QString title- Lesen
title()SchreibensetTitle()BenachrichtigungtitleChanged() QString subtitle- Lesen
subtitle()SchreibensetSubtitle()BenachrichtigungsubtitleChanged() QString valueSuffixEinheitensuffix für Wertanzeigen (z. B. " ms" oder "%").
LesenvalueSuffix()SchreibensetValueSuffix()BenachrichtigungvalueSuffixChanged()QString centerText- Lesen
centerText()SchreibensetCenterText()BenachrichtigungcenterTextChanged() QString centerCaption- Lesen
centerCaption()SchreibensetCenterCaption()BenachrichtigungcenterCaptionChanged() bool loadingZeigt einen Ladezustand an, während Daten extern vorbereitet werden.
LesenisLoading()SchreibensetLoading()BenachrichtigungloadingChanged()bool autoYRange- Lesen
isAutoYRange()BenachrichtigungyRangeChanged() bool legendVisible- Lesen
isLegendVisible()SchreibensetLegendVisible()BenachrichtigunglegendVisibleChanged() int maximumPointCount- Lesen
maximumPointCount()SchreibensetMaximumPointCount()BenachrichtigungmaximumPointCountChanged() int maximumFrameRate- Lesen
maximumFrameRate()SchreibensetMaximumFrameRate()BenachrichtigungmaximumFrameRateChanged() bool autoRange- Lesen
isAutoRange()BenachrichtigungxRangeChanged()
Signale
void valueSuffixChanged(const QString& suffix)Einheitensuffix für Wertanzeigen (z. B. " ms" oder "%").
void loadingChanged(bool loading)Zeigt einen Ladezustand an, während Daten extern vorbereitet werden.
void rangeActivated(int series, int first, int last)Wird gesendet, wenn ein angezeigter Punkt oder ein Bereich [first, last) aktiviert wird.
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