Metodo ChartSheetBase.GetChartElement

Articolo
08/11/2011

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.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Sub GetChartElement ( _
    x As Integer, _
    y As Integer, _
    ByRef elementID As Integer, _
    ByRef arg1 As Integer, _
    ByRef arg2 As Integer _
)

public 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	Nessuna correzione
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	GroupIndex	Nessuna correzione
xlDropLines	GroupIndex	Nessuna correzione
xlHiLoLines	GroupIndex	Nessuna correzione
xlRadarAxisLabels	GroupIndex	Nessuna correzione
xlSeriesLines	GroupIndex	Nessuna correzione
xlUpBars	GroupIndex	Nessuna correzione
xlChartArea	Nessuna correzione	Nessuna correzione
xlChartTitle	Nessuna correzione	Nessuna correzione
xlCorners	Nessuna correzione	Nessuna correzione
xlDataTable	Nessuna correzione	Nessuna correzione
xlFloor	Nessuna correzione	Nessuna correzione
xlLeaderLines	Nessuna correzione	Nessuna correzione
xlLegend	Nessuna correzione	Nessuna correzione
xlNothing	Nessuna correzione	Nessuna correzione
xlPlotArea	Nessuna correzione	Nessuna correzione
xlWalls	Nessuna correzione	Nessuna correzione
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	Nessuna correzione
xlLegendEntry	SeriesIndex	Nessuna correzione
xlLegendKey	SeriesIndex	Nessuna correzione
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	Nessuna correzione
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	Nessuna correzione
xlYErrorBars	SeriesIndex	Nessuna correzione

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

Argomento	Oggetto di 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 dell'insieme Microsoft.Office.Interop.Excel.ChartGroups per uno specifico gruppo di grafici.
PivotFieldIndex	Specifica l'offset all'interno dell'insieme T:Microsoft.Office.Interop.Excel.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 dell'insieme 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 dell'insieme Series per una specifica serie.
ShapeIndex	Specifica l'offset all'interno dell'insieme Shapes per una specifica forma.
TrendlineIndex	Specifica l'offset all'interno dell'insieme Trendlines per una specifica linea di tendenza in una serie.

Esempi

Nell'esempio di codice seguente viene utilizzato il metodo GetChartElement per visualizzare l'elemento del grafico quando un utente fa clic sul grafico.

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

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    Me.ChartType = Excel.XlChartType.xlColumnClustered
End Sub

Sub ChartSheet_MouseDown(ByVal Button As Integer, ByVal Shift As Integer, _
    ByVal x As Integer, ByVal y As Integer) Handles Me.MouseDown

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

    Me.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 void DisplayChartElement()
{
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    this.ChartType = Excel.XlChartType.xlColumnClustered;

    this.MouseDown +=
        new Excel.ChartEvents_MouseDownEventHandler(ChartSheet_MouseDown);
}

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

    this.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

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ChartSheetBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite