Condividi tramite


Metodo Chart.GetChartElement

Ottiene informazioni relative all'elemento del grafico in corrispondenza delle coordinate X e Y specificate.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • x
    Tipo: System.Int32
    Coordinata X dell'elemento del grafico.
  • y
    Tipo: System.Int32
    Coordinata Y dell'elemento del grafico.
  • ElementID
    Tipo: System.Int32%
    Quando il metodo restituisce il risultato, questo argomento contiene il valore XlChartItem dell'elemento del grafico in corrispondenza delle coordinate specificate.Per ulteriori informazioni, vedere la sezione "Note".
  • Arg1
    Tipo: System.Int32%
    Quando il metodo restituisce il risultato, questo argomento contiene informazioni correlate all'elemento del grafico.Per ulteriori informazioni, vedere la sezione "Note".
  • Arg2
    Tipo: System.Int32%
    Quando il metodo restituisce il risultato, questo argomento contiene informazioni correlate all'elemento del grafico.Per ulteriori informazioni, vedere la sezione "Note".

Note

Questo metodo è poco utilizzato poiché vengono specificati valori solo per i primi due argomenti. Gli altri argomenti vengono completati automaticamente in Microsoft Office Excel e il codice deve esaminare tali valori alla restituzione del metodo.

Il valore di ElementID dopo l'esecuzione del metodo determina se gli argomenti Arg1 e Arg2 contengono informazioni, come illustrato nella tabella seguente.

ElementID

Arg1

Arg2

xlAxis

AxisIndex

AxisType

xlAxisTitle

AxisIndex

AxisType

xlDisplayUnitLabel

AxisIndex

AxisType

xlMajorGridlines

AxisIndex

AxisType

xlMinorGridlines

AxisIndex

AxisType

xlPivotChartDropZone

DropZoneType

Nessuno

xlPivotChartFieldButton

DropZoneType

PivotFieldIndex

xlDownBars

GroupIndex

Nessuno

xlDropLines

GroupIndex

Nessuno

xlHiLoLines

GroupIndex

Nessuno

xlRadarAxisLabels

GroupIndex

Nessuno

xlSeriesLines

GroupIndex

Nessuno

xlUpBars

GroupIndex

Nessuno

xlChartArea

Nessuno

Nessuno

xlChartTitle

Nessuno

Nessuno

xlCorners

Nessuno

Nessuno

xlDataTable

Nessuno

Nessuno

xlFloor

Nessuno

Nessuno

xlLeaderLines

Nessuno

Nessuno

xlLegend

Nessuno

Nessuno

xlNothing

Nessuno

Nessuno

xlPlotArea

Nessuno

Nessuno

xlWalls

Nessuno

Nessuno

xlDataLabel

SeriesIndex

PointIndex

xlErrorBars

SeriesIndex

Nessuno

xlLegendEntry

SeriesIndex

Nessuno

xlLegendKey

SeriesIndex

Nessuno

xlSeries

SeriesIndex

PointIndex

xlShape

ShapeIndex

Nessuno

xlTrendline

SeriesIndex

TrendLineIndex

xlXErrorBars

SeriesIndex

Nessuno

xlYErrorBars

SeriesIndex

Nessuno

Nella tabella riportata di seguito viene descritto il significato dei parametri Arg1 e Arg2 dopo la restituzione del metodo.

Argomento

Descrizione

AxisIndex

Specifica se l'asse è principale o secondario. Può essere una delle seguenti costanti di XlAxisGroup: xlPrimary o xlSecondary.

AxisType

Specifica il tipo di asse. Può essere una delle seguenti costanti di XlAxisType: xlCategory, xlSeriesAxis o xlValue.

DropZoneType

Specifica il tipo di area di rilascio: campo di colonna, dati, pagina o riga. Può essere una delle seguenti costanti di XlPivotFieldOrientation: xlColumnField, xlDataField, xlPageField o xlRowField. Le costanti di campo di colonna o di riga specificano rispettivamente i campi delle serie e delle categorie.

GroupIndex

Specifica l'offset all'interno della raccolta ChartGroups per uno specifico gruppo di grafici.

PivotFieldIndex

Specifica l'offset all'interno della raccolta PivotFields per uno specifico campo di colonna (serie), di dati, di pagina o di riga (categoria). -1 se il tipo di area di rilascio è xlDataField.

PointIndex

Specifica l'offset all'interno della raccolta Points per uno specifico punto all'interno di una serie. Il valore – 1 indica che tutti i punti dati sono selezionati.

SeriesIndex

Specifica l'offset all'interno della raccolta Series per una specifica serie.

ShapeIndex

Specifica l'offset all'interno della raccolta Shapes per una specifica forma.

TrendlineIndex

Specifica l'offset all'interno della raccolta Trendlines per una specifica linea di tendenza in una serie.

Esempi

Nell'esempio di codice seguente vengono utilizzati un metodo Microsoft.Office.Tools.Excel.Chart e quindi il metodo GetChartElement per visualizzare l'elemento del grafico quando un utente fa clic sul grafico.

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());
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

Chart Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel