Chart 接口

表示 Microsoft Office Excel 的 Office 项目中的一个内嵌图表。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
<GuidAttribute("c4435b63-6e69-4360-92fb-2b144fd9b1d2")> _
Public Interface Chart _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("c4435b63-6e69-4360-92fb-2b144fd9b1d2")]
public interface Chart : IBindableComponent, IComponent, 
    IDisposable, ISupportInitialize

Chart 类型公开以下成员。

属性

	名称	说明
	_CodeName	基础结构。
	Application	获取一个 Application，它表示 Microsoft Office Excel 应用程序。
	Area3DGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的面积图组。
	AutoScaling	缩放三维图表，以使其在大小上更接近等效的二维图表。
	BackWall	获取一个对象，该对象表示三维图表的背面墙。
	Bar3DGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的条形图组。
	BarShape	获取或设置用于三维条形或柱形图的形状。
	BindingContext	获取或设置 IBindableComponent 的货币管理器的集合。 （继承自 IBindableComponent。）
	ChartArea	获取一个 ChartArea 对象，该对象表示图表的完整图表区域。
	ChartStyle	获取或设置图表的样式。
	ChartTitle	获取一个 ChartTitle 对象，该对象表示指定图表的标题。
	ChartType	获取或设置图表类型。
	CodeName	基础结构。
	Column3DGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的柱形图组。
	Container	基础结构。
	Corners	获取一个 Corners 对象，该对象表示三维图表的角点。
	Creator	获取在其中创建此 Chart 的应用程序。
	DataBindings	获取此 IBindableComponent 的数据绑定对象的集合。 （继承自 IBindableComponent。）
	DataTable	获取一个表示图表数据表的 DataTable。
	DefaultDataSourceUpdateMode	获取或设置默认 DataSourceUpdateMode。
	DepthPercent	获取或设置三维图表的深度，以图表宽度的百分比形式（在 20% 到 2000% 之间）表示。
	DisplayBlanksAs	获取或设置在图表上绘制空白单元格的方式。
	Dummy24
	Dummy25
	Elevation	获取或设置三维图表视图的仰角（以度为单位）。
	Floor	获取一个 Floor 对象，该对象表示三维图表的基底。
	GapDepth	获取或设置三维图表中数据系列之间的距离（以标记宽度的百分比形式表示）。
	HasAxis	获取或设置一个值，该值指示在 Chart 控件上是否存在特定的轴。
	HasDataTable	获取或设置一个值，该值指示 Chart 控件是否包含数据表。
	HasLegend	获取或设置一个值，该值指示 Chart 控件是否包含图例。
	HasPivotFields	获取或设置一个值，该值指示是否在指定的数据透视图报表上显示数据透视图控件。
	HasTitle	获取或设置一个值，该值指示 Chart 控件是否具有标题。
	HeightPercent	获取或设置三维图表的高度（以 Chart 控件宽度的百分比形式表示）。
	Hyperlinks	获取一个 Hyperlinks 集合，该集合表示范围或工作表的超链接。
	Index	基础结构。
	InnerObject	获取一个 Microsoft.Office.Interop.Excel.Chart，它表示 Chart 的基础本机对象。
	Legend	获取一个 Legend 对象，该对象表示图表的图例。
	Line3DGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的折线图组。
	MailEnvelope	表示文档的电子邮件标头。
	Name	获取 Chart 控件的名称。
	OnDoubleClick	基础结构。
	OnSheetActivate	基础结构。
	OnSheetDeactivate	基础结构。
	PageSetup	获取一个 PageSetup，包含指定对象的所有页面设置。
	Parent	获取 Chart 控件的父对象。
	Perspective	获取或设置三维图表视图的透视系数。
	Pie3DGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的饼图组。
	PivotLayout	获取一个 PivotLayout 对象，该对象表示数据透视图报表中字段的位置和数据透视图报表中轴的位置。
	PlotArea	获取一个 PlotArea 对象，该对象表示图表的绘图区。
	PlotBy	获取或设置在图表上将列或行用作数据系列的方式。
	PlotVisibleOnly	获取或设置一个值，该值指示是否只绘制可见单元格。
	PrintedCommentPages	获取要为当前图表打印的注释页的数目。
	ProtectContents	基础结构。
	ProtectData	获取或设置一个值，该值指示是否禁止修改系列公式。
	ProtectDrawingObjects	基础结构。
	ProtectFormatting	获取或设置一个值，该值指示是否禁止修改 Chart 控件格式设置。
	ProtectGoalSeek	获取或设置一个值，该值指示是否防止使用鼠标操作修改 Chart 控件数据点。
	ProtectionMode	基础结构。
	ProtectSelection	获取或设置一个值，该值指示是否禁止 Chart 控件元素。
	RightAngleAxes	获取或设置一个值，该值指示 Chart 控件轴是否成直角（与图表旋转角或仰角无关）。
	Rotation	获取或设置三维图表视图的旋转角（绘图区绕 z 轴的旋转角，以度为单位）。
	Scripts	获取 Scripts 集合，该集合包含 Script 对象，这些对象表示在指定文档保存为网页后该文档中的脚本块或代码块。
	Shapes	获取一个 Shapes 对象，该对象表示 Chart 控件上的所有形状。
	ShowAllFieldButtons	获取或设置是否在数据透视图上显示所有字段按钮。
	ShowAxisFieldButtons	获取或设置是否在数据透视图上显示轴字段按钮。
	ShowDataLabelsOverMaximum	获取或设置一个值，该值指示当值大于数值轴上的最大值时是否显示数据标签。
	ShowLegendFieldButtons	获取或设置是否在数据透视图上显示图例字段按钮。
	ShowReportFilterFieldButtons	获取或设置是否在数据透视图上显示报告筛选器字段按钮。
	ShowValueFieldButtons	获取或设置是否在数据透视图上显示值字段按钮。
	ShowWindow	获取或设置一个值，该值指示是否在单独的窗口中显示嵌入式图表。
	SideWall	获取一个对象，该对象表示三维图表的侧面墙。
	Site	获取或设置与 IComponent 关联的 ISite。 （继承自 IComponent。）
	SizeWithWindow	获取或设置一个值，该值指示 Microsoft Office Excel 是否调整 Chart 控件的大小以匹配图表工作表窗口的大小
	SubType	基础结构。
	SurfaceGroup	获取一个 ChartGroup 对象，该对象表示三维图表上的曲面图组。
	Tab	获取 Chart 控件的 Tab 对象。
	Tag	获取或设置包含有关 Tag 控件的数据的对象。
	Type	基础结构。
	Walls	获取一个 Walls 对象，该对象表示三维图表的墙纸。
	WallsAndGridlines2D	获取或设置一个值，该值指示是否在三维图表上以二维方式绘制网格线。

页首

方法

	名称	说明
	_ApplyDataLabels	基础结构。
	_Dummy23	基础结构。
	_Evaluate	基础结构。
	_PrintOut	基础结构。
	_Protect	基础结构。
	_SaveAs	基础结构。
	Activate	使当前 Chart 控件成为活动图表。
	ApplyChartTemplate	将标准或自定义图表模板应用于图表。
	ApplyCustomType	将标准或自定义的图表类型应用于 Chart 控件。
	ApplyDataLabels	将数据标签应用于 Chart 控件的某个点、某个系列或所有系列。
	ApplyLayout	应用功能区上显示的布局。
	Arcs	基础结构。
	AreaGroups	在二维图表上获取一个对象，该对象表示单个面积图组（ChartGroup 对象）或面积图组的集合（ChartGroups 集合）。
	AutoFormat	基础结构。
	Axes	获取一个对象，该对象表示图表上的一个轴或一个轴集合。
	BarGroups	在二维图表上，返回一个对象，该对象表示单个条形图组（ChartGroup 对象）或条形图组的集合（ChartGroups 集合）。
	BeginInit	用信号通知对象初始化即将开始。 （继承自 ISupportInitialize。）
	Buttons	基础结构。
	ChartGroups	获取单个图表组（ChartGroup 对象）或图表中所有图表组的集合（ChartGroups 对象）。
	ChartObjects	获取一个对象，该对象表示工作表上的单个嵌入式图表（ChartObject 对象）或所有嵌入式图表的集合（ChartObjects 对象）。
	ChartWizard	修改给定 Chart 控件的属性。使用此方法可以快速地对 Chart 控件进行格式设置，而无需逐个设置所有属性。此方法是非交互式的，它只更改指定的属性。
	CheckBoxes	基础结构。
	CheckSpelling	检查对象的拼写。Microsoft Office Excel 显示“拼写检查”对话框
	ClearToMatchStyle	清除格式设置为自动的图表元素。
	ColumnGroups	在二维图表上，返回一个对象，该对象表示单个柱形图组（ChartGroup 对象）或柱形图组的集合（ChartGroups 集合）。
	Copy	基础结构。
	CopyChartBuild	基础结构。
	CopyPicture	将图表作为图片复制到剪贴板。
	CreatePublisher	基础结构。
	Delete	从工作表中删除动态创建的 Chart 控件并将其从 ControlCollection 中移除。
	Deselect	取消指定 Chart 控件的所选内容。
	Dispose	执行与释放或重置非托管资源相关的应用程序定义的任务。 （继承自 IDisposable。）
	DoughnutGroups	在二维图表上返回一个对象，该对象表示单个圆环图组（ChartGroup 对象）或圆环图组的集合（ChartGroups 集合）。
	DrawingObjects	基础结构。
	Drawings	基础结构。
	DropDowns	基础结构。
	EndInit	用信号通知对象初始化已完成。 （继承自 ISupportInitialize。）
	Evaluate	将 Microsoft Office Excel 名称转换为对象或值。
	Export	以图形格式导出图表。
	ExportAsFixedFormat	以 PDF 或 XPS 格式保存图表。
	get_HasAxis	基础结构。
	GetChartElement	获取有关指定 X 和 Y 坐标上的图表元素的信息。
	GroupBoxes	基础结构。
	GroupObjects	基础结构。
	Labels	基础结构。
	LineGroups	在二维图表上，返回单个折线图组（ChartGroup 对象）或折线图组的集合（ChartGroups 集合）。
	Lines	基础结构。
	ListBoxes	基础结构。
	Location	将 Chart 控件移动到新位置。
	Move	基础结构。
	OptionButtons	基础结构。
	Ovals	基础结构。
	Paste	从剪贴板将图表数据粘贴到指定的 Chart 控件中。
	Pictures	基础结构。
	PieGroups	在二维图表上返回一个对象，该对象表示单个饼图组（ChartGroup 对象）或饼图组的集合（ChartGroups 集合）。
	PrintOut	打印 Chart 控件。
	PrintOutEx	打印图表。
	PrintPreview	显示与打印效果相同的 Chart 控件预览。
	RadarGroups	在二维图表上返回一个对象，该对象表示单个雷达图组（ChartGroup 对象）或雷达图组的集合（ChartGroups 集合）。
	Rectangles	基础结构。
	Refresh	更新 Chart 或 PivotTable 对象的缓存。
	SaveChartTemplate	将当前图表作为自定义模板保存在可用图表模板的列表中。
	ScrollBars	基础结构。
	SeriesCollection	获取图表或图表组中的单个系列（Series 对象）或所有系列的集合（SeriesCollection 集合）。
	set_HasAxis	基础结构。
	SetBackgroundPicture	设置 Chart 控件的背景图形。
	SetDefaultChart	指定 Microsoft Office Excel 在创建新图表时使用的图表模板的名称。
	SetElement	修改图表中的元素。
	SetSourceData	设置 Chart 控件的源数据范围。
	Spinners	基础结构。
	TextBoxes	基础结构。
	XYGroups	在二维图表上返回一个对象，该对象表示单个散点图组（ChartGroup 对象）或散点图组的集合（ChartGroups 集合）。

页首

事件

	名称	说明
	ActivateEvent	在激活 Chart 控件时发生。
	BeforeDoubleClick	在双击 Chart 控件时，但在默认双击操作之前发生。
	BeforeRightClick	在右击 Chart 控件时，但在默认右击操作之前发生。
	BindingContextChanged	基础结构。
	Calculate	在 Chart 控件绘制新的或更改的数据后发生。
	Deactivate	在从 Chart 控件中移走所选内容以使 Chart 控件停用时发生。
	Disposed	表示处理组件的 Disposed 事件的方法。 （继承自 IComponent。）
	DragOver	当在 Chart 控件上拖动单元格范围时发生。
	DragPlot	在将单元格范围拖放至 Chart 控件上时发生。
	MouseDown	当指针位于 Chart 控件上，按下鼠标按钮时发生。
	MouseMove	当鼠标指针的位置在 Chart 控件上更改时发生。
	MouseUp	当指针位于 Chart 控件上，释放鼠标按钮时发生。
	Resize	当更改 Chart 控件的大小时发生。
	SelectEvent	当选择 Chart 控件时发生。
	SeriesChange	当更改 Chart 控件数据点的值时发生。

页首

备注

Chart 控件提供 Excel 对象模型中的本机 Microsoft.Office.Interop.Excel.Chart 对象的所有功能。 但是，Chart 控件还公开事件。 有关更多信息，请参见Chart 控件。

备注

此接口由 Visual Studio Tools for Office Runtime 实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关面向 .NET Framework 3.5 的项目中的此类型的文档，请参见 Visual Studio 2008 文档中的以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。

请参见

参考

Microsoft.Office.Tools.Excel 命名空间

其他资源

Chart 控件

如何：向工作表添加 Chart 控件

宿主项和宿主控件概述