Auf dieser Seite

BoxPlotSeries QML Type

Stellt Daten in Box-and-Whiskers-Diagrammen dar. Mehr...

Import Statement: import QtCharts 2.12
In C++: QBoxPlotSeries
Inherits:

AbstractSeries

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Signale

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] }
    }
}

Screenshot eines Boxplots, der die Einkünfte über einen Zeitraum von fünf Monaten von Januar bis Mai darstellt


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.