Back to Qt.io
Contact Us Blog Download Qt

QBoxSet Class

Die Klasse QBoxSet stellt ein Element in einem Box-and-Whiskers-Diagramm dar. Mehr...

Header: #include <QBoxSet>
In QML: BoxSet
Inherits: QObject

Öffentliche Typen

enum ValuePositions { LowerExtreme, LowerQuartile, Median, UpperQuartile, UpperExtreme }

Eigenschaften

Öffentliche Funktionen

QBoxSet(const QString label = QString(), QObject *parent = nullptr)
QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label = QString(), QObject *parent = nullptr)
virtual ~QBoxSet()
void append(const QList<qreal> &values)
void append(const qreal value)
qreal at(const int index) const
QBrush brush() const
void clear()
int count() const
QString label() const
QPen pen() const
void setBrush(const QBrush &brush)
void setLabel(const QString label)
void setPen(const QPen &pen)
void setValue(const int index, const qreal value)
QBoxSet &operator<<(const qreal &value)
qreal operator[](const int index) const

Signale

void brushChanged()
void cleared()
void clicked()
void doubleClicked()
void hovered(bool status)
void penChanged()
void pressed()
void released()
void valueChanged(int index)
void valuesChanged()

Detaillierte Beschreibung

Ein Box-and-Whiskers-Element ist eine grafische Darstellung eines Bereichs und dreier Medianwerte, die aus fünf verschiedenen Werten konstruiert wird. Es gibt zwei Möglichkeiten, die Werte zu spezifizieren. Die erste Möglichkeit ist die Verwendung eines Konstruktors oder Stream-Operators (<<). Die Werte müssen in der folgenden Reihenfolge angegeben werden: unteres Extrem, unteres Quartil, Median, oberes Quartil und oberes Extrem.

Die zweite Möglichkeit besteht darin, eine leere QBoxSet-Instanz zu erstellen und die Werte mit der Methode setValue() anzugeben.

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

Siehe auch QBoxPlotSeries.

Dokumentation zum Member-Typ

enum QBoxSet::ValuePositions

Dieser Enum-Typ definiert die Werte eines Box-and-Whiskers-Elements:

KonstanteWertBeschreibung
QBoxSet::LowerExtreme0Der kleinste Wert des Box-and-Whiskers-Elements.
QBoxSet::LowerQuartile1Der Medianwert der unteren Hälfte des Box-and-Whiskers-Elements.
QBoxSet::Median2Der Medianwert der Box-and-Whiskers-Position.
QBoxSet::UpperQuartile3Der Medianwert der oberen Hälfte der Box-and-Whiskers-Position.
QBoxSet::UpperExtreme4Der größte Wert der Box-and-Whiskers-Position.

Dokumentation der Eigenschaft

brush : QBrush

Diese Eigenschaft enthält den Pinsel, mit dem das Feld des Box-and-Whiskers-Elements gefüllt wird.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void brushChanged()

pen : QPen

Diese Eigenschaft enthält den Stift, der zum Zeichnen der Linien des Box-and-Whiskers-Elements verwendet wird.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void penChanged()

Member Function Dokumentation

[explicit] QBoxSet::QBoxSet(const QString label = QString(), QObject *parent = nullptr)

Konstruiert ein Box-and-Whiskers-Element mit dem optionalen Label label und dem übergeordneten Element parent.

[explicit] QBoxSet::QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label = QString(), QObject *parent = nullptr)

Konstruiert ein Box-and-Whiskers-Element mit den folgenden geordneten Werten: le gibt das untere Extrem an, lq das untere Quartil, m den Median, uq das obere Quartil und ue das obere Quartil. Optional können die Werte label und parent angegeben werden.

[virtual noexcept] QBoxSet::~QBoxSet()

Zerstört den Gegenstand Box-and-Whiskers.

void QBoxSet::append(const QList<qreal> &values)

Hängt eine Liste von reellen Werten, die durch values angegeben wird, an das Ende des Box-and-Whiskers-Elements an.

Siehe auch append().

void QBoxSet::append(const qreal value)

Hängt den durch value angegebenen neuen Wert an das Ende des Box-and-Whiskers-Elements an.

qreal QBoxSet::at(const int index) const

Gibt den Wert des durch index angegebenen Box-and-Whiskers-Elements zurück. Der Index kann durch die Verwendung von ValuePositions Aufzählungswerten angegeben werden. Liegt der Index außerhalb des zulässigen Bereichs, wird 0,0 zurückgegeben.

QBrush QBoxSet::brush() const

Gibt den Pinsel zurück, der zum Füllen des Box-and-Whiskers-Elements verwendet wird.

Hinweis: Getter-Funktion für die Eigenschaft brush.

Siehe auch setBrush().

[signal] void QBoxSet::brushChanged()

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

Hinweis: Benachrichtigungssignal für die Eigenschaft brush.

Siehe auch brush.

void QBoxSet::clear()

Setzt alle Werte des Elements "Box-and-Whiskers" auf 0.

[signal] void QBoxSet::cleared()

Dieses Signal wird ausgegeben, wenn alle Werte des Box-and-Whiskers-Elements auf 0 gesetzt werden.

[signal] void QBoxSet::clicked()

Dieses Signal wird ausgegeben, wenn der Benutzer auf ein Box-and-Whiskers-Element im Diagramm klickt.

int QBoxSet::count() const

Gibt die Anzahl der Werte zurück, die an das Box-and-Whiskers-Element angehängt wurden.

[signal] void QBoxSet::doubleClicked()

Dieses Signal wird ausgegeben, wenn der Benutzer auf ein Box-and-Whiskers-Element doppelt klickt.

[signal] void QBoxSet::hovered(bool status)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über ein Box-and-Whiskers-Element in einem Diagramm bewegt wird. Wenn die Maus über das Element bewegt wird, wechselt status zu true, und wenn die Maus wieder wegbewegt wird, wechselt sie zu false.

QString QBoxSet::label() const

Gibt die Bezeichnung der Kategorie des Box-and-Whiskers-Elements zurück.

Siehe auch setLabel().

QPen QBoxSet::pen() const

Gibt den Stift zurück, der zum Zeichnen des Box-and-Whiskers-Elements verwendet wurde.

Hinweis: Getter-Funktion für die Eigenschaft pen.

Siehe auch setPen().

[signal] void QBoxSet::penChanged()

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

Hinweis: Benachrichtigungssignal für die Eigenschaft pen.

Siehe auch pen.

[signal] void QBoxSet::pressed()

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

[signal] void QBoxSet::released()

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf einem Box-and-Whiskers-Element loslässt.

void QBoxSet::setBrush(const QBrush &brush)

Setzt den Pinsel, der zum Füllen des Box-and-Whiskers-Elements verwendet wird, auf brush.

Hinweis: Setter-Funktion für die Eigenschaft brush.

Siehe auch brush().

void QBoxSet::setLabel(const QString label)

Setzt die durch label angegebene Bezeichnung für die Kategorie des Box-and-Whiskers-Elements.

Siehe auch label().

void QBoxSet::setPen(const QPen &pen)

Setzt den Stift, der zum Zeichnen des Box-and-Whiskers-Elements verwendet wird, auf pen.

Hinweis: Setter-Funktion für die Eigenschaft pen.

Siehe auch pen().

void QBoxSet::setValue(const int index, const qreal value)

Setzt den durch value angegebenen Wert an der durch index angegebenen Position. Der Index kann mit Hilfe der Aufzählungswerte ValuePositions angegeben werden.

[signal] void QBoxSet::valueChanged(int index)

Dieses Signal wird ausgegeben, wenn der Wert des durch index angegebenen Box-and-Whiskers-Elements geändert wird.

Siehe auch at().

[signal] void QBoxSet::valuesChanged()

Dieses Signal wird ausgegeben, wenn sich mehrere Werte des Box-and-Whiskers-Elements ändern.

Siehe auch append().

QBoxSet &QBoxSet::operator<<(const qreal &value)

Ein einfacher Operator zum Anhängen des durch value angegebenen reellen Wertes an das Ende des Box-and-Whiskers-Elements.

Siehe auch append().

qreal QBoxSet::operator[](const int index) const

Gibt den Wert des durch index angegebenen Box-and-Whiskers-Elements zurück. Der Index kann durch die Verwendung von ValuePositions Aufzählungswerten angegeben werden. Liegt der Index außerhalb des zulässigen Bereichs, wird 0,0 zurückgegeben.

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