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

• range
  Type : Microsoft.Office.Interop.Excel.Range
  Range qui fournit les limites du contrôle.

• name
  Type : System.String
  Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.

Valeur de retour

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

Exceptions

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

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ControlCollection Interface

AddChart, surcharge

Microsoft.Office.Tools.Excel, espace de noms