Auf dieser Seite

BoxPlotSeries QML Type

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

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

AbstractSeries

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)

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 BarCategoryAxis wird verwendet, um die Kategorien zur Achse des Diagramms hinzuzufügen. Kategoriebeschriftungen müssen eindeutig sein. Wenn dieselbe Kategoriebezeichnung für mehrere Box-and-Whiskers-Elemente definiert ist, wird nur das erste Element gezeichnet.

Der folgende QML-Codeausschnitt zeigt, wie man ein einfaches Box-and-Whiskers-Diagramm erstellt:

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 Boxplot-Diagramms, das ein Einkommen über fünf Monate von Januar bis Mai anzeigt


Siehe auch BoxSet und BarCategoryAxis.

Dokumentation der Eigenschaft

axisX : AbstractAxis

Die für die Reihe verwendete x-Achse. Wenn Sie sowohl axisX als auch axisXTop undefiniert lassen, wird eine BarCategoryAxis für die Reihe erstellt.

Siehe auch axisXTop.

axisXTop : AbstractAxis

Die für die Serie verwendete x-Achse, die oben in der Diagrammansicht gezeichnet wird.

Hinweis: Sie können nur entweder axisX oder axisXTop angeben, aber nicht beides.

Siehe auch axisX.

axisY : AbstractAxis

Die für die Reihe verwendete y-Achse. Wenn Sie sowohl axisY als auch axisYRight undefiniert lassen, wird eine ValueAxis für die Reihe erstellt.

Siehe auch axisYRight.

axisYRight : AbstractAxis

Die für die Serie verwendete y-Achse, die in der Diagrammansicht nach rechts gezeichnet wird.

Hinweis: Sie können nur entweder axisY oder axisYRight angeben, aber nicht beides.

Siehe auch axisY.

boxOutlineVisible : bool

Die Sichtbarkeit des Umrisses der Box.

boxWidth : real

Die Breite des Box-and-Whiskers-Elements. Der Wert gibt die relative Breite des Eintrags 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.

brushFilename : string

Der Name der Datei, die als Pinsel für die Serie verwendet wird.

count : int [read-only]

Die Anzahl der Box-and-Whiskers-Elemente in einer Boxplot-Reihe.

Signal-Dokumentation

boxsetsAdded(list sets)

Dieses Signal wird ausgegeben, wenn die durch sets angegebenen Box-and-Whiskers-Elemente zur Serie hinzugefügt werden.

Der entsprechende Signalhandler ist onBoxsetsAdded().

Hinweis: Der entsprechende Handler ist onBoxsetsAdded.

boxsetsRemoved(list sets)

Dieses Signal wird ausgegeben, wenn die durch sets angegebenen Box-and-Whiskers-Elemente aus der Serie entfernt werden.

Der entsprechende Signalhandler ist onBoxsetsRemoved().

Hinweis: Der entsprechende Handler ist onBoxsetsRemoved.

clicked(BoxSet boxset)

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

Der entsprechende Signalhandler ist onClicked().

Hinweis: Der entsprechende Handler ist onClicked.

doubleClicked(BoxSet boxset)

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

Der entsprechende Signalhandler ist onDoubleClicked().

Hinweis: Der entsprechende Handler ist onDoubleClicked.

hovered(bool status, BoxSet 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.

Der entsprechende Signalhandler ist onHovered().

Hinweis: Der entsprechende Handler ist onHovered.

pressed(BoxSet boxset)

Dieses Signal wird ausgegeben, wenn der Benutzer die boxset auf dem Diagramm drückt.

Der entsprechende Signalhandler ist onPressed.

Hinweis: Der entsprechende Handler ist onPressed.

released(BoxSet boxset)

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

Der entsprechende Signalhandler ist onReleased().

Hinweis: Der entsprechende Handler ist onReleased.

Dokumentation der Methode

void append(BoxSet box)

Fügt das durch box angegebene Box-and-Whiskers-Element an die Serie an.

void append(string label, VariantList values)

Fügt ein neues Box-and-Whiskers-Element mit der durch label angegebenen Bezeichnung und den durch values angegebenen Werten an die Serie an.

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 Serie und löscht sie dauerhaft.

void insert(int index, string label, VariantList values)

Fügt ein neues Box-and-Whiskers-Element mit der durch label angegebenen Bezeichnung und den durch values angegebenen Werten an der durch index angegebenen Position in die Serie ein.

void remove(QBoxSet boxset)

Entfernt das durch boxset angegebene Box-and-Whiskers-Element aus der Serie.

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