Chart 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
代表工作簿中的图表。 图表可以是嵌入图表 (包含在 ChartObject) 中，也可以是单独的图表工作表。
public interface class Chart : Microsoft::Office::Interop::Excel::_Chart, Microsoft::Office::Interop::Excel::ChartEvents_Event[System.Runtime.InteropServices.Guid("000208D6-0000-0000-C000-000000000046")]
public interface Chart : Microsoft.Office.Interop.Excel._Chart, Microsoft.Office.Interop.Excel.ChartEvents_EventPublic Interface Chart
Implements _Chart, ChartEvents_Event- 派生
- 属性
- 实现
注解
这是派生自 COM Coclass（托管代码要求此 Coclass 来实现与相应的 COM 对象的互操作性）的 .NET 接口。 使用此派生的接口来访问所有方法、属性和 COM 对象的事件成员。 但是，如果您想要使用的方法或事件共享同一名称并且位于相同的 COM 对象下，请转换为相应的主接口以调用该方法，并转换为最新的事件接口以连接到该事件。 参考此主题以获取有关 COM 对象的信息。 有关 COM 对象的方法和属性成员的信息，请参阅 _Chart。
本部分介绍了用于返回 Chart 对象的以下属性：
- Chart 财产
- Charts 财产
- ActiveChart 财产
- ActiveSheet 财产
Chart 属性
使用 Chart 属性可返回一个 Chart 对象，该对象代表 ChartObject 对象中包含的图表。
Charts 属性
集合 Charts 包含工作簿中每个图表工作表的 Chart 对象。 使用 Chart (index) （其中 index 是图表工作表索引号或名称）返回单个 Chart 对象。
图表索引号表示图表工作表在工作簿标签栏上的位置。 所有图表工作表都包含在索引计数中，即使它们已隐藏。 图表工作表名称显示在图表的工作簿选项卡上。 可以使用 Name 属性设置或返回图表名称。
Chart 对象也是集合的成员Sheets。 Sheets 集合包含工作簿中所有的工作表（图表工作表和工作表）。 使用 工作表 (index) （其中 index 是工作表索引号或名称）返回单个工作表。
ActiveChart 属性
如果图表是活动对象，可以使用 ActiveChart 属性引用它。 如果用户已选择图表工作表或已使用 方法激活图表工作表， Activate() 则图表工作表处于活动状态。
如果用户已选择嵌入图表，或者 ChartObject 已使用 Activate 方法激活了嵌入图表中包含的对象，则嵌入图表处于活动状态。
ActiveSheet 属性
如果图表工作表是活动工作表，可以使用 ActiveSheet 属性引用它。
属性
| _CodeName |
仅供内部使用。 (继承自 _Chart) |
| Application |
在没有对象限定符的情况下使用时，此属性返回表示 Application Microsoft Excel 应用程序的 对象。 如果与对象识别符一起使用，则此属性返回代表指定对象的创建者的 Application 对象（可以将此属性与 OLE 自动化对象一起使用以返回该对象的应用程序）。 (继承自 _Chart) |
| Area3DGroup |
返回一个 ChartGroup 对象，该对象代表三维图表上的面积图组。 (继承自 _Chart) |
| AutoScaling |
如果 Microsoft Excel 对三维图表进行缩放，使之与等效的二维图表的大小相近，则该属性值为 True。 属性 RightAngleAxes 必须为 True。 (继承自 _Chart) |
| BackWall |
返回一个 Walls 对象，该对象允许用户单独设置三维图表的后墙的格式。 此为只读属性。 (继承自 _Chart) |
| Bar3DGroup |
返回一个 ChartGroup 对象，该对象代表三维图表上的条形图组。 (继承自 _Chart) |
| BarShape |
返回或设置用于三维条形图或柱形图的形状。 (继承自 _Chart) |
| CategoryLabelLevel |
返回一个 XlCategoryLabelLevel 常量，该常量引用类别标签的来源级别。 C# 中的整数 (int ) 读/写。 (继承自 _Chart) |
| ChartArea |
返回一个 ChartArea 对象，该对象代表图表的完整图表区。 (继承自 _Chart) |
| ChartColor |
以 C # ) 返回 或设置整数 (int ，表示图表的配色方案。 读写。 (继承自 _Chart) |
| ChartStyle |
返回或设置图表的图表样式。 读/写。 (继承自 _Chart) |
| ChartTitle |
返回一个 ChartTitle 对象，该对象代表指定图表的标题。 (继承自 _Chart) |
| ChartType |
返回或设置图表类型。 (继承自 _Chart) |
| CodeName |
返回对象的代码名。 (继承自 _Chart) |
| Column3DGroup |
返回一个 ChartGroup 对象，该对象代表三维图表上的柱形图组。 (继承自 _Chart) |
| Corners |
返回一个 Corners 对象，该对象代表三维图表的角。 (继承自 _Chart) |
| Creator |
在枚举中 XlCreator 返回一个常量，该常量指示创建此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 (继承自 _Chart) |
| DataTable |
返回表示 DataTable 图表数据表的 对象。 (继承自 _Chart) |
| DepthPercent |
返回或设置三维图表的深度，以图表宽度的百分比表示（有效范围从 20% 到 2000%）。 (继承自 _Chart) |
| DisplayBlanksAs |
返回或设置图表上的空白单元格的绘制方式。 可以是以下 XlDisplayBlanksAs 常量之一： xlNotPlotted、 xlInterpolated 或 xlZero。 (继承自 _Chart) |
| Dummy24 |
代表工作簿中的图表。 图表可以是嵌入图表 (包含在 ChartObject) 中，也可以是单独的图表工作表。 (继承自 _Chart) |
| Dummy25 |
代表工作簿中的图表。 图表可以是嵌入图表 (包含在 ChartObject) 中，也可以是单独的图表工作表。 (继承自 _Chart) |
| Elevation |
返回或设置三维图表视图的海拔（以度为单位）。 (继承自 _Chart) |
| Floor |
返回一个 Floor 对象，该对象代表三维图表的底板。 (继承自 _Chart) |
| GapDepth |
以标记宽度的百分比的形式返回或设置三维图表中数据系列之间的距离。 该属性的值必须介于 0 到 500 之间。 (继承自 _Chart) |
| HasAxis[Object, Object] |
返回或设置图表中出现的坐标轴。 (继承自 _Chart) |
| HasDataTable |
如果图表有模拟运算表，则该属性值为 True 。 (继承自 _Chart) |
| HasHiddenContent |
代表工作簿中的图表。 图表可以是嵌入图表 (包含在 ChartObject) 中，也可以是单独的图表工作表。 (继承自 _Chart) |
| HasLegend |
如果图表有图例，则该属性值为 True 。 (继承自 _Chart) |
| HasPivotFields |
如此 如果 数据透视图控件显示在指定的数据透视图报表上。 默认值为 True。 对于常规图表，此属性始终返回 False ，无法设置。 (继承自 _Chart) |
| HasTitle |
如果坐标轴或图表有可见标题，则该属性值为 True 。 (继承自 _Chart) |
| HeightPercent |
返回或设置三维图表的高度，以图表宽度的百分比表示（有效范围从 5% 到 500%）。 (继承自 _Chart) |
| Hyperlinks |
返回一个 Hyperlinks 集合，该集合表示区域或工作表的超链接。 (继承自 _Chart) |
| Index |
返回对象在其同类对象所组成的集合内的编号。 (继承自 _Chart) |
| Legend |
返回一个 Legend 对象，该对象代表图表的图例。 (继承自 _Chart) |
| Line3DGroup |
返回一个 ChartGroup 对象，该对象代表三维图表上的折线图组。 (继承自 _Chart) |
| MailEnvelope |
表示文档的电子邮件标题。 (继承自 _Chart) |
| Name |
返回或设置对象的名称。 (继承自 _Chart) |
| Next |
返回一个 Chart 对象，该对象代表下一个工作表或单元格。 (继承自 _Chart) |
| OnDoubleClick |
仅供内部使用。 (继承自 _Chart) |
| OnSheetActivate |
仅供内部使用。 (继承自 _Chart) |
| OnSheetDeactivate |
仅供内部使用。 (继承自 _Chart) |
| PageSetup |
返回一个 PageSetup 对象，该对象包含指定对象的所有页面设置设置。 (继承自 _Chart) |
| Parent |
返回指定对象的父对象。 (继承自 _Chart) |
| Perspective |
返回或设置三维图表视图的透视系数。 必须介于 0 和 100 之间。 如果该属性为 True，RightAngleAxes则忽略此属性。 (继承自 _Chart) |
| Pie3DGroup |
返回一个 ChartGroup 对象，该对象代表三维图表上的饼图组。 (继承自 _Chart) |
| PivotLayout |
返回一个 PivotLayout 对象，该对象表示字段在数据透视表中的位置以及轴在数据透视图报表中的位置。 (继承自 _Chart) |
| PlotArea |
返回一个 PlotArea 对象，该对象代表图表的绘图区。 (继承自 _Chart) |
| PlotBy |
返回或设置图表上的列或行用作数据系列的方式。 可以是以下 XlRowCol 常量之一： xlColumns 或 xlRows。 对于数据透视图报表中，此属性是只读的且始终返回 xlColumns 。 (继承自 _Chart) |
| PlotVisibleOnly |
如此 如果只绘制可见单元格。 假 如果可见和隐藏单元格的绘制。 (继承自 _Chart) |
| Previous |
返回一个 对象，该对象代表上一 Chart 个工作表或单元格。 (继承自 _Chart) |
| PrintedCommentPages |
获取将为当前图表打印的注释页数。 (继承自 _Chart) |
| ProtectContents |
如果工作表内容是受保护的，则为 True。 这可以保护整个图表。 (继承自 _Chart) |
| ProtectData |
如果用户不能更改系列公式，则该属性值为 True。 (继承自 _Chart) |
| ProtectDrawingObjects |
如果形状是受保护的，则为 True。 (继承自 _Chart) |
| ProtectFormatting |
如果用户不能更改格式，则该属性值为 True。 (继承自 _Chart) |
| ProtectGoalSeek |
如果用户不能用鼠标操作修改图表数据点，则该属性值为 True。 (继承自 _Chart) |
| ProtectionMode |
如果启用了用户界面专用保护，则为 True。 若要启用用户界面保护，请使用 Protect(Object, Object, Object, Object, Object) 参数设置为 True 的方法 |
| ProtectSelection |
如果不能选定图表元素，则该属性值为 True。 (继承自 _Chart) |
| RightAngleAxes |
如果图表的坐标轴为直角，并与图表的转角或仰角无关，则该属性值为 True。 仅应用于三维折线图、柱形图和条形图。 (继承自 _Chart) |
| Rotation |
返回或设置三维图表视图的旋转 (围绕 z 轴的绘图区的旋转（以度为单位) ）。 本属性的取值必须介于 0 到 360 之间，三维条形图除外（从 0 到 44 之间）。 默认值为 20。 仅适用于三维图表。 (继承自 _Chart) |
| Scripts |
返回 Scripts 集合，该集合包含 Script 表示指定文档中脚本或代码块的对象（保存为网页时）。 (继承自 _Chart) |
| SeriesNameLevel |
返回一个 XlSeriesNameLevel 常量，该常量引用系列名称的来源级别。 C# 中的整数 (int ) 读/写。 (继承自 _Chart) |
| Shapes |
返回一个 Shapes 对象，该对象代表工作表或图表工作表上的所有形状。 此为只读属性。 (继承自 _Chart) |
| ShowAllFieldButtons |
获取或设置是否在数据透视图上显示所有字段按钮。 (继承自 _Chart) |
| ShowAxisFieldButtons |
获取或设置是否在数据透视图上显示轴字段按钮。 (继承自 _Chart) |
| ShowDataLabelsOverMaximum |
返回或设置当值大于数值轴上的最大值时是否显示数据标签。 读/写。 (继承自 _Chart) |
| ShowLegendFieldButtons |
获取或设置是否在数据透视图上显示图例字段按钮。 (继承自 _Chart) |
| ShowReportFilterFieldButtons |
获取或设置是否在数据透视图上显示报表筛选字段按钮。 (继承自 _Chart) |
| ShowValueFieldButtons |
获取或设置是否在数据透视图上显示值字段按钮。 (继承自 _Chart) |
| ShowWindow |
如此 如果 嵌入的图表显示在单独的窗口中。 Chart与此属性一起使用的对象必须引用嵌入的图表。 (继承自 _Chart) |
| SideWall |
返回一个 Walls 对象，该对象允许用户单独设置三维图表的侧墙格式。 此为只读属性。 (继承自 _Chart) |
| SizeWithWindow |
如此 如果 Microsoft Excel 调整图表的大小以匹配图表工作表窗口的大小。 如果图表大小未附加到窗口大小，则为 False。 仅适用于图表工作表， (不适用于嵌入图表) 。 (继承自 _Chart) |
| SubType |
仅供内部使用。 (继承自 _Chart) |
| SurfaceGroup |
返回一个 ChartGroup 对象，该对象代表三维图表的图面图表组。 (继承自 _Chart) |
| Tab |
返回 Tab 图表或工作表的 对象。 (继承自 _Chart) |
| Type |
仅供内部使用。 (继承自 _Chart) |
| Visible |
决定对象是否可见。 (继承自 _Chart) |
| Walls |
返回一个 Walls 对象，该对象代表三维图表的墙壁。 (继承自 _Chart) |
| WallsAndGridlines2D |
如果三维图表中的网格线以二维方式绘制，则该属性值为 True。 (继承自 _Chart) |
方法
事件
| Activate |
在激活图表工作表或嵌入图表时发生。 (继承自 ChartEvents_Event) |
| BeforeDoubleClick |
在默认双击操作之前双击嵌入的图表时发生。 (继承自 ChartEvents_Event) |
| BeforeRightClick |
在默认的右键单击操作之前右键单击嵌入的图表时发生。 (继承自 ChartEvents_Event) |
| Calculate |
在图表绘制新的或更改的数据之后发生。 (继承自 ChartEvents_Event) |
| Deactivate |
停用图表时发生。 (继承自 ChartEvents_Event) |
| DragOver |
在图表上拖动单元格区域时发生。 (继承自 ChartEvents_Event) |
| DragPlot |
在图表上拖放单元格区域时发生。 (继承自 ChartEvents_Event) |
| MouseDown |
当在图表上按下鼠标按钮时，发生此事件。 (继承自 ChartEvents_Event) |
| MouseMove |
当鼠标指针在图表上的位置改变时发生此事件。 (继承自 ChartEvents_Event) |
| MouseUp |
当在图表上释放鼠标按钮时发生此事件。 (继承自 ChartEvents_Event) |
| Resize |
调整图表大小时发生此事件。 (继承自 ChartEvents_Event) |
| Select |
选定图表元素时发生此事件。 (继承自 ChartEvents_Event) |
| SeriesChange |
当用户更改图表数据点的值时发生。 (继承自 ChartEvents_Event) |
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈