Partager via


ControlCollection.AddChart, méthode (Double, Double, Double, Double, String)

Ajoute un nouveau contrôle Chart à la feuille de calcul selon la taille et l'emplacement spécifiés.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
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
)

Paramètres

  • left
    Type : System.Double
    Distance, en points, entre le bord gauche du contrôle et le bord gauche de la feuille de calcul.
  • top
    Type : System.Double
    Distance, en points, entre le bord supérieur du contrôle et le bord supérieur de la feuille de calcul.

Valeur de retour

Type : Microsoft.Office.Tools.Excel.Chart
Contrôle Chart qui a été ajouté à l'instance de ControlCollection.

Exceptions

Exception Condition
ArgumentNullException

L'argument de nom a la valeur nullune référence null (Nothing en Visual Basic) ou une longueur nulle.

ControlNameAlreadyExistsException

Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.

Notes

La méthode AddChart vous permet d'ajouter des contrôles Chart à la fin de ControlCollection.Pour supprimer un contrôle Chart précédemment ajouté par programme, utilisez la méthode Remove.

Exemples

L'exemple de code suivant insère le nombre 16 dans les cellules E1 à E3 et le nombre 24 dans les cellules F1 à F3.Le code crée ensuite un contrôle Chart en haut de la feuille de calcul et passe les cellules E1 à F3 à la méthode SetSourceData pour remplir le graphique avec les données.

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

Sécurité .NET Framework

Voir aussi

Référence

ControlCollection Interface

AddChart, surcharge

Microsoft.Office.Tools.Excel, espace de noms