ChartSheet.GetChartElement(Int32, Int32, Int32, Int32, Int32) Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.Office.Tools.Excel
Bütünleştirilmiş Kodlar:
Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Belirtilen X ve Y koordinatlarındaki grafik öğesi hakkında bilgi alır.

public void GetChartElement (int x, int y, ref int ElementID, ref int Arg1, ref int Arg2);

Parametreler

x
Int32

Grafik öğesinin X koordinatı.

y
Int32

Grafik öğesinin Y koordinatı.

ElementID
Int32

Yöntem döndüğünde, bu bağımsız değişken, XlChartItem belirtilen koordinatlardaki grafik öğesinin değerini içerir. Daha fazla bilgi edinmek için "Açıklamalar" bölümüne bakın.

Arg1
Int32

Yöntem döndürüldüğünde bu bağımsız değişken, grafik öğesiyle ilgili bilgiler içerir. Daha fazla bilgi edinmek için "Açıklamalar" bölümüne bakın.

Arg2
Int32

Yöntem döndürüldüğünde bu bağımsız değişken, grafik öğesiyle ilgili bilgiler içerir. Daha fazla bilgi edinmek için "Açıklamalar" bölümüne bakın.

Örnekler

Aşağıdaki kod örneği, GetChartElement bir Kullanıcı grafiğe tıkladığında grafik öğesini göstermek için yöntemini kullanır.

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

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

Açıklamalar

Bu yöntem, yalnızca ilk iki bağımsız değişken için değer belirttiğinizden olağan dışı bir yöntemdir. Microsoft Office Excel diğer bağımsız değişkenleri doldurduğunda, yöntemin döndürdüğü kodda bu değerler incelenmelidir.

ElementIDYöntemi döndürmesinin ardından değeri, Arg1 Arg2 Aşağıdaki tabloda gösterildiği gibi herhangi bir bilgi olup olmadığını belirler.

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

Aşağıdaki tablo Arg1 Arg2 , yönteminin getirme anlamını ve sonra açıklar.

Bağımsız Değişken Açıklama
AxisIndex Eksenin birincil mi yoksa ikincil mi olduğunu belirtir. Aşağıdaki XlAxisGroup sabitlerden biri olabilir: xlPrimary veya xlSecondary .
AxisType Eksen türünü belirtir. Aşağıdaki XlAxisType sabitlerden biri olabilir: xlCategory , xlSeriesAxis , veya xlValue .
DropZoneType Bırakma bölgesi türünü belirtir: sütun, veri, sayfa veya satır alanı. Aşağıdaki XlPivotFieldOrientation sabitlerden biri olabilir: xlColumnField , xlDataField , xlPageField veya xlRowField . Sütun ve satır alanı sabitleri sırasıyla seriler ve kategori alanlarını belirtir.
GroupIndex Microsoft.Office.Interop.Excel.ChartGroupsBelirli bir grafik grubu için koleksiyon içerisindeki boşluğu belirtir.
PivotFieldIndex Belirli bir sütun (Seriler), veriler, sayfa veya satır (kategori) alanı için T:Microsoft.Office.Interop.Excel.PivotFields koleksiyonunun içindeki sapmayı belirtir. -1 ise bırakma bölgesi türü xlDataField .
PointIndex PointsBir serinin içindeki belirli bir nokta için koleksiyon içerisindeki sapmayı belirtir. – 1 değeri tüm veri noktalarının seçili olduğunu gösterir.
SeriesIndex SeriesBelirli bir seri için koleksiyon içerisindeki boşluğu belirtir.
ShapeIndex ShapesBelirli bir şekil için koleksiyon içerisindeki boşluğu belirtir.
Trendlineındex TrendlinesBir serinin içindeki belirli bir eğilim çizgisinin koleksiyon içerisindeki sapmayı belirtir.

Şunlara uygulanır