Aspose.Cells FOSS - FOSS per a Python

Informació del paquet


Paquet PyPI	`aspose-cells-foss`
Importació Python	`from aspose.cells_foss import ...`
Versió	26.3.1
Licència	MIT
Requisit de Python	>= 3,7
Dependències	`pycryptodome>=3.15.0`, `olefile>=0.46`

Mòduls

Mòdul	Descripció
aspose.cells_foss	API de la taula principal: quadres, fulles de treball, cèl·lules, estils, gràfics, manipuladors de format

Nota::No hi ha: aspose.pydrawing Módul en Aspose.Cells FOSS. Els colors s’expressen com a cadenes hexàtriques AARRGGBB de 8 xifres (per exemple,., "FFFF0000" per al vermell opac).

aspose.cells_foss

Classes

Classe	Pàgina	Descripció
`Workbook`	llibre de treball	Punte d’entrada per crear, carregar i guardar arxius de fitxers de plantilla.
`Worksheet`	Folla de treball	Representa una sola fulla; proporciona accés a cèl·lules, gràfics i imatges.
`Cells`	cèl·lules	Col·lecció de diccionaris com el `Cell` objectes dins d’un `Worksheet`
`Cell`	cel·la	Representa una cel·la individual; valor, fórmula i estil
`Style`	estil	Formateig de cèl·lula: font, ompliment, bordures, alineament, format número, protecció
`Font`	estil	Propietats de la lletra: nom, mida, color, en negrit, cursiva, sota l’índex, resplendor.
`Fill`	estil	Llens de fons: sòlid, gradient o patró.
`NumberFormat`	estil	Utilitats de recerca integrades en format de números
`SaveFormat`	llibre de treball	Enumeració dels formats de sortida suportats (XLSX, CSV, MARKDOWN, JSON)
`Chart`	gràfic	Representa un quadre inclosat en una fulla de treball.
`ChartType`	gràfic	Enum: LINE, BAR, PIE, AREA, STOCK i més.
`NSeries`	gràfic	Col·lecció de sèries de dades en un gràfic
`ChartSeries`	gràfic	Una única sèrie de dades amb valors, categories i barres d’error.
`ChartAxis`	gràfic	Ajustes de l’eix: escala, format, títol
`ChartView3D`	gràfic	3D rotation and perspective settings
`ChartErrorBars`	gràfic	Configuració de barra d’errors per a una sèrie
`DataValidation`	validació de dades	Regla de validació única en un interval de cèl·lules
`DataValidationCollection`	validació de dades	Totes les regles de validació per a una fitxa d’escriptura
`DataValidationType`	validació de dades	Enum: INTELL_NUMBER, DECIMAL, LIST, Date, TIME, TEXT_LENGTH, CUSTOM (en anglès)
`DataValidationOperator`	validació de dades	Enum: BETWEEN, EQUAL, GREATER_THAN, etc.
`DataValidationAlertStyle`	validació de dades	Enum: STOP, AVIGAció. INFORMATION
`CSVHandler`	manipulador de csv	Mètodes estàtiques per a l’exportació i el tractament de dades CSV
`CSVLoadOptions`	manipulador de csv	Opcions per a la càrrega de fitxers CSV
`CSVSaveOptions`	manipulador de csv	Opcions per guardar arxius CSV
`MarkdownHandler`	manipulador de marcació	Mètodes estàtiques per a l’exportació de Marca baixa
`MarkdownSaveOptions`	manipulador de marcació	Opcions per a l’exportació de Marca baixa
`JsonHandler`	Json-handler (escollir)	Mètodes estàtiques per a l’exportació JSON
`JsonSaveOptions`	Json-handler (escollir)	Opcions per a l’exportació JSON
`Shape`	forma de la seva cara	Dibuixar forma amb rellotge, línia, text i format de font
`ShapeCollection`	forma de la seva cara	Totes les formes en una fitxa (`ws.shapes`)
`MsoDrawingType`	forma de la seva cara	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc.
`Table`	taula	Taula d’Excel (referència estructurada) en una fitxa de treball
`TableCollection`	taula	Totes les taules en una fitxa (`ws.tables`)
`TableColumn`	taula	Definició de columnes dins d’una taula
`TableStyleInfo`	taula	Configuració de l’estil visual d’una taula
`SparklineGroup`	Esparguila	Grup de gràfics amb un estil visual comú.
`SparklineGroupCollection`	Esparguila	Tots els grups de lluminària (`ws.sparkline_groups`)
`Sparkline`	Esparguila	Una sola cel·la de sparkline vinculada a un interval de dades.
`SparklineType`	Esparguila	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	interrompre pàgines	Pausa de pàgines horitzontals manual (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	interrompre pàgines	Pausa de pàgina vertical manual (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	encriptació	Parametres de xifratge AES-256/SHA-512 (recomandat)
`StandardEncryptionParameters`	encriptació	Paràmetres de xifratge AES-128/SHA-1 heretats
`CipherAlgorithm`	encriptació	Enum: AES_128, AEs_192, Aes_256
`HashAlgorithm`	encriptació	Enum: SHA1, Sha256, Shaa384, Shah512

Carnet de treball

Construtores

Signatura	Descripció
`Workbook()`	Crear un llibre de treball nou i buit (format XLSX)
`Workbook(file_path: str)`	Carregar un llibre de treball des d’una ruta de fitxer
`Workbook(file_path: str, password: str)`	Carregar un llibre de treball protegit per contrasenya

Propietats clau

Immobiliari	Tipus de productes	Descripció
`worksheets`	llista	Fills de treball d’accés per índex: `workbook.worksheets[0]`

Mètodes clau

Mètode	Retorn	Descripció
`save(file_path)`	Cap de les:	Salvar a arxiu; format inferit de l’extensió
`save(file_path, save_format)`	Cap de les:	Salvar amb SaveFormat explícit
`save_as_csv(file_path, options=None)`	Cap de les:	Salvar com CSV
`save_as_markdown(file_path, options=None)`	Cap de les:	Salvar com a taules de marcada baixa
`save_as_json(file_path, options=None)`	Cap de les:	Salvar com JSON
`load_csv(file_path, options=None)`	Cap de les:	Obtenir el llibre de treball des d’un fitxer CSV
`add_worksheet(name=None)`	Folla de treball	Ajustar una nova fulla de treball
`get_worksheet(index_or_name)`	Folla de treball	Obtindre la fitxa de treball per indexe o nom
`remove_worksheet(index_or_name)`	Cap de les:	Eliminar una fulla de treball
`copy_worksheet(index_or_name_or_ws)`	Folla de treball	Copiar una fulla de treball existent
`protect(password=None, lock_structure=True)`	Cap de les:	Protegeix amb contraseny el llibre de treball
`unprotect(password=None)`	Cap de les:	Eliminar la protecció del llibre de treball
`is_protected()`	bool (fòrum)	Comprova si el llibre de treball està protegit.

Folla de treball

Propietats clau

Immobiliari	Tipus de productes	Descripció
`name`	estr	Nom de la pesta del full d’obra
`cells`	Cèl·lules	Totes les cèl·lules d’aquesta fitxa de treball
`charts`	ChartCollection	Tots els quadres d’aquesta fitxa de treball

Cèl·lules

Cells Suporta l’accés de diccionari per cadena d’adreces cel·lulars.

Models d’accés

# 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

Cel·la

Constructor

Signatura	Descripció
`Cell(value=None)`	Crear una cèl·lula amb un valor (int, float, str o None)
`Cell(value, formula)`	Crear una cèl·lula de fórmula (el valor és normalment Ningú)

Propietats clau

Immobiliari	Tipus de productes	Descripció
`value`	Qualsevol	Valor de la cèl·lula (str, int, float o None)
`formula`	estr	Cadenes de fórmules (per exemple,., `"=SUM(A1:A5)"`)
`style`	Estilo	Estil de cèl·lula (font, omplir)

Estilo

Immobiliari	Tipus de productes	Descripció
`font`	Font de text	Ajust de font per a aquest estil
`fill`	Mantenir el registre de la reserva.	Ajust de rellotge d’exterior

Font de text

Els colors s’expressen com: 8-digit AARRGGBB hex strings sense una # Prefix. Exemples: "FFFF0000" = vermell opac, "FF0000FF" = blau opac, "FF000000" = negre.

Propriedats	Tipus de productes	Default	Descripció
`name`	estr	Calibres	Nom de família de fonts
`size`	float (flot)	11	Taula de font en punts
`color`	estr	FF000000	8-digit AARRGGBB hex color string
`bold`	bool (fòrum)	Falses	Text en negreta
`italic`	bool (fòrum)	Falses	Text en cursiva
`underline`	bool (fòrum)	Falses	Text subratllat
`strikethrough`	bool (fòrum)	Falses	Marca de text

Constructor

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

Mantenir el registre de la reserva.

Mètode	Descripció
`set_solid_fill(color)`	Un fons sòlid.; `color` és una cadena hexàgrafica de 8 xifres AARRGGBB
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Emplencament amb patrons
`set_no_fill()`	Eliminar el rellotge de fons

MarkdownHandler

Mètode	Retorn	Descripció
`MarkdownHandler.save_markdown_to_string(workbook)`	estr	Exportar llibre de treball a una cadena Markdown en memòria

MarkdownSaveOptions

Immobiliari	Tipus de productes	Default	Descripció
`default_alignment`	estr	esquerra.	Alineament de columnes: esquerra, dreta o centre.
`include_worksheet_name`	bool (fòrum)	Verdad.	Inclou el nom de la ficha com a títol
`header_level`	int	2	Nivel de direcció d’apunt (1-6)
`worksheet_index`	int	0	Índex de pàgines per a l’exportació; -1 exportacions totes les pàgines

ChartCollection

Els gràfics s’afegeixen utilitzant mètodes dedicats per tipus. amb base zero.

Mètode	Retorn	Descripció
`add_bar(top_row, left_col, bottom_row, right_col)`	Gràfica	Afegir un gràfic de columnes (barre vertical)
`add_line(top_row, left_col, bottom_row, right_col)`	Gràfica	Afegir un gràfic de línies
`add_pie(top_row, left_col, bottom_row, right_col)`	Gràfica	Afegir un gràfic de tarta

Gràfica

Immobiliari	Tipus de productes	Descripció
`title`	estr	Títol del gràfic com a cadena simple (no) `.title.text`)
`category_data`	estr	Distància de cèl·lules per a etiquetes de la categoria dels eixos x
`n_series`	NSserie	Recopilació de sèries de dades
`show_legend`	bool (fòrum)	Si mostrar la llegenda
`legend_position`	estr	Posició de la llegenda: dreta, inferior, esquerra o superior.

NSserie

Mètode	Descripció
`add(data_range, category_data=None, name=None)`	Afegir una sèrie de dades amb nom

Enumeració.

Constant	Format de sortida
`SaveFormat.XLSX`	Format XML d’Excel (default)
`SaveFormat.CSV`	Valors separats per comas
`SaveFormat.TSV`	Constant de només lectura. `workbook.save()` no suporta els augmentaments de TSV `ValueError` en el moment de l’execució.
`SaveFormat.MARKDOWN`	Taules de reducció
`SaveFormat.JSON`	Dades estructurades en JSON

Nota:: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, i SaveFormat.PPTX són: no disponible en Aspose.Cells FOSS. Aquests formats requereixen que el producte comercial sigui presentat a la pàgina web de l’empresa, i no al seu lloc d’ús. aspose-cells-python paquet.

Exemples de codi

Crear, dissenyar i guardar un llibre de treball

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")

Exportació a Markdown en memòria

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)

Construir un gràfic de línies

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")

Recursos relacionats

Guia de desenvolupadors: Tutorials per a totes les característiques principals
Inici / Instal·lació: pip instal·lació i configuració
Base de coneixement: Guides d’actuació orientats a les tasques
Vista general del producte: Resum de les característiques i capacitats
GitHub Repositori
Blog: Introducció d’Aspose.Cells FOSS: Vista general de la biblioteca i inici ràpid