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

Qt QPieSlice详解

news 2025/9/19 7:51:36

1、概述

QPieSlice 是 Qt 图表模块（Qt Charts）中的一个类，用于表示 QPieSeries 中的单个扇形切片。它是构成饼图的基本元素，每个切片可以设置自己的数值、标签、颜色等属性，用于可视化数据的比例关系。

QPieSlice 通常与 QPieSeries 配合使用，一个 QPieSeries 包含多个 QPieSlice 对象，共同组成一个完整的饼图。通过 QPieSlice，你可以控制每个扇形的外观和行为，包括大小、颜色、标签显示等。

2、重要方法

QPieSlice(QString label, qreal value)：构造函数，创建一个带有指定标签和数值的扇形切片
void setValue(qreal value)：设置切片的数值，决定了该切片在饼图中所占的比例
qreal value() const：返回切片的数值
void setLabel(QString label)：设置切片的标签文本
QString label() const：返回切片的标签文本
void setLabelVisible(bool visible)：设置标签是否可见
bool isLabelVisible() const：判断标签是否可见
void setLabelPosition(QPieSlice::LabelPosition position)：设置标签的位置
QPieSlice::LabelPosition labelPosition() const：返回标签的位置
void setColor(QColor color)：设置切片的填充颜色
QColor color() const：返回切片的填充颜色
void setBorderColor(QColor color)：设置切片的边框颜色
QColor borderColor() const：返回切片的边框颜色
void setBorderWidth(int width)：设置切片的边框宽度
int borderWidth() const：返回切片的边框宽度
void setExploded(bool exploded)：设置切片是否从饼图中心向外分离
bool isExploded() const：判断切片是否分离
void setExplodeDistanceFactor(qreal factor)：设置分离距离因子（相对于饼图半径的比例）
qreal explodeDistanceFactor() const：返回分离距离因子
qreal percentage() const：返回该切片占总数值的百分比（0.0 到 1.0 之间）

3、信号

void clicked(bool pressed = false)：当切片被点击时发射
void hovered(bool hovered)：当鼠标悬停在切片上或离开时发射（hovered 为 true 表示进入，false 表示离开）
void labelChanged()：当标签文本改变时发射
void valueChanged()：当切片数值改变时发射
void explodedChanged()：当切片的分离状态改变时发射
void colorChanged()：当切片颜色改变时发射
void borderColorChanged()：当边框颜色改变时发射
void borderWidthChanged()：当边框宽度改变时发射

4、常用枚举

QPieSlice::LabelPosition - 定义标签的位置：

QPieSlice::LabelOutside：标签显示在切片外部（默认值）
QPieSlice::LabelInsideHorizontal：标签水平显示在切片内部
QPieSlice::LabelInsideTangential：标签沿切片切线方向显示在内部
QPieSlice::LabelInsideNormal：标签沿切片法线方向显示在内部

5、C++ 实例

#include <QApplication>
#include <QtCharts/QChartView>
#include <QtCharts/QLineSeries>
#include <QtCharts/QValueAxis>
#include <QtCharts/QAreaSeries>
#include <QLegend>
#include <QPieSlice>QT_CHARTS_USE_NAMESPACEint main(int argc, char *argv[])
{QApplication a(argc, argv);// 创建饼图数据系列QPieSeries *series = new QPieSeries();// 添加数据切片到系列中QPieSlice *slice1 = series->append("苹果", 30);  // 标签为“苹果”，值为30QPieSlice *slice2 = series->append("香蕉", 50);  // 标签为“香蕉”，值为50QPieSlice *slice3 = series->append("橙子", 20);   // 标签为“橙子”，值为20// 设置饼图切片的样式slice1->setColor(Qt::red);  // 设置“苹果”切片的颜色为红色slice2->setColor(Qt::yellow); // 设置“香蕉”切片的颜色为黄色slice3->setColor(Qt::blue); //// 设置切片为可爆炸状态（使得某个切片突出）slice1->setExploded(true);  // “苹果”切片突出显示// 创建图表对象并添加数据系列QChart *chart = new QChart();chart->addSeries(series);chart->setTitle("水果分布饼图");// 创建图表视图并设置为可抗锯齿QChartView *chartView = new QChartView(chart);chartView->setRenderHint(QPainter::Antialiasing);// 创建布局并将图表视图添加到窗口中QWidget window;QVBoxLayout *layout = new QVBoxLayout();layout->addWidget(chartView);window.setLayout(layout);window.setWindowTitle("Qt 饼图示例");window.resize(600, 400);window.show();return a.exec();
}