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,
Excel.XlRowCol.xlColumns);
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。