Aspose.Cells FOSS for Python

Informazioni sul pacchetto


pacchetto PyPI	`aspose-cells-foss`
Python importazione	`from aspose.cells_foss import ...`
ImageRenderOptions	26.3.1
ImageRenderOptions	MIT
Python requisito	>= 3.7
ImageRenderOptions	`pycryptodome>=3.15.0`, `olefile>=0.46`

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	API principale per fogli di calcolo: cartelle di lavoro, fogli di lavoro, celle, stili, grafici, gestori di formato

ImageRenderOptions: Non c’è aspose.pydrawing modulo in Aspose.Cells FOSS. I colori sono espressi come stringhe esadecimali a 8 cifre AARRGGBB (ad es., "FFFF0000" per rosso opaco).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	cartella di lavoro	Punto di ingresso per creare, caricare e salvare file di foglio di calcolo
`Worksheet`	foglio di lavoro	Rappresenta un singolo foglio; fornisce l’accesso a celle, grafici e immagini
`Cells`	celle	Collezione simile a un dizionario di `Cell` oggetti all’interno di un `Worksheet`
`Cell`	cella	Rappresenta una cella individuale; valore, formula e stile
`Style`	stile	Formattazione della cella: carattere, riempimento, bordi, allineamento, formato numerico, protezione
`Font`	stile	Proprietà del font: nome, dimensione, colore, grassetto, corsivo, sottolineato, barrato
`Fill`	stile	Riempimento di sfondo: solido, gradiente o motivo
`NumberFormat`	stile	Utility integrate per la ricerca di formati numerici
`SaveFormat`	cartella di lavoro	Enumerazione dei formati di output supportati (XLSX, CSV, MARKDOWN, JSON)
`Chart`	grafico	Rappresenta un grafico incorporato in un foglio di lavoro
`ChartType`	grafico	Enum: LINE, BAR, PIE, AREA, STOCK e altri
`NSeries`	grafico	Raccolta di serie di dati su un grafico
`ChartSeries`	grafico	Una singola serie di dati con valori, categorie e barre di errore
`ChartAxis`	grafico	Impostazioni dell’asse: scala, formato, titolo
`ChartView3D`	grafico	3D rotation and perspective settings
`ChartErrorBars`	grafico	Configurazione della barra di errore per una serie
`DataValidation`	data-validation	Regola di convalida singola su un intervallo di celle
`DataValidationCollection`	data-validation	Tutte le regole di convalida per un foglio di lavoro
`DataValidationType`	data-validation	Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	data-validation	Enum: BETWEEN, EQUAL, GREATER_THAN, ecc.
`DataValidationAlertStyle`	data-validation	Enum: STOP, WARNING, INFORMATION
`CSVHandler`	csv-handler	Metodi statici per l’importazione/esportazione CSV
`CSVLoadOptions`	csv-handler	Opzioni per il caricamento di file CSV
`CSVSaveOptions`	csv-handler	Opzioni per il salvataggio di file CSV
`MarkdownHandler`	markdown-handler	Metodi statici per l’esportazione Markdown
`MarkdownSaveOptions`	markdown-handler	Opzioni per l’esportazione Markdown
`JsonHandler`	json-handler	Metodi statici per l’esportazione JSON
`JsonSaveOptions`	json-handler	Opzioni per l’esportazione JSON
`Shape`	forma	Disegnare una forma con riempimento, linea, testo e formattazione del carattere
`ShapeCollection`	forma	Tutte le forme in un foglio di lavoro (`ws.shapes`)
`MsoDrawingType`	forma	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, ecc.
`Table`	tabella	Tabella Excel (riferimento strutturato) in un foglio di lavoro
`TableCollection`	tabella	Tutte le tabelle in un foglio di lavoro (`ws.list_objects`)
`TableColumn`	tabella	Definizione della colonna all’interno di una tabella
`TableStyleInfo`	tabella	Impostazioni dello stile visivo per una tabella
`SparklineGroup`	sparkline	Gruppo di grafici sparkline che condividono uno stile visivo
`SparklineGroupCollection`	sparkline	Tutti i gruppi di sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	Una singola cella sparkline collegata a un intervallo di dati
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	page-break	Interruzioni di pagina orizzontali manuali (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	page-break	Interruzioni di pagina verticali manuali (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	cifratura	Parametri di cifratura AES-256/SHA-512 (consigliati)
`StandardEncryptionParameters`	cifratura	Parametri di cifratura legacy AES-128/SHA-1
`CipherAlgorithm`	cifratura	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	cifratura	Enum: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Crea un nuovo workbook vuoto (formato XLSX)
`Workbook(file_path: str)`	Carica un workbook da un percorso di file
`Workbook(file_path: str, password: str)`	Carica una cartella di lavoro protetta da password

Proprietà chiave

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	elenco	Accedi ai fogli di lavoro per indice: `workbook.worksheets[0]`

Metodi chiave

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Salva su file; formato dedotto dall’estensione
`save(file_path, save_format)`	ImageRenderOptions	Salva con SaveFormat esplicito
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Salva come CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Salva come tabelle Markdown
`save_as_json(file_path, options=None)`	ImageRenderOptions	Salva come JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Carica dati CSV nella cartella di lavoro
`add_worksheet(name=None)`	ImageRenderOptions	Aggiungi un nuovo foglio di lavoro
`get_worksheet(index_or_name)`	ImageRenderOptions	Ottieni il foglio di lavoro per indice o nome
`remove_worksheet(index_or_name)`	ImageRenderOptions	Rimuovi un foglio di lavoro
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Copia un foglio di lavoro esistente
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Proteggi la cartella di lavoro con password
`unprotect(password=None)`	ImageRenderOptions	Rimuovi la protezione della cartella di lavoro
`is_protected()`	bool	Verifica se la cartella di lavoro è protetta

ImageRenderOptions

Proprietà chiave

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Nome della scheda del foglio di lavoro
`cells`	ImageRenderOptions	Tutte le celle in questo foglio di lavoro
`charts`	ChartCollection	Tutti i grafici in questo foglio di lavoro

ImageRenderOptions

Cells supporta l’accesso in stile dizionario tramite stringa di indirizzo della cella.

Modelli di accesso

# 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)`	Crea una cella con un valore (int, float, str o None)
`Cell(value, formula)`	Crea una cella formula (il valore è tipicamente None)

Proprietà chiave

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Valore della cella (str, int, float o None)
`formula`	str	Stringa della formula (ad es., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Stile della cella (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Impostazioni del font per questo stile
`fill`	ImageRenderOptions	Impostazioni di riempimento dello sfondo

ImageRenderOptions

I colori sono espressi come 8-digit AARRGGBB hex strings senza un # prefisso. Esempi: "FFFF0000" = rosso opaco, "FF0000FF" = blu opaco, "FF000000" = nero.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Nome della famiglia di caratteri
`size`	float	11	Dimensione del carattere in punti
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Testo in grassetto
`italic`	bool	ImageRenderOptions	Testo in corsivo
`underline`	bool	ImageRenderOptions	Testo sottolineato
`strikethrough`	bool	ImageRenderOptions	Testo barrato

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Sfondo solido; `color` è una stringa esadecimale AARRGGBB a 8 cifre
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Riempimento a trama
`set_no_fill()`	Rimuovi riempimento di sfondo

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Esporta la cartella di lavoro in una stringa Markdown in memoria

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	sinistra	Allineamento colonna: sinistra, destra o centro
`include_worksheet_name`	bool	ImageRenderOptions	Indica se includere il nome del foglio come intestazione
`header_level`	int	2	Livello di intestazione Markdown (1-6)
`worksheet_index`	int	0	Indice del foglio da esportare; -1 esporta tutti i fogli

ChartCollection

I grafici vengono aggiunti usando metodi dedicati per tipo. Gli indici di riga e colonna sono basati su zero.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Aggiungi un grafico a colonne (barra verticale)
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Aggiungi un grafico a linee
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Aggiungi un grafico a torta

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Titolo del grafico come stringa semplice (non `.title.text`)
`category_data`	str	Intervallo di celle per le etichette di categoria dell’asse x
`n_series`	NSeries	Raccolta di serie di dati
`show_legend`	bool	Se visualizzare la legenda
`legend_position`	str	Posizione della legenda: destra, in basso, sinistra o in alto

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Aggiungi una serie di dati denominata

Enumerazione SaveFormat

ImageRenderOptions	Formato di output
`SaveFormat.XLSX`	Excel Open XML (predefinito)
`SaveFormat.CSV`	Valori separati da virgola
`SaveFormat.TSV`	Valori separati da tabulazione
`SaveFormat.MARKDOWN`	Tabelle Markdown
`SaveFormat.JSON`	Dati strutturati JSON

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, e SaveFormat.PPTX sono non disponibili in Aspose.Cells FOSS. Questi formati richiedono il commerciale aspose-cells-python pacchetto.

Esempi di codice

Crea, formatta e salva una cartella di lavoro

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

Esporta in Markdown in memoria

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)

Crea un grafico a linee

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

Risorse correlate

Guida per sviluppatori: Tutorial per tutte le funzionalità principali
Iniziare / Installazione: pip install e configurazione
Base di conoscenza: Guide pratiche orientate al compito
Panoramica del prodotto: Riepilogo di funzionalità e capacità
Repository GitHub
Blog: Presentazione di Aspose.Cells FOSS: Panoramica della libreria e avvio rapido