Chart класс
Chart класс
Инкапсулирует объект, представляющий одну диаграмму Excel.
Тип Chart предоставляет следующие элементы:
Характеристики
| Свойство | Описание |
|---|---|
| style | Получает и задает встроенный стиль. |
| chart_object | Представляет форму диаграммы; |
| 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, представляющую ряд данных на диаграмме. |
| filtered_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 | Возвращает или задаёт значение, указывающее, будет ли отображаться легенда диаграммы. Значение по умолчанию — true. |
| is_rectangular_cornered | Возвращает или задает значение, указывающее, имеет ли область диаграммы прямоугольные углы. Значение по умолчанию — true. |
| 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 | Истина, если линии сетки отображены на трехмерной диаграмме в двух измерениях. |
| rotation_angle | Представляет поворот трехмерного представления диаграммы (поворот области построения вокруг оси z в градусах). |
| elevation | Представляет высоту трехмерного представления карты в градусах. |
| right_angle_axes | Истина, если оси диаграммы расположены под прямым углом. Применимо только к трёхмерным диаграммам (кроме Column3D и 3D Pie Charts). |
| auto_scaling | Истина, если 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 | Получает строку. |
Методы
| Метод | Описание |
|---|---|
calculate(self) | Рассчитывает пользовательское положение области графика и осей, если их положение назначено автоматически. |
calculate(self, calculate_options) | Рассчитывает пользовательское положение области графика и осей, если их положение назначено автоматически, с помощью параметров расчета диаграммы. |
to_image(self, image_file) | Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения. |
to_image(self, image_file, image_type) | Создает изображение диаграммы и сохраняет его в файле указанного типа изображения. |
to_image(self, image_file, jpeg_quality) | Создает изображение диаграммы и сохраняет его в файле в формате Jpeg. |
to_image(self, stream, jpeg_quality) | Создает изображение диаграммы и сохраняет его в потоке в формате Jpeg. |
to_image(self, stream, image_type) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате. |
to_image(self, image_file, options) | Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения. |
to_image(self, stream, options) | Создает изображение диаграммы и сохраняет его в потоке в указанном формате. |
to_pdf(self, file_name) | Сохраняет диаграмму в PDF-файл. |
to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Сохраняет диаграмму в PDF-файл. |
to_pdf(self, stream) | Создает диаграмму в формате PDF и сохраняет ее в потоке. |
to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | Создает диаграмму в формате PDF и сохраняет ее в потоке. |
is_refered_by_chart(self, row_index, column_index) | Возвращает, ссылается ли ячейка на диаграмму. |
is_cell_refered_by_chart(self, sheet_index, row_index, column_index) | Возвращает, ссылается ли ячейка на диаграмму. |
is_chart_data_changed(self) | Определяет, изменился ли источник данных диаграммы. |
refresh_pivot_data(self) | Обновляет данные диаграммы из сводной таблицы. |
change_template(self, data) | Измените тип диаграммы с помощью предустановленного шаблона. |
move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column) | Перемещает диаграмму в указанное место. |
get_actual_size(self) | Получает фактический размер диаграммы в пикселях. |
has_axis(self, aixs_type, is_primary) | Возвращает, какие оси существуют на диаграмме. |
switch_row_column(self) | Переключает строку/столбец. |
get_chart_data_range(self) | Получает диапазон источника данных диаграммы. |
set_chart_data_range(self, area, is_vertical) | Задает диапазон данных для диаграммы. |
Пример
Следующие коды показывают, как создать диаграмму с помощью кодов .Net.
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
