Aspose.Cells FOSS за Python
Информация за опаковката
| Пакет PyPI | aspose-cells-foss |
| Импорт на Python | from aspose.cells_foss import ... |
| Версия на: | 26.3.1 |
| Лицензия | MIT |
| Изискване за Python | >= 3,7 |
| Зависимости | pycryptodome>=3.15.0, olefile>=0.46 |
Модули
| Модул | Описание на състоянието |
|---|---|
| aspose.cells_foss | Основен API за електронни таблици: работни книги, листчета, клетки, стилове, диаграми, обработчици на формати |
Забележка::Няма:
aspose.pydrawingмодул в Aspose.Cells FOSS. Цветовете се изразяват като 8-цифрови AARRGGBB хексасидни нишки (напр.,"FFFF0000"за непрозрачно червено).
aspose.cells_foss
Класове
| Класът | Страница | Описание на състоянието |
|---|---|---|
Workbook | работна книга | Входна точка за създаване, зареждане и съхранение на файлове от таблици |
Worksheet | работен лист | Представя един лист; предоставя достъп до клетки, диаграми и картини |
Cells | клетки | Сборник като речник на Cell обекти в рамките на Worksheet |
Cell | клетка | Представя отделна клетка; стойност, формула и стил |
Style | стил | Форматиране на клетките: шрифт, пълнене, граници, подравняване, формат на номера, защита |
Font | стил | Свойства на шрифта: име, размер, цвят, дебели букви, курсив, подчертание, пробиване през |
Fill | стил | Запълване на фона: твърдо, с градиент или модел |
NumberFormat | стил | Вградени утилити за търсене на формат номер |
SaveFormat | работна книга | Изброяване на поддържаните формати за изход (XLSX, CSV, MARKDOWN, JSON) |
Chart | диаграма | Представя таблица, вградена в работен лист. |
ChartType | диаграма | Енум: ЛИНА, BAR, PIE, AREA, СТОК и др. |
NSeries | диаграма | Събиране на серии данни в диаграма |
ChartSeries | диаграма | Единна серия от данни с стойности, категории и ленти за грешки. |
ChartAxis | диаграма | Настройки на оси: мащаб, формат, заглавие |
ChartView3D | диаграма | 3D rotation and perspective settings |
ChartErrorBars | диаграма | Конфигурация на лентата с грешки за серия |
DataValidation | валидиране на данни | Правило за еднократно валидиране на диапазон от клетки |
DataValidationCollection | валидиране на данни | Всички правила за валидиране на работен лист |
DataValidationType | валидиране на данни | Enum: WHOLE_NUMBER, DECIMAL, LIST, ДАТА, Времето, TEXT_LENGTH, CUSTOM (по-долу) |
DataValidationOperator | валидиране на данни | Enum: BETWEEN, EQUAL, GREATER_THAN и др. |
DataValidationAlertStyle | валидиране на данни | СТОП, ВРЕДНИЩО. INFORMATION - За да се изправиш на това място? |
CSVHandler | CSV-разредувач | Статични методи за износ на CSV и обработка на данни от CS V |
CSVLoadOptions | CSV-разредувач | Опции за зареждане на CSV файлове |
CSVSaveOptions | CSV-разредувач | Опции за съхранение на CSV файлове |
MarkdownHandler | Маркировъчен механизъм за обработка на данни | Статични методи за износ с Markdown |
MarkdownSaveOptions | Маркировъчен механизъм за обработка на данни | Опции за износ с Markdown |
JsonHandler | Джентълмен Хендлър | Статични методи за износ на JSON |
JsonSaveOptions | Джентълмен Хендлър | Опции за износ в JSON |
Shape | форма на косъм | Рисуване на форма с попълнение, линия, текст и форматиране на шрифт |
ShapeCollection | форма на косъм | Всички форми в таблица (ws.shapes) |
MsoDrawingType | форма на косъм | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW и др. |
Table | таблица | Таблица в Excel (структурирана референция) в работен лист |
TableCollection | таблица | Всички таблици в даден лист (ws.tables) |
TableColumn | таблица | Определение на колони в таблица |
TableStyleInfo | таблица | Настройки на визуален стил за таблица |
SparklineGroup | Спарклин (светър) | Група от диаграми с общ визуален стил. |
SparklineGroupCollection | Спарклин (светър) | Всички групи с искри (ws.sparkline_groups) |
Sparkline | Спарклин (светър) | Една клетка с искри, свързана към диапазон от данни. |
SparklineType | Спарклин (светър) | Enum: 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 | криптиране | Enum: SHA1, Sha256, Shaa384, Shaha512 |
Списание на работния лист
Конструктори
| Подписът | Описание на състоянието |
|---|---|
Workbook() | Създаване на нова празна работна книга (формат XLSX) |
Workbook(file_path: str) | Зареждане на работна книга от пътека за файл |
Workbook(file_path: str, password: str) | Зареждане на защитена с парола работна книга |
Основни свойства
| Имотът | Тип на изпитване | Описание на състоянието |
|---|---|---|
worksheets | списък на | Достъпни работни листове по индекс: workbook.worksheets[0] |
Основни методи
| Методът: | Връщане. | Описание на състоянието |
|---|---|---|
save(file_path) | Никакви | Запишете във файл; формат, извлечен от разширението |
save(file_path, save_format) | Никакви | Запазване с изрично SaveFormat |
save_as_csv(file_path, options=None) | Никакви | Запишете като CSV |
save_as_markdown(file_path, options=None) | Никакви | Запазване като таблици за отчитане |
save_as_json(file_path, options=None) | Никакви | Запишете като JSON |
load_csv(file_path, options=None) | Никакви | Запълване на работната книга от CSV файл |
add_worksheet(name=None) | Работен лист | Добавяне на нов работен лист |
get_worksheet(index_or_name) | Работен лист | Изберете работен лист по индекс или име |
remove_worksheet(index_or_name) | Никакви | Изтриване на работен лист |
copy_worksheet(index_or_name_or_ws) | Работен лист | Копиране на съществуващ работен лист |
protect(password=None, lock_structure=True) | Никакви | Защита с парола на работната книга |
unprotect(password=None) | Никакви | Отстраняване на защитата на работната книга |
is_protected() | Буул | Проверете дали работният книжок е защитен. |
Работен лист
Основни свойства
| Имотът | Тип на изпитване | Описание на състоянието |
|---|---|---|
name | Стройка | Име на раздела за работен лист |
cells | Клетки | Всички клетки в този лист |
charts | ChartCollection | Всички графики в този лист |
Клетки
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Клетка
Строител
| Подписът | Описание на състоянието |
|---|---|
Cell(value=None) | Създаване на клетка с стойност (int, float, str или None) |
Cell(value, formula) | Създаване на клетка с формула (ценката обикновено е Никаква) |
Основни свойства
| Имотът | Тип на изпитване | Описание на състоянието |
|---|---|---|
value | Всякакви | Стойност на клетката (str, int, float или None) |
formula | Стройка | Строка от формули (напр.., "=SUM(A1:A5)") |
style | Стилът | Стил на клетка (черник, попълване) |
Стилът
| Имотът | Тип на изпитване | Описание на състоянието |
|---|---|---|
font | Фонт | Настройки за този стил на шрифт |
fill | Запълване | Настройки за попълване на фона |
Фонт
Цветовете се изразяват като: 8-digit AARRGGBB hex strings без а # Префикс. Примери: "FFFF0000" = непрозрачно червено, "FF0000FF" = непрозрачно синьо, "FF000000" - Черно.
| Имотът | Тип на изпитване | По подразбиране: | Описание на състоянието |
|---|---|---|---|
name | Стройка | Калибри | Фамилия на шрифта |
size | плаващо | 11 | Размер на шрифта в точки |
color | Стройка | FF000000 | 8-digit AARRGGBB hex color string |
bold | Буул | Неправилно | Текст в дебело писмо |
italic | Буул | Неправилно | Текст в курсив |
underline | Буул | Неправилно | Подчертан текст |
strikethrough | Буул | Неправилно | Пробиване през текст |
Строител
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)Запълване
| Методът: | Описание на състоянието |
|---|---|
set_solid_fill(color) | Достоверна история; color е 8-цифрен AARRGGBB хексалов ред |
set_pattern_fill(pattern_type, fg_color, bg_color) | Схематично пълнене |
set_no_fill() | Да премахне запълване на фона |
MarkdownHandler
| Методът: | Връщане. | Описание на състоянието |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | Стройка | Износ на работна книга в Markdown реплика в паметта |
MarkdownSaveOptions
| Имотът | Тип на изпитване | По подразбиране: | Описание на състоянието |
|---|---|---|---|
default_alignment | Стройка | Вляво. | Настройка на колоните: ляво, дясно или в центъра. |
include_worksheet_name | Буул | Вярно. | Дали да се включи името на листата като заглавие |
header_level | в) | 2 | Ниво на маркировката (1-6) |
worksheet_index | в) | 0 | Индекс на листата за износ; -1 износа всички листове |
ChartCollection
Графиките се добавят чрез специални методи за всеки тип. Индексите на редове и колони са: на нулева основа.
| Методът: | Връщане. | Описание на състоянието |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | Графика на състоянието | Добавете колона (вертикална лента) диаграма |
add_line(top_row, left_col, bottom_row, right_col) | Графика на състоянието | Добавяне на графика от редове |
add_pie(top_row, left_col, bottom_row, right_col) | Графика на състоянието | Добавете диаграма с пити. |
Графика на състоянието
| Имотът | Тип на изпитване | Описание на състоянието |
|---|---|---|
title | Стройка | Заглавие на диаграмата като обикновена нишка (не .title.text) |
category_data | Стройка | Обхват на клетките за етикети от категорията x-осе |
n_series | НСерията | Събиране на серии данни |
show_legend | Буул | Дали да се показва легендата |
legend_position | Стройка | Положение на легендата: дясно, долу, ляво или горе. |
НСерията
| Методът: | Описание на състоянието |
|---|---|
add(data_range, category_data=None, name=None) | Добавяне на серия от данни с име |
SaveFormat Преброяване
| Постоянна | Формат на изхода |
|---|---|
SaveFormat.XLSX | Формат на Excel XML (по подразбиране) |
SaveFormat.CSV | Разделени с кома стойности |
SaveFormat.TSV | Постоянна само за четене. workbook.save() не поддържа повишаване на TSV ValueError в момента на изпълнение. |
SaveFormat.MARKDOWN | Таблици за отчитане на стойностите |
SaveFormat.JSON | Строежи в JSON |
Забележка::
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")Свързани ресурси
- Ръководство за разработчиците:Тюриали за всички основни функции
- Започване / Инсталация: инсталиране и настройка на пип
- База от знания: насочени към задачи ръководства за подход
- Общ преглед на продукта: Описание на характеристиките и възможностите
- GitHub Репозиторий
- Блог: Представяме Aspose.Cells FOSS: Преглед на библиотеката и бърз старт