Share via

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 (零) 到對應類別或數列中最大數目減一的數字。
  • 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, 
        Excel.XlRowCol.xlColumns);
}

.NET Framework 安全性

請參閱

參考

Chart 介面

Microsoft.Office.Tools.Excel 命名空間