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, представляющую ряд данных на диаграмме. |
| 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 | Получает или задает значение, указывающее, будет ли отображаться легенда диаграммы. По умолчанию верно. |
| 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 | Истинно, если линии сетки нарисованы на трехмерной диаграмме в двухмерном виде. |
| rotation_angle | Представляет вращение трехмерного представления диаграммы (поворот области графика вокруг оси Z в градусах). |
| elevation | Представляет высоту трехмерной карты в градусах. |
| right_angle_axes | Верно, если оси диаграммы расположены под прямым углом. Применяется только для трехмерных диаграмм (кроме Column3D и трехмерных круговых диаграмм). |
| 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 | Вычисляет пользовательское положение области графика и осей, если их положение назначено автоматически. |
| calculate | Вычисляет пользовательское положение области графика и осей, если их положение назначено автоматически, с помощью параметров расчета диаграммы. |
| to_image | Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения. |
| to_image | Создает изображение диаграммы и сохраняет его в файл указанного типа изображения. |
| to_image | Создает изображение диаграммы и сохраняет его в файл в формате Jpeg. |
| to_image | Создает изображение диаграммы и сохраняет его в поток в формате Jpeg. |
| to_image | Создает изображение диаграммы и сохраняет его в поток в указанном формате. |
| to_image | Создает изображение диаграммы и сохраняет его в файл. Расширение имени файла определяет формат изображения. |
| to_image | Создает изображение диаграммы и сохраняет его в поток в указанном формате. |
| to_pdf | Сохраняет диаграмму в файл PDF. |
| to_pdf | Сохраняет диаграмму в файл PDF. |
| to_pdf | Создает диаграмму в формате PDF и сохраняет ее в поток. |
| to_pdf | Создает диаграмму в формате PDF и сохраняет ее в поток. |
| is_refered_by_chart | Возвращает, на какую ячейку ссылается диаграмма. |
| is_cell_refered_by_chart | Возвращает, на какую ячейку ссылается диаграмма. |
| is_chart_data_changed | Обнаруживает, изменился ли источник данных диаграммы. |
| refresh_pivot_data | Обновляет данные сводной диаграммы из источника сводных данных. |
| change_template | Измените тип диаграммы с помощью предустановленного шаблона. |
| move | Перемещает диаграмму в указанное место. |
| get_actual_size | Получает фактический размер диаграммы в пикселях. |
| has_axis | Возвращает сведения о том, какие оси существуют на диаграмме. |
| switch_row_column | Переключает строку/столбец. |
| get_chart_data_range | Получает диапазон источника данных диаграммы. |
| set_chart_data_range | Указывает диапазон данных для диаграммы. |
Пример
Следующие коды показывают, как создать диаграмму с кодами .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
