Méthode Chart.GetChartElement (Excel)

Renvoie des informations sur l’élément de graphique aux coordonnées x et y spécifiées. Cette méthode est particulière en ce sens que vous ne spécifiez que les valeurs des deux premiers arguments. Microsoft Excel complète les autres arguments et c'est votre code qui examine ces valeurs lorsque la méthode renvoie son résultat.

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 de graphique.
y Obligatoire Long Coordonnée y de l’élément de graphique.
ID élément Obligatoire Long Lorsque la méthode est renvoyée, cet argument contient la valeur XLChartItem de l’élément de graphique aux coordonnées spécifiées. Pour plus d'informations, voir la section Notes.
Arg1 Obligatoire Long Lors du renvoi des résultats de la méthode, cet argument contient les informations concernant l’élément graphique. Pour plus d'informations, voir la section Notes.
Arg2 Obligatoire Long Lors du renvoi des résultats de la méthode, cet argument contient les informations concernant l’élément graphique. Pour plus d’informations, voir la section « Remarques».

Remarques

Après que la méthode a renvoyé son résultat, la valeur d'IDÉlément détermine si Arg1 et Arg2 contiennent des informations, comme indiqué dans le tableau suivant.

Constante ElementID Valeur 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 suivant explique ce que Arg1 et Arg2 signifient après le renvoi du résultat de la méthode.

Argument Description
AxisIndex Spécifie s’il s’agit d’un axe principal ou secondaire. Peut être l’une des constantes XlAxisGroup suivantes : xlPrimary ou xlSecondary.
Type d’axe Spécifie le type d’axe. Peut être l’une des constantes 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 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 ChartGroups pour un groupe de graphiques spécifique.
PivotFieldIndex (en anglais) Spécifie le décalage dans la collection PivotFields pour un champ de colonne (série), de données, de page ou de ligne (catégorie) spécifique. -1 si le type de zone de projection est xlDataField.
Index des points Spécifie le décalage dans la collection 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 la collection Series 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 Courbes de tendance pour une courbe de tendance spécifique au sein d’une série.

Exemple

Cet exemple montre comment avertir l'utilisateur lorsqu'il déplace la souris sur la légende du graphique.

Private Sub Chart_MouseMove(ByVal Button As Long, _ 
 ByVal Shift As Long, ByVal X As Long, ByVal Y As Long) 
 Dim IDNum As Long 
 Dim a As Long 
 Dim b As Long 
 
 ActiveChart.GetChartElement X, Y, IDNum, a, b 
 If IDNum = xlLegendEntry Then _ 
 MsgBox "WARNING: Move away from the legend" 
End Sub

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.