Chart.GetChartElement – metoda

Článek
05/14/2013

Získá informace o prvku grafu na zadané souřadnice X a Y.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

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

Parametry

x
Typ: System.Int32
Souřadnice X prvku grafu.

y
Typ: System.Int32
Souřadnice Y prvku grafu.

ElementID
Typ: System.Int32%
Když se vrátí metoda obsahuje tento argument XlChartItem hodnotu prvku grafu na zadaných souřadnic.Další informace naleznete v části "Poznámky".

Arg1
Typ: System.Int32%
Když se vrátí metoda tento argument obsahuje informace vztahující se k prvku grafu.Další informace naleznete v části "Poznámky".

Arg2
Typ: System.Int32%
Když se vrátí metoda tento argument obsahuje informace vztahující se k prvku grafu.Další informace naleznete v části "Poznámky".

Poznámky

Tato metoda neobvyklé v tom, že můžete zadat hodnoty pro první dva argumenty.Aplikace Microsoft Office Excel vyplní další argumenty a váš kód by měl prozkoumat tyto hodnoty, při metoda vrátí.

Hodnota ElementID po vrátí metoda určuje, zda Arg1 a Arg2 obsahovat žádné informace, jak je znázorněno v následující tabulce.

ElementID	Arg1	Arg2
xlAxis	AxisIndex	AxisType
xlAxisTitle	AxisIndex	AxisType
xlDisplayUnitLabel	AxisIndex	AxisType
xlMajorGridlines	AxisIndex	AxisType
xlMinorGridlines	AxisIndex	AxisType
xlPivotChartDropZone	DropZoneType	Žádná
xlPivotChartFieldButton	DropZoneType	PivotFieldIndex
xlDownBars	Index skupiny	Žádná
xlDropLines	Index skupiny	Žádná
xlHiLoLines	Index skupiny	Žádná
xlRadarAxisLabels	Index skupiny	Žádná
xlSeriesLines	Index skupiny	Žádná
xlUpBars	Index skupiny	Žádná
xlChartArea	Žádná	Žádná
xlChartTitle	Žádná	Žádná
xlCorners	Žádná	Žádná
xlDataTable	Žádná	Žádná
xlFloor	Žádná	Žádná
xlLeaderLines	Žádná	Žádná
xlLegend	Žádná	Žádná
xlNothing	Žádná	Žádná
xlPlotArea	Žádná	Žádná
xlWalls	Žádná	Žádná
xlDataLabel	SeriesIndex	PointIndex
xlErrorBars	SeriesIndex	Žádná
xlLegendEntry	SeriesIndex	Žádná
xlLegendKey	SeriesIndex	Žádná
xlSeries	SeriesIndex	PointIndex
xlShape	ShapeIndex	Žádná
xlTrendline	SeriesIndex	TrendLineIndex
xlXErrorBars	SeriesIndex	Žádná
xlYErrorBars	SeriesIndex	Žádná

Následující tabulka popisuje význam Arg1 a Arg2 po metoda vrátí.

Argument	Description
AxisIndex	Určuje, zda je na ose primární nebo sekundární.Může nabývat jedné z následujících XlAxisGroup konstanty: xlPrimary nebo xlSecondary.
AxisType	Určuje typ osy.Může nabývat jedné z následujících XlAxisType konstanty: xlCategory, xlSeriesAxis, nebo xlValue.
DropZoneType	Určuje typ zóny: sloupec, data, stránky nebo řádkové pole.Can be one of the following XlPivotFieldOrientation constants: xlColumnField, xlDataField, xlPageField, or xlRowField.Konstanty pole řádků a sloupců určete pole řad a kategorií, respektive.
Index skupiny	Určuje posun v rámci ChartGroups kolekce pro skupinu zvláštní graf.
PivotFieldIndex	Určuje posun v rámci PivotFields kolekce pro určitého sloupce (řad), data, stránky nebo řádkové (kategorie).-1, pokud je typ zóny xlDataField.
PointIndex	Určuje posun v rámci Points kolekce pro konkrétní bod v řadě.Hodnota-1 označuje, zda jsou vybrány všechny datové body.
SeriesIndex	Určuje posun v rámci Series kolekce pro určitou sérii.
ShapeIndex	Určuje posun v rámci Shapes kolekce pro určitý obrazec.
TrendlineIndex	Určuje posun v rámci Trendlines kolekce pro konkrétní spojnice trendu v řadě.

Příklady

Následující příklad kódu vytvoří Microsoft.Office.Tools.Excel.Chart a potom použije GetChartElement metoda zobrazení prvku grafu, když uživatel klikne na graf.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

Chart Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím