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 控件。
  • Format
    类型:System.Object
    内置自动套用格式的选项编号。可以是一个 1 到 10 之间的数(取决于库类型)。如果省略此参数,则 Excel 根据库类型和数据源选择默认值。
  • CategoryLabels
    类型:System.Object
    一个整数,指定源范围中包含类别标签的行数或列数。合法值是从 0(零)到相应类别或系列的最大数减一。
  • SeriesLabels
    类型:System.Object
    一个整数,指定源范围中包含系列标签的行数或列数。合法值是从 0(零)到相应类别或系列的最大数减一。
  • 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 安全性

请参见

参考

Chart 接口

Microsoft.Office.Tools.Excel 命名空间