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.
- width
Type : System.Double
Largeur du contrôle en points.
- height
Type : System.Double
Hauteur du contrôle en points.
- name
Type : System.String
Nom du contrôle.
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
- 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.