Aspose.Cells FOSS for Python

Informații despre pachet


pachet PyPI	`aspose-cells-foss`
import Python	`from aspose.cells_foss import ...`
ImageRenderOptions	26.3.1
ImageRenderOptions	MIT
cerință Python	>= 3.7
ImageRenderOptions	`pycryptodome>=3.15.0`, `olefile>=0.46`

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	API de bază pentru foi de calcul: cărți de lucru, foi de lucru, celule, stiluri, grafice, gestori de format

ImageRenderOptions: Nu există aspose.pydrawing modul în Aspose.Cells FOSS. Culorile sunt exprimate ca șiruri hexazecimale de 8 cifre AARRGGBB (de exemplu,., "FFFF0000" pentru roșu opac).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	carte de lucru	Punct de intrare pentru crearea, încărcarea și salvarea fișierelor de foi de calcul
`Worksheet`	foaie de lucru	Reprezintă o singură foaie; oferă acces la celule, grafice și imagini
`Cells`	celule	Colecție de tip dicționar a `Cell` obiecte dintr-un `Worksheet`
`Cell`	celulă	Reprezintă o celulă individuală; valoare, formulă și stil
`Style`	stil	Formatarea celulei: font, umplere, borduri, aliniere, format numeric, protecție
`Font`	stil	Proprietăți font: nume, dimensiune, culoare, îngroșat, italic, subliniat, tăiat
`Fill`	stil	Umplere de fundal: solidă, gradientă sau model
`NumberFormat`	stil	Utilități încorporate pentru căutarea formatelor de număr
`SaveFormat`	caiet de lucru	Enumerarea formatelor de ieșire suportate (XLSX, CSV, MARKDOWN, JSON)
`Chart`	diagramă	Reprezintă o diagramă încorporată într-un caiet de lucru
`ChartType`	diagramă	Enum: LINE, BAR, PIE, AREA, STOCK și altele
`NSeries`	diagramă	Colecție de serii de date pe o diagramă
`ChartSeries`	diagramă	O singură serie de date cu valori, categorii și bare de eroare
`ChartAxis`	diagramă	Setări axă: scară, format, titlu
`ChartView3D`	diagramă	3D rotation and perspective settings
`ChartErrorBars`	diagramă	Configurarea barei de eroare pentru o serie
`DataValidation`	validare-date	O regulă de validare unică pe un interval de celule
`DataValidationCollection`	validare-date	Toate regulile de validare pentru o foaie de lucru
`DataValidationType`	data-validation	Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	data-validation	Enum: BETWEEN, EQUAL, GREATER_THAN, etc.
`DataValidationAlertStyle`	data-validation	Enum: STOP, WARNING, INFORMATION
`CSVHandler`	csv-handler	Metode statice pentru import/export CSV
`CSVLoadOptions`	csv-handler	Opțiuni pentru încărcarea fișierelor CSV
`CSVSaveOptions`	csv-handler	Opțiuni pentru salvarea fișierelor CSV
`MarkdownHandler`	markdown-handler	Metode statice pentru exportul Markdown
`MarkdownSaveOptions`	markdown-handler	Opțiuni pentru exportul Markdown
`JsonHandler`	json-handler	Metode statice pentru exportul JSON
`JsonSaveOptions`	json-handler	Opțiuni pentru exportul JSON
`Shape`	formă	Desenarea formei cu umplere, linie, text și formatare a fontului
`ShapeCollection`	formă	Toate formele dintr‑o foaie de lucru (`ws.shapes`)
`MsoDrawingType`	formă	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc.
`Table`	tabel	Tabel Excel (referință structurată) într‑o foaie de lucru
`TableCollection`	tabel	Toate tabelele dintr‑o foaie de lucru (`ws.list_objects`)
`TableColumn`	tabel	Definiție de coloană în cadrul unui Tabel
`TableStyleInfo`	tabel	Setări de stil vizual pentru un tabel
`SparklineGroup`	sparkline	Grup de grafice sparkline care împărtășesc același stil vizual
`SparklineGroupCollection`	sparkline	Toate grupurile sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	O singură celulă sparkline legată de un interval de date
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	page-break	Întreruperi de pagină orizontale manuale (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	întrerupere de pagină	Întreruperi de pagină verticale manuale (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	criptare	Parametri de criptare AES-256/SHA-512 (recomandat)
`StandardEncryptionParameters`	criptare	Parametri de criptare legacy AES-128/SHA-1
`CipherAlgorithm`	criptare	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	criptare	Enum: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Creează un registru de lucru nou și gol (format XLSX)
`Workbook(file_path: str)`	Încarcă un registru de lucru dintr-o cale de fișier
`Workbook(file_path: str, password: str)`	Încarcă un registru de lucru protejat prin parolă

Proprietăți cheie

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	listă	Accesează foile de lucru prin index: `workbook.worksheets[0]`

Metode cheie

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Salvează în fișier; formatul este dedus din extensie
`save(file_path, save_format)`	ImageRenderOptions	Salvează cu SaveFormat explicit
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Salvează ca CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Salvează ca tabele Markdown
`save_as_json(file_path, options=None)`	ImageRenderOptions	Salvează ca JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Încarcă date CSV în registrul de lucru
`add_worksheet(name=None)`	ImageRenderOptions	Adaugă o nouă foaie de lucru
`get_worksheet(index_or_name)`	ImageRenderOptions	Obține foaia de lucru după index sau nume
`remove_worksheet(index_or_name)`	ImageRenderOptions	Elimină o foaie de lucru
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Copiază o foaie de lucru existentă
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Protejează cu parolă caietul de lucru
`unprotect(password=None)`	ImageRenderOptions	Elimină protecția caietului de lucru
`is_protected()`	bool	Verifică dacă caietul de lucru este protejat

ImageRenderOptions

Proprietăți cheie

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Numele filei de lucru
`cells`	ImageRenderOptions	Toate celulele din această foaie de lucru
`charts`	ChartCollection	Toate graficele din această foaie de lucru

ImageRenderOptions

Cells acceptă acces în stil dicționar prin șirul adresei celulei.

Modele de acces

# 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)`	Creează o celulă cu o valoare (int, float, str sau None)
`Cell(value, formula)`	Creează o celulă de formulă (valoarea este de obicei None)

Proprietăți cheie

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Valoarea celulei (str, int, float sau None)
`formula`	str	Șir de formulă (de ex., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Stilul celulei (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Setări de font pentru acest stil
`fill`	ImageRenderOptions	Setări de umplere de fundal

ImageRenderOptions

Culorile sunt exprimate ca 8-digit AARRGGBB hex strings fără un # prefix. Exemple: "FFFF0000" = roșu opac, "FF0000FF" = albastru opac, "FF000000" = negru.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Nume familie font
`size`	float	11	Mărime font în puncte
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Text îngroșat
`italic`	bool	ImageRenderOptions	Text italic
`underline`	bool	ImageRenderOptions	Text subliniat
`strikethrough`	bool	ImageRenderOptions	Text tăiat

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Fundal solid; `color` este un șir hexazecimal AARRGGBB de 8 cifre
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Umplere cu model
`set_no_fill()`	Elimină umplerea de fundal

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Exportă caietul de lucru într-un șir Markdown în memorie

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	stânga	Alinierea coloanei: stânga, dreapta sau centru
`include_worksheet_name`	bool	ImageRenderOptions	Dacă să includă numele foii ca titlu
`header_level`	int	2	Nivelul titlului Markdown (1-6)
`worksheet_index`	int	0	Indexul foii de exportat; -1 exportă toate foile

ChartCollection

Graficele sunt adăugate utilizând metode dedicate pentru fiecare tip. Indicii de rând și coloană sunt bazate pe zero.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Adaugă un grafic cu coloane (bare verticale)
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Adaugă un grafic de tip linie
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Adaugă un grafic tip plăcintă

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Titlul graficului ca un șir simplu (nu `.title.text`)
`category_data`	str	Interval de celule pentru etichetele de categorie ale axei x
`n_series`	NSeries	Colecție de serii de date
`show_legend`	bool	Dacă să se afișeze legenda
`legend_position`	str	Poziția legendei: dreapta, jos, stânga sau sus

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Adaugă o serie de date denumită

Enumerarea SaveFormat

ImageRenderOptions	Format de ieșire
`SaveFormat.XLSX`	Excel Open XML (implicit)
`SaveFormat.CSV`	Valori separate prin virgulă
`SaveFormat.TSV`	Valori separate prin tab
`SaveFormat.MARKDOWN`	Tabele Markdown
`SaveFormat.JSON`	Date structurate JSON

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, și SaveFormat.PPTX sunt nu sunt disponibile în Aspose.Cells FOSS. Aceste formate necesită pachetul comercial aspose-cells-python pachetul.

Exemple de cod

Creează, stilizează și salvează un caiet de lucru

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

Exportă în Markdown în memorie

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)

Construiește un grafic liniar

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

Resurse conexe

Ghid pentru dezvoltatori: Tutoriale pentru toate funcționalitățile de bază
Începeți / Instalare: pip install și configurare
Bază de cunoștințe: Ghiduri practice orientate pe sarcini
Prezentare generală a produsului: Sumar al caracteristicilor și capabilităților
Depozit GitHub
Blog: Prezentarea Aspose.Cells FOSS: Prezentare generală a bibliotecii și pornire rapidă