Metoda ChartSheetBase.GetChartElement —

Artykuł
05/08/2013

Pobiera informacje o elementu wykresu w określonych współrzędnych X i Y.

Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Składnia

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

Parametry

x
Typ: System.Int32
Współrzędna X elementu wykresu.

y
Typ: System.Int32
Współrzędna Y elementu wykresu.

elementID
Typ: System.Int32%
Gdy metoda zwraca wartość, argument ten zawiera XlChartItem wartość elementu wykresu w określonych współrzędnych.Aby uzyskać więcej informacji zobacz sekcję "Uwagi".

arg1
Typ: System.Int32%
Gdy metoda zwraca wartość, argument ten zawiera informacje związane z elementu wykresu.Aby uzyskać więcej informacji zobacz sekcję "Uwagi".

arg2
Typ: System.Int32%
Gdy metoda zwraca wartość, argument ten zawiera informacje związane z elementu wykresu.Aby uzyskać więcej informacji zobacz sekcję "Uwagi".

Uwagi

Ta metoda jest niczym niezwykłym, że określisz wartości dla pierwszych dwóch argumentów.Program Microsoft Office Excel wypełnia inne argumenty i kodzie powinny zbadać te wartości, gdy metoda zwraca wartość.

Wartość ElementID po metoda zwraca wartość określa, czy Arg1 i Arg2 zawierać wszelkie informacje, jak pokazano w poniższej tabeli.

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

W poniższej tabeli opisano znaczenie Arg1 i Arg2 po powrocie z metody.

Argument	Opis
AxisIndex	Określa, czy oś jest podstawowym lub pomocniczym.Może być jedną z następujących XlAxisGroup stałych: xlPrimary lub xlSecondary.
AxisType	Określa typ osi.Może być jedną z następujących XlAxisType stałych: xlCategory, xlSeriesAxis, lub xlValue.
DropZoneType	Określa typ strefy upuszczania: kolumny, danych, strony lub polem wiersza.Can be one of the following XlPivotFieldOrientation constants: xlColumnField, xlDataField, xlPageField, or xlRowField.Stałe pole kolumny i wiersza określ odpowiednio pól serii i kategorii.
Indeks grupy	Określa przesunięcie w ramach Microsoft.Office.Interop.Excel.ChartGroups kolekcji dla grup określonych wykresu.
PivotFieldIndex	Określa przesunięcie w zbiorze T:Microsoft.Office.Interop.Excel.PivotFields dla konkretnej kolumny (serii), dane, strony lub pole wiersza (kategorii).-1, jeśli typ strefy upuszczania jest xlDataField.
PointIndex	Określa przesunięcie w ramach Points kolekcji dla określonego punktu w serii.Wartość-1 wskazuje, że zaznaczone są wszystkie punkty danych.
SeriesIndex	Określa przesunięcie w ramach Series kolekcji dla konkretnej serii.
ShapeIndex	Określa przesunięcie w ramach Shapes kolekcji dla określonego kształtu.
TrendlineIndex	Określa przesunięcie w ramach Trendlines kolekcji na określonej linii trendu w ramach serii.

Przykłady

Następujący kod w przykładzie wykorzystano GetChartElement metodę wyświetlania elementu wykresu, gdy użytkownik kliknie wykresu.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

ChartSheetBase Klasa

Przestrzeń nazw Microsoft.Office.Tools.Excel

Udostępnij za pośrednictwem