当前位置：首页 > news >正文

Qt QVBoxPlotModelMapper详解

news 2025/9/19 7:25:27

1、概述

QVBoxPlotModelMapper 是 Qt 图表模块（Qt Charts）中的一个类，用于将数据模型（QAbstractItemModel）与箱线图（QBoxPlotSeries）进行映射。它建立了模型数据与箱线图可视化之间的桥梁，允许开发者通过数据模型来管理箱线图所需的数据，实现数据与视图的分离。

箱线图通常需要五组数据（最小值、下四分位数、中位数、上四分位数、最大值）来表示一个数据系列，QVBoxPlotModelMapper 负责将模型中的数据正确映射到这些值上。

2、重要方法

QVBoxPlotModelMapper(QObject *parent = nullptr)：构造函数，创建一个 QVBoxPlotModelMapper 实例
QAbstractItemModel *model() const：返回当前关联的数据模型
void setModel(QAbstractItemModel *model)：设置要关联的数据模型
QBoxPlotSeries *series() const：返回当前关联的箱线图系列
void setSeries(QBoxPlotSeries *series)：设置要关联的箱线图系列
int firstRow() const：返回模型中开始映射的行索引
void setFirstRow(int firstRow)：设置模型中开始映射的行索引
int rowCount() const：返回要映射的行数
void setRowCount(int rowCount)：设置要映射的行数
int firstColumn() const：返回模型中开始映射的列索引
void setFirstColumn(int firstColumn)：设置模型中开始映射的列索引

3、信号

void modelReplaced()：当数据模型被替换时发射
void seriesReplaced()：当箱线图系列被替换时发射
void firstRowChanged()：当起始行索引改变时发射
void rowCountChanged()：当映射的行数改变时发射
void firstColumnChanged()：当起始列索引改变时发射

4、C++ 实例

#include <QApplication>
#include <QtCharts/QChartView>
#include <QtCharts/QLineSeries>
#include <QtCharts/QValueAxis>
#include <QtCharts/QAreaSeries>
#include <QLegend>
#include <QPieSlice>QT_CHARTS_USE_NAMESPACEclass ChartView : public QWidget {
public:ChartView(QWidget *parent = nullptr) : QWidget(parent) {initializeChart();}private:void initializeChart() {// 创建一个图表QChart *chart = new QChart();chart->setTitle("Sample Chart");// 创建数据模型QStandardItemModel *model = new QStandardItemModel(10, 2, this);for (int row = 0; row < 10; ++row) {model->setData(model->index(row, 0), row); // X 值model->setData(model->index(row, 1), row * row); // Y 值}// 创建折线系列QLineSeries *series = new QLineSeries();// 使用 QVBoxPlotModelMapper 将模型数据映射到 seriesfor (int row = 0; row < model->rowCount(); ++row) {double x = model->data(model->index(row, 0)).toDouble();double y = model->data(model->index(row, 1)).toDouble();series->append(x, y);}// 将系列添加到图表chart->addSeries(series);chart->createDefaultAxes();// 设置坐标轴范围QValueAxis *axisX = new QValueAxis();axisX->setRange(0, 10);QValueAxis *axisY = new QValueAxis();axisY->setRange(0, 100);chart->setAxisX(axisX, series);chart->setAxisY(axisY, series);// 创建图表视图QChartView *chartView = new QChartView(chart);chartView->setRenderHint(QPainter::Antialiasing);// 布局QVBoxLayout *layout = new QVBoxLayout(this);layout->addWidget(chartView);setLayout(layout);}
};int main(int argc, char *argv[])
{QApplication a(argc, argv);ChartView view;view.resize(800, 600);view.show();return a.exec();
}