Aspose.Cells FOSS for Python

Информация о пакете


Пакет PyPI	`aspose-cells-foss`
Python импорт	`from aspose.cells_foss import ...`
ImageRenderOptions	26.3.1
ImageRenderOptions	MIT
Python требование	>= 3.7
ImageRenderOptions	`pycryptodome>=3.15.0`, `olefile>=0.46`

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	Основное API электронных таблиц: рабочие книги, листы, ячейки, стили, диаграммы, обработчики форматов

ImageRenderOptions: Нет aspose.pydrawing модуль в Aspose.Cells FOSS. Цвета задаются 8-значными шестнадцатеричными строками AARRGGBB (например,., "FFFF0000" для непрозрачного красного).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	рабочая книга	Точка входа для создания, загрузки и сохранения файлов электронных таблиц
`Worksheet`	рабочий лист	Представляет отдельный лист; предоставляет доступ к ячейкам, диаграммам и изображениям
`Cells`	ячейки	Коллекция, похожая на словарь, из `Cell` объектов внутри `Worksheet`
`Cell`	ячейка	Представляет отдельную ячейку; значение, формула и стиль
`Style`	стиль	Форматирование ячейки: шрифт, заливка, границы, выравнивание, числовой формат, защита
`Font`	стиль	Свойства шрифта: имя, размер, цвет, полужирный, курсив, подчеркивание, зачеркивание
`Fill`	стиль	Фоновая заливка: сплошная, градиентная или узорчатая
`NumberFormat`	стиль	Встроенные утилиты поиска форматов чисел
`SaveFormat`	рабочая книга	Перечисление поддерживаемых форматов вывода (XLSX, CSV, MARKDOWN, JSON)
`Chart`	диаграмма	Представляет диаграмму, встроенную в лист
`ChartType`	диаграмма	Перечисление: LINE, BAR, PIE, AREA, STOCK и др.
`NSeries`	диаграмма	Коллекция рядов данных на диаграмме
`ChartSeries`	диаграмма	Один ряд данных со значениями, категориями и полосами ошибок
`ChartAxis`	диаграмма	Настройки оси: масштаб, формат, заголовок
`ChartView3D`	диаграмма	3D rotation and perspective settings
`ChartErrorBars`	диаграмма	Настройка полосы ошибок для ряда
`DataValidation`	валидация данных	Единственное правило валидации для диапазона ячеек
`DataValidationCollection`	data-validation	Все правила валидации для рабочего листа
`DataValidationType`	валидация данных	Перечисление: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	валидация данных	Перечисление: BETWEEN, EQUAL, GREATER_THAN, и т.д.
`DataValidationAlertStyle`	валидация данных	Enum: STOP, WARNING, INFORMATION
`CSVHandler`	csv-handler	Статические методы для импорта/экспорта CSV
`CSVLoadOptions`	csv-handler	Параметры загрузки CSV‑файлов
`CSVSaveOptions`	csv-handler	Параметры сохранения CSV‑файлов
`MarkdownHandler`	обработчик markdown	Статические методы для экспорта Markdown
`MarkdownSaveOptions`	обработчик markdown	Опции экспорта Markdown
`JsonHandler`	json-handler	Статические методы для экспорта JSON
`JsonSaveOptions`	json-handler	Параметры экспорта JSON
`Shape`	фигура	Рисование фигуры с заливкой, линией, текстом и форматированием шрифта
`ShapeCollection`	фигура	Все фигуры в листе (`ws.shapes`)
`MsoDrawingType`	фигура	Перечисление: RECTANGLE, OVAL, TEXT_BOX, ARROW и т.д.
`Table`	таблица	Таблица Excel (структурная ссылка) в листе
`TableCollection`	таблица	Все таблицы в листе (`ws.list_objects`)
`TableColumn`	таблица	Определение столбца в таблице
`TableStyleInfo`	таблица	Настройки визуального стиля для таблицы
`SparklineGroup`	спарклайн	Группа спарклайн‑диаграмм, использующих общий визуальный стиль
`SparklineGroupCollection`	sparkline	Все группы sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	Одна ячейка sparkline, связанная с диапазоном данных
`SparklineType`	sparkline	Перечисление: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	разрыв страницы	Ручные горизонтальные разрывы страниц (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	разрыв-страницы	Ручные вертикальные разрывы страниц (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	шифрование	Параметры шифрования AES-256/SHA-512 (рекомендовано)
`StandardEncryptionParameters`	шифрование	Унаследованные параметры шифрования AES-128/SHA-1
`CipherAlgorithm`	шифрование	Перечисление: AES_128, AES_192, AES_256
`HashAlgorithm`	шифрование	Перечисление: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Создать новую пустую книгу (формат XLSX)
`Workbook(file_path: str)`	Загрузить книгу из пути к файлу
`Workbook(file_path: str, password: str)`	Загрузить книгу, защищённую паролем

Ключевые свойства

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	список	Доступ к листам по индексу: `workbook.worksheets[0]`

Ключевые методы

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Сохранить в файл; формат определяется по расширению
`save(file_path, save_format)`	ImageRenderOptions	Сохранить с явным указанием SaveFormat
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Сохранить как CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Сохранить как таблицы Markdown
`save_as_json(file_path, options=None)`	ImageRenderOptions	Сохранить как JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Загрузить данные CSV в workbook
`add_worksheet(name=None)`	ImageRenderOptions	Добавить новый worksheet
`get_worksheet(index_or_name)`	ImageRenderOptions	Получить worksheet по индексу или имени
`remove_worksheet(index_or_name)`	ImageRenderOptions	Удалить worksheet
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Скопировать существующий лист
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Защитить книгу паролем
`unprotect(password=None)`	ImageRenderOptions	Снять защиту книги
`is_protected()`	bool	Проверить, защищена ли книга

ImageRenderOptions

Ключевые свойства

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Имя вкладки листа
`cells`	ImageRenderOptions	Все ячейки на этом листе
`charts`	ChartCollection	Все диаграммы в этом листе

ImageRenderOptions

Cells поддерживает доступ в стиле словаря по строке адреса ячейки.

Шаблоны доступа

# Read a cell value
value = ws.cells["A1"].value

# Set a cell value directly
ws.cells["A1"].value = "Hello"

# Assign a Cell object
from aspose.cells_foss import Cell
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14)
ws.cells["A3"] = Cell("Hello World")
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)")   # formula cell

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Cell(value=None)`	Создать ячейку со значением (int, float, str или None)
`Cell(value, formula)`	Создать ячейку с формулой (значение обычно None)

Ключевые свойства

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Значение ячейки (str, int, float или None)
`formula`	str	Строка формулы (например,., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Стиль ячейки (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Настройки шрифта для этого стиля
`fill`	ImageRenderOptions	Настройки заливки фона

ImageRenderOptions

Цвета задаются как 8-digit AARRGGBB hex strings без # префикса. Примеры: "FFFF0000" = непрозрачный красный, "FF0000FF" = непрозрачный синий, "FF000000" чёрный.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Название семейства шрифтов
`size`	float	11	Размер шрифта в пунктах
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Жирный текст
`italic`	bool	ImageRenderOptions	Курсивный текст
`underline`	bool	ImageRenderOptions	Подчёркнутый текст
`strikethrough`	bool	ImageRenderOptions	Зачёркнутый текст

ImageRenderOptions

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Сплошной фон; `color` является 8-значной шестнадцатеричной строкой AARRGGBB
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Узорное заполнение
`set_no_fill()`	Удалить заливку фона

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Экспортировать рабочую книгу в строку Markdown в памяти

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	слева	Выравнивание столбца: слева, справа или по центру
`include_worksheet_name`	bool	ImageRenderOptions	Включать ли имя листа в качестве заголовка
`header_level`	int	2	Уровень заголовка Markdown (1-6)
`worksheet_index`	int	0	Индекс листа для экспорта; -1 экспортирует все листы

ChartCollection

Диаграммы добавляются с помощью специализированных методов для каждого типа. Индексы строк и столбцов являются нумерацией с нуля.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Добавить столбчатую (вертикальную) диаграмму
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Добавить линейную диаграмму
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Добавить круговую диаграмму

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Заголовок диаграммы как обычная строка (не `.title.text`)
`category_data`	str	Диапазон ячеек для меток категорий оси X
`n_series`	NSeries	Коллекция рядов данных
`show_legend`	bool	Отображать ли легенду
`legend_position`	str	Позиция легенды: справа, снизу, слева или сверху

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Добавить именованную серию данных

Перечисление SaveFormat

ImageRenderOptions	Формат вывода
`SaveFormat.XLSX`	Excel Open XML (по умолчанию)
`SaveFormat.CSV`	Значения, разделённые запятыми
`SaveFormat.TSV`	Значения, разделённые табуляцией
`SaveFormat.MARKDOWN`	Таблицы Markdown
`SaveFormat.JSON`	JSON-структурированные данные

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, и SaveFormat.PPTX являются не доступны в Aspose.Cells FOSS. Эти форматы требуют коммерческого aspose-cells-python пакет.

Примеры кода

Создание, стилизация и сохранение рабочей книги

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["A1"].value = "Revenue Report"
ws.cells["A2"].value = 125000

ws.cells["A1"].style.font.bold = True
ws.cells["A1"].style.font.size = 14
ws.cells["A1"].style.font.color = "FF1E64C8"   # Blue (AARRGGBB, no #)

wb.save("report.xlsx")

Экспорт в Markdown в памяти

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95

md = MarkdownHandler.save_markdown_to_string(wb)
print(md)

Создание линейного графика

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

for i, (m, v) in enumerate([("Jan", 50), ("Feb", 80), ("Mar", 120)], start=2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = v

chart = ws.charts.add_line(5, 0, 18, 7)
chart.title = "Monthly Trend"
chart.category_data = "A2:A4"
chart.n_series.add("B2:B4", category_data="A2:A4", name="Sales")

wb.save("trend.xlsx")

Сопутствующие ресурсы

Руководство разработчика: Учебники по всем основным функциям
Getting Started / Installation: pip install и настройка
База знаний: Практические руководства, ориентированные на задачи
Обзор продукта: Сводка функций и возможностей
Репозиторий GitHub
Блог: Представляем Aspose.Cells FOSS: Обзор библиотеки и быстрое начало