Chart.GetChartElement-Methode

Artikel
08/10/2011

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über