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(). Это свойство будет удалено через 12 месяцев с июля 2022 года. Aspose приносит извинения за возможные неудобства.
AutoScaling
Истина, если Microsoft Excel масштабирует 3-D диаграмму так, чтобы она была ближе по размеру к эквивалентной 2-D диаграмме. Свойство RightAngleAxes должно быть истинным.
public bool AutoScaling { get; set; }Значение свойства
BackWall
Возвращает объект Aspose.Cells.Charts.Chart.Walls, который представляет заднюю стенку 3-D диаграммы.
public Walls BackWall { get; }Значение свойства
CategoryAxis
Получает ось X диаграммы.
public Axis CategoryAxis { get; }Значение свойства
ChartArea
Получает область диаграммы на рабочем листе.
public ChartArea ChartArea { get; }Значение свойства
ChartDataTable
Представляет таблицу данных диаграммы.
public ChartDataTable ChartDataTable { get; }Значение свойства
ChartObject
Представляет ChartShape;
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
Возвращает объект Aspose.Cells.Charts.Chart.Floor, который представляет стены 3-D диаграммы.
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
Указывает, следует ли скрывать кнопки полей сводной диаграммы только тогда, когда диаграмма является сводной диаграммой.
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 истинно.
public short Perspective { get; set; }Значение свойства
PivotOptions
Указывает элементы управления сводной таблицы, которые отображаются на диаграмме.
public PivotOptions PivotOptions { get; }Значение свойства
PivotSource
Источник — это данные сводной таблицы. Если PivotSource не пуст, диаграмма является сводной диаграммой.
public string PivotSource { get; set; }Значение свойства
Примечания
Если сводная таблица “PivotTable1” на рабочем листе “Sheet1” в файле “Book1.xls”. 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
Истина, если оси диаграммы находятся под прямым углом. Применяется только для 3-D диаграмм (за исключением Column3D и 3-D Pie Charts).
public bool RightAngleAxes { get; set; }Значение свойства
Примечания
Если это свойство истинно, свойство 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
Возвращает объект Aspose.Cells.Charts.Chart.Walls, который представляет боковую стенку 3-D диаграммы.
public Walls SideWall { get; }Значение свойства
SizeWithWindow
Истина, если Microsoft Excel изменяет размер диаграммы, чтобы соответствовать размеру окна листа диаграммы.
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
Возвращает объект Aspose.Cells.Charts.Chart.Walls, который представляет стены 3-D диаграммы.
public Walls Walls { get; }Значение свойства
Примечания
Это свойство не применяется к 3-D круговым диаграммам.
WallsAndGridlines2D
Истина, если линии сетки рисуются двумерно на 3-D диаграмме.
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
Возвращает
Примечания
Обычно у круговой, взрывной круговой, круговой диаграмме, круговой диаграмме с баром, 3-D круговой, взрывной 3-D круговой, донатной, взрывной донатной диаграмме нет осей.
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.
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает.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.
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает.ToImage(string, long)
Создает изображение диаграммы и сохраняет его в файл в формате Jpeg.
public void ToImage(string imageFile, long jpegQuality)Параметры
imageFile string
Имя файла изображения с полным путем.
jpegQuality long
Качество Jpeg.
Примечания
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает.
ToImage(Stream, long)
Создает изображение диаграммы и сохраняет его в поток в формате Jpeg.
public void ToImage(Stream stream, long jpegQuality)Параметры
stream Stream
Выходной поток.
jpegQuality long
Качество Jpeg.
Примечания
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает.
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.
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает.ToImage(string, ImageOrPrintOptions)
Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения.
public void ToImage(string imageFile, ImageOrPrintOptions options)Параметры
imageFile string
Имя файла изображения с полным путем.
options ImageOrPrintOptions
Дополнительные параметры создания изображения
Примеры
Сохраняет в Tiff с 300 dpi и сжатие CCITT4.
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)Сохраняет в Jpeg с 300 dpi и качеством изображения 80.
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.
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает. Пожалуйста, обратитесь к Списку поддерживаемых диаграмм для получения дополнительной информации.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.
Если ширина или высота равны нулю или диаграмма не поддерживается в соответствии со списком поддерживаемых диаграмм, этот метод ничего не сделает. Пожалуйста, обратитесь к Списку поддерживаемых диаграмм для получения дополнительной информации.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
Вертикальный тип выравнивания диаграммы на выходной странице.
