# gdip.chart.line 库模块帮助文档

## GdipChartLineObject 成员列表 <a id="GdipChartLineObject" href="#GdipChartLineObject">&#x23;</a>

### GdipChartLineObject.dataset <a id="GdipChartLineObject.dataset" href="#GdipChartLineObject.dataset">&#x23;</a>

```aardio
GdipChartLineObject.dataset = {  
    data = {65, 85, 45, 75, 95, 55, 80}; //单条折线  
    //data = {{65, 85, 45, 75}, {45, 65, 35, 55}}; //多条折线  
    labels = ["周一", "周二", "周三", "周四", "周五", "周六", "周日"];  
    seriesLabels = ["销售额", "利润"]; //多条折线时的图例标签  
    colors = [0xFF3498DB, 0xFFE74C3C];  
    maxValue = 100; //Y轴最大值  
    minValue = 0; //Y轴最小值  
    showGrid = true; //显示网格线  
    gridLines = 5; //网格线数量  
    gridColor = 0x20000000; //网格线颜色  
    axisColor = 0xFFBDC3C7; //坐标轴颜色  
    showPoints = true; //显示数据点  
    pointSize = 3; //数据点大小（DPI缩放前）  
    showValues = false; //显示数值标签  
    smooth = false; //平滑曲线，可选字段  
    lineWidth = 2; //线条宽度（DPI 缩放前），可选  
    yTickCount = 5; //Y 轴刻度数量，可选  
    precision = 1; //Y 轴标签小数位数，可选  
    /*  
指定折线图配置，字段说明：  
data: 数值数组或二维数组，指定折线图数据。二维数组表示多条折线。  
labels: 字符串数组，用于指定X轴标签。  
seriesLabels: 字符串数组，多条折线时的图例标签。  
colors: 折线颜色值数组（颜色格式 0xAARRGGBB），可选字段。  
maxValue/minValue: Y轴最大/最小值，可选字段。  
showGrid: 是否显示网格线。  
gridLines: 网格线数量。  
gridColor: 网格线颜色。  
axisColor: 坐标轴颜色。  
showPoints: 是否显示数据点。  
pointSize: 数据点大小。  
showValues: 是否显示数值标签。  
smooth: 是否绘制平滑曲线。  
tension: 曲线强度（0 到 1 ），指定此字段则 smooth 自动设为 true  
lineWidth: 线条宽度。  
yTickCount: Y轴刻度数量。  
precision: Y轴标签小数位数。  
注意修改 dataset 并不会主动重绘控件，  
如果控件已显示，可调用控件的 redraw 或 redrawTransparent 函数刷新。*/  
};
```

### GdipChartLineObject.redraw() <a id="GdipChartLineObject.redraw" href="#GdipChartLineObject.redraw">&#x23;</a>
重绘图表，等价于调用 plus 控件的 redrawTransparent 函数。

## gdip.chart 成员列表 <a id="gdip.chart" href="#gdip.chart">&#x23;</a>

### gdip.chart.line <a id="gdip.chart.line" href="#gdip.chart.line">&#x23;</a>
基于 GDI+ 在 plus 控件内绘制折线图 / 平滑曲线图。  
如果要实现更丰富的图表效果，请改用 web.view 等浏览器控件加载 chart.js 等图表组件。

### gdip.chart.line() <a id="gdip.chart.line" href="#gdip.chart.line">&#x23;</a>
创建折线图对象，参数指定 plus 控件对象。  
此对象在 plus 控件自绘前景的 onDrawForeground 事件内绘制折线图。  
折线图的绘制范围为 plus 控件的前景显示范围，前景边距也会成为折线图的边距。  
plus 控件的前景色将显示为折线图的背景色。  
控件设置的字体与字体颜色将用于显示折线图中的文字。

[返回对象:GdipChartLineObject](#GdipChartLineObject)
