qpieseries

### QPieSeries 的使用方法

QPieSeries 是用于创建饼图的数据系列类。通过该类可以方便地向图表中添加扇形区域来表示不同类别所占的比例。

#### 创建 QPieSeries 对象并设置属性

为了使用 `QPieSeries`，首先需要包含相应的头文件：

#include <QtCharts/QChartView>
#include <QtCharts/QPieSeries>
#include <QtCharts/QPieSlice>

接着实例化 `QPieSeries` 类对象，并调用其成员函数添加数据项[^1]。

#### 添加数据到 QPieSeries 中

可以通过 `append()` 方法为序列增加新的片段，也可以先构建 `QPieSlice` 对象再加入到序列里。每个片段代表一个分类及其对应的数值大小。

#### 设置样式与交互特性

对于每一个 `QPieSlice` 片段都可以单独配置颜色、标签可见性和爆炸效果等视觉特征；还可以定义鼠标悬停提示文字以及点击事件响应逻辑。

以下是完整的代码示例展示如何利用 `QPieSeries` 构建简单的饼状统计图形界面程序[^2]：

// main.cpp
#include "widget.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    
    // 创建窗口部件
    Widget w;
    
    // 更改应用程序整体外观风格
    QPalette palette = a.palette();
    palette.setColor(QPalette::Window, QColor(4, 7, 38));
    a.setPalette(palette);

    // 显示主窗体
    w.show();

    return a.exec();
}

// widget.h
#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QtCharts/QChartView>
#include <QtCharts/QPieSeries>
#include <QtCharts/QPieSlice>

class Widget : public QWidget {
public:
    explicit Widget(QWidget *parent = nullptr);

private:
    void setupUI();
};

#endif // WIDGET_H


// widget.cpp
#include "widget.h"

Widget::Widget(QWidget *parent): QWidget(parent){
    setupUI();
}

void Widget::setupUI(){
    auto chart = new QtCharts::QChart;

    // 初始化饼图序列
    auto series = new QtCharts::QPieSeries(this);

    // 向序列追加多个分片（即各个部分）
    series->append("Jane", 1);
    series->append("Joe", 2);
    series->append("Andy", 3);
    series->append("Barbara", 4);
    series->append("Hulk", 5);

    // 获取特定的切片进行个性化定制
    QtCharts::QPieSlice *slice = series->slices().at(1);
    slice->setLabelVisible(true);          // 展示百分比标签
    slice->setExploded();                  // 让此片突出显示
    slice->setColor(Qt::darkGreen);        // 修改填充色
    
    // 将整个序列添加至图表内
    chart->addSeries(series);
    chart->setTitle("Simple piechart example");
    chart->legend()->show();               // 开启图例说明栏

    // 实例化视图组件并将上述图表关联上去
    auto view = new QtCharts::QChartView(chart,this);
    view->setRenderHint(QPainter::Antialiasing);   // 平滑渲染绘图质量

    setCentralWidget(view);                // 设定为主布局中心位置
}