** CnetComPonents ** 是我写的一个图表控件。
本来没打算也这篇东西的,因为东西很简单,又有源代码,而且源代码里也有注释。
不过最近有一些朋友问我怎么用这东西,正好这几天又有时间,就随便瞎写一下了。 J
CnetComPonents 主要功能:
根据要求显示不同的统计视图,目前实现了:直线、曲线、饼状、柱状。这 4 种图形也是目前用的最多的。直线与曲线都是线条,所以我将这两种图形合并在一个类中 [StatChartLine] 、柱状 [StatChartHist] 、饼状 [StatChartCaky] 。
下面主要介绍一下各个类的方法、属性:
一、 StatChartLine :
构造函数:
public StatChartHist()
图片使用预定义的宽与高
public StatChartHist(int Width, int Height)
指定图片的宽与高 Width: 高 Height: 宽
说明:不管是是用预定义的宽和高还是指定的宽和高,最后生成的图片的宽会增加 100 ,高会增加 50 。也就是 (Width+100,Height+50) 。
公共方法:
public MemoryStream GetChartOfStream(System.Drawing.Imaging.ImageFormat
imageFormat,CNetComponents.StatChartLine.LineType lineType,float[][] content)
根据数据生成一张图片并转换成 MemoryStream 对象返回。这个方法主要用在
Webfrom 中。
参数说明:
imageFormat
|
System.Drawing.Imageing.ImageFormat 枚举,指定生成图片的格式。
---|---
lineType
|
CNetComponents.StatChartLine.LineType 枚举,指定生成的图形是直线还是曲线。
Content
|
要统计的数据。这是一个锯齿型数组。 ( 此处省略 100 字。俺不懂的怎么来形容。等想到了在补上。 J )
public string SaveChartToFile( System.Drawing.Imaging.ImageFormat imageFormat,
string filePath,CNetComponents.StatChartLine.LineType lineType, float[][]
content)
根据数据生成图片,并保存到指定的路径。
参数说明:
imageFormat
|
System.Drawing.Imageing.ImageFormat 枚举,指定生成图片的格式。
---|---
filePath
|
文件保存路径,不包括文件名。
lineType
|
CNetComponents.StatChartLine.LineType 枚举,指定生成的图形是直线还是曲线
Content
|
要统计的数据。这是一个锯齿型数组。 ( 此处省略 100 字。俺不懂的怎么来形容。等想到了在补上。 J )
public Image GetChartOfImage(CNetComponents.StatChartLine.LineType
lineType,float[][] content)
根据数据生成图片,并作为一个 Image 对象返回。返回的 Image 对象可以直接用于
WinForm 的 Picture 控件。
参数说明参考上面两个方法。
public float[][] TableToArray(CNetComponents.StatChartLine.TableToArrayMode
mode, DataTable table)
将表格按指定的方式转换成 2 维动态数组。
参数说明:
mode
|
CNetComponents.StatChartLine.TableToArrayMode 枚举成员。可以指定表格按行或者列转换成 2 维动态数组
---|---
table
|
DataTable 对象,需要进行转换的表格
属性:
Xstring
|
设置、获取 X 轴提示信息
---|---
YString
|
设置、获取 Y 轴提示信息
Title
|
设置、获取图片的标题
TitleFontColor
|
设置、获取标题颜色
TitleFont
|
设置、获取标题字体
TitleFontSize
|
设置、获取标题字体大小
bgColor
|
设置、获取图片背景颜色
LineSize
|
设置、获取线条的大小
IsShowValue
|
设置、获取数据的显示状态
IsShowPoint
|
设置、获取统计线上点的显示状态
Ypart
|
设置、获取 Y 轴分段数量
Xpart
|
设置、获取 X 轴分段数量
ColorList
|
设置、获取所有柱体的颜色,与数据一一对应。如果指定的颜色数目小与线条数目,将使用预定义的颜色。
Information
|
设置各个统计数据的说明信息,与数据一一对应。如果指定的说明数目小与线条数目,将使用预定义的说明。
二、 StatChartHist :
参考 StatChartLine 的说明
三、 StatChartCaky
参考 StatChartLine 的说明