ChartSheet.GetChartElement 메서드
지정된 X 좌표 및 Y 좌표에 있는 차트 요소에 대한 정보를 가져옵니다.
네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel.v4.0.Utilities(Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
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 |
---|---|---|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
DropZoneType |
없음 |
|
DropZoneType |
PivotFieldIndex |
|
GroupIndex |
없음 |
|
GroupIndex |
없음 |
|
GroupIndex |
없음 |
|
GroupIndex |
없음 |
|
GroupIndex |
없음 |
|
GroupIndex |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
없음 |
없음 |
|
SeriesIndex |
PointIndex |
|
SeriesIndex |
없음 |
|
SeriesIndex |
없음 |
|
SeriesIndex |
없음 |
|
SeriesIndex |
PointIndex |
|
ShapeIndex |
없음 |
|
SeriesIndex |
TrendLineIndex |
|
SeriesIndex |
없음 |
|
SeriesIndex |
없음 |
다음 표에서는 메서드가 반환된 후 Arg1 및 Arg2가 갖는 의미를 설명합니다.
인수 |
설명 |
---|---|
AxisIndex |
축이 기본 축인지 또는 보조 축인지 지정합니다.XlAxisGroup 상수인 xlPrimary 또는 xlSecondary일 수 있습니다. |
AxisType |
축 서식을 지정합니다.XlAxisType 상수인 xlCategory, xlSeriesAxis 또는 xlValue일 수 있습니다. |
DropZoneType |
끌어 놓기 영역 형식을 열, 데이터, 페이지 또는 행 필드로 지정합니다.XlPivotFieldOrientation 상수인 xlColumnField, xlDataField, xlPageField 또는 xlRowField일 수 있습니다.열 및 행 필드 상수는 각각 계열 및 범주 필드를 지정합니다. |
GroupIndex |
특정 차트 그룹에 대한 Microsoft.Office.Interop.Excel.ChartGroups 컬렉션 내의 오프셋을 지정합니다. |
PivotFieldIndex |
특정 열(계열), 데이터, 페이지 또는 행(범주) 필드에 대한 T:Microsoft.Office.Interop.Excel.PivotFields 컬렉션 내의 오프셋을 지정합니다.끌어 놓기 영역 서식이 xlDataField이면 -1입니다. |
PointIndex |
계열에 있는 특정 요소에 대한 Points 컬렉션 내의 오프셋을 지정합니다.-1 값은 모든 데이터 요소가 선택되었음을 나타냅니다. |
SeriesIndex |
특정 계열에 대한 Series 컬렉션 내의 오프셋을 지정합니다. |
ShapeIndex |
특정 모양에 대한 Shapes 컬렉션 내의 오프셋을 지정합니다. |
TrendlineIndex |
계열에 있는 특정 추세선에 대한 Trendlines 컬렉션 내의 오프셋을 지정합니다. |
예제
다음 코드 예제에서는 GetChartElement 메서드를 사용하여 사용자가 차트를 클릭할 때 차트 요소를 표시합니다.
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());
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.