BoxPlotSeries QML Type
以箱线图形式展示数据。更多...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QBoxPlotSeries |
| Inherits: | |
| Status: | Deprecated |
此类型已弃用。我们强烈建议在新代码中不要使用它。
属性
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- boxOutlineVisible : bool
- boxWidth : real
- brushFilename : string
- count : int
信号
- boxsetsAdded(list sets)
- boxsetsRemoved(list sets)
- clicked(BoxSet boxset)
- doubleClicked(BoxSet boxset)
- hovered(bool status, BoxSet boxset)
- pressed(BoxSet boxset)
- released(BoxSet boxset)
方法
- 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)
详细说明
箱线图系列作为箱线图数据项的容器。来自多个系列的数据项将根据其索引值被分组到不同的类别中。
BarCategoryAxis 类用于将类别添加到图表的坐标轴上。类别标签必须是唯一的。如果为多个箱线图数据点定义了相同的类别标签,则仅绘制第一个数据点。
以下 QML 代码片段演示了如何创建一个简单的箱线图:
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] }
}
}
另请参阅 BoxSet 和BarCategoryAxis 。
属性文档
axisX : AbstractAxis
该系列使用的x轴。如果同时未定义axisX和axisXTop ,则会为该系列创建一个BarCategoryAxis。
另请参阅 axisXTop 。
axisXTop : AbstractAxis
绘制在图表视图顶部的、用于该数据系列的x轴。
注意:您 只能指定axisX 或 axisXTop 其中之一,不能同时指定两者。
另请参阅 axisX 。
axisY : AbstractAxis
该系列使用的y轴。如果同时未定义axisY和axisYRight ,系统会为该系列创建一个ValueAxis。
另请参阅 axisYRight 。
axisYRight : AbstractAxis
该数据系列所使用的y轴,在图表视图中向右绘制。
注意:您 只能指定axisY 或 axisYRight 其中之一,不能同时指定两者。
另请参阅 axisY 。
boxOutlineVisible : bool
框线的外观可见性。
boxWidth : real
箱线图中各条目的宽度。该值表示该条目在其所属类别中的相对宽度。该值范围为 0.0 到 1.0。负值将被替换为 0.0,大于 1.0 的值将被替换为 1.0。
brushFilename : string
该系列中用作画笔的文件名称。
count : int [read-only]
箱线图系列中各数据点的数量。
Signal 文档
boxsetsAdded(list sets)
当将由 `sets ` 指定的箱线图数据项添加到系列中时,会触发此信号。
相应的信号处理程序为onBoxsetsAdded() 。
注意: 相应的处理程序 是onBoxsetsAdded 。
boxsetsRemoved(list sets)
当由 `sets ` 指定的箱线图数据项从序列中移除时,会触发此信号。
相应的信号处理程序为onBoxsetsRemoved() 。
注意: 相应的处理程序 为onBoxsetsRemoved 。
clicked(BoxSet boxset)
当用户在图表中点击由boxset 指定的箱线图项时,会触发此信号。
相应的信号处理程序为onClicked() 。
注意: 相应的处理程序 是onClicked 。
doubleClicked(BoxSet boxset)
当用户在图表中双击由boxset 指定的箱线图项目时,将触发此信号。
相应的信号处理程序为onDoubleClicked() 。
注意: 相应的处理程序 是onDoubleClicked 。
hovered(bool status, BoxSet boxset)
当鼠标悬停在图表中由 `boxset ` 指定的箱线图项目上时,会触发此信号。当鼠标移至该项目上方时,`status ` 变为 `true`;当鼠标再次移开时,它变为 `false`。
相应的信号处理程序是onHovered() 。
注意: 相应的处理程序 是onHovered 。
pressed(BoxSet boxset)
当用户点击图表上的“boxset ”时,会触发此信号。
相应的信号处理程序为onPressed 。
注意: 相应的处理程序 是onPressed 。
released(BoxSet boxset)
当用户松开鼠标,结束对图表中由boxset 指定的箱线图项的点击时,会触发此信号。
相应的信号处理程序为onReleased() 。
注意: 相应的处理程序 是onReleased 。
方法文档
void append(BoxSet box)
将由box 指定的箱线图项目追加到该序列中。
void append(string label, VariantList values)
将一个新的箱线图项目(标签由label 指定,数值由values 指定)追加到该序列中。
BoxSet at(int index)
返回位于index 指定位置的箱线图项。
void clear()
从序列中移除所有箱线图项目,并将其永久删除。
void insert(int index, string label, VariantList values)
在该序列中,于由index 指定的位置插入一个新的箱线图项目,其标签由label 指定,数值由values 指定。
void remove(QBoxSet boxset)
从该序列中删除由 `boxset ` 指定的箱线图项。
© 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.