Freigeben über


Chart.GetChartElement-Methode

Ruft Informationen über das Diagrammelement an den angegebenen X- und Y-Koordinaten ab.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

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

Parameter

  • x
    Typ: System.Int32
    Die X-Koordinate des Diagrammelements.
  • y
    Typ: System.Int32
    Die Y-Koordinate des Diagrammelements.
  • ElementID
    Typ: System.Int32%
    Diese Methode gibt ein Argument zurück, das den XlChartItem-Wert des Diagrammelements an den angegebenen Koordinaten enthält.Weitere Informationen finden Sie im Abschnitt "Hinweise".
  • Arg1
    Typ: System.Int32%
    Diese Methode gibt ein Argument zurück, das Informationen zum Diagrammelement enthält.Weitere Informationen finden Sie im Abschnitt "Hinweise".
  • Arg2
    Typ: System.Int32%
    Diese Methode gibt ein Argument zurück, das Informationen zum Diagrammelement enthält.Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweise

Diese Methode ist unüblich, da Sie nur für die ersten zwei Argumente Werte angeben. Microsoft Office Excel füllt die anderen Argumente aus, und Ihr Code muss diese Werte prüfen, wenn die Methode zurückgegeben wird.

Der Wert von ElementID nach Zurückgeben der Methode bestimmt, ob Arg1 und Arg2 Informationen enthalten, wie in folgender Tabelle dargestellt.

ElementID

Arg1

Arg2

xlAxis

AxisIndex

AxisType

xlAxisTitle

AxisIndex

AxisType

xlDisplayUnitLabel

AxisIndex

AxisType

xlMajorGridlines

AxisIndex

AxisType

xlMinorGridlines

AxisIndex

AxisType

xlPivotChartDropZone

DropZoneType

None

xlPivotChartFieldButton

DropZoneType

PivotFieldIndex

xlDownBars

GroupIndex

None

xlDropLines

GroupIndex

None

xlHiLoLines

GroupIndex

None

xlRadarAxisLabels

GroupIndex

None

xlSeriesLines

GroupIndex

None

xlUpBars

GroupIndex

None

xlChartArea

None

None

xlChartTitle

None

None

xlCorners

None

None

xlDataTable

None

None

xlFloor

None

None

xlLeaderLines

None

None

xlLegend

None

None

xlNothing

None

None

xlPlotArea

None

None

xlWalls

None

None

xlDataLabel

SeriesIndex

PointIndex

xlErrorBars

SeriesIndex

None

xlLegendEntry

SeriesIndex

None

xlLegendKey

SeriesIndex

None

xlSeries

SeriesIndex

PointIndex

xlShape

ShapeIndex

None

xlTrendline

SeriesIndex

TrendLineIndex

xlXErrorBars

SeriesIndex

None

xlYErrorBars

SeriesIndex

None

In der folgenden Tabelle wird die Bedeutung von Arg1 und Arg2 nach dem Zurückgeben der Methode beschrieben.

Argument

Beschreibungen

AxisIndex

Gibt an, ob die Achse primär oder sekundär ist. Kann eine der folgenden XlAxisGroup-Konstanten sein: xlPrimary oder xlSecondary.

AxisType

Gibt den Achsentyp an. Kann eine der folgenden XlAxisType-Konstanten sein: xlCategory, xlSeriesAxis oder xlValue.

DropZoneType

Gibt den Ablagezonentyp an: Spalte, Daten, Seite oder Zeilenfeld. Kann einer der folgenden XlPivotFieldOrientation-Konstanten sein: xlColumnField, xlDataField, xlPageField oder xlRowField. Die Spalten- und Zeilenfeldkonstanten geben jeweils die Reihen- und Kategoriefelder an.

GroupIndex

Gibt den Offset in der ChartGroups-Auflistung für eine bestimmte Diagrammgruppe an.

PivotFieldIndex

Gibt den Offset in der PivotFields-Auflistung für ein bestimmtes Feld (Spalte (Reihe), Daten, Seite oder Zeile (Rubrik)) an. -1, wenn der Ablagezonentyp xlDataField ist.

PointIndex

Gibt den Offset in der Points-Auflistung für einen bestimmten Punkt in einer Reihe an. Ein Wert von - 1 gibt an, dass alle Datenpunkte ausgewählt sind.

SeriesIndex

Gibt den Offset in der Series-Auflistung für eine bestimmte Reihe an.

ShapeIndex

Gibt den Offset in der Shapes-Auflistung für eine bestimmte Form an.

TrendlineIndex

Gibt den Offset in der Trendlines-Auflistung für eine bestimmte Trendlinie in einer Reihe an.

Beispiele

Im folgenden Codebeispiel wird ein Microsoft.Office.Tools.Excel.Chart erstellt und dann mithilfe der GetChartElement-Methode das Diagrammelement angezeigt, wenn ein Benutzer auf das Diagramm klickt.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace