# gdip.chart.pie 库模块帮助文档
## GdipChartPieObject 成员列表 #
### GdipChartPieObject.dataset #
```aardio
GdipChartPieObject.dataset = {
data = [25, 35, 15, 10, 15];
labels = ["苹果", "香蕉", "橘子", "葡萄", "其他"];
colors = [0xFFE74C3C, 0xFFF1C40F, 0xFFE67E22, 0xFF9B59B6, 0xFF3498DB];
showPercentage = true;
cutoutPercentage = 50;
/*
指定饼图配置，字段说明：
data: 数值数组，指定饼图数据。
labels: 字符串数组，用于指定图例中显示的标签，可选字段。
colors: 扇区颜色值数组（颜色格式 0xAARRGGBB），可选字段，数组长度可以小于 data 数组的长度。
showPercentage: 标签后是否显示百分比以取代数据值。
cutoutPercentage: 可选大于 0 并小于 100 的整数指定要在中间擦除的中心圆大小（甜甜圈效果）。
注意修改 dataset 并不会主动重绘控件，
如果控件已显示，可调用控件的 redraw 或 redrawTransparent 函数刷新。*/
};
```
### GdipChartPieObject.redraw() #
重绘图表，等价于调用 plus 控件的 redrawTransparent 函数。
## gdip.chart 成员列表 #
### gdip.chart.pie #
基于 GDI+ 在 plus 控件内绘制简单饼图或环形图（甜甜圈图 / 面包圈图）。
如果要实现更丰富的图表效果，请改用 web.view 等浏览器控件加载 chart.js 等图表组件。
### gdip.chart.pie() #
创建饼图对象，参数指定 plus 控件对象。
此对象在 plus 控件自绘前景的 onDrawForeground 事件内绘制饼图。
饼图的绘制范围为 plus 控件的前景显示范围，前景边距也会成为饼图的边距。
plus 控件的前景色将显示为饼图的背景色。
控件设置的字体与字体颜色将用于显示饼图中的文字与图例。
[返回对象:GdipChartPieObject](#GdipChartPieObject)