Chart.GetChartElement, méthode

Article
01/06/2014

Obtient des informations à propos de l'élément de graphique aux coordonnées X et Y spécifiées.

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

Syntaxe

'Déclaration
Sub GetChartElement ( _
    x As Integer, _
    y As Integer, _
    ByRef ElementID As Integer, _
    ByRef Arg1 As Integer, _
    ByRef Arg2 As Integer _
)

void GetChartElement(
    int x,
    int y,
    ref int ElementID,
    ref int Arg1,
    ref int Arg2
)

Paramètres

x
Type : System.Int32
Coordonnée X de l'élément du graphique.

y
Type : System.Int32
Coordonnée Y de l'élément du graphique.

ElementID
Type : System.Int32%
Lorsque la méthode retourne une valeur, cet argument contient la valeur XlChartItem de l'élément de graphique aux coordonnées spécifiées.Pour plus d'informations, consultez la section « Notes ».

Arg1
Type : System.Int32%
Lorsque la méthode retourne une valeur, cet argument contient les informations relatives à l'élément de graphique.Pour plus d'informations, consultez la section « Notes ».

Arg2
Type : System.Int32%
Lorsque la méthode retourne une valeur, cet argument contient les informations relatives à l'élément de graphique.Pour plus d'informations, consultez la section « Notes ».

Notes

Cette méthode est inhabituelle dans le sens où vous spécifiez des valeurs pour les deux premiers arguments seulement. Microsoft Office Excel renseigne les autres arguments et votre code doit examiner ces valeurs lorsque la méthode retourne une valeur.

La valeur de ElementID après que la méthode a retourné une valeur détermine si Arg1 et Arg2 contiennent des informations, comme illustré dans le tableau suivant.

ElementID	Arg1	Arg2
xlAxis	axisIndex	AxisType
xlAxisTitle	axisIndex	AxisType
xlDisplayUnitLabel	axisIndex	AxisType
xlMajorGridlines	axisIndex	AxisType
xlMinorGridlines	axisIndex	AxisType
xlPivotChartDropZone	DropZoneType	Aucun
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	Aucun
xlDropLines	GroupIndex	Aucun
xlHiLoLines	GroupIndex	Aucun
xlRadarAxisLabels	GroupIndex	Aucun
xlSeriesLines	GroupIndex	Aucun
xlUpBars	GroupIndex	Aucun
xlChartArea	Aucun	Aucun
xlChartTitle	Aucun	Aucun
xlCorners	Aucun	Aucun
xlDataTable	Aucun	Aucun
xlFloor	Aucun	Aucun
xlLeaderLines	Aucun	Aucun
xlLegend	Aucun	Aucun
xlNothing	Aucun	Aucun
xlPlotArea	Aucun	Aucun
xlWalls	Aucun	Aucun
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	Aucun
xlLegendEntry	SeriesIndex	Aucun
xlLegendKey	SeriesIndex	Aucun
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	Aucun
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	Aucun
xlYErrorBars	SeriesIndex	Aucun

Le tableau suivant décrit la signification de Arg1 et Arg2 après que la méthode a retourné une valeur.

Argument	Description
axisIndex	Spécifie si l'axe est 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 la zone de dépôt : colonne, données, page ou champ de ligne. Il peut s'agir de l'une des constantes XlPivotFieldOrientation suivantes : xlColumnField, xlDataField, xlPageField ou xlRowField. Les constantes de colonne et de ligne de champ indiquent respectivement les champs de série et de catégorie.
GroupIndex	Spécifie l'offset dans la collection ChartGroups pour un groupe de graphiques spécifique.
PivotFieldIndex	Spécifie l'offset dans la collection PivotFields pour une colonne (série), des données, une page ou un champ de ligne (catégorie) spécifiques. -1 si le type de zone de dépôt est xlDataField.
PointIndex	Spécifie l'offset dans la collection Points pour un point spécifique dans une série. Une valeur de – 1 indique que tous les points de données sont sélectionnés.
SeriesIndex	Spécifie l'offset dans la collection Series pour une série spécifique.
ShapeIndex	Spécifie l'offset dans la collection Shapes pour une forme spécifique.
TrendlineIndex	Spécifie l'offset dans la collection Trendlines pour une courbe de tendance spécifique dans une série.

Exemples

L'exemple de code suivant crée un Microsoft.Office.Tools.Excel.Chart, puis utilise la méthode GetChartElement pour afficher l'élément du graphique lorsqu'un utilisateur clique sur le graphique.

WithEvents elementChart As Microsoft.Office.Tools.Excel.Chart

Private Sub DisplayChartElement()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    elementChart = Me.Controls.AddChart(Me.Range("D2", "H12"), _
        "elementChart")
    elementChart.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    elementChart.ChartType = Excel.XlChartType.xl3DColumn
End Sub

Sub elementChart_MouseDownHandler(ByVal Button As Integer, ByVal Shift As Integer, _
    ByVal x As Integer, ByVal y As Integer) Handles elementChart.MouseDown

    Dim elementID As Integer = 0
    Dim arg1 As Integer = 0
    Dim arg2 As Integer = 0

    elementChart.GetChartElement(x, y, elementID, arg1, arg2)

    MsgBox("Chart element is: " & CType(elementID, Excel.XlChartItem).ToString() _
            & Constants.vbNewLine & "arg1 is: " & arg1.ToString() _
            & Constants.vbNewLine & "arg2 is: " & arg2.ToString())
End Sub

private Microsoft.Office.Tools.Excel.Chart elementChart;

private void DisplayChartElement()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    elementChart = this.Controls.AddChart(this.Range["D2", "H12"],
        "elementChart");

    elementChart.SetSourceData(this.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    elementChart.ChartType = Excel.XlChartType.xl3DColumn;
    elementChart.MouseDown +=
        new Excel.ChartEvents_MouseDownEventHandler(elementChart_MouseDown);
}

void elementChart_MouseDown(int Button, int Shift, int x, int y)
{
    Int32 elementID = 0;
    Int32 arg1 = 0;
    Int32 arg2 = 0;

    elementChart.GetChartElement(x, y, ref elementID, ref arg1, ref arg2);

    MessageBox.Show("Chart element is: " + ((Excel.XlChartItem)elementID).ToString()
        + "\n arg1 is: " + arg1.ToString() + "\n arg2 is: " + arg2.ToString());
}

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

Chart Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via