ControlCollection.AddChart – metoda (Double, Double, Double, Double, String)

Článek
01/03/2014

Přidá nový Chart list v zadané velikosti a umístění ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
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
)

Parametry

left
Typ: System.Double
Vzdálenost v bodech mezi levým okrajem ovládacího prvku a levým okrajem listu.

top
Typ: System.Double
Vzdálenost v bodech mezi horním okrajem ovládacího prvku a horním okrajem listu.

width
Typ: System.Double
Šířka ovládacího prvku v bodech.

height
Typ: System.Double
Výšku ovládacího prvku v bodech.

name
Typ: System.String
Název ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Chart
Chart Ovládací prvek, který byl přidán ControlCollection instance.

Výjimky

Výjimka	Podmínka
ArgumentNullException	Argument pro název nullodkaz null (Nothing v jazyce Visual Basic) nebo má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.

Poznámky

AddChart Metoda umožňuje přidat Chart ovládacích prvků na konec ControlCollection.Chcete-li odebrat Chart ovládací prvek, který byl dříve přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu vloží číslo 16 buněk E1 přes E3 a číslo 24 na buňky F1 přes F3.Kód poté vytvoří Chart k hornímu okraji buňky list a předá řízení E1 přes F3 na SetSourceData metoda naplnění graf s daty.

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;
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.