Partager via


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

Ajoute un nouveau contrôle Chart à la feuille de calcul à la plage spécifiée.

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

Syntaxe

'Déclaration
Function AddChart ( _
    range As Range, _
    name As String _
) As Chart
Chart AddChart(
    Range range,
    string name
)

Paramètres

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 ou de plage a la valeur nullune référence null (Nothing en Visual Basic) ou l'argument de nom a une longueur nulle.

ControlNameAlreadyExistsException

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

InvalidRangeException

La plage spécifiée n'est pas valide. Les plages sur plusieurs zones ne peuvent pas être utilisées. La plage doit se trouver dans la même feuille de calcul que 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 dans les cellules A1 à C8 et passe les cellules E1 à F3 à la méthode SetSourceData pour remplir le graphique avec les données.

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

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
        = Me.Controls.AddChart(Me.Range("A1", "C8"), _
        "Chart1")

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

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

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");

    chart1.SetSourceData(this.Range["E1", "F5"], 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