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.

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

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