Chart

Chart class

封装表示单个 Excel 图表的对象。

public class Chart

特性

姓名描述
AutoScaling { get; set; }如果 Microsoft Excel 缩放 3-D 图表以使其尺寸更接近等效的 2-D 图表,则为真。 RightAngleAxes 属性必须为 True。
BackWall { get; }返回一个Walls表示 3-D 图表后壁的对象。
CategoryAxis { get; }获取图表的 X 轴。
ChartArea { get; }获取工作表中的图表区域。
ChartDataTable { get; }代表图表数据表。
ChartObject { get; }代表图表形状;
DepthPercent { get; set; }将 3-D 图表的深度表示为图表宽度的百分比(介于 20% 和 2000% 之间)。
DisplayNaAsBlank { get; set; }表示是否将#N/A 显示为空白值。
Elevation { get; set; }表示 3-D 图表视图的高度,以度为单位。
FirstSliceAngle { get; set; }获取或设置第一个饼图或圆环图切片的角度,以度为单位(从垂直顺时针方向)。仅适用于饼图、3-D 饼图和圆环图,0 到 360。
Floor { get; }返回一个Floor表示 3-D 图表墙壁的对象。
GapDepth { get; set; }获取或设置 3-D 图表中数据系列之间的距离,以标记宽度的百分比表示。 此属性的值必须介于 0 和 500 之间。
GapWidth { get; set; }返回或设置条形或列簇之间的间距,以条形或列宽的百分比表示。 此属性的值必须介于 0 和 500 之间。
HeightPercent { get; set; }返回或设置 3-D 图表的高度,作为图表宽度的百分比(介于 5% 和 500% 之间)。
HidePivotFieldButtons { get; set; }表示是否仅在图表为数据透视图时隐藏数据透视图字段按钮。
Is3D { get; }表示图表是否为 3d 图表。
IsRectangularCornered { get; set; }获取或设置一个值,指示图表区域是否为矩形角。 默认为true。
Legend { get; }获取图表图例。
Line { get; }获取线。
Name { get; set; }获取和设置图表的名称。
NSeries { get; }得到一个SeriesCollection表示图表中数据系列的集合。
PageSetup { get; }表示此图表中的页面设置说明。
Perspective { get; set; }返回或设置 3-D 图表视图的透视图。必须介于 0 和 100 之间。 如果 RightAngleAxes 属性为 True,则忽略此属性。
PivotOptions { get; }指定出现在图表上的枢轴控件
PivotSource { get; set; }来源为数据透视表的数据。 如果PivotSource不为空,则图表为PivotChart。
Placement { get; set; }表示图表附加到其下方单元格的方式。
PlotArea { get; }获取图表的绘图区域,其中包括轴刻度标签。
PlotBy { get; }获取和设置是按行还是按列绘制。
PlotEmptyCellsType { get; set; }获取并设置如何绘制空单元格。
PlotVisibleCells { get; set; }表示是否只绘制可见单元格。
PrintSize { get; set; }获取和设置打印的图表大小。
RightAngleAxes { get; set; }如果图表轴成直角,则为真。仅适用于 3-D 图表(Column3D 和 3-D 饼图除外)。
RotationAngle { get; set; }表示 3-D 图表视图的旋转(绘图区域围绕 z 轴的旋转,以度为单位)。
SecondCategoryAxis { get; }获取图表的第二个 X 轴。
SecondValueAxis { get; }获取图表的第二个 Y 轴。
SeriesAxis { get; }获取图表的系列轴。
Shapes { get; }返回此图表中的所有绘图形状。
ShowDataTable { get; set; }获取或设置图表是否显示数据表的值。
ShowLegend { get; set; }获取或设置是否显示图表图例的值。默认为真。
SideWall { get; }返回一个Walls表示 3-D 图表侧壁的对象。
SizeWithWindow { get; set; }如果 Microsoft Excel 调整图表大小以匹配图表工作表窗口的大小,则为真。
Style { get; set; }获取和设置内置样式。
SubTitle { get; }获取图表的副标题。 仅适用于 ODS 格式文件。
Title { get; }获取图表的标题。
Type { get; set; }获取或设置图表的类型。
ValueAxis { get; }获取图表的 Y 轴。
Walls { get; }返回一个Walls表示 3-D 图表墙壁的对象。
WallsAndGridlines2D { get; set; }如果网格线在 3-D 图表上以二维方式绘制,则为真。
Worksheet { get; }获取包含此图表的工作表。

方法

姓名描述
Calculate()计算绘图区域的自定义位置,如果坐标轴的位置是自动分配的。
GetActualSize()以像素为单位获取图表的实际大小。
GetChartDataRange()获取图表的数据源范围。
HasAxis(AxisType, bool)返回图表上存在哪些轴。
IsChartDataChanged()检测图表的数据源是否已更改。
Move(int, int, int, int)将图表移动到指定位置。
RefreshPivotData()从它的透视数据源刷新透视图的数据。
SetChartDataRange(string, bool)指定图表的数据范围。
SwitchRowColumn()切换行/列。
ToImage()获取 32 位位图图表对象.
ToImage(ImageOrPrintOptions)获取 32 位位图图表对象. ImageOrPrintOptions.ImageFormat , ImageOrPrintOptions.TiffCompression 和 ImageOrPrintOptions.Quality 属性被忽略。
ToImage(string)创建图表图像并将其保存到文件中。 文件名的扩展名决定图像的格式。
ToImage(Stream, ImageOrPrintOptions)创建图表图像并将其保存到指定格式的流中。
ToImage(Stream, ImageType)创建图表图像并将其保存到指定格式的流中。
ToImage(Stream, long)创建图表图像并将其保存到 Jpeg 格式的流中。
ToImage(string, ImageOrPrintOptions)创建图表图像并将其保存到文件中。 文件名的扩展名决定图像的格式。
ToImage(string, ImageType)创建图表图像并将其保存到指定图像类型的文件中。
ToImage(string, long)创建图表图像并将其保存到 Jpeg 格式的文件中。
ToPdf(Stream)创建图表 pdf 并将其保存到流中。
ToPdf(string)将图表保存为 pdf 文件。
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)创建图表 pdf 并将其保存到流中。
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)将图表保存为 pdf 文件。

例子

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
		
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);

Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
		
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex) 
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"

也可以看看