Aspose.Cells FOSS for Python

Pakkeinformasjon


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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	Kjerne‑regneark‑API: arbeidsbøker, regneark, celler, stiler, diagrammer, formatbehandlere

ImageRenderOptions: Det finnes ingen aspose.pydrawing modul i Aspose.Cells FOSS. Farger uttrykkes som 8-sifrede AARRGGBB heksadesimale strenger (f.eks., "FFFF0000" for ugjennomsiktig rød).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	arbeidsbok	Inngangspunkt for å opprette, laste inn og lagre regnearkfiler
`Worksheet`	regneark	Representerer et enkelt ark; gir tilgang til celler, diagrammer og bilder
`Cells`	celler	Ordbok-lignende samling av `Cell` objekter innenfor en `Worksheet`
`Cell`	celle	Representerer en individuell celle; verdi, formel og stil
`Style`	stil	Celleformatering: skrifttype, fyll, kanter, justering, tallformat, beskyttelse
`Font`	stil	Skrift‑egenskaper: navn, størrelse, farge, fet, kursiv, understrekning, gjennomstreking
`Fill`	stil	Bakgrunnsfyll: solid, gradient eller mønster
`NumberFormat`	stil	Innebygde verktøy for oppslag av tallformat
`SaveFormat`	arbeidsbok	Opplisting av støttede utdataformater (XLSX, CSV, MARKDOWN, JSON)
`Chart`	diagram	Representerer et diagram som er innebygd i et arbeidsark
`ChartType`	diagram	Enum: LINE, BAR, PIE, AREA, STOCK, og mer
`NSeries`	diagram	Samling av dataserier på et diagram
`ChartSeries`	diagram	En enkelt dataserie med verdier, kategorier og feilstolper
`ChartAxis`	diagram	Akselinnstillinger: skala, format, tittel
`ChartView3D`	diagram	3D rotation and perspective settings
`ChartErrorBars`	diagram	Feilstolpekonfigurasjon for en serie
`DataValidation`	data-validation	Enkelt valideringsregel på et celleområde
`DataValidationCollection`	data-validation	Alle valideringsregler for et regneark
`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	Statiske metoder for CSV-import/eksport
`CSVLoadOptions`	csv-handler	Alternativer for lasting av CSV-filer
`CSVSaveOptions`	csv-handler	Alternativer for lagring av CSV-filer
`MarkdownHandler`	markdown-handler	Statiske metoder for Markdown-eksport
`MarkdownSaveOptions`	markdown-handler	Alternativer for Markdown-eksport
`JsonHandler`	json-handler	Statiske metoder for JSON-eksport
`JsonSaveOptions`	json-handler	Alternativer for JSON-eksport
`Shape`	shape	Tegning av form med fyll, linje, tekst og skrifttypeformatering
`ShapeCollection`	shape	Alle former i et regneark (`ws.shapes`)
`MsoDrawingType`	shape	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, osv.
`Table`	table	Excel-tabell (strukturert referanse) i et regneark
`TableCollection`	table	Alle tabeller i et regneark (`ws.list_objects`)
`TableColumn`	table	Kolonnedefinisjon i en Table
`TableStyleInfo`	tabell	Visuelle stilinnstillinger for en tabell
`SparklineGroup`	sparkline	Gruppe av sparkline-diagrammer som deler en visuell stil
`SparklineGroupCollection`	sparkline	Alle sparkline-grupper (`ws.sparkline_groups`)
`Sparkline`	sparkline	En enkelt sparkline-celle knyttet til et dataområde
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	page-break	Manuelle horisontale sideskift (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	page-break	Manuelle vertikale sideskift (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	kryptering	AES-256/SHA-512 krypteringsparametere (anbefalt)
`StandardEncryptionParameters`	kryptering	Legacy AES-128/SHA-1 krypteringsparametere
`CipherAlgorithm`	kryptering	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	kryptering	Enum: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Opprett en ny tom arbeidsbok (XLSX-format)
`Workbook(file_path: str)`	Last inn en arbeidsbok fra en filsti
`Workbook(file_path: str, password: str)`	Last inn en passordbeskyttet arbeidsbok

Viktige egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	liste	Tilgang til regneark etter indeks: `workbook.worksheets[0]`

Viktige metoder

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Lagre til fil; formatet blir inferert fra filendelsen
`save(file_path, save_format)`	ImageRenderOptions	Lagre med eksplisitt SaveFormat
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Lagre som CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Lagre som Markdown‑tabeller
`save_as_json(file_path, options=None)`	ImageRenderOptions	Lagre som JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Last inn CSV‑data i arbeidsboken
`add_worksheet(name=None)`	ImageRenderOptions	Legg til et nytt regneark
`get_worksheet(index_or_name)`	ImageRenderOptions	Hent regneark etter indeks eller navn
`remove_worksheet(index_or_name)`	ImageRenderOptions	Fjern et regneark
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Kopier et eksisterende regneark
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Passordbeskytt arbeidsboken
`unprotect(password=None)`	ImageRenderOptions	Fjern arbeidsbokbeskyttelse
`is_protected()`	bool	Sjekk om arbeidsboken er beskyttet

ImageRenderOptions

Viktige egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Navn på ark-fane
`cells`	ImageRenderOptions	Alle celler i dette regnearket
`charts`	ChartCollection	Alle diagrammer i dette regnearket

ImageRenderOptions

Cells støtter ordbokstilgang via celleadresse‑streng.

Tilgangsmønstre

# 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)`	Opprett en celle med en verdi (int, float, str eller None)
`Cell(value, formula)`	Opprett en formelcelle (verdien er vanligvis None)

Viktige egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Celleverdi (str, int, float eller None)
`formula`	str	Formelstreng (f.eks., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Celleformat (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Font‑innstillinger for denne stilen
`fill`	ImageRenderOptions	Innstillinger for bakgrunnsfyll

ImageRenderOptions

Farger uttrykkes som 8-digit AARRGGBB hex strings uten en # prefiks. Eksempler: "FFFF0000" = ugjennomsiktig rød, "FF0000FF" = ugjennomsiktig blå, "FF000000" = svart.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Skriftfamilienavn
`size`	float	11	Skriftstørrelse i punkter
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Fet tekst
`italic`	bool	ImageRenderOptions	Kursiv tekst
`underline`	bool	ImageRenderOptions	Understreket tekst
`strikethrough`	bool	ImageRenderOptions	Gjennomstreket tekst

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Solid bakgrunn; `color` er en 8-sifret AARRGGBB heksadesimal streng
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Mønstret fyll
`set_no_fill()`	Fjern bakgrunnsfyll

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Eksporter arbeidsbok til en Markdown-streng i minnet

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	venstre	Kolonnejustering: venstre, høyre eller midt
`include_worksheet_name`	bool	ImageRenderOptions	Om arkets navn skal inkluderes som en overskrift
`header_level`	int	2	Markdown-overskriftsnivå (1-6)
`worksheet_index`	int	0	Arkindeks som skal eksporteres; -1 eksporterer alle ark

ChartCollection

Diagrammer legges til ved hjelp av dedikerte metoder per type. Rad- og kolonneindekser er nullbasert.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Legg til et kolonnediagram (vertikal stolpe)
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Legg til et linjediagram
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Legg til et kakediagram

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Diagramtittel som en ren streng (ikke `.title.text`)
`category_data`	str	Celleområde for x-akse kategori-etiketter
`n_series`	NSeries	Samling av dataserier
`show_legend`	bool	Om legenden skal vises
`legend_position`	str	Legendeplassering: høyre, bunn, venstre eller topp

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Legg til en navngitt dataserie

SaveFormat-oppramsing

ImageRenderOptions	Utdataformat
`SaveFormat.XLSX`	Excel Open XML (standard)
`SaveFormat.CSV`	Kommaseparerte verdier
`SaveFormat.TSV`	Tab-separerte verdier
`SaveFormat.MARKDOWN`	Markdown-tabeller
`SaveFormat.JSON`	JSON-strukturerte data

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, og SaveFormat.PPTX er ikke tilgjengelig i Aspose.Cells FOSS. Disse formatene krever den kommersielle aspose-cells-python pakken.

Kodeeksempler

Opprett, stiliser og lagre en arbeidsbok

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

Eksporter til Markdown i minnet

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)

Bygg et linjediagram

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

Relaterte ressurser

Utviklerguide: Veiledninger for alle kjernefunksjoner
Kom i gang / Installering: pip install og oppsett
Kunnskapsbase:Oppgaveorienterte hvordan‑gjør‑guider
Produktoversikt: Sammendrag av funksjoner og muligheter
GitHub-repositorium
Blogg: Introduksjon av Aspose.Cells FOSS: Bibliotekoversikt og rask start