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
True, якщо Microsoft Excel масштабує 3-D діаграму так, щоб вона була ближчою за розміром до відповідної 2-D діаграми. Властивість RightAngleAxes повинна бути True.
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
Вказує, чи потрібно приховувати кнопки полів зведеної діаграми лише тоді, коли діаграма є 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; }Значення властивості
Зауваження
Якщо зведена таблиця “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
True, якщо осі діаграми перебувають під прямими кутами. Застосовується лише до 3-D діаграм (за винятком Column3D та 3-D Pie Charts).
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
Повертає об’єкт Aspose.Cells.Charts.Chart.Walls, який представляє бічну стіну 3-D діаграми.
public Walls SideWall { get; }Значення властивості
SizeWithWindow
True, якщо 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
True, якщо сітки малюються двомірно на 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
Повертає
Зауваження
Зазвичай, для кругових, вибухових кругових, кругових кругових, кругових стовпчикових, 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.
Якщо ширина або висота дорівнює нулю або діаграма не підтримується відповідно до списку підтримуваних діаграм, цей метод нічого не зробить.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
Тип вертикального вирівнювання діаграми на вихідній сторінці.
