Chart.GetChartElement, méthode (Project)

Article
04/07/2023

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 publiée de Project 2013.

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 graphique.
y	Obligatoire	Long	Coordonnée Y de l'élément graphique.
ElementID	Obligatoire	Long	Lorsque la méthode GetChartElement est retournée, ElementID contient la valeur Office.XLChartItem de l’élément de graphique aux coordonnées spécifiées. Pour plus d’informations, consultez Remarques.
Arg1	Obligatoire	Long	Lorsque la méthode est retournée, Arg1 contient des informations relatives à l’élément de graphique. Pour plus d’informations, consultez Remarques.
Arg2	Obligatoire	Long	Lorsque la méthode est retournée, Arg2 contient des informations relatives à l’élément de graphique. Pour plus d’informations, consultez Remarques.

Valeur renvoyée

La méthode GetChartElement retourne Nothing. Les valeurs retournées se trouvent dans les paramètres ElementID, Arg1 et Arg2 .

Remarques

Remarque

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

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

La valeur de 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 d’élément

Constante ElementID	Valeur de la 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 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. Il peut s’agir de l’une des constantes Office.XlAxisGroup suivantes : xlPrimary ou xlSecondary.
AxisType	Spécifie le type d’axe. Il peut s’agir de l’une des constantes Office.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 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	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éplacement est xlDataField.
PointIndex	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.
SeriesIndex	Spécifie le décalage dans Office.IMsoChart.SeriesCollection 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 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) dans le graphique. Par exemple, si le point se trouve dans la zone de traçage, la sortie dans le volet Exécution 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.

Partager via