BoxPlotSeries QML Type
Stellt Daten in Box-and-Whiskers-Diagrammen dar. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QBoxPlotSeries |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- boxOutlineVisible : bool
- boxWidth : real
- brushFilename : string
- count : int
Signale
- boxsetsAdded(list sets)
- boxsetsRemoved(list sets)
- clicked(BoxSet boxset)
- doubleClicked(BoxSet boxset)
- hovered(bool status, BoxSet boxset)
- pressed(BoxSet boxset)
- released(BoxSet boxset)
Methoden
- void append(BoxSet box)
- void append(string label, VariantList values)
- BoxSet at(int index)
- void clear()
- void insert(int index, string label, VariantList values)
- void remove(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 „ BarCategoryAxis “ 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.
Der folgende QML-Codeausschnitt zeigt, wie ein einfaches Box-and-Whiskers-Diagramm erstellt wird:
import QtQuick 2.0
import QtCharts 2.0
ChartView {
title: "Box Plot series"
width: 400
height: 300
theme: ChartView.ChartThemeBrownSand
legend.alignment: Qt.AlignBottom
BoxPlotSeries {
id: plotSeries
name: "Income"
BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] }
BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] }
BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] }
BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] }
BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] }
}
}
Siehe auch „ BoxSet “ und „ BarCategoryAxis “.
Dokumentation zu den Eigenschaften
axisX : AbstractAxis
Die für die Reihe verwendete x-Achse. Wenn Sie sowohl „axisX“ als auch „ axisXTop “ nicht definieren, wird für die Reihe eine „BarCategoryAxis“ erstellt.
Siehe auch „ axisXTop “.
axisXTop : AbstractAxis
Die für die Reihe verwendete x-Achse, die über der Diagrammansicht eingezeichnet wird.
Hinweis: Sie können entweder „ axisX “ oder „axisXTop“ angeben, jedoch nicht beides.
Siehe auch „ axisX “.
axisY : AbstractAxis
Die für die Reihe verwendete y-Achse. Wenn Sie sowohl „axisY“ als auch „ axisYRight “ nicht definieren, wird für die Reihe eine „ValueAxis“ erstellt.
Siehe auch „ axisYRight “.
axisYRight : AbstractAxis
Die für die Reihe verwendete y-Achse, die in der Diagrammansicht nach rechts verläuft.
Hinweis: Sie können entweder „ axisY “ oder „axisYRight“ angeben, jedoch nicht beides.
Siehe auch „ axisY “.
boxOutlineVisible : bool
Die Sichtbarkeit des Rahmenumrisses.
boxWidth : real
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 ersetzt, und Werte größer als 1,0 werden durch 1,0 ersetzt.
brushFilename : string
Der Name der Datei, die als Pinsel für die Serie verwendet wird.
count : int [read-only]
Die Anzahl der Einträge in einer Boxplot-Reihe.
Signal-Dokumentation
boxsetsAdded(list sets)
Dieses Signal wird ausgelöst, wenn die durch „ sets “ angegebenen Box-and-Whiskers-Elemente zur Reihe hinzugefügt werden.
Der entsprechende Signal-Handler ist „ onBoxsetsAdded() “.
Hinweis: Der entsprechende Handler lautet „ onBoxsetsAdded “.
boxsetsRemoved(list sets)
Dieses Signal wird ausgelöst, wenn die durch „ sets “ angegebenen Box-and-Whiskers-Elemente aus der Reihe entfernt werden.
Der zugehörige Signal-Handler ist „ onBoxsetsRemoved() “.
Hinweis: Der entsprechende Handler ist „ onBoxsetsRemoved “.
clicked(BoxSet boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf das durch boxset angegebene Box-and-Whiskers-Element klickt.
Der zugehörige Signal-Handler lautet „ onClicked() “.
Hinweis: Der zugehörige Handler lautet „ onClicked “.
doubleClicked(BoxSet boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf das durch „ boxset “ angegebene Box-and-Whiskers-Element doppelklickt.
Der zugehörige Signal-Handler lautet „ onDoubleClicked() “.
Hinweis: Der zugehörige Handler lautet „ onDoubleClicked “.
hovered(bool status, BoxSet boxset)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über das durch „ boxset “ im Diagramm angegebene Box-and-Whiskers-Element bewegt wird. Wenn der Mauszeiger über das Element bewegt wird, wechselt „ status “ zu „ true “, und wenn der Mauszeiger wieder wegbewegt wird, wechselt es zu „ false “.
Der zugehörige Signal-Handler ist onHovered().
Hinweis: Der zugehörige Handler lautet „ onHovered “.
pressed(BoxSet boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer auf das Symbol „ boxset “ im Chart klickt.
Der entsprechende Signal-Handler lautet „ onPressed “.
Hinweis: Der entsprechende Handler ist „ onPressed “.
released(BoxSet boxset)
Dieses Signal wird ausgelöst, wenn der Benutzer den Maustaste-Druck auf das durch „ boxset “ im Diagramm angegebene Box-and-Whiskers-Element loslässt.
Der zugehörige Signal-Handler lautet „ onReleased() “.
Hinweis: Der entsprechende Handler lautet „ onReleased “.
Methodendokumentation
void append(BoxSet box)
Fügt das durch „ box “ angegebene Box-and-Whiskers-Element zur Reihe hinzu.
void append(string label, VariantList values)
Fügt der Reihe ein neues Box-and-Whiskers-Element mit der in „ label “ angegebenen Bezeichnung und den in „ values “ angegebenen Werten hinzu.
BoxSet at(int index)
Gibt das Box-and-Whiskers-Element an der durch ` index` angegebenen Position zurück.
void clear()
Entfernt alle Box-and-Whiskers-Elemente aus der Reihe und löscht sie endgültig.
void insert(int index, string label, VariantList values)
Fügt ein neues Box-and-Whiskers-Element mit der durch ` label ` angegebenen Beschriftung und den durch ` values ` angegebenen Werten an der durch ` index` angegebenen Position in die Reihe ein.
void remove(QBoxSet boxset)
Entfernt das durch „ boxset “ angegebene Box-and-Whiskers-Element aus der Reihe.
© 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.