Partager via


Chart.GetChartElement, méthode

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

Voir aussi

Référence

Chart Interface

Microsoft.Office.Tools.Excel, espace de noms