Aspose.Cells FOSS for Python

Paketinformation


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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
aspose.cells_foss	Kärn-API för kalkylblad: arbetsböcker, arbetsblad, celler, stilar, diagram, format‑hanterare

ImageRenderOptions: Det finns ingen aspose.pydrawing modul i Aspose.Cells FOSS. Färger uttrycks som 8-siffriga AARRGGBB‑hex‑strängar (t.ex., "FFFF0000" för ogenomskinlig röd).

aspose.cells_foss

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Workbook`	arbetsbok	Ingångspunkt för att skapa, läsa in och spara kalkylbladsfiler
`Worksheet`	arbetsblad	Representerar ett enskilt blad; ger åtkomst till celler, diagram och bilder
`Cells`	celler	Ordboksliknande samling av `Cell` objekt inom en `Worksheet`
`Cell`	cell	Representerar en individuell cell; värde, formel och stil
`Style`	stil	Cellformatering: teckensnitt, fyllning, kanter, justering, talformat, skydd
`Font`	stil	Teckensnittsegenskaper: namn, storlek, färg, fet, kursiv, understruken, genomstruken
`Fill`	stil	Bakgrundsfyllning: solid, gradient eller mönster
`NumberFormat`	stil	Inbyggda verktyg för uppslagning av talformat
`SaveFormat`	arbetsbok	Uppräkning av stödda utdataformat (XLSX, CSV, MARKDOWN, JSON)
`Chart`	diagram	Representerar ett diagram inbäddat i ett kalkylblad
`ChartType`	diagram	Enum: LINE, BAR, PIE, AREA, STOCK och fler
`NSeries`	diagram	Dataseriekollektion på ett diagram
`ChartSeries`	diagram	En enskild dataserie med värden, kategorier och felstaplar
`ChartAxis`	diagram	Axelinställningar: skala, format, titel
`ChartView3D`	diagram	3D rotation and perspective settings
`ChartErrorBars`	diagram	Konfiguration av felstaplar för en serie
`DataValidation`	data-validation	Enstaka valideringsregel för ett cellområde
`DataValidationCollection`	data-validation	Alla valideringsregler för ett kalkylblad
`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	Statiska metoder för CSV-import/export
`CSVLoadOptions`	csv-handler	Alternativ för att läsa in CSV-filer
`CSVSaveOptions`	csv-handler	Alternativ för att spara CSV-filer
`MarkdownHandler`	markdown-handler	Statiska metoder för Markdown-export
`MarkdownSaveOptions`	markdown-handler	Alternativ för Markdown-export
`JsonHandler`	json-handler	Statisk metoder för JSON-export
`JsonSaveOptions`	json-handler	Alternativ för JSON-export
`Shape`	form	Rita form med fyllning, linje, text och teckensnittsformatering
`ShapeCollection`	form	Alla former i ett kalkylblad (`ws.shapes`)
`MsoDrawingType`	form	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc.
`Table`	tabell	Excel-tabell (strukturerad referens) i ett kalkylblad
`TableCollection`	tabell	Alla tabeller i ett kalkylblad (`ws.list_objects`)
`TableColumn`	tabell	Kolumndefinition inom en tabell
`TableStyleInfo`	tabell	Inställningar för visuell stil för en tabell
`SparklineGroup`	sparkline	Grupp av sparkline-diagram som delar en visuell stil
`SparklineGroupCollection`	sparkline	Alla sparkline-grupper (`ws.sparkline_groups`)
`Sparkline`	sparkline	En enskild sparkline-cell länkad till ett dataområde
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	sidbrytning	Manuella horisontella sidbrytningar (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	sidbrytning	Manuella vertikala sidbrytningar (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	kryptering	AES-256/SHA-512 krypteringsparametrar (rekommenderas)
`StandardEncryptionParameters`	kryptering	Äldre AES-128/SHA-1 krypteringsparametrar
`CipherAlgorithm`	kryptering	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	kryptering	Enum: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`Workbook()`	Skapa en ny tom arbetsbok (XLSX-format)
`Workbook(file_path: str)`	Läs in en arbetsbok från en filväg
`Workbook(file_path: str, password: str)`	Läs in en lösenordsskyddad arbetsbok

Viktiga egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`worksheets`	lista	Åtkomst till arbetsblad efter index: `workbook.worksheets[0]`

Viktiga metoder

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`save(file_path)`	ImageRenderOptions	Spara till fil; formatet härleds från filändelsen
`save(file_path, save_format)`	ImageRenderOptions	Spara med explicit SaveFormat
`save_as_csv(file_path, options=None)`	ImageRenderOptions	Spara som CSV
`save_as_markdown(file_path, options=None)`	ImageRenderOptions	Spara som Markdown-tabeller
`save_as_json(file_path, options=None)`	ImageRenderOptions	Spara som JSON
`load_csv(file_path, options=None)`	ImageRenderOptions	Läs in CSV-data i arbetsboken
`add_worksheet(name=None)`	ImageRenderOptions	Lägg till ett nytt arbetsblad
`get_worksheet(index_or_name)`	ImageRenderOptions	Hämta arbetsblad efter index eller namn
`remove_worksheet(index_or_name)`	ImageRenderOptions	Ta bort ett arbetsblad
`copy_worksheet(index_or_name_or_ws)`	ImageRenderOptions	Kopiera ett befintligt arbetsblad
`protect(password=None, lock_structure=True)`	ImageRenderOptions	Lösenordsskydda arbetsboken
`unprotect(password=None)`	ImageRenderOptions	Ta bort arbetsbokens skydd
`is_protected()`	bool	Kontrollera om arbetsboken är skyddad

ImageRenderOptions

Viktiga egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	Arbetsbladets fliknamn
`cells`	ImageRenderOptions	Alla celler i detta arbetsblad
`charts`	ChartCollection	Alla diagram i detta arbetsblad

ImageRenderOptions

Cells stöder åtkomst i ordboksstil med celladresssträng.

Åtkomstmönster

# 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)`	Skapa en cell med ett värde (int, float, str eller None)
`Cell(value, formula)`	Skapa en formelcell (värdet är vanligtvis None)

Viktiga egenskaper

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`value`	ImageRenderOptions	Cellvärde (str, int, float eller None)
`formula`	str	Formelsträng (t.ex., `"=SUM(A1:A5)"`)
`style`	ImageRenderOptions	Cellstil (font, fill)

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`font`	ImageRenderOptions	Fontinställningar för denna stil
`fill`	ImageRenderOptions	Bakgrundsfyllningsinställningar

ImageRenderOptions

Färger uttrycks som 8-digit AARRGGBB hex strings utan en # prefix. Exempel: "FFFF0000" = ogenomskinlig röd, "FF0000FF" = ogenomskinlig blå, "FF000000" = svart.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	str	ImageRenderOptions	Typsnittsfamiljens namn
`size`	float	11	Teckenstorlek i punkter
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	ImageRenderOptions	Fet text
`italic`	bool	ImageRenderOptions	Kursiv text
`underline`	bool	ImageRenderOptions	Understruken text
`strikethrough`	bool	ImageRenderOptions	Genomstruken text

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions
`set_solid_fill(color)`	Solid bakgrund; `color` är en 8-siffrig AARRGGBB hex-sträng
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Mönstrad fyllning
`set_no_fill()`	Ta bort bakgrundsfyllning

MarkdownHandler

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Exportera arbetsbok till en Markdown-sträng i minnet

MarkdownSaveOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`default_alignment`	str	vänster	Kolumnjustering: vänster, höger eller centrerad
`include_worksheet_name`	bool	ImageRenderOptions	Om bladnamnet ska inkluderas som en rubrik
`header_level`	int	2	Markdown-rubriksnivå (1-6)
`worksheet_index`	int	0	Bladindex att exportera; -1 exporterar alla blad

ChartCollection

Diagram läggs till med dedikerade metoder per typ. Rad- och kolumnindex är nollbaserade.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`add_bar(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Lägg till ett stapeldiagram (vertikal stapel)
`add_line(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Lägg till ett linjediagram
`add_pie(top_row, left_col, bottom_row, right_col)`	ImageRenderOptions	Lägg till ett cirkeldiagram

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`title`	str	Diagramtitel som en vanlig sträng (inte `.title.text`)
`category_data`	str	Cellintervall för x-axelns kategorietiketter
`n_series`	NSeries	Dataseriesamling
`show_legend`	bool	Om legenden ska visas
`legend_position`	str	Legendeplacering: höger, nedre, vänster eller topp

NSeries

ImageRenderOptions	ImageRenderOptions
`add(data_range, category_data=None, name=None)`	Lägg till en namngiven dataserie

SaveFormat-uppräkning

ImageRenderOptions	Utdatformat
`SaveFormat.XLSX`	Excel Open XML (standard)
`SaveFormat.CSV`	Kommaseparerade värden
`SaveFormat.TSV`	Tabbseparerade värden
`SaveFormat.MARKDOWN`	Markdown-tabeller
`SaveFormat.JSON`	JSON-strukturerad data

ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, och SaveFormat.PPTX är inte tillgängliga i Aspose.Cells FOSS. Dessa format kräver den kommersiella aspose-cells-python paketet.

Kodexempel

Skapa, formatera och spara en arbetsbok

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

Exportera till 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)

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

Relaterade resurser

Utvecklarguide: Handledning för alla kärnfunktioner
Kom igång / Installation: pip-installation och konfiguration
Kunskapsbas: Uppgiftsorienterade instruktionsguider
Produktöversikt: Sammanfattning av funktioner och möjligheter
GitHub‑arkiv
Blogg: Introducerar Aspose.Cells FOSS: Biblioteksöversikt och snabbstart