Chart

Chart class

Инкапсулирует объект, представляющий одну диаграмму Excel.

public class Chart

Характеристики

ИмяОписание
AutoScaling { get; set; }Истинно, если Microsoft Excel масштабирует трехмерную диаграмму так, чтобы ее размер был ближе к эквивалентной двухмерной диаграмме. Свойство RightAngleAxes должно быть равно True.
BackWall { get; }ВозвращаетWalls объект, представляющий заднюю стенку трехмерной диаграммы.
CategoryAxis { get; }Получает ось X диаграммы.
ChartArea { get; }Получает область диаграммы на листе.
ChartDataTable { get; }Представляет таблицу данных диаграммы.
ChartObject { get; }Представляет диаграмму Shape;
DepthPercent { get; set; }Представляет глубину трехмерной диаграммы в процентах от ширины диаграммы (от 20 до 2000 процентов).
DisplayNaAsBlank { get; set; }Указывает, отображается ли #N/A как пустое значение.
Elevation { get; set; }Представляет высоту трехмерной карты в градусах.
FirstSliceAngle { get; set; }Получает или задает угол первого фрагмента круговой диаграммы или кольцевой диаграммы в градусах (по часовой стрелке от вертикали). Применяется только к круговым, трехмерным круговым и кольцевым диаграммам от 0 до 360.
Floor { get; }ВозвращаетFloor объект, представляющий стены трехмерной диаграммы.
GapDepth { get; set; }Получает или задает расстояние между рядами данных на трехмерной диаграмме в процентах от ширины маркера. Значение этого свойства должно быть в диапазоне от 0 до 500.
GapWidth { get; set; }Возвращает или задает расстояние между кластерами столбцов или столбцов в процентах от ширины столбца или столбца. Значение этого свойства должно быть в диапазоне от 0 до 500.
HeightPercent { get; set; }Возвращает или задает высоту трехмерной диаграммы в процентах от ширины диаграммы (от 5 до 500 процентов).
HidePivotFieldButtons { get; set; }Указывает, следует ли скрывать кнопки поля сводной диаграммы только в том случае, если диаграмма является сводной диаграммой.
Is3D { get; }Указывает, является ли диаграмма трехмерной диаграммой.
IsRectangularCornered { get; set; }Получает или задает значение, указывающее, является ли область диаграммы прямоугольной с углами. Значение по умолчанию — true.
Legend { get; }Получает легенду диаграммы.
Line { get; }Получает строку.
Name { get; set; }Получает и задает имя диаграммы.
NSeries { get; }ПолучаетSeriesCollection коллекция, представляющая серию данных на диаграмме.
PageSetup { get; }Представляет описание настройки страницы на этой диаграмме.
Perspective { get; set; }Возвращает или задает перспективу для просмотра трехмерной диаграммы. Должно быть от 0 до 100. Это свойство игнорируется, если свойство RightAngleAxes имеет значение True.
PivotOptions { get; }Определяет элементы управления поворотом, которые появляются на диаграмме
PivotSource { get; set; }Источником являются данные сводной таблицы. Если PivotSource не пуст, диаграмма является сводной диаграммой.
Placement { get; set; }Представляет способ прикрепления диаграммы к ячейкам под ней.
PlotArea { get; }Получает область построения диаграммы, которая включает метки деления оси.
PlotBy { get; }Получает и устанавливает график по строкам или столбцам.
PlotEmptyCellsType { get; set; }Получает и задает способ построения пустых ячеек.
PlotVisibleCells { get; set; }Указывает, отображать ли только видимые ячейки.
PrintSize { get; set; }Получает и задает размер распечатываемой диаграммы.
RightAngleAxes { get; set; }Истинно, если оси диаграммы расположены под прямым углом. Применяется только для трехмерных диаграмм (кроме Column3D и трехмерных круговых диаграмм).
RotationAngle { get; set; }Представляет поворот представления трехмерной диаграммы (поворот области графика вокруг оси Z в градусах).
SecondCategoryAxis { get; }Получает вторую ось X диаграммы.
SecondValueAxis { get; }Получает вторую ось Y диаграммы.
SeriesAxis { get; }Получает ось серии диаграммы.
Shapes { get; }Возвращает все фигуры рисунка на этой диаграмме.
ShowDataTable { get; set; }Получает или задает значение, указывающее, отображает ли диаграмма таблицу данных.
ShowLegend { get; set; }Получает или задает значение, указывающее, будет ли отображаться легенда диаграммы. Значение по умолчанию — true.
SideWall { get; }ВозвращаетWallsобъект, который представляет собой боковую стенку трехмерной диаграммы.
SizeWithWindow { get; set; }Истинно, если Microsoft Excel изменяет размер диаграммы в соответствии с размером окна листа диаграммы.
Style { get; set; }Получает и устанавливает встроенный стиль.
SubTitle { get; }Получает подзаголовок диаграммы. Только для файла формата ODS.
Title { get; }Получает заголовок диаграммы.
Type { get; set; }Получает или задает тип диаграммы.
ValueAxis { get; }Получает ось Y диаграммы.
Walls { get; }ВозвращаетWalls объект, представляющий стены трехмерной диаграммы.
WallsAndGridlines2D { get; set; }Истинно, если линии сетки нарисованы двумерными на трехмерной диаграмме.
Worksheet { get; }Получает рабочий лист, содержащий эту диаграмму.

Методы

ИмяОписание
Calculate()Вычисляет пользовательское положение области графика, осей, если их положение назначено автоматически.
GetActualSize()Получает фактический размер диаграммы в пикселях.
GetChartDataRange()Получает диапазон источника данных диаграммы.
HasAxis(AxisType, bool)Возвращает, какие оси существуют на диаграмме.
IsChartDataChanged()Определяет, изменился ли источник данных диаграммы.
Move(int, int, int, int)Перемещает диаграмму в указанное место.
RefreshPivotData()Обновляет данные сводной диаграммы из источника сводных данных.
SetChartDataRange(string, bool)Указывает диапазон данных для диаграммы.
SwitchRowColumn()Переключает строку/столбец.
ToImage()Получает 32-битныйБитовая карта объект диаграммы.
ToImage(ImageOrPrintOptions)Получает 32-битныйБитовая карта объект диаграммы. ImageOrPrintOptions.ImageFormat , атрибуты ImageOrPrintOptions.TiffCompression и ImageOrPrintOptions.Quality игнорируются.
ToImage(string)Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения.
ToImage(Stream, ImageOrPrintOptions)Создает изображение диаграммы и сохраняет его в потоке в указанном формате.
ToImage(Stream, ImageType)Создает изображение диаграммы и сохраняет его в потоке в указанном формате.
ToImage(Stream, long)Создает изображение диаграммы и сохраняет его в поток в формате Jpeg.
ToImage(string, ImageOrPrintOptions)Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения.
ToImage(string, ImageType)Создает изображение диаграммы и сохраняет его в файл с указанным типом изображения.
ToImage(string, long)Создает изображение графика и сохраняет его в файл в формате Jpeg.
ToPdf(Stream)Создает диаграмму в формате pdf и сохраняет ее в поток.
ToPdf(string)Сохраняет диаграмму в файл PDF.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Создает диаграмму в формате pdf и сохраняет ее в поток.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Сохраняет диаграмму в файл PDF.

Примеры

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company 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 = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company 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 = "Income Analysis"

Смотрите также

CategoryType ChartArea