Chart.ChartWizard 方法
修改给定 Chart 控件的属性。 使用此方法可以快速地对 Chart 控件进行格式设置,而无需逐个设置所有属性。 此方法是非交互式的,它只更改指定的属性。
命名空间: Microsoft.Office.Tools.Excel
程序集: Microsoft.Office.Tools.Excel(在 Microsoft.Office.Tools.Excel.dll 中)
语法
声明
Sub ChartWizard ( _
Source As Object, _
Gallery As Object, _
Format As Object, _
PlotBy As Object, _
CategoryLabels As Object, _
SeriesLabels As Object, _
HasLegend As Object, _
Title As Object, _
CategoryTitle As Object, _
ValueTitle As Object, _
ExtraTitle As Object _
)
void ChartWizard(
Object Source,
Object Gallery,
Object Format,
Object PlotBy,
Object CategoryLabels,
Object SeriesLabels,
Object HasLegend,
Object Title,
Object CategoryTitle,
Object ValueTitle,
Object ExtraTitle
)
参数
- Source
类型:System.Object
包含新图表的源数据的范围。如果省略此参数,则 Microsoft Office Excel 编辑活动图表工作表或在活动工作表上选择的 Chart 控件。
- Gallery
类型:System.Object
XlChartType.图表类型。
- Format
类型:System.Object
内置自动套用格式的选项编号。可以是一个 1 到 10 之间的数(取决于库类型)。如果省略此参数,则 Excel 根据库类型和数据源选择默认值。
- PlotBy
类型:System.Object
指定每个系列的数据是按行绘制还是按列绘制。可以为以下 XlRowCol 常数之一:xlRows 或 xlColumns。
- CategoryLabels
类型:System.Object
一个整数,指定源范围中包含类别标签的行数或列数。合法值是从 0(零)到相应类别或系列的最大数减一。
- SeriesLabels
类型:System.Object
一个整数,指定源范围中包含系列标签的行数或列数。合法值是从 0(零)到相应类别或系列的最大数减一。
- HasLegend
类型:System.Object
为 true 时包含图例。
- Title
类型:System.Object
Chart 控件标题文本。
- CategoryTitle
类型:System.Object
分类轴标题文本。
- ValueTitle
类型:System.Object
数值轴标题文本
- ExtraTitle
类型:System.Object
三维图表的系列轴标题或二维图表的第二个数值轴标题。
备注
如果省略 Source,且所选内容不是活动工作表上的嵌入式图表或者活动工作表不是现有图表,则此方法会失败并发生错误。
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例使用 ChartWizard 方法创建一个显示单元格 A1 到 B5 范围内数据系列的三维柱形图。
Private Sub Create3DColumnChart()
Me.Range("A1", "A5").Value2 = 22
Me.Range("B1", "B5").Value2 = 55
Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")
Chart1.ChartWizard(Me.Range("A1", "B5"), _
Excel.XlChartType.xl3DColumn, PlotBy:=Excel.XlRowCol.xlColumns)
End Sub
private void Create3DColumnChart()
{
this.Range["A1", "A5"].Value2 = 22;
this.Range["B1", "B5"].Value2 = 55;
Microsoft.Office.Tools.Excel.Chart chart1 =
this.Controls.AddChart(this.Range["D2", "H12"],
"chart1");
chart1.ChartWizard(this.Range["A1", "B5"],
Excel.XlChartType.xl3DColumn, missing,
Excel.XlRowCol.xlColumns, missing, missing, missing,
missing, missing, missing, missing);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。