Fluent-Qt

Diagramme

PieChart Kreisdiagramm

Zeigt den Anteil einzelner Teile an einer Gesamtsumme.

Beispiel

PieChart Kreisdiagramm: Traffic-Quellen

Verwendung

Traffic-Quellen

Ein ChartModel mit setModel() binden; ChartModel::setPoints() liefert Werte und Beschriftungen. Stellt positive Werte der ersten Datenreihe dar und fasst Einträge ab Zeile 12 zu einem Segment zusammen.

#include <FluentQt/Charts.h>
using namespace fluent::charts;

auto* chart = new PieChart(this);
chart->setObjectName("chartPresentation");
chart->setMinimumHeight(420);
chart->setTitle("Traffic sources");
chart->setSubtitle("Share of sessions");
auto* model = new ChartModel(chart);
model->setName("Primary");
model->setPoints({{0, 48.2}, {1, 26.8}, {2, 16.4}, {3, 8.6}}, {"Direct", "Search", "Referral", "Campaign"});
chart->setModel(model);

fluent::charts::PieChart

Erbt von ChartView

Kreisdiagramm-Widget auf Basis eines ChartModel (stellt nur die erste Reihe dar; bevorzugt setModel() verwenden).

Konstruktoren

Geerbt von fluent::charts::ChartView

Enumerationen

enum ChartType
  • Line
  • Area
  • Bar
  • HorizontalBar
  • Pie
  • Donut
  • Scatter
  • Sparkline

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

Einheitensuffix für Wertanzeigen (z. B. " ms" oder "%").

void setValueSuffix(const QString& suffix)

Einheitensuffix für Wertanzeigen (z. B. " ms" oder "%").

bool isLoading() const

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

Anzahl 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) const

Exportiert 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()Schreiben setChartType()Benachrichtigung chartTypeChanged()
QString title
Lesen title()Schreiben setTitle()Benachrichtigung titleChanged()
QString subtitle
Lesen subtitle()Schreiben setSubtitle()Benachrichtigung subtitleChanged()
QString valueSuffix

Einheitensuffix für Wertanzeigen (z. B. " ms" oder "%").

Lesen valueSuffix()Schreiben setValueSuffix()Benachrichtigung valueSuffixChanged()
QString centerText
Lesen centerText()Schreiben setCenterText()Benachrichtigung centerTextChanged()
QString centerCaption
Lesen centerCaption()Schreiben setCenterCaption()Benachrichtigung centerCaptionChanged()
bool loading

Zeigt einen Ladezustand an, während Daten extern vorbereitet werden.

Lesen isLoading()Schreiben setLoading()Benachrichtigung loadingChanged()
bool autoYRange
Lesen isAutoYRange()Benachrichtigung yRangeChanged()
bool legendVisible
Lesen isLegendVisible()Schreiben setLegendVisible()Benachrichtigung legendVisibleChanged()
int maximumPointCount
Lesen maximumPointCount()Schreiben setMaximumPointCount()Benachrichtigung maximumPointCountChanged()
int maximumFrameRate
Lesen maximumFrameRate()Schreiben setMaximumFrameRate()Benachrichtigung maximumFrameRateChanged()
bool autoRange
Lesen isAutoRange()Benachrichtigung xRangeChanged()

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