Auf dieser Seite

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.

Box-and-Whiskers-Diagramm zum Vergleich der monatlichen Kursschwankungen zweier Unternehmen im Jahr 2012

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:

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:

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.