QBoxPlotSeries Class
Die Klasse „QBoxPlotSeries“ stellt Daten in Box-and-Whiskers-Diagrammen dar. Mehr...
| Header: | #include <QBoxPlotSeries> |
| In QML: | BoxPlotSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
Öffentliche Funktionen
| QBoxPlotSeries(QObject *parent = nullptr) | |
| virtual | ~QBoxPlotSeries() |
| bool | append(QBoxSet *set) |
| bool | append(const QList<QBoxSet *> &sets) |
| bool | boxOutlineVisible() |
| QList<QBoxSet *> | boxSets() const |
| qreal | boxWidth() |
| QBrush | brush() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBoxSet *set) |
| QPen | pen() const |
| bool | remove(QBoxSet *set) |
| void | setBoxOutlineVisible(bool visible) |
| void | setBoxWidth(qreal width) |
| void | setBrush(const QBrush &brush) |
| void | setPen(const QPen &pen) |
| bool | take(QBoxSet *set) |
Neu implementierte öffentliche Funktionen
| virtual QAbstractSeries::SeriesType | type() const override |
Signale
| void | boxOutlineVisibilityChanged() |
| void | boxWidthChanged() |
| void | boxsetsAdded(const QList<QBoxSet *> &sets) |
| void | boxsetsRemoved(const QList<QBoxSet *> &sets) |
| void | brushChanged() |
| void | clicked(QBoxSet *boxset) |
| void | countChanged() |
| void | doubleClicked(QBoxSet *boxset) |
| void | hovered(bool status, QBoxSet *boxset) |
| void | penChanged() |
| void | pressed(QBoxSet *boxset) |
| void | released(QBoxSet *boxset) |
Ausführliche Beschreibung
Eine Boxplot-Reihe dient als Container für Box-and-Whiskers-Elemente. Elemente aus mehreren Reihen werden entsprechend ihres Indexwerts in Kategorien gruppiert.
Die Klasse „ QBarCategoryAxis “ wird verwendet, um die Kategorien zur Achse des Diagramms hinzuzufügen. Kategoriebezeichnungen müssen eindeutig sein. Wenn für mehrere Box-and-Whiskers-Elemente dieselbe Kategoriebezeichnung definiert ist, wird nur das erste Element gezeichnet.
In der Galerie „Diagramme mit Widgets “ erfahren Sie, wie Sie ein Box-and-Whiskers-Diagramm erstellen.

Siehe auch „ QBoxSet “ und „ QBarCategoryAxis “.
Dokumentation zu den Eigenschaften
boxOutlineVisible : bool
Diese Eigenschaft legt die Sichtbarkeit des Rahmenkonturs fest.
Zugriffsfunktionen:
| bool | boxOutlineVisible() |
| void | setBoxOutlineVisible(bool visible) |
Notifier-Signal:
| void | boxOutlineVisibilityChanged() |
boxWidth : qreal
Diese Eigenschaft gibt die Breite des Box-and-Whiskers-Elements an. Der Wert gibt die relative Breite des Elements innerhalb seiner Kategorie an. Der Wert kann zwischen 0,0 und 1,0 liegen. Negative Werte werden durch 0,0 ersetzt, und Werte größer als 1,0 werden durch 1,0 ersetzt.
Zugriffsfunktionen:
| qreal | boxWidth() |
| void | setBoxWidth(qreal width) |
Benachrichtigungssignal:
| void | boxWidthChanged() |
brush : QBrush
Diese Eigenschaft enthält den Pinsel, der zum Ausfüllen der Kästchen der Box-and-Whiskers-Elemente verwendet wird.
Zugriffsfunktionen:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Notifier-Signal:
| void | brushChanged() |
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Box-and-Whiskers-Elemente in einer Boxplot-Reihe an.
Zugriffsfunktionen:
| int | count() const |
Benachrichtigungssignal:
| void | countChanged() |
pen : QPen
Diese Eigenschaft enthält den Stift, mit dem die Linien der Box-and-Whiskers-Elemente gezeichnet wurden.
Zugriffsfunktionen:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Notifier-Signal:
| void | penChanged() |
Dokumentation der Member-Funktionen
[explicit] QBoxPlotSeries::QBoxPlotSeries(QObject *parent = nullptr)
Erstellt eine leere Boxplot-Reihe, die ein „ QObject “ ist und zu „ parent “ gehört.
[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()
Entfernt die Reihe aus dem Diagramm.
bool QBoxPlotSeries::append(QBoxSet *set)
Fügt der Reihe ein einzelnes Box-and-Whiskers-Element hinzu, das durch ` set ` angegeben wird, und übernimmt die Eigentumsrechte daran. Ist das Element null oder gehört es bereits zur Reihe, wird es nicht angehängt. Gibt ` true ` zurück, wenn das Anhängen erfolgreich war.
bool QBoxPlotSeries::append(const QList<QBoxSet *> &sets)
Fügt der Reihe eine Liste von Box-and-Whiskers-Elementen hinzu, die durch ` sets ` angegeben sind, und übernimmt die Verantwortung für diese. Ist die Liste null oder gehören die Elemente bereits zur Reihe, erfolgt kein Hinzufügen. Gibt ` true ` zurück, wenn das Hinzufügen erfolgreich war.
[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()
Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit des Rahmenkonturs ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ boxOutlineVisible “.
QList<QBoxSet *> QBoxPlotSeries::boxSets() const
Gibt eine Liste der Box-and-Whiskers-Elemente einer Boxplot-Reihe zurück. Die Eigentumsrechte an den Elementen bleiben erhalten.
[signal] void QBoxPlotSeries::boxWidthChanged()
Dieses Signal wird ausgegeben, wenn sich die Breite des Box-and-Whiskers-Elements ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ boxWidth “.
[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)
Dieses Signal wird ausgegeben, wenn die Liste der Box-and-Whiskers-Elemente, die über „ sets “ festgelegt wurde, zur Reihe hinzugefügt wird.
[signal] void QBoxPlotSeries::boxsetsRemoved(const QList<QBoxSet *> &sets)
Dieses Signal wird ausgegeben, wenn die durch „ sets “ angegebene Liste der Box-and-Whiskers-Elemente aus der Reihe entfernt wird.
[signal] void QBoxPlotSeries::brushChanged()
Dieses Signal wird ausgegeben, wenn sich der Pinsel ändert, der zum Ausfüllen der Kästchen der Box-and-Whiskers-Elemente verwendet wird.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ brush “.
void QBoxPlotSeries::clear()
Entfernt alle Box-and-Whiskers-Elemente aus der Reihe und löscht sie endgültig.
[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf das durch „ boxset “ angegebene Box-and-Whiskers-Element klickt.
int QBoxPlotSeries::count() const
Gibt die Anzahl der Box-and-Whiskers-Elemente in einer Boxplot-Reihe zurück.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[signal] void QBoxPlotSeries::countChanged()
Dieses Signal wird ausgegeben, wenn sich die Anzahl der Box-and-Whiskers-Elemente in der Reihe ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ count “.
[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf das durch „ boxset “ angegebene Box-and-Whiskers-Element doppelklickt.
[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über das durch „ boxset “ im Diagramm angegebene Box-and-Whiskers-Element bewegt wird. Wenn die Maus über das Element bewegt wird, wechselt die Farbe von „ status “ zu „ true “, und wenn die Maus wieder wegbewegt wird, wechselt sie zu „ false “.
bool QBoxPlotSeries::insert(int index, QBoxSet *set)
Fügt ein durch ` set ` angegebenes Box-and-Whiskers-Element an der durch ` index ` angegebenen Position in eine Reihe ein und übernimmt die Eigentumsrechte an diesem Element. Ist das Element null oder gehört es bereits zur Reihe, wird es nicht angehängt. Gibt ` true ` zurück, wenn das Einfügen erfolgreich war.
[signal] void QBoxPlotSeries::penChanged()
Dieses Signal wird ausgegeben, wenn sich der Stift ändert, mit dem die Linien der Box-and-Whiskers-Elemente gezeichnet werden.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ pen “.
[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf das durch „ boxset “ angegebene Box-and-Whiskers-Element klickt und die Maustaste gedrückt hält.
[signal] void QBoxPlotSeries::released(QBoxSet *boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer den Maustaste-Druck auf dem durch „ boxset “ im Diagramm angegebenen Box-and-Whiskers-Element loslässt.
bool QBoxPlotSeries::remove(QBoxSet *set)
Entfernt das durch ` set ` angegebene Box-and-Whiskers-Element aus der Reihe und löscht es dauerhaft, sofern das Entfernen erfolgreich war. Gibt ` true ` zurück, wenn das Element entfernt wurde.
bool QBoxPlotSeries::take(QBoxSet *set)
Entnimmt das durch „ set “ angegebene Box-and-Whiskers-Element aus der Serie. Das Element wird dabei nicht gelöscht.
Hinweis: Die Serie bleibt das übergeordnete Objekt des Elements. Sie müssen das übergeordnete Objekt festlegen, um die vollständige Eigentümerschaft zu übernehmen.
Gibt „ true “ zurück, wenn der Take-Vorgang erfolgreich war.
[override virtual] QAbstractSeries::SeriesType QBoxPlotSeries::type() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.
Gibt den Typ der Reihe zurück.
Siehe auch „ QAbstractSeries “ und „ SeriesType “.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.