## Chart класс Инкапсулирует объект, представляющий одну диаграмму Excel. Тип Chart предоставляет следующие элементы: ### Характеристики | Свойство| Описание| | :- | :- | | [style](/cells/python-net/ru/aspose.cells.charts/chart/style) | Получает и задает встроенный стиль.| | [chart_object](/cells/python-net/ru/aspose.cells.charts/chart/chart_object) | Представляет форму диаграммы;| | [hide_pivot_field_buttons](/cells/python-net/ru/aspose.cells.charts/chart/hide_pivot_field_buttons) | Указывает, следует ли скрывать кнопки полей сводной диаграммы только в том случае, если диаграмма является сводной диаграммой.| | [pivot_options](/cells/python-net/ru/aspose.cells.charts/chart/pivot_options) | Задает элементы управления поворотом, которые отображаются на диаграмме.| | [pivot_source](/cells/python-net/ru/aspose.cells.charts/chart/pivot_source) |Источником являются данные сводной таблицы.
Если PivotSource не пуст, то диаграмма будет PivotChart.| | [plot_by](/cells/python-net/ru/aspose.cells.charts/chart/plot_by) | Возвращает и задает тип построения графика: по строкам или по столбцам.| | [plot_empty_cells_type](/cells/python-net/ru/aspose.cells.charts/chart/plot_empty_cells_type) | Получает и задает способ отображения пустых ячеек.| | [plot_visible_cells](/cells/python-net/ru/aspose.cells.charts/chart/plot_visible_cells) | Указывает, следует ли отображать на графике только видимые ячейки.| | [plot_visible_cells_only](/cells/python-net/ru/aspose.cells.charts/chart/plot_visible_cells_only) | Указывает, следует ли отображать на графике только видимые ячейки.| | [display_na_as_blank](/cells/python-net/ru/aspose.cells.charts/chart/display_na_as_blank) | Указывает, отображать ли #N/A как пустое значение.| | [name](/cells/python-net/ru/aspose.cells.charts/chart/name) | Получает и задает имя диаграммы.| | [size_with_window](/cells/python-net/ru/aspose.cells.charts/chart/size_with_window) | Истина, если Microsoft Excel изменяет размер диаграммы в соответствии с размером окна листа диаграммы.| | [worksheet](/cells/python-net/ru/aspose.cells.charts/chart/worksheet) | Получает рабочий лист, содержащий эту диаграмму.| | [shapes](/cells/python-net/ru/aspose.cells.charts/chart/shapes) | Возвращает все фигуры чертежей на этой диаграмме.| | [print_size](/cells/python-net/ru/aspose.cells.charts/chart/print_size) | Получает и задает размер печатной диаграммы.| | [type](/cells/python-net/ru/aspose.cells.charts/chart/type) | Получает или задает тип диаграммы.| | [n_series](/cells/python-net/ru/aspose.cells.charts/chart/n_series) | Получает коллекцию [`SeriesCollection`](/cells/python-net/ru/aspose.cells.charts/seriescollection), представляющую ряд данных на диаграмме.| | [filtered_n_series](/cells/python-net/ru/aspose.cells.charts/chart/filtered_n_series) | Получает коллекцию [`SeriesCollection`](/cells/python-net/ru/aspose.cells.charts/seriescollection), представляющую ряды данных, отфильтрованные на диаграмме.| | [title](/cells/python-net/ru/aspose.cells.charts/chart/title) | Получает название диаграммы.| | [sub_title](/cells/python-net/ru/aspose.cells.charts/chart/sub_title) | Получает подзаголовок диаграммы.
Только для файла формата ODS.| | [plot_area](/cells/python-net/ru/aspose.cells.charts/chart/plot_area) |Получает область построения диаграммы, включающую метки делений осей.| | [chart_area](/cells/python-net/ru/aspose.cells.charts/chart/chart_area) | Получает область диаграммы на рабочем листе.| | [category_axis](/cells/python-net/ru/aspose.cells.charts/chart/category_axis) | Получает ось X диаграммы.| | [value_axis](/cells/python-net/ru/aspose.cells.charts/chart/value_axis) | Получает ось Y диаграммы.| | [second_value_axis](/cells/python-net/ru/aspose.cells.charts/chart/second_value_axis) | Получает вторую ось Y диаграммы.| | [second_category_axis](/cells/python-net/ru/aspose.cells.charts/chart/second_category_axis) | Получает вторую ось X диаграммы.| | [series_axis](/cells/python-net/ru/aspose.cells.charts/chart/series_axis) | Получает ось рядов диаграммы.| | [legend](/cells/python-net/ru/aspose.cells.charts/chart/legend) | Получает легенду диаграммы.| | [chart_data_table](/cells/python-net/ru/aspose.cells.charts/chart/chart_data_table) | Представляет таблицу данных диаграммы.| | [show_legend](/cells/python-net/ru/aspose.cells.charts/chart/show_legend) | Возвращает или задаёт значение, указывающее, будет ли отображаться легенда диаграммы. Значение по умолчанию — true.| | [is_rectangular_cornered](/cells/python-net/ru/aspose.cells.charts/chart/is_rectangular_cornered) | Возвращает или задает значение, указывающее, имеет ли область диаграммы прямоугольные углы.
Значение по умолчанию — true.| | [show_data_table](/cells/python-net/ru/aspose.cells.charts/chart/show_data_table) | Возвращает или задает значение, указывающее, отображает ли диаграмма таблицу данных.| | [first_slice_angle](/cells/python-net/ru/aspose.cells.charts/chart/first_slice_angle) | Возвращает или задает угол первого сектора круговой или кольцевой диаграммы в градусах (по часовой стрелке от вертикали).
Применимо только к круговым, трехмерным круговым и кольцевым диаграммам, от 0 до 360.| | [gap_width](/cells/python-net/ru/aspose.cells.charts/chart/gap_width) | Возвращает или задает расстояние между кластерами полос или столбцов в процентах от ширины полосы или столбца.
Значение этого свойства должно быть от 0 до 500.| | [gap_depth](/cells/python-net/ru/aspose.cells.charts/chart/gap_depth) |Возвращает или задает расстояние между рядами данных на трехмерной диаграмме в процентах от ширины маркера.
Значение этого свойства должно быть от 0 до 500.| | [floor](/cells/python-net/ru/aspose.cells.charts/chart/floor) | Возвращает объект [`Chart.floor`](/cells/python-net/ru/aspose.cells.charts/chart#floor), представляющий стены трехмерной диаграммы.| | [walls](/cells/python-net/ru/aspose.cells.charts/chart/walls) | Возвращает объект [`Chart.walls`](/cells/python-net/ru/aspose.cells.charts/chart#walls), представляющий стены трехмерной диаграммы.| | [back_wall](/cells/python-net/ru/aspose.cells.charts/chart/back_wall) | Возвращает объект [`Chart.walls`](/cells/python-net/ru/aspose.cells.charts/chart#walls), представляющий заднюю стенку трехмерной диаграммы.| | [side_wall](/cells/python-net/ru/aspose.cells.charts/chart/side_wall) | Возвращает объект [`Chart.walls`](/cells/python-net/ru/aspose.cells.charts/chart#walls), представляющий боковую стенку трехмерной диаграммы.| | [walls_and_gridlines_2d](/cells/python-net/ru/aspose.cells.charts/chart/walls_and_gridlines_2d) | Истина, если линии сетки отображены на трехмерной диаграмме в двух измерениях.| | [rotation_angle](/cells/python-net/ru/aspose.cells.charts/chart/rotation_angle) | Представляет поворот трехмерного представления диаграммы (поворот области построения вокруг оси z в градусах).| | [elevation](/cells/python-net/ru/aspose.cells.charts/chart/elevation) | Представляет высоту трехмерного представления карты в градусах.| | [right_angle_axes](/cells/python-net/ru/aspose.cells.charts/chart/right_angle_axes) | Истина, если оси диаграммы расположены под прямым углом. Применимо только к трёхмерным диаграммам (кроме Column3D и 3D Pie Charts).| | [auto_scaling](/cells/python-net/ru/aspose.cells.charts/chart/auto_scaling) | Истина, если Microsoft Excel масштабирует трехмерную диаграмму так, чтобы она была ближе по размеру к эквивалентной двухмерной диаграмме.
Свойство RightAngleAxes должно иметь значение True.| | [height_percent](/cells/python-net/ru/aspose.cells.charts/chart/height_percent) | Возвращает или задает высоту трехмерной диаграммы в процентах от ширины диаграммы (от 5 до 500 процентов).| | [perspective](/cells/python-net/ru/aspose.cells.charts/chart/perspective) |Возвращает или задаёт перспективу для трёхмерного представления диаграммы. Должна быть в диапазоне от 0 до 100.
Это свойство игнорируется, если свойство RightAngleAxes имеет значение True.| | [is_3d](/cells/python-net/ru/aspose.cells.charts/chart/is_3d) | Указывает, является ли диаграмма трехмерной.| | [depth_percent](/cells/python-net/ru/aspose.cells.charts/chart/depth_percent) | Представляет глубину трехмерной диаграммы в процентах от ширины диаграммы (от 20 до 2000 процентов).| | [actual_chart_size](/cells/python-net/ru/aspose.cells.charts/chart/actual_chart_size) | Получает фактический размер диаграммы в пикселях.| | [placement](/cells/python-net/ru/aspose.cells.charts/chart/placement) | Представляет собой способ прикрепления диаграммы к ячейкам под ней.| | [page_setup](/cells/python-net/ru/aspose.cells.charts/chart/page_setup) | Представляет описание настройки страницы в этой диаграмме.| | [line](/cells/python-net/ru/aspose.cells.charts/chart/line) | Получает строку.| ### Методы | Метод| Описание| | :- | :- | | [`calculate(self)`](/cells/python-net/ru/aspose.cells.charts/chart/calculate/#) | Рассчитывает пользовательское положение области графика и осей, если их положение назначено автоматически.| | [`calculate(self, calculate_options)`](/cells/python-net/ru/aspose.cells.charts/chart/calculate/#aspose.cells.charts.chartcalculateoptions) | Рассчитывает пользовательское положение области графика и осей, если их положение назначено автоматически, с помощью параметров расчета диаграммы.| | [`to_image(self, image_file)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#str) | Создает изображение диаграммы и сохраняет его в файл.
Расширение имени файла определяет формат изображения.| | [`to_image(self, image_file, image_type)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#str-aspose.cells.drawing.imagetype) | Создает изображение диаграммы и сохраняет его в файле указанного типа изображения.| | [`to_image(self, image_file, jpeg_quality)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#str-int) |Создает изображение диаграммы и сохраняет его в файле в формате Jpeg.| | [`to_image(self, stream, jpeg_quality)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#io.rawiobase-int) | Создает изображение диаграммы и сохраняет его в потоке в формате Jpeg.| | [`to_image(self, stream, image_type)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#io.rawiobase-aspose.cells.drawing.imagetype) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате.| | [`to_image(self, image_file, options)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#str-aspose.cells.rendering.imageorprintoptions) | Создает изображение диаграммы и сохраняет его в файл.
Расширение имени файла определяет формат изображения.| | [`to_image(self, stream, options)`](/cells/python-net/ru/aspose.cells.charts/chart/to_image/#io.rawiobase-aspose.cells.rendering.imageorprintoptions) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате.| | [`to_pdf(self, file_name)`](/cells/python-net/ru/aspose.cells.charts/chart/to_pdf/#str) | Сохраняет диаграмму в PDF-файл.| | [`to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`](/cells/python-net/ru/aspose.cells.charts/chart/to_pdf/#str-float-float-aspose.cells.pagelayoutalignmenttype-aspose.cells.pagelayoutalignmenttype) | Сохраняет диаграмму в PDF-файл.| | [`to_pdf(self, stream)`](/cells/python-net/ru/aspose.cells.charts/chart/to_pdf/#io.rawiobase) | Создает диаграмму в формате PDF и сохраняет ее в потоке.| | [`to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`](/cells/python-net/ru/aspose.cells.charts/chart/to_pdf/#io.rawiobase-float-float-aspose.cells.pagelayoutalignmenttype-aspose.cells.pagelayoutalignmenttype) | Создает диаграмму в формате PDF и сохраняет ее в потоке.| | [`is_refered_by_chart(self, row_index, column_index)`](/cells/python-net/ru/aspose.cells.charts/chart/is_refered_by_chart/#int-int) | Возвращает, ссылается ли ячейка на диаграмму.| | [`is_cell_refered_by_chart(self, sheet_index, row_index, column_index)`](/cells/python-net/ru/aspose.cells.charts/chart/is_cell_refered_by_chart/#int-int-int) | Возвращает, ссылается ли ячейка на диаграмму.| | [`is_chart_data_changed(self)`](/cells/python-net/ru/aspose.cells.charts/chart/is_chart_data_changed/#) | Определяет, изменился ли источник данных диаграммы.| | [`refresh_pivot_data(self)`](/cells/python-net/ru/aspose.cells.charts/chart/refresh_pivot_data/#) | Обновляет данные диаграммы из сводной таблицы.| | [`change_template(self, data)`](/cells/python-net/ru/aspose.cells.charts/chart/change_template/#bytes) | Измените тип диаграммы с помощью предустановленного шаблона.| | [`move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`](/cells/python-net/ru/aspose.cells.charts/chart/move/#int-int-int-int) | Перемещает диаграмму в указанное место.| | [`get_actual_size(self)`](/cells/python-net/ru/aspose.cells.charts/chart/get_actual_size/#) | Получает фактический размер диаграммы в пикселях.| | [`has_axis(self, aixs_type, is_primary)`](/cells/python-net/ru/aspose.cells.charts/chart/has_axis/#aspose.cells.charts.axistype-bool) | Возвращает, какие оси существуют на диаграмме.| | [`switch_row_column(self)`](/cells/python-net/ru/aspose.cells.charts/chart/switch_row_column/#) | Переключает строку/столбец.| | [`get_chart_data_range(self)`](/cells/python-net/ru/aspose.cells.charts/chart/get_chart_data_range/#) | Получает диапазон источника данных диаграммы.| | [`set_chart_data_range(self, area, is_vertical)`](/cells/python-net/ru/aspose.cells.charts/chart/set_chart_data_range/#str-bool) | Задает диапазон данных для диаграммы.| ### Пример Следующие коды показывают, как создать диаграмму с помощью кодов .Net. ```python from aspose.cells import Workbook from aspose.cells.charts import ChartType workbook = Workbook() sheet = workbook.worksheets[0] cells = sheet.cells cells.get(0, 1).put_value("Income") cells.get(1, 0).put_value("Company A") cells.get(2, 0).put_value("Company B") cells.get(3, 0).put_value("Company C") cells.get(1, 1).put_value(10000) cells.get(2, 1).put_value(20000) cells.get(3, 1).put_value(30000) chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15) chart = sheet.charts[chartIndex] chart.set_chart_data_range("A1:B4", True) chart.show_legend = True chart.title.text = "Income Analysis" ``` ### Смотрите также * модуль [`aspose.cells.charts`](..) * класс [`SeriesCollection`](/cells/python-net/ru/aspose.cells.charts/seriescollection)