Aspose.Cells FOSS за Python

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

Пакет PyPIaspose-cells-foss
Импорт на Pythonfrom 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 - За да се изправиш на това място?
CSVHandlerCSV-разредувачСтатични методи за износ на CSV и обработка на данни от CS V
CSVLoadOptionsCSV-разредувачОпции за зареждане на CSV файлове
CSVSaveOptionsCSV-разредувачОпции за съхранение на 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КлеткиВсички клетки в този лист
chartsChartCollectionВсички графики в този лист

Клетки

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СтройкаFF0000008-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")

Свързани ресурси

 Български