ControlCollection.AddChart 메서드 (Double, Double, Double, Double, String)
워크시트의 지정된 위치에 지정된 크기의 새 Chart 컨트롤을 추가합니다.
네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)
구문
‘선언
Function AddChart ( _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As Chart
Chart AddChart(
double left,
double top,
double width,
double height,
string name
)
매개 변수
- left
형식: System.Double
컨트롤의 왼쪽 가장자리와 워크시트의 오른쪽 가장자리 사이의 거리(포인트)입니다.
- top
형식: System.Double
컨트롤의 위쪽 가장자리와 워크시트의 위쪽 가장자리 사이의 거리(포인트)입니다.
- width
형식: System.Double
컨트롤의 너비(포인트)입니다.
- height
형식: System.Double
컨트롤의 높이(포인트)입니다.
- name
형식: System.String
컨트롤의 이름입니다.
반환 값
형식: Microsoft.Office.Tools.Excel.Chart
ControlCollection 인스턴스에 추가된 Chart 컨트롤입니다.
예외
| 예외 | 상황 |
|---|---|
| ArgumentNullException | 이름 인수가 nullNull 참조(Visual Basic의 경우 Nothing)이거나 이름 인수의 길이가 0인 경우 |
| ControlNameAlreadyExistsException | 이름이 같은 컨트롤이 ControlCollection 인스턴스에 있는 경우 |
설명
AddChart 메서드를 사용하여 Chart 컨트롤을 ControlCollection의 끝에 추가할 수 있습니다. 이전에 프로그래밍 방식으로 추가된 Chart 컨트롤을 제거하려면 Remove 메서드를 사용합니다.
예제
다음 코드 예제에서는 E1부터 E3까지의 셀에 숫자 16을 삽입하고, F1부터 F3까지의 셀에 숫자 24를 삽입합니다. 그런 다음 워크시트 맨 위에 Chart 컨트롤을 만들고, SetSourceData 메서드에 E1부터 F3까지의 셀을 전달하여 차트에 데이터를 채웁니다.
Private Sub ExcelAddChart()
Me.Range("E1", "E3").Value2 = 16
Me.Range("F1", "F3").Value2 = 24
Dim Chart1 As Microsoft.Office.Tools.Excel. _
Chart = Me.Controls.AddChart(0, 0, 130, _
130, "Chart1")
Chart1.SetSourceData(Me.Range("E1", "F3"), _
Excel.XlRowCol.xlColumns)
Chart1.ChartType = Excel.XlChartType. _
xlColumnClustered
End Sub
private void ExcelAddChart()
{
this.Range["E1", "E3"].Value2 = 16;
this.Range["F1", "F3"].Value2 = 24;
Microsoft.Office.Tools.Excel.Chart chart1 =
this.Controls.AddChart(0, 0, 130, 130, "chart1");
chart1.SetSourceData(this.Range["E1", "F3"], Excel.XlRowCol.xlColumns);
chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.