QAreaLegendMarker Class 详解

QAreaLegendMarker 类详解

QAreaLegendMarker 类是 Qt Charts 模块中用于表示面积图系列（QAreaSeries）的图例标记（Legend Marker）的类。图例标记是图例中的一个小图标，用于标识图表中的不同系列。QAreaLegendMarker 专门用于面积图系列，它继承自 QLegendMarker 类。

主要功能

1. 图例标记显示：QAreaLegendMarker 用于在图表图例中显示面积图系列的标记。
2. 样式自定义：可以通过 setBrush() 和 setPen() 方法自定义图例标记的填充颜色和边框样式。
3. 系列关联：每个 QAreaLegendMarker 都与一个 QAreaSeries 对象关联，用于表示该系列在图例中的标记。

常用方法

• series() const：返回与图例标记关联的 QAreaSeries 对象。
• setBrush(const QBrush &brush)：设置图例标记的填充颜色。
• brush() const：获取图例标记的填充颜色。
• setPen(const QPen &pen)：设置图例标记的边框样式。
• pen() const：获取图例标记的边框样式。

示例代码

以下是一个完整的示例，展示了如何使用 QAreaSeries 和 QAreaLegendMarker 来创建一个面积图，并自定义图例标记的样式。

#include 
#include 
#include 
#include 
#include 
#include  // 包含 QLegendMarker 的头文件
#include 
#include 
QT_CHARTS_USE_NAMESPACE

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 创建上下边界线系列
    QLineSeries *upperSeries = new QLineSeries();
    upperSeries->append(0, 6);
    upperSeries->append(1, 4);
    upperSeries->append(2, 8);
    upperSeries->append(3, 4);
    upperSeries->append(4, 5);

    QLineSeries *lowerSeries = new QLineSeries();
    lowerSeries->append(0, 2);
    lowerSeries->append(1, 1);
    lowerSeries->append(2, 3);
    lowerSeries->append(3, 0);
    lowerSeries->append(4, 1);

    // 创建面积系列
    QAreaSeries *areaSeries = new QAreaSeries(upperSeries, lowerSeries);
    areaSeries->setName("面积图示例");
    areaSeries->setColor(QColor(0, 255, 0, 100)); // 设置填充颜色
    areaSeries->setBorderColor(Qt::green);        // 设置边框颜色

    // 创建图表并添加系列
    QChart *chart = new QChart();
    chart->addSeries(areaSeries);
    chart->setTitle("面积图示例");
    chart->createDefaultAxes();

    // 获取图例并设置图例标记样式
    QLegend *legend = chart->legend();
    legend->setVisible(true);
    legend->setAlignment(Qt::AlignBottom);

    // 获取图例标记并自定义样式
    QList<QLegendMarker *> markers = legend->markers();
    for (QLegendMarker *marker : markers) {
        if (marker->type() == QLegendMarker::LegendMarkerTypeArea) {
            QAreaLegendMarker *areaMarker = qobject_cast<QAreaLegendMarker *>(marker);
            if (areaMarker) {
                areaMarker->setBrush(QBrush(QColor(0, 255, 0, 100))); // 设置填充颜色
                areaMarker->setPen(QPen(Qt::green));                  // 设置边框颜色
            }
        }
    }

    // 创建图表视图并设置图表
    QChartView *chartView = new QChartView(chart);
    chartView->setRenderHint(QPainter::Antialiasing);

    // 显示窗口
    chartView->resize(800, 600);
    chartView->show();

    return a.exec();
}

代码说明

1. QLineSeries：创建了两个折线系列，分别表示面积图的上边界和下边界。
2. QAreaSeries：通过上下边界系列创建了一个面积图系列，并设置了填充颜色和边框颜色。
3. QChart：创建了一个图表对象，并将面积图系列添加到图表中。
4. QLegend：获取图例对象，并设置图例的可见性和对齐方式。
5. QAreaLegendMarker：遍历图例中的标记，找到面积图系列的图例标记，并自定义其填充颜色和边框样式。
6. QChartView：创建了一个图表视图，用于显示图表。

运行结果

运行该程序后，将会显示一个包含面积图的窗口，图例中会显示面积图系列的标记，并且标记的填充颜色和边框样式已被自定义。

总结

QAreaLegendMarker 是用于面积图系列的图例标记类，可以通过它自定义图例标记的样式。通过结合 QAreaSeries 和 QAreaLegendMarker，可以创建具有自定义样式的面积图，并在图例中显示相应的标记。