ChartSheet.GetChartElement – metoda

Článek
01/03/2014

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.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
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
X souřadnice prvku grafu.

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

ElementID
Typ: System.Int32%
Pokud metoda vrátí, obsahuje tento argument XlChartItem hodnota prvku grafu na zadaných souřadnic.Další informace naleznete v části „Poznámky“.

Arg1
Typ: System.Int32%
Když tato metoda vrátí hodnotu, tento argument obsahuje informace související s elementem grafu.Další informace naleznete v části „Poznámky“.

Arg2
Typ: System.Int32%
Když tato metoda vrátí hodnotu, tento argument obsahuje informace související s elementem 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 kódu by měla prozkoumat tyto hodnoty, pokud 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	GroupIndex	Žádná
xlDropLines	GroupIndex	Žádná
xlHiLoLines	GroupIndex	Žádná
xlRadarAxisLabels	GroupIndex	Žádná
xlSeriesLines	GroupIndex	Žádná
xlUpBars	GroupIndex	Žá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 se jednat o jednu z následujících konstant XlAxisGroup: xlPrimary nebo xlSecondary
AxisType	Určuje typ osy.Může být jeden 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čují v uvedeném pořadí pole řad a kategorií.
GroupIndex	Určuje posun v rámci Microsoft.Office.Interop.Excel.ChartGroups kolekce pro určitý graf skupiny.
PivotFieldIndex	Určuje posun v kolekci T:Microsoft.Office.Interop.Excel.PivotFields pro určité sloupce (pole ř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 používá GetChartElement metoda zobrazení prvku grafu, po kliknutí na graf.

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

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

ChartSheet Rozhraní

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

Sdílet prostřednictvím