Chart.GetChartElement, méthode (Excel)
Retourne 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.
Parameters
| 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. |
| ElementID | Obligatoire | Long | Lorsque la méthode est retourné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 | AxisType |
| xlAxisTitle | 17 | AxisIndex | AxisType |
| xlDisplayUnitLabel | 30 | AxisIndex | AxisType |
| xlMajorGridlines | 15 | AxisIndex | AxisType |
| xlMinorGridlines | 16 | AxisIndex | AxisType |
| xlPivotChartDropZone | 32 | DropZoneType | Aucun |
| xlPivotChartFieldButton | 31 | DropZoneType | PivotFieldIndex |
| 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 |
| xlLeaderLines | 29 | Aucun | Aucun |
| xlLegend | 24 | Aucun | Aucun |
| xlNothing | 28 | Aucun | Aucun |
| xlPlotArea | 19 | Aucun | Aucun |
| xlWalls | 5 | Aucun | Aucun |
| xlDataLabel | 7 | SeriesIndex | PointIndex |
| xlErrorBars | 9 | SeriesIndex | Aucun |
| xlLegendEntry | 12 | SeriesIndex | Aucun |
| xlLegendKey | 13 | SeriesIndex | Aucun |
| xlSeries | 3 | SeriesIndex | PointIndex |
| xlShape | 14 | ShapeIndex | Aucun |
| xlTrendline | 8 | SeriesIndex | TrendLineIndex |
| xlXErrorBars | 10 | SeriesIndex | Aucun |
| xlYErrorBars | 11 | SeriesIndex | 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. Il peut s’agir de l’une des constantes XlAxisGroup suivantes : xlPrimary ou xlSecondary. |
| AxisType | Spécifie le type d’axe. Il peut s’agir de l’une des constantes XlAxisType suivantes : xlCategory, xlSeriesAxis ou xlValue. |
| DropZoneType | Spécifie le type de zone de projection : champ de colonne, de données, de page ou de ligne. Il peut s’agir de 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 | 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. |
| PointIndex | Spécifie le décalage dans la collection Points pour un point spécifique dans une série. La valeur 1 indique que tous les points de données sont sélectionnés. |
| SeriesIndex | Spécifie le décalage dans la collection Series pour une série spécifique. |
| ShapeIndex | Spécifie le décalage dans la collection Shapes pour une forme spécifique. |
| TrendlineIndex | Spécifie le décalage dans la collection Trendlines 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.