WorksheetBase.ChartObjects, méthode

Article
01/06/2014

Obtient un objet qui représente un graphique incorporé (Microsoft.Office.Interop.Excel.ChartObject) ou une collection de tous les graphiques incorporés (Microsoft.Office.Interop.Excel.ChartObjects) sur la feuille de calcul.

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

Syntaxe

'Déclaration
Public Function ChartObjects ( _
    index As Object _
) As Object

public Object ChartObjects(
    Object index
)

Paramètres

index
Type : System.Object
Nom ou numéro du graphique.Cet argument peut être un tableau, pour spécifier plusieurs graphiques.

Valeur de retour

Type : System.Object
Un objet qui représente un graphique incorporé (Microsoft.Office.Interop.Excel.ChartObject) ou une collection de tous les graphiques incorporés (Microsoft.Office.Interop.Excel.ChartObjects) sur la feuille de calcul.

Notes

Cette méthode n'est pas équivalente à la propriété Charts. Cette méthode retourne des graphiques incorporés ; la propriété Charts retourne des feuilles de graphique.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant montre comment utiliser la méthode ChartObjects pour obtenir la collection de graphiques incorporés et un seul graphique incorporé. L'exemple utilise d'abord la méthode ChartObjects pour obtenir la collection Microsoft.Office.Interop.Excel.ChartObjects de la feuille de calcul active et créer un nouveau Microsoft.Office.Interop.Excel.ChartObject. Après avoir mis en forme le nouveau Microsoft.Office.Interop.Excel.ChartObject et donner un nom à Microsoft.Office.Interop.Excel.ChartObject, l'exemple utilise la méthode ChartObjects pour obtenir le nouveau Microsoft.Office.Interop.Excel.ChartObject (indexé par son nom) et affiche un aperçu avant impression du graphique.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub CreateAndPreviewChart()
    Me.Range("A1", "A3").Value2 = 11
    Me.Range("B1", "B3").Value2 = 55

    Dim ChartObjects1 As Excel.ChartObjects = _
        CType(Me.ChartObjects(), Excel.ChartObjects)
    Dim chartObject1 As Excel.ChartObject = _
        ChartObjects1.Add(100, 20, 400, 250)

    chartObject1.Chart.ChartWizard(Me.Range("A1", "B3"), _
        Excel.XlChartType.xl3DColumn, Title:="New Chart")
    chartObject1.Name = "NewChartObject"

    Dim chartObject2 As Excel.ChartObject = _
        CType(Me.ChartObjects("NewChartObject"), Excel.ChartObject)
    chartObject2.Chart.PrintPreview(False)
End Sub

private void CreateAndPreviewChart()
{
    this.Range["A1", "A3"].Value2 = 11;
    this.Range["B1", "B3"].Value2 = 55;

    Excel.ChartObjects ChartObjects1 =
        (Excel.ChartObjects)this.ChartObjects();
    Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);

    chartObject1.Chart.ChartWizard(this.Range["A1", "B3"],
        Excel.XlChartType.xl3DColumn, "New Chart");
    chartObject1.Name = "NewChartObject";

    Excel.ChartObject chartObject2 =
        (Excel.ChartObject)this.ChartObjects("NewChartObject");
    chartObject2.Chart.PrintPreview(false);
}

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

WorksheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via