Chart класс
Chart класс
Инкапсулирует объект, представляющий одну диаграмму Excel.
Тип Chart предоставляет следующие члены:
Характеристики
| Свойство | Описание |
|---|---|
| style | Получает и задает встроенный стиль. |
| chart_object | Представляет диаграммуShape; |
| hide_pivot_field_buttons | Указывает, следует ли скрывать кнопки поля сводной диаграммы только в том случае, если диаграмма является сводной диаграммой. |
| pivot_options | Задает элементы управления поворотом, которые отображаются на диаграмме. |
| pivot_source | Источником являются данные сводной таблицы.
Если PivotSource не пуст, диаграмма является PivotChart. |
| plot_by | Получает и задает график по строке или по столбцу. |
| plot_empty_cells_type | Получает и задает способ построения пустых ячеек. |
| plot_visible_cells | Указывает, отображать ли только видимые ячейки. |
| plot_visible_cells_only | Указывает, отображать ли на графике только видимые ячейки. |
| display_na_as_blank | Указывает, отображается ли #N/A как пустое значение. |
| name | Получает и задает имя диаграммы. |
| size_with_window | Истинно, если Microsoft Excel изменяет размер диаграммы, чтобы она соответствовала размеру окна листа диаграммы. |
| worksheet | Получает рабочий лист, содержащий эту диаграмму. |
| shapes | Возвращает все фигуры рисования на этой диаграмме. |
| print_size | Получает и задает размер напечатанной диаграммы. |
| type | Получает или задает тип диаграммы. |
| n_series | Получает коллекцию SeriesCollection, представляющую серию данных на диаграмме. |
| title | Получает заголовок диаграммы. |
| sub_title | Получает подзаголовок диаграммы.
Только для файла формата ODS. |
| plot_area | Получает область графика диаграммы, которая включает метки делений оси. |
| chart_area | Получает область диаграммы на листе. |
| category_axis | Получает ось X диаграммы. |
| value_axis | Получает ось Y диаграммы. |
| second_value_axis | Получает вторую ось Y диаграммы. |
| second_category_axis | Получает вторую ось X диаграммы. |
| series_axis | Получает ось серии диаграммы. |
| legend | Получает легенду диаграммы. |
| chart_data_table | Представляет таблицу данных диаграммы. |
| show_legend | Получает или задает значение, указывающее, будет ли отображаться легенда диаграммы. Значение по умолчанию верно. |
| is_rectangular_cornered | Получает или задает значение, указывающее, имеет ли область диаграммы прямоугольные углы.
Значение по умолчанию верно. |
| show_data_table | Получает или задает значение, указывающее, отображается ли на диаграмме таблица данных. |
| first_slice_angle | Получает или задает угол первого фрагмента круговой или кольцевой диаграммы в градусах (по часовой стрелке от вертикали). Применяется только к круговым, трехмерным круговым и кольцевым диаграммам от 0 до 360. |
| gap_width | Возвращает или задает расстояние между кластерами полос или столбцов в процентах от ширины полосы или столбца.
Значение этого свойства должно находиться в диапазоне от 0 до 500. |
| gap_depth | Получает или задает расстояние между рядами данных на трехмерной диаграмме в процентах от ширины маркера.
Значение этого свойства должно находиться в диапазоне от 0 до 500. |
| floor | Возвращает объект Chart.floor, представляющий стены трехмерной диаграммы. |
| walls | Возвращает объект Chart.walls, представляющий стены трехмерной диаграммы. |
| back_wall | Возвращает объект Chart.walls, представляющий заднюю стенку трехмерной диаграммы. |
| side_wall | Возвращает объект Chart.walls, представляющий боковую стенку трехмерной диаграммы. |
| walls_and_gridlines_2d | Значение true, если линии сетки на трехмерной диаграмме отображаются двумерными. |
| rotation_angle | Представляет поворот представления трехмерной диаграммы (поворот области графика вокруг оси Z в градусах). |
| elevation | Представляет высоту представления трехмерной карты в градусах. |
| right_angle_axes | Истинно, если оси диаграммы расположены под прямым углом. Применяется только для трехмерных диаграмм (кроме Column3D и трехмерных круговых диаграмм). |
| auto_scaling | Значение true, если Microsoft Excel масштабирует трехмерную диаграмму так, чтобы она была ближе по размеру к эквивалентной двумерной диаграмме.
Свойство RightAngleAxes должно быть равно True. |
| height_percent | Возвращает или задает высоту трехмерной диаграммы в процентах от ширины диаграммы (от 5 до 500 процентов). |
| perspective | Возвращает или задает перспективу для представления трехмерной диаграммы. Должно быть от 0 до 100.
Это свойство игнорируется, если свойство RightAngleAxes имеет значение True. |
| is_3d | Указывает, является ли диаграмма трехмерной. |
| depth_percent | Представляет глубину трехмерной диаграммы в процентах от ширины диаграммы (от 20 до 2000 процентов). |
| actual_chart_size | Получает фактический размер диаграммы в пикселях. |
| placement | Представляет способ прикрепления диаграммы к ячейкам под ней. |
| page_setup | Представляет описание настройки страницы на этой диаграмме. |
| line | Получает строку. |
Методы
| Метод | Описание |
|---|---|
| to_image(image_file) | Создает изображение диаграммы и сохраняет его в файл.
Расширение имени файла определяет формат изображения. |
| to_image(image_file, image_type) | Создает изображение диаграммы и сохраняет его в файл с указанным типом изображения. |
| to_image(image_file, jpeg_quality) | Создает изображение диаграммы и сохраняет его в файл в формате Jpeg. |
| to_image(stream, jpeg_quality) | Создает изображение диаграммы и сохраняет его в поток в формате Jpeg. |
| to_image(stream, image_type) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате. |
| to_image(image_file, options) | Создает изображение диаграммы и сохраняет его в файл.
Расширение имени файла определяет формат изображения. |
| to_image(stream, options) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате. |
| to_pdf(file_name) | Сохраняет диаграмму в файл pdf. |
| to_pdf(file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Сохраняет диаграмму в файл pdf. |
| to_pdf(stream) | Создает диаграмму в формате pdf и сохраняет ее в поток. |
| to_pdf(stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Создает диаграмму в формате pdf и сохраняет ее в поток. |
| is_chart_data_changed() | Определяет, изменился ли источник данных диаграммы. |
| refresh_pivot_data() | Обновляет данные сводной диаграммы из ее источника сводных данных. |
| change_template(data) | Измените тип диаграммы с помощью предустановленного шаблона. |
| move(upper_left_row, upper_left_column, lower_right_row, lower_right_column) | Перемещает диаграмму в указанное место. |
| calculate() | Вычисляет пользовательское положение области графика, осей, если их положение назначено автоматически. |
| get_actual_size() | Получает фактический размер диаграммы в пикселях. |
| has_axis(aixs_type, is_primary) | Возвращает, какие оси существуют на диаграмме. |
| switch_row_column() | Переключает строку/столбец. |
| get_chart_data_range() | Получает диапазон источника данных диаграммы. |
| set_chart_data_range(area, is_vertical) | Указывает диапазон данных для диаграммы. |
Пример
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
