Back to Qt.io
Contact Us Blog Download Qt

QBoxPlotSeries Class

Die Klasse QBoxPlotSeries stellt Daten in Box-and-Whiskers-Diagrammen dar. Mehr...

Header: #include <QBoxPlotSeries>
In QML: BoxPlotSeries
Inherits: QAbstractSeries

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)

Reimplementierte ö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)

Detaillierte Beschreibung

Eine Boxplot-Serie dient als Container für Box-and-Whiskers-Elemente. Elemente aus mehreren Serien werden entsprechend ihrem Indexwert in Kategorien gruppiert.

Die Klasse QBarCategoryAxis wird verwendet, um die Kategorien zur Achse des Diagramms hinzuzufügen. Kategoriebeschriftungen müssen eindeutig sein. Wenn dieselbe Kategoriebeschriftung für mehrere Box-and-Whiskers-Elemente definiert ist, wird nur das erste Element gezeichnet.

In der Galerie Diagramme mit Widgets erfahren Sie, wie Sie ein Box-and-Whiskers-Diagramm erstellen können.

Siehe auch QBoxSet und QBarCategoryAxis.

Dokumentation der Eigenschaft

boxOutlineVisible : bool

Diese Eigenschaft bestimmt die Sichtbarkeit des Umrisses der Box.

Zugriffsfunktionen:

bool boxOutlineVisible()
void setBoxOutlineVisible(bool visible)

Melder-Signal:

void boxOutlineVisibilityChanged()

boxWidth : qreal

Diese Eigenschaft enthält die Breite des Box-and-Whiskers-Elements. 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 und Werte größer als 1,0 durch 1,0 ersetzt.

Zugriffsfunktionen:

qreal boxWidth()
void setBoxWidth(qreal width)

Melder-Signal:

void boxWidthChanged()

brush : QBrush

Diese Eigenschaft enthält den Pinsel, der zum Füllen der Boxen der Box-and-Whiskers-Elemente verwendet wird.

Zugriffsfunktionen:

QBrush brush() const
void setBrush(const QBrush &brush)

Benachrichtigungssignal:

void brushChanged()

[read-only] count : const 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, der zum Zeichnen der Linien der Box-and-Whiskers-Elemente verwendet wird.

Zugriffsfunktionen:

QPen pen() const
void setPen(const QPen &pen)

Benachrichtigungssignal:

void penChanged()

Member Function Dokumentation

[explicit] QBoxPlotSeries::QBoxPlotSeries(QObject *parent = nullptr)

Konstruiert eine leere Boxplot-Reihe, die eine QObject und ein Kind von parent ist.

[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()

Entfernt die Serie aus dem Diagramm.

bool QBoxPlotSeries::append(QBoxSet *set)

Fügt der Serie ein einzelnes Box-and-Whiskers-Element hinzu, das durch set angegeben wird, und übernimmt die Eigentümerschaft an diesem Element. Wenn das Element null ist oder bereits zur Serie gehört, 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 Serie eine Liste von Box-and-Whiskers-Elementen hinzu, die durch sets angegeben wird, und übernimmt das Eigentum an ihnen. Wenn die Liste null ist oder die Elemente bereits zur Serie gehören, wird sie nicht angehängt. Gibt true zurück, wenn das Anhängen erfolgreich war.

[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit des Umrisses der Box ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft boxOutlineVisible.

QList<QBoxSet *> QBoxPlotSeries::boxSets() const

Liefert eine Liste von Box-and-Whiskers-Elementen in einer Boxplot-Serie. Behält die Eigentümerschaft der Elemente bei.

[signal] void QBoxPlotSeries::boxWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die Breite des Box-and-Whiskers-Elements ändert.

Hinweis: Meldesignal für die Eigenschaft boxWidth.

[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)

Dieses Signal wird ausgegeben, wenn die durch sets angegebene Liste von Box-and-Whiskers-Elementen zur Serie 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 zum Füllen der Boxen der Box-and-Whiskers-Elemente ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft brush.

void QBoxPlotSeries::clear()

Entfernt alle Box-and-Whiskers-Elemente aus der Serie und löscht sie dauerhaft.

[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf das durch boxset angegebene Box-and-Whiskers-Element im Diagramm 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 Serie ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft count.

[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf das durch boxset angegebene Box-and-Whiskers-Element im Diagramm doppelt klickt.

[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über das durch boxset angegebene Box-and-Whiskers-Element im Diagramm bewegt wird. Wenn die Maus über das Element bewegt wird, wird status zu true, und wenn die Maus wieder wegbewegt wird, wird sie zu false.

bool QBoxPlotSeries::insert(int index, QBoxSet *set)

Fügt ein durch set angegebenes Box-and-Whiskers-Element in eine Serie an der durch index angegebenen Position ein und übernimmt das Eigentum an dem Element. Wenn das Element null ist oder bereits zu der Serie gehört, wird es nicht eingefügt. Gibt true zurück, wenn das Einfügen erfolgreich war.

[signal] void QBoxPlotSeries::penChanged()

Dieses Signal wird ausgegeben, wenn sich der zum Zeichnen der Linien der Box-and-Whiskers-Elemente verwendete Stift ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft pen.

[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)

Dieses Signal wird ausgegeben, wenn der Benutzer auf das durch boxset angegebene Box-and-Whiskers-Element im Diagramm klickt und die Maustaste gedrückt hält.

[signal] void QBoxPlotSeries::released(QBoxSet *boxset)

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem Box-and-Whiskers-Element loslässt, das durch boxset im Diagramm angegeben ist.

bool QBoxPlotSeries::remove(QBoxSet *set)

Entfernt das durch set angegebene Box-and-Whiskers-Element aus der Serie und löscht es dauerhaft, wenn 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 nicht gelöscht.

Hinweis: Die Serie bleibt das übergeordnete Objekt des Elements. Sie müssen das übergeordnete Objekt festlegen, um den vollen Besitz zu übernehmen.

Gibt true zurück, wenn der Vorgang "take" erfolgreich war.

[override virtual] QAbstractSeries::SeriesType QBoxPlotSeries::type() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QAbstractSeries::type.

Gibt den Typ der Reihe zurück.

Siehe auch QAbstractSeries und SeriesType.

© 2025 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.