Chart.GetChartElement 메서드

지정된 X 좌표 및 Y 좌표에 있는 차트 요소에 대한 정보를 가져옵니다.

네임스페이스:  Microsoft.Office.Tools.Excel
어셈블리:  Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
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
)

매개 변수

• x
  형식: System.Int32
  차트 요소의 X 좌표입니다.

• y
  형식: System.Int32
  차트 요소의 Y 좌표입니다.

• ElementID
  형식: System.Int32%
  메서드가 반환되면 지정된 좌표에 있는 차트 요소의 XlChartItem 값이 이 인수에 포함됩니다.자세한 내용은 "설명" 부분을 참조하십시오.

• Arg1
  형식: System.Int32%
  메서드가 반환되면 차트 요소와 관련된 정보가 이 인수에 포함됩니다.자세한 내용은 "설명" 부분을 참조하십시오.

• Arg2
  형식: System.Int32%
  메서드가 반환되면 차트 요소와 관련된 정보가 이 인수에 포함됩니다.자세한 내용은 "설명" 부분을 참조하십시오.

설명

이 메서드의 경우 다른 메서드와는 달리 처음 두 개의 인수에 대한 값만을 지정합니다. 그리고 나머지 인수들은 Microsoft Office Excel에서 자동으로 채워지기 때문에 메서드가 반환될 때 이러한 값을 확인할 수 있도록 코드를 작성해야 합니다.

다음 표에 나타난 것처럼 메서드가 반환된 후 ElementID의 값을 통해 Arg1 및 Arg2에 정보가 있는지 여부를 확인할 수 있습니다.

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

다음 표에서는 메서드가 반환된 후 Arg1 및 Arg2가 갖는 의미를 설명합니다.

인수	설명
AxisIndex	축이 기본 축인지 또는 보조 축인지 지정합니다. XlAxisGroup 상수인 xlPrimary 또는 xlSecondary일 수 있습니다.
AxisType	축 서식을 지정합니다. XlAxisType 상수인 xlCategory, xlSeriesAxis 또는 xlValue일 수 있습니다.
DropZoneType	끌어 놓기 영역 형식을 열, 데이터, 페이지 또는 행 필드로 지정합니다. XlPivotFieldOrientation 상수인 xlColumnField, xlDataField, xlPageField 또는 xlRowField일 수 있습니다. 열 및 행 필드 상수는 각각 계열 및 범주 필드를 지정합니다.
GroupIndex	특정 차트 그룹에 대한 ChartGroups 컬렉션 내의 오프셋을 지정합니다.
PivotFieldIndex	특정 열(계열), 데이터, 페이지 또는 행(범주) 필드에 대한 PivotFields 컬렉션 내의 오프셋을 지정합니다. 끌어 놓기 영역 서식이 xlDataField이면 -1입니다.
PointIndex	계열에 있는 특정 요소에 대한 Points 컬렉션 내의 오프셋을 지정합니다. -1 값은 모든 데이터 요소가 선택되었음을 나타냅니다.
SeriesIndex	특정 계열에 대한 Series 컬렉션 내의 오프셋을 지정합니다.
ShapeIndex	특정 모양에 대한 Shapes 컬렉션 내의 오프셋을 지정합니다.
TrendlineIndex	계열에 있는 특정 추세선에 대한 Trendlines 컬렉션 내의 오프셋을 지정합니다.

예제

다음 코드 예제에서는 Microsoft.Office.Tools.Excel.Chart를 만든 다음 GetChartElement 메서드를 사용하여 사용자가 차트를 클릭할 때 차트 요소를 표시합니다.

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 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

Chart 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스