通过

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 控件

宿主项和宿主控件概述