Méthode Chart.GetChartElement (Project)

Cette méthode renvoie les informations concernant l'élément graphique situé aux coordonnées X et Y spécifiées. Cette méthode sera supprimée dans la version commerciale de Project 2013.

Syntaxe

expression. GetChartElement (x, y, ElementID,Arg1, Arg2)

expression Variable qui représente un objet Chart.

Paramètres

Nom Requis/Facultatif Type de données Description
x Obligatoire Long Coordonnée X de l'élément graphique.
y Obligatoire Long Coordonnée Y de l'élément graphique.
ID élément Obligatoire Long Lorsque la méthode GetChartElement est renvoyée, ElementID contient la valeur Office.XLChartItem de l’élément de graphique aux coordonnées spécifiées. Pour plus d’informations, voir Remarques.
Arg1 Obligatoire Long Lorsque la méthode est renvoyée, Arg1 contient des informations relatives à l’élément de graphique. Pour plus d’informations, voir Remarques.
Arg2 Obligatoire Long Lorsque la méthode est renvoyée, Arg2 contient des informations relatives à l’élément de graphique. Pour plus d’informations, voir Remarques.

Valeur renvoyée

La méthode GetChartElementne renvoie rien. Les valeurs renvoyées sont dans les paramètres ElementID,Arg1 et Arg2 .

Remarques

Remarque

La méthode GetChartElement sera supprimée de la version publiée de Project 2013. L’objet Chart dans Project n’implémente pas d’événements ; Ainsi, un graphique dans Project ne peut pas être animé avec la méthode GetChartElement en interagissant avec les événements de la souris.

La méthode GetChartElement est inhabituelle car vous spécifiez des valeurs uniquement pour les deux premiers arguments. Project renvoie les données des autres arguments, et votre code doit examiner ces valeurs lorsque la méthode est renvoyée.

La valeur d’ElementID après le retour de la méthode détermine si Arg1 et Arg2 contiennent des informations (voir tableau 1).

Tableau 1. Informations dans Arg1 et Arg2, basées sur l’ID de l’élément

Constante ElementID Valeur de la constante Arg1 Arg2
xlAxis 21 AxisIndex Type d’axe
xlAxisTitle 17 AxisIndex Type d’axe
xlDisplayUnitLabel 30 AxisIndex Type d’axe
xlMajorGridlines 15 AxisIndex Type d’axe
xlMinorGridlines 16 AxisIndex Type d’axe
xlPivotChartDropZone 32 Type de DropZone Aucun
xlPivotChartFieldButton 31 Type de DropZone PivotFieldIndex (en anglais)
xlDownBars 20 GroupIndex Aucun
xlDropLines 26 GroupIndex Aucun
xlHiLoLines 25 GroupIndex Aucun
xlRadarAxisLabels 27 GroupIndex Aucun
xlSeriesLines 22 GroupIndex Aucun
xlUpBars 18 GroupIndex Aucun
xlChartArea 2 Aucun Aucun
xlChartTitle 4 Aucun Aucun
xlCorners 6 Aucun Aucun
xlDataTable 7 Aucun Aucun
xlFloor 23 Aucun Aucun
xlLeadersLines 29 Aucun Aucun
xlLegend 24 Aucun Aucun
xlRien 28 Aucun Aucun
xlPlotArea 19 Aucun Aucun
xlWalls 5 Aucun Aucun
xlDataLabel 7 Index de la série Index des points
xlErrorBars 9 Index de la série Aucun
xlLegendEntry 12 Index de la série Aucun
xlLegendKey 13 Index de la série Aucun
xlSeries 3 Index de la série Index des points
xlShape 14 Index ShapeIndex Aucun
xlTrendline 8 Index de la série Index de la tendance
xlXErrorBars 10 Index de la série Aucun
xlYErrorBars 11 Index de la série Aucun

Le tableau 2 décrit la signification de Arg1 et Arg2 après le retour de la méthode. Les valeurs de la colonne Argument proviennent du tableau 1.

Tableau 2. Signification des données dans Arg1 et Arg2

Argument Description
AxisIndex Spécifie s’il s’agit d’un axe principal ou secondaire. Peut être l’une des constantes Office.XlAxisGroup suivantes : xlPrimary ou xlSecondary.
Type d’axe Spécifie le type d’axe. Peut être l’une des constantes Office.XlAxisType suivantes : xlCategory, xlSeriesAxis ou xlValue.
Type de DropZone Spécifie le type de zone de projection : champ de colonne, de données, de page ou de ligne. Peut être l’une des constantes Office.XlPivotFieldOrientation suivantes : xlColumnField, xlDataField, xlPageField ou xlRowField. Les constantes de champ de colonne et de ligne définissent respectivement les champs de série et de catégorie.
GroupIndex Spécifie le décalage dans la collection Office.IMsoChart.ChartGroups pour un groupe de graphiques spécifique.
PivotFieldIndex (en anglais) Spécifie le décalage dans la collection Excel.PivotFields pour un champ de colonne (série), de données, de page ou de ligne (catégorie) spécifique. La valeur est -1 si le type de zone de dépôt est xlDataField.
Index des points Spécifie le décalage dans la collection Office.IMsoSeries.Points pour un point spécifique au sein d’une série. La valeur 1 indique que tous les points de données sont sélectionnés.
Index de la série Spécifie le décalage dans Office.IMsoChart.SeriesCollection pour une série spécifique.
Index ShapeIndex Spécifie le décalage dans la collection Formes pour une forme spécifique.
Indice de tendance Spécifie le décalage dans la collection Office.IMsoSeries.Trendlines pour une courbe de tendance spécifique au sein d’une série.

Exemple

L’exemple suivant obtient les informations d’élément de graphique pour le point (100, 100) du graphique. Par exemple, si le point se trouve dans la zone de traçage, la sortie dans le volet Immédiat est idNum: 19, a: 0, b: 0. D’après les informations du tableau 1, xlPlotArea = 19.

Sub TestGetChartElements()
    Dim chartShape As Shape
    Dim reportName As String
    Dim x As Long
    Dim y As Long
    Dim idNum As Long
    Dim a As Long
    Dim b As Long
    
    reportName = "Simple scalar chart"
    Set chartShape = ActiveProject.Reports(reportName).Shapes(1)
    
    ' Specify a point in the chart.
    x = 100
    y = 100
    
    chartShape.Chart.GetChartElement x, y, idNum, a, b
    
    Debug.Print "idNum: " & idNum & ", a: " & a & ", b: " & b
End Sub

Voir aussi

Objet Chart

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.