Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
단일 Excel 차트를 나타내는 객체를 캡슐화합니다.
public class Chart상속
상속된 멤버
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
예제
아래 코드는 .Net 코드를 사용하여 차트를 생성하는 방법을 보여줍니다.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("수익");
cells[1,0].PutValue("회사 A");
cells[2,0].PutValue("회사 B");
cells[3,0].PutValue("회사 C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "수익 분석";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("수익")
cells(1,0).PutValue("회사 A")
cells(2,0).PutValue("회사 B")
cells(3,0).PutValue("회사 C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)
Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "수익 분석"속성
ActualChartSize
차트의 실제 크기를 픽셀 단위로 가져옵니다.
[Obsolete("Chart.GetActualSize() 메서드를 대신 사용하십시오.")]
public Size ActualChartSize { get; }속성 값
비고
참고: 이 멤버는 이제 더 이상 사용되지 않습니다. 대신 Chart.GetActualSize() 메서드를 사용하십시오. 이 속성은 2022년 7월 이후 12개월 후에 제거됩니다. Aspose는 귀하가 겪었을 수 있는 불편에 대해 사과드립니다.
AutoScaling
Microsoft Excel이 3-D 차트를 스케일링하여 해당 2-D 차트와 크기가 더 가까워지면 True입니다. RightAngleAxes 속성은 True여야 합니다.
public bool AutoScaling { get; set; }속성 값
BackWall
3-D 차트의 뒷벽을 나타내는 Aspose.Cells.Charts.Chart.Walls 객체를 반환합니다.
public Walls BackWall { get; }속성 값
CategoryAxis
차트의 X 축을 가져옵니다.
public Axis CategoryAxis { get; }속성 값
ChartArea
워크시트의 차트 영역을 가져옵니다.
public ChartArea ChartArea { get; }속성 값
ChartDataTable
차트 데이터 테이블을 나타냅니다.
public ChartDataTable ChartDataTable { get; }속성 값
ChartObject
차트 모양을 나타냅니다.
public ChartShape ChartObject { get; }속성 값
DepthPercent
차트 너비의 백분율로서 3-D 차트의 깊이를 나타냅니다(20~2000% 사이).
public int DepthPercent { get; set; }속성 값
DisplayNaAsBlank
#N/A를 빈 값으로 표시할지 여부를 나타냅니다.
public bool DisplayNaAsBlank { get; set; }속성 값
Elevation
3-D 차트 보기의 고도를 나타내며, 단위는 도입니다.
public int Elevation { get; set; }속성 값
비고
차트 고도는 차트를 보는 높이를 도 단위로 나타냅니다. 대부분의 차트 유형의 기본값은 15입니다. 이 속성의 값은 -90과 90 사이여야 하며, 3-D 막대 차트의 경우 0과 44 사이여야 합니다.
FilteredNSeries
차트에서 필터링된 데이터 시리즈를 나타내는 Aspose.Cells.Charts.SeriesCollection 컬렉션을 가져옵니다.
public SeriesCollection FilteredNSeries { get; }속성 값
FirstSliceAngle
첫 번째 파이 차트 또는 도넛 차트 조각의 각도를 가져오거나 설정합니다. 단위는 도(수직에서 시계 방향으로). 파이, 3-D 파이, 도넛 차트에만 적용됩니다. 0에서 360.
public int FirstSliceAngle { get; set; }속성 값
Floor
3-D 차트의 벽을 나타내는 Aspose.Cells.Charts.Chart.Floor 객체를 반환합니다.
public Floor Floor { get; }속성 값
비고
이 속성은 3-D 파이 차트에는 적용되지 않습니다.
GapDepth
3-D 차트에서 데이터 시리즈 간의 거리를 마커 너비의 백분율로 가져오거나 설정합니다. 이 속성의 값은 0과 500 사이여야 합니다.
public int GapDepth { get; set; }속성 값
GapWidth
막대 또는 열 클러스터 간의 간격을 막대 또는 열 너비의 백분율로 반환하거나 설정합니다. 이 속성의 값은 0과 500 사이여야 합니다.
public int GapWidth { get; set; }속성 값
HeightPercent
3-D 차트의 높이를 차트 너비의 백분율로 반환하거나 설정합니다(5~500% 사이).
public int HeightPercent { get; set; }속성 값
HidePivotFieldButtons
차트가 PivotChart일 때만 피벗 차트 필드 버튼을 숨길지 여부를 나타냅니다.
public bool HidePivotFieldButtons { get; set; }속성 값
Is3D
차트가 3D 차트인지 여부를 나타냅니다.
public bool Is3D { get; }속성 값
IsRectangularCornered
차트 영역이 직각 모서리인지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 true입니다.
public bool IsRectangularCornered { get; set; }속성 값
Legend
차트 범례를 가져옵니다.
public Legend Legend { get; }속성 값
Line
선을 가져옵니다.
public Line Line { get; }속성 값
NSeries
차트의 데이터 시리즈를 나타내는 Aspose.Cells.Charts.SeriesCollection 컬렉션을 가져옵니다.
public SeriesCollection NSeries { get; }속성 값
Name
차트의 이름을 가져오거나 설정합니다.
public string Name { get; set; }속성 값
PageSetup
이 차트의 페이지 설정 설명을 나타냅니다.
public PageSetup PageSetup { get; }속성 값
Perspective
3-D 차트 보기를 위한 원근감을 반환하거나 설정합니다. 0과 100 사이여야 합니다. RightAngleAxes 속성이 True인 경우 이 속성은 무시됩니다.
public short Perspective { get; set; }속성 값
PivotOptions
차트에 표시되는 피벗 컨트롤을 지정합니다.
public PivotOptions PivotOptions { get; }속성 값
PivotSource
소스는 피벗 테이블의 데이터입니다. PivotSource가 비어 있지 않으면 차트는 PivotChart입니다.
public string PivotSource { get; set; }속성 값
비고
워크시트 “Sheet1"의 피벗 테이블 “PivotTable1"이 있는 경우, 차트와 피벗 테이블이 동일한 통합 문서에 없으면 pivotSource는 “[Book1.xls]Sheet1!PivotTable1"이 될 수 있습니다. 이 속성을 설정하면 이전 데이터 소스 설정이 손실됩니다.
Placement
차트가 아래의 셀에 첨부되는 방식을 나타냅니다.
public PlacementType Placement { get; set; }속성 값
PlotArea
차트의 플롯 영역을 가져옵니다. 이 영역에는 축 눈금 레이블이 포함됩니다.
public PlotArea PlotArea { get; }속성 값
PlotBy
행 또는 열로 플롯할지를 가져오거나 설정합니다.
public PlotDataByType PlotBy { get; }속성 값
PlotEmptyCellsType
빈 셀을 플롯하는 방법을 가져오거나 설정합니다.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }속성 값
PlotVisibleCellsOnly
가시 셀만 플롯할지 여부를 나타냅니다.
public bool PlotVisibleCellsOnly { get; set; }속성 값
PrintSize
인쇄된 차트 크기를 가져오거나 설정합니다.
public PrintSizeType PrintSize { get; set; }속성 값
RightAngleAxes
차트 축이 직각인 경우 True입니다. 3-D 차트에만 적용됩니다(열 3D 및 3-D 파이 차트 제외).
public bool RightAngleAxes { get; set; }속성 값
비고
이 속성이 True인 경우 Perspective 속성은 무시됩니다.
RotationAngle
3-D 차트 보기의 회전을 나타냅니다(플롯 영역의 z축 주위 회전, 단위는 도).
public int RotationAngle { get; set; }속성 값
비고
이 속성의 값은 0에서 360 사이여야 하며, 3-D 막대 차트의 경우 0에서 44 사이여야 합니다. 기본값은 20입니다. 3-D 차트에만 적용됩니다.
SecondCategoryAxis
차트의 두 번째 X 축을 가져옵니다.
public Axis SecondCategoryAxis { get; }속성 값
SecondValueAxis
차트의 두 번째 Y 축을 가져옵니다.
public Axis SecondValueAxis { get; }속성 값
SeriesAxis
차트의 시리즈 축을 가져옵니다.
public Axis SeriesAxis { get; }속성 값
Shapes
이 차트의 모든 도형을 반환합니다.
public ShapeCollection Shapes { get; }속성 값
ShowDataTable
차트가 데이터 테이블을 표시하는지 여부를 나타내는 값을 가져오거나 설정합니다.
public bool ShowDataTable { get; set; }속성 값
ShowLegend
차트 범례가 표시될지 여부를 나타내는 값을 가져오거나 설정합니다. 기본값은 true입니다.
public bool ShowLegend { get; set; }속성 값
SideWall
3-D 차트의 측면 벽을 나타내는 Aspose.Cells.Charts.Chart.Walls 객체를 반환합니다.
public Walls SideWall { get; }속성 값
SizeWithWindow
Microsoft Excel이 차트 시트 창의 크기에 맞게 차트를 조정하면 True입니다.
public bool SizeWithWindow { get; set; }속성 값
Style
내장 스타일을 가져오거나 설정합니다.
public int Style { get; set; }속성 값
비고
1과 48 사이여야 합니다. 설정되지 않은 경우 -1을 반환합니다.
SubTitle
차트의 부제목을 가져옵니다. ODS 형식 파일에만 해당됩니다.
public Title SubTitle { get; }속성 값
Title
차트의 제목을 가져옵니다.
public Title Title { get; }속성 값
Type
차트의 유형을 가져오거나 설정합니다.
public ChartType Type { get; set; }속성 값
ValueAxis
차트의 Y 축을 가져옵니다.
public Axis ValueAxis { get; }속성 값
Walls
3-D 차트의 벽을 나타내는 Aspose.Cells.Charts.Chart.Walls 객체를 반환합니다.
public Walls Walls { get; }속성 값
비고
이 속성은 3-D 파이 차트에는 적용되지 않습니다.
WallsAndGridlines2D
3-D 차트에 그리드라인이 2차원으로 그려지면 True입니다.
public bool WallsAndGridlines2D { get; set; }속성 값
Worksheet
이 차트를 포함하는 워크시트를 가져옵니다.
public Worksheet Worksheet { get; }속성 값
메서드
Calculate()
플롯 영역, 축의 사용자 정의 위치를 계산합니다. 위치가 자동으로 할당된 경우.
public void Calculate()Calculate(ChartCalculateOptions)
플롯 영역, 축의 사용자 정의 위치를 계산합니다. 위치가 자동으로 할당된 경우, 차트 계산 옵션과 함께.
public void Calculate(ChartCalculateOptions calculateOptions)매개변수
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
프리셋 템플릿으로 차트 유형을 변경합니다.
public void ChangeTemplate(byte[] data)매개변수
data byte[]
차트 템플릿 파일(.crtx)의 데이터입니다.
GetActualSize()
차트의 실제 크기를 픽셀 단위로 가져옵니다.
public int[] GetActualSize()반환 값
int[]
배열에서의 실제 크기(너비 및 높이). [0]은 너비; [1]은 높이입니다.
GetChartDataRange()
차트의 데이터 소스 범위를 가져옵니다.
public string GetChartDataRange()반환 값
데이터 소스입니다.
비고
범위만 지원합니다.
HasAxis(AxisType, bool)
차트에 어떤 축이 존재하는지 반환합니다.
public bool HasAxis(AxisType aixsType, bool isPrimary)매개변수
aixsType AxisType
isPrimary bool
반환 값
비고
일반적으로, 파이, 파이 폭발, 파이 파이, 파이 바, 파이 3D, 파이 3D 폭발, 도넛, 도넛 폭발에는 축이 없습니다.
IsCellReferedByChart(int, int, int)
차트에 의해 참조된 셀인지 여부를 반환합니다.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)매개변수
sheetIndex int
시트 인덱스. -1은 현재 차트를 포함하는 워크시트를 의미합니다.
rowIndex int
행 인덱스
columnIndex int
열 인덱스
반환 값
IsChartDataChanged()
차트의 데이터 소스가 변경되었는지 감지합니다.
public bool IsChartDataChanged()반환 값
차트가 변경된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.
비고
이 메서드는 차트를 이미지 형식으로 렌더링하기 전에 차트의 데이터 소스의 변경 사항을 감지합니다. 첫 번째 Chart.toImage 호출 시, 차트 소스 데이터(예: XValuesParseData, ValuesParseData)가 기록됩니다. Chart.toImage 메서드를 다시 호출하기 전에 IsChartDataChanged 메서드를 호출하여 차트를 다시 렌더링해야 하는지 확인합니다.
Move(int, int, int, int)
차트를 지정된 위치로 이동합니다.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)매개변수
upperLeftRow int
왼쪽 상단 행 인덱스입니다.
upperLeftColumn int
왼쪽 상단 열 인덱스입니다.
lowerRightRow int
오른쪽 하단 행 인덱스입니다.
lowerRightColumn int
오른쪽 하단 열 인덱스입니다.
RefreshPivotData()
피벗 테이블에서 차트의 데이터를 새로 고칩니다.
public void RefreshPivotData()비고
피벗 데이터 소스에서 데이터를 수집하여 피벗 테이블 보고서를 생성합니다. 이 메서드는 피벗 차트에 모든 데이터를 수집하는 데만 사용됩니다.
SetChartDataRange(string, bool)
차트의 데이터 범위를 지정합니다.
public void SetChartDataRange(string area, bool isVertical)매개변수
area string
데이터 시리즈를 플롯할 값을 지정합니다.
isVertical bool
행 또는 열로 셀 값의 범위에서 시리즈를 플롯할지를 지정합니다.
SwitchRowColumn()
행/열을 전환합니다.
public bool SwitchRowColumn()반환 값
False는 행/열 전환이 실패했음을 의미합니다.
ToImage(string)
차트 이미지를 생성하고 파일에 저장합니다. 파일 이름의 확장이 이미지 형식을 결정합니다.
public void ToImage(string imageFile)매개변수
imageFile string
전체 경로가 포함된 이미지 파일 이름입니다.
비고
이미지 형식은 파일 이름의 확장을 사용하여 지정됩니다. 예를 들어 "myfile.png"를 지정하면 이미지는 PNG 형식으로 저장됩니다. 다음 파일 확장이 인식됩니다: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.ToImage(string, ImageType)
차트 이미지를 생성하고 지정된 이미지 형식으로 파일에 저장합니다.
public void ToImage(string imageFile, ImageType imageType)매개변수
imageFile string
전체 경로가 포함된 이미지 파일 이름입니다.
imageType ImageType
이미지를 저장할 형식입니다.
비고
이미지의 유형은 `imageType`를 사용하여 지정됩니다. 지원되는 유형은 다음과 같습니다: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.ToImage(string, long)
차트 이미지를 생성하고 Jpeg 형식으로 파일에 저장합니다.
public void ToImage(string imageFile, long jpegQuality)매개변수
imageFile string
전체 경로가 포함된 이미지 파일 이름입니다.
jpegQuality long
Jpeg 품질입니다.
비고
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.
ToImage(Stream, long)
차트 이미지를 생성하고 Jpeg 형식으로 스트림에 저장합니다.
public void ToImage(Stream stream, long jpegQuality)매개변수
stream Stream
출력 스트림입니다.
jpegQuality long
Jpeg 품질입니다.
비고
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.
ToImage(Stream, ImageType)
차트 이미지를 생성하고 지정된 형식으로 스트림에 저장합니다.
public void ToImage(Stream stream, ImageType imageType)매개변수
stream Stream
출력 스트림입니다.
imageType ImageType
이미지를 저장할 형식입니다.
비고
이미지의 유형은 `imageType`를 사용하여 지정됩니다. 지원되는 형식은 다음과 같습니다: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다.ToImage(string, ImageOrPrintOptions)
차트 이미지를 생성하고 파일에 저장합니다. 파일 이름의 확장이 이미지 형식을 결정합니다.
public void ToImage(string imageFile, ImageOrPrintOptions options)매개변수
imageFile string
전체 경로가 포함된 이미지 파일 이름입니다.
options ImageOrPrintOptions
추가 이미지 생성 옵션입니다.
예제
300 dpi 및 CCITT4 압축으로 Tiff로 저장합니다.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.TiffCompression = TiffCompression.CompressionCCITT4;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Tiff", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.TiffCompression = TiffCompression.CompressionCCITT4
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Tiff", options)300 dpi 및 80 이미지 품질로 Jpeg로 저장합니다.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.Quality = 80;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Jpeg", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.Quality = 80
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Jpeg", options)비고
이미지 형식은 파일 이름의 확장을 사용하여 지정됩니다. 예를 들어 "myfile.png"를 지정하면 이미지는 PNG 형식으로 저장됩니다. 다음 파일 확장이 인식됩니다: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다. 자세한 내용은 지원되는 차트 목록을 참조하십시오.ToImage(Stream, ImageOrPrintOptions)
차트 이미지를 생성하고 지정된 형식으로 스트림에 저장합니다.
public void ToImage(Stream stream, ImageOrPrintOptions options)매개변수
stream Stream
출력 스트림입니다.
options ImageOrPrintOptions
추가 이미지 생성 옵션입니다.
비고
이미지의 유형은 `options.ImageType`를 사용하여 지정됩니다. 지원되는 형식은 다음과 같습니다: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
너비 또는 높이가 0이거나 차트가 지원되는 차트 목록에 따라 지원되지 않는 경우, 이 메서드는 아무 작업도 수행하지 않습니다. 자세한 내용은 지원되는 차트 목록을 참조하십시오.ToPdf(string)
차트를 pdf 파일로 저장합니다.
public void ToPdf(string fileName)매개변수
fileName string
전체 경로가 포함된 pdf 파일 이름입니다.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
차트를 pdf 파일로 저장합니다.
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)매개변수
fileName string
전체 경로가 포함된 pdf 파일 이름입니다.
desiredPageWidth float
원하는 페이지 너비(인치 단위)입니다.
desiredPageHeight float
원하는 페이지 높이(인치 단위)입니다.
hAlignmentType PageLayoutAlignmentType
출력 페이지의 차트 수평 정렬 유형입니다.
vAlignmentType PageLayoutAlignmentType
출력 페이지의 차트 수직 정렬 유형입니다.
ToPdf(Stream)
차트 pdf를 생성하고 스트림에 저장합니다.
public void ToPdf(Stream stream)매개변수
stream Stream
출력 스트림입니다.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
차트 pdf를 생성하고 스트림에 저장합니다.
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)매개변수
stream Stream
출력 스트림입니다.
desiredPageWidth float
원하는 페이지 너비(인치 단위)입니다.
desiredPageHeight float
원하는 페이지 높이(인치 단위)입니다.
hAlignmentType PageLayoutAlignmentType
출력 페이지의 차트 수평 정렬 유형입니다.
vAlignmentType PageLayoutAlignmentType
출력 페이지의 차트 수직 정렬 유형입니다.
