# gdip.chart.bar 库模块帮助文档
## GdipChartBarObject 成员列表 #
### GdipChartBarObject.dataset #
```aardio
GdipChartBarObject.dataset = {
maxValue = 100; //可选指定 Y 轴最大值
data = [65, 85, 45, 75, 95];
labels = ["第一季度", "第二季度", "第三季度", "第四季度", "预测"];
colors = [0xFF3498DB, 0xFF2ECC71, 0xFFE74C3C, 0xFFF1C40F, 0xFF9B59B6];
axisColor = 0xFFBDC3C7;/*
指定柱状图配置，字段说明：
maxValue: 可选字段，指定 Y 轴最大值。
data: 数值数组，指定柱状图数据。
labels: 字符串数组，用于指定所有柱子下面显示的标签。
colors: 柱子颜色值数组（颜色格式 0xAARRGGBB），可选字段，数组长度可以小于 data 数组的长度。
axisColor: 坐标轴颜色（颜色格式 0xAARRGGBB），可选字段。
注意修改 dataset 并不会主动重绘控件，
如果控件已显示，可调用控件的 redraw 或 redrawTransparent 函数刷新。*/
};
```
## GdipChartPieObject 成员列表 #
### GdipChartPieObject.redraw() #
重绘图表，等价于调用 canvas 控件的 redrawTransparent 函数。
## gdip.chart 成员列表 #
### gdip.chart.bar #
基于 GDI+ 在 canvas 控件内绘制简单柱状图。
如果要实现更丰富的图表效果，请改用 web.view 等浏览器控件加载 chart.js 等图表组件。
### gdip.chart.bar() #
创建柱状图对象，参数指定 canvas 控件对象。
此对象在 canvas 控件自绘前景的 onDrawForeground 事件内绘制柱状图。
柱状图的绘制范围为 canvas 控件的前景显示范围，前景边距也会成为柱状图的边距。
canvas 控件的前景色将显示为柱状图的背景色。
控件设置的字体与字体颜色将用于显示柱状图中的文字。
控件如果设置了文本或图标文本、边框等仍然按设置的样式显示。
[返回对象:GdipChartBarObject](#GdipChartBarObject)