共用方式為

ControlCollection.AddChart 方法 (Double, Double, Double, Double, String)

  • 發行項

將新的 Chart 控制項依指定大小和位置加入至工作表。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function AddChart ( _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As Chart

Chart AddChart(
    double left,
    double top,
    double width,
    double height,
    string name
)

參數

  • left
    型別：System.Double
    控制項左邊緣和工作表左邊緣之間的距離 (以點為單位)。
  • top
    型別：System.Double
    控制項上邊緣和工作表上邊緣之間的距離 (以點為單位)。
  • width
    型別：System.Double
    控制項的寬度 (以點為單位)。
  • height
    型別：System.Double
    控制項的高度 (以點為單位)。

傳回值

型別：Microsoft.Office.Tools.Excel.Chart
加入 ControlCollection 執行個體的 Chart 控制項中。

例外狀況

例外狀況 條件
ArgumentNullException

名稱引數為 nullnull 參考 (即 Visual Basic 中的 Nothing)，或者長度為 0。
ControlNameAlreadyExistsException

具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。

備註

AddChart 方法可以用來將 Chart 控制項加入至 ControlCollection 的結尾。若要移除先前以程式設計方式加入的 Chart 控制項，請使用 Remove 方法。

範例

下列程式碼範例會將數字 16 插入儲存格 E1 至 E3，以及將數字 24 加入至 F1 至 F3。然後程式碼會在工作表頂端建立一個 Chart 控制項，然後將儲存格 E1 至 F3 傳遞至 SetSourceData 方法，將資料填入圖表。

Private Sub ExcelAddChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel. _
        Chart = Me.Controls.AddChart(0, 0, 130, _
        130, "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F3"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub

private void ExcelAddChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(0, 0, 130, 130, "chart1");

    chart1.SetSourceData(this.Range["E1", "F3"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

.NET Framework 安全性

請參閱

參考

ControlCollection 介面

AddChart 多載

Microsoft.Office.Tools.Excel 命名空間