Aspose.Cells FOSS - FOSS for Python

Pakkeoplysninger


PyPI-pakke	`aspose-cells-foss`
Python-import	`from aspose.cells_foss import ...`
Udgave:	26.3.1
Licens	MIT
Python-krav	>= 3,7
Afhængighed	`pycryptodome>=3.15.0`, `olefile>=0.46`

Moduler

Modul	Beskrivelse:
aspose.cells_foss	Kerne-API til regneark: arbejdsbøger, regnearks, celler, stilarter, diagrammer og formatbehandlere

Bemærkning::Der er ingen aspose.pydrawing Modul i Aspose.Cells FOSS. Farverne udtrykkes som 8-cifrede AARRGGBB-hexstrenge (f.eks.., "FFFF0000" for uigennemsigtigt rødt).

aspose.cells_foss

Klasse:

Klasse	Siderne	Beskrivelse:
`Workbook`	Arbejdsmappe	Indgangspunkt for at oprette, indlæse og gemme regnearkfiler
`Worksheet`	Arbejdsskemaet	Repræsenter et enkelt ark; giver adgang til celler, diagrammer og billeder
`Cells`	Celler	Ordboglignende samling af `Cell` objekter inden for en `Worksheet`
`Cell`	Celle	Repræsenter en enkelt celle; værdi, formel og stil
`Style`	stil	Celleformater: skrifttype, fyldning, grænser, justering, nummerformat, beskyttelse
`Font`	stil	Skriftegenskaber: navn, størrelse, farve, fedtet, kursivt, understreget, gennemtrængende
`Fill`	stil	Baggrundsfyldning: fast, gradient eller mønster
`NumberFormat`	stil	Indbyggede numreformatsøgningsanordninger
`SaveFormat`	Arbejdsmappe	Oplysninger om de understøttede udgangsformater (XLSX, CSV, MARKDOWN, JSON)
`Chart`	diagrammet	Repræsenter et diagram indlejret i en regneark
`ChartType`	diagrammet	Enum: LINE, BAR, PIE, AREA, STOCK og mere
`NSeries`	diagrammet	Dataforsamling i et diagram
`ChartSeries`	diagrammet	En enkelt dataserie med værdier, kategorier og fejlstænger
`ChartAxis`	diagrammet	Akseindstillinger: skala, format og titel
`ChartView3D`	diagrammet	3D rotation and perspective settings
`ChartErrorBars`	diagrammet	Fejllinjekonfiguration for en serie
`DataValidation`	datavalidering	Enkel valideringsregel for et celleområde
`DataValidationCollection`	datavalidering	Alle valideringsregler for et regneark
`DataValidationType`	datavalidering	Enum: ENDELIGT_TAL, DECIMAL , LIST, dato, TID, tekst_LENGTH, brugerdefineret
`DataValidationOperator`	datavalidering	Enum: BETWEEN, EQUAL, GREATER_THAN osv. Det er en af de vigtigste elementer i denne liste.
`DataValidationAlertStyle`	datavalidering	Stop, advarsel.
`CSVHandler`	CSV-håndteringsenhed	Statiske metoder til eksport af CSV og behandling af data i CS V
`CSVLoadOptions`	CSV-håndteringsenhed	Muligheder for at indlæse CSV-filer
`CSVSaveOptions`	CSV-håndteringsenhed	Muligheder for at gemme CSV-filer
`MarkdownHandler`	markdown-håndterer	Statiske metoder til markdown-eksport
`MarkdownSaveOptions`	markdown-håndterer	Optioner for eksport til markdown
`JsonHandler`	Json-handler	Statiske metoder til JSON-eksport
`JsonSaveOptions`	Json-handler	Muligheder for JSON-eksport
`Shape`	form	Tegning af form med fyld, linje, tekst og skrifttypeformater
`ShapeCollection`	form	Alle former i et regneark (`ws.shapes`)
`MsoDrawingType`	form	Enum: RECTANGLE, OVAL, TEXT_BOX, PIL og lignende.
`Table`	tabellen	Excel-tabell (struktureret reference) i et regneark
`TableCollection`	tabellen	Alle tabeller i et regneark (`ws.tables`)
`TableColumn`	tabellen	Kolonnedefinition i en tabel
`TableStyleInfo`	tabellen	Indstillinger for visuel stil til en tabel
`SparklineGroup`	Sparkline	Gruppe af sparkline diagrammer, der deler en visuel stil
`SparklineGroupCollection`	Sparkline	Alle sparklinegrupper (`ws.sparkline_groups`)
`Sparkline`	Sparkline	En enkelt sparklinecelle forbundet med et datamængde
`SparklineType`	Sparkline	Enum: LINE, COLUMN, WIN_LOSS (Finds- og tab)
`HorizontalPageBreakCollection`	side-bræk	Manuelle horisontale sidebryder (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	side-bræk	Manuelle lodrette sidebrud (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	kryptering	AES-256/SHA-512-krypteringsparametre (anbefalet)
`StandardEncryptionParameters`	kryptering	Forældre AES-128/SHA-1-krypteringsparametre
`CipherAlgorithm`	kryptering	Enum: AES_128, AEs_192, Aes_256
`HashAlgorithm`	kryptering	Enum: SHA1, Sha256, Shaa384, Shaan512

Arbejdsmappe

Konstruktorer

Underskrift	Beskrivelse:
`Workbook()`	Oprette en ny tom arbejdsbog (XLSX-format)
`Workbook(file_path: str)`	Lade en arbejdsbog fra filstien
`Workbook(file_path: str, password: str)`	Lade en adgangskodebeskyttet arbejdsdokument ind

Nøgleegenskaber

Ejendomme	Type:	Beskrivelse:
`worksheets`	liste over	Arbejdsskemaer for adgang efter indeks: `workbook.worksheets[0]`

Nøglemetoder

Metode	Tilbagevenden	Beskrivelse:
`save(file_path)`	Ingen af dem.	Lagre til fil; format udledt af udvidelsen
`save(file_path, save_format)`	Ingen af dem.	Spare med eksplicit SaveFormat
`save_as_csv(file_path, options=None)`	Ingen af dem.	Gemme som CSV
`save_as_markdown(file_path, options=None)`	Ingen af dem.	Gemme som markdown-tabeller
`save_as_json(file_path, options=None)`	Ingen af dem.	Gem som JSON
`load_csv(file_path, options=None)`	Ingen af dem.	Fuldføre arbejdsbogen fra en CSV-fil
`add_worksheet(name=None)`	Arbejdsskemaet	Tilføj et nyt regneark
`get_worksheet(index_or_name)`	Arbejdsskemaet	Få regneark efter indeks eller navn
`remove_worksheet(index_or_name)`	Ingen af dem.	Fjern et regneark
`copy_worksheet(index_or_name_or_ws)`	Arbejdsskemaet	Kopier et eksisterende regneark
`protect(password=None, lock_structure=True)`	Ingen af dem.	Beskyt arbejdsmålen med adgangskode
`unprotect(password=None)`	Ingen af dem.	Fjern arbejdslistebeskyttelse
`is_protected()`	Boolean	Kontrollér, om arbejdsmålen er beskyttet.

Arbejdsskemaet

Nøgleegenskaber

Ejendomme	Type:	Beskrivelse:
`name`	str.	Arbejdsskema-flade navn
`cells`	Celler	Alle celler i dette regneark
`charts`	ChartCollection	Alle diagrammer i dette regneark

Celler

Cells understøtter adgang i ordbogstil ved hjælp af en celleadresse.

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

Celle

Konstruktor

Underskrift	Beskrivelse:
`Cell(value=None)`	Oprette en celle med et værdi (int, float, str eller None)
`Cell(value, formula)`	Oprette en formel celle (værdien er typisk Ingen)

Nøgleegenskaber

Ejendomme	Type:	Beskrivelse:
`value`	Alle	Celleværdi (str, int, float eller ingen)
`formula`	str.	Formelstreng (f.eks.., `"=SUM(A1:A5)"`)
`style`	Stil	Cellstil (skrift, fyld)

Stil

Ejendomme	Type:	Beskrivelse:
`font`	Skriftart	Fontsætninger til denne stil
`fill`	Udfyldning	Indstillinger for baggrundssætning

Skriftart

Farver udtrykkes som: 8-digit AARRGGBB hex strings uden en # - Det er en forordning. Eksempler: "FFFF0000" = uigennemsigtigt rødt, "FF0000FF" = uigennemsigtigt blå, "FF000000" - Sort.

Ejendomme	Type:	Standardindstilling	Beskrivelse:
`name`	str.	Kalibrer	Fontsamlingens navn
`size`	flydende	11	Skriftstørrelse i punkter
`color`	str.	FF000000	8-digit AARRGGBB hex color string
`bold`	Boolean	Falske	Fuldvægtet tekst
`italic`	Boolean	Falske	Kursiv tekst
`underline`	Boolean	Falske	Understreget tekst
`strikethrough`	Boolean	Falske	Strik gennem tekst

Konstruktor

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

Udfyldning

Metode	Beskrivelse:
`set_solid_fill(color)`	- Solid baggrund.; `color` er en 8-cifret hexstring AARRGGBB
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Mønsterfyldning
`set_no_fill()`	Fjern baggrundsfyldning

MarkdownHandler

Metode	Tilbagevenden	Beskrivelse:
`MarkdownHandler.save_markdown_to_string(workbook)`	str.	Eksport arbejdsbog til en Markdown-streng i hukommelsen

MarkdownSaveOptions

Ejendomme	Type:	Standardindstilling	Beskrivelse:
`default_alignment`	str.	Venstre side	Kolonnelynering: venstre, højre eller midt.
`include_worksheet_name`	Boolean	Sandt.	Om bladets navn skal medtages som overskrift
`header_level`	ind- og udlandsk	2	Markeringskursniveau (1-6)
`worksheet_index`	ind- og udlandsk	0	Eksportindeks; -1 eksport alle ark

ChartCollection

Indekserne for rader og kolonner er: Nullbaseret.

Metode	Tilbagevenden	Beskrivelse:
`add_bar(top_row, left_col, bottom_row, right_col)`	Tabel	Tilføj et kolonne-diagram (vertikal bar)
`add_line(top_row, left_col, bottom_row, right_col)`	Tabel	Tilføj en linjekart
`add_pie(top_row, left_col, bottom_row, right_col)`	Tabel	Tilføj et pie diagram

Tabel

Ejendomme	Type:	Beskrivelse:
`title`	str.	Diagramtitel som en simpel streng (ikke `.title.text`)
`category_data`	str.	Celleområde for x-akse kategorimærker
`n_series`	NSerien	Dataindsamling af dataerie
`show_legend`	Boolean	Om der skal vises legenden
`legend_position`	str.	Legenden position: højre, nederste, venstre eller øverste side

NSerien

Metode	Beskrivelse:
`add(data_range, category_data=None, name=None)`	Tilføj en navngivet dataserie

SaveFormat Opsummering

Konstante	Udgangsformat
`SaveFormat.XLSX`	Excel XML-format (udvalgt)
`SaveFormat.CSV`	Komma-opdelte værdier
`SaveFormat.TSV`	Kun læsningskonstante. `workbook.save()` understøtter ikke TSV hævninger `ValueError` ved køretid.
`SaveFormat.MARKDOWN`	Markeringstabeller
`SaveFormat.JSON`	JSON-strukturerede data

Bemærkning:: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, og SaveFormat.PPTX er: ikke tilgængelig Disse formater kræver, at den kommercielle udgave af en vare er tilgængelig i alle de forskellige typer. aspose-cells-python Pakke.

Kodeksempler

Oprette, stil og gem en arbejdsbog

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

Eksport til Markdown i hukommelse

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)

Opbyg et linjekart

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

Relaterede ressourcer

Udviklervejledning:Tutorials for alle centrale funktioner
Start / Installation: pip installation og opstilling
Vidensgrundlag:Opgaverne er baseret på:
Oversigt over produktet: Sammendrag af funktioner og muligheder
GitHub Repositoriet
Blog: Indførelse af Aspose.Cells FOSS: Oversigt over biblioteket og hurtig start