Aspose.Cells FOSS pro Python

Informace o balení:

Balíček PyPIaspose-cells-foss
Python importfrom aspose.cells_foss import ...
Verze:26.3.1
LicenceMIT
Požadavek Python>= 3,7
Závislost na jiných produktechpycryptodome>=3.15.0, olefile>=0.46

Moduly

ModulPopis:
aspose.cells_fossZákladní API pro tabulky: pracovní knihy, listy, buňky, styly, grafy, manipulatory formátu

Poznámka::Není tu žádná: aspose.pydrawing Modul v Aspose.Cells FOSS. Barvy jsou vyjádřeny jako osmiciferné hexáziové řetězce AARRGGBB (např.., "FFFF0000" pro neprůhlednou červenou).


aspose.cells_foss

Třídy

TřídaStránkaPopis:
Workbookpracovní knihaVstupní bod pro vytváření, načítání a ukládání souborů tabulkových listů
Worksheetpracovní listZobrazuje jediný list; poskytuje přístup k buňkám, tabulkám a obrázkům
CellsbuňkySbírka slovníků Cell objekty v rámci Worksheet
CellceluleZobrazuje jednotlivé buňky; hodnota, vzorec a styl
StylestylFormátování buňky: písmo, vyplnění, hranice, vyrovnání, formát čísel, ochrana
FontstylVlastnosti písma: název, velikost, barva, tučná, kurzivní, podtržená, přesná.
FillstylZpůsob vyplnění: pevná, gradientní nebo vzorová.
NumberFormatstylVestavěné vyhledávací nástroje ve formátu čísel
SaveFormatpracovní knihaSeznam podporovaných výstupních formátů (XLSX, CSV, MARKDOWN, JSON)
CharttabulkaZobrazuje graf vložený do pracovního listu.
ChartTypetabulkaEnum: LINE, BAR, PIE, AREA, STOCK a další
NSeriestabulkaSbírka datových řad na grafu
ChartSeriestabulkaJednotná databáze s hodnotami, kategoriemi a odkazy chyb.
ChartAxistabulkaNastavení osy: rozsah, formát, název
ChartView3Dtabulka3D rotation and perspective settings
ChartErrorBarstabulkaKonfigurace řádku v pruhovém pásmu chyb
DataValidationověřování údajůJednotné pravidlo ověřování v rozsahu buněk
DataValidationCollectionověřování údajůVšechna pravidla pro ověřování pracovního listu
DataValidationTypeověřování údajůEnum: WHOLE_NUMBER, DECIMAL, LIST, Date, TIME, TEXT_LENGTH, CUSTOM (Dejny a časové údaje)
DataValidationOperatorověřování údajůEnum: BETWEEN, EQUAL, GREATER_THAN atd. (Význam a souhrn).
DataValidationAlertStyleověřování údajůPřestaň, varování.
CSVHandlerCSV-handlerStatické metody pro vývoz a zpracování dat CSV
CSVLoadOptionsCSV-handlerMožnosti načítání souborů CSV
CSVSaveOptionsCSV-handlerMožnosti ukládání souborů CSV
MarkdownHandlerpřepínač pro odbaveníStatické metody pro vývoz Markdownu
MarkdownSaveOptionspřepínač pro odbaveníMožnosti pro vývoz Markdownu
JsonHandlerJson-handlerováStatické metody pro export JSONu
JsonSaveOptionsJson-handlerováMožnosti pro export JSONu
ShapetvarKreslení tvaru s vyplněním, řádkem, textem a formátováním písma
ShapeCollectiontvarVšechny tvary v pracovním listu (ws.shapes)
MsoDrawingTypetvarEnum: OVAL, TEXT_BOX, ARROW atd.
TabletabulkaTabulka Excel (strukturovaný odkaz) v pracovním listu
TableCollectiontabulkaVšechny tabulky v pracovním listu (ws.tables)
TableColumntabulkaDefinování sloupce v tabulce
TableStyleInfotabulkaNastavení vizuálního stylu pro tabulku
SparklineGroupŠpárková řetězecSkupina žárovkových grafů sdílejících vizuální styl
SparklineGroupCollectionŠpárková řetězecVšechny skupiny třpytivých linií (ws.sparkline_groups)
SparklineŠpárková řetězecJediná buňka s palicí spojenou se datovým rozsahem.
SparklineTypeŠpárková řetězecZde je seznam všech aktivních položek, které jsou v souvislosti s tímto bodem vybrány.
HorizontalPageBreakCollectionrozbití stránekRuční horizontální přestávky (ws.horizontal_page_breaks)
VerticalPageBreakCollectionrozbití stránekRuční vertikální přestávky (ws.vertical_page_breaks)
AgileEncryptionParametersšifrováníParametry šifrování AES-256/SHA-512 (doporučené)
StandardEncryptionParametersšifrováníZákladní parametry šifrování AES-128/SHA-1
CipherAlgorithmšifrováníČíslo: AES_128, AEs_192, Aes_256
HashAlgorithmšifrováníSHA1, Sha256, Shaa384, Shaan512

Pracovní kniha

Výrobci

Podpis:Popis:
Workbook()Vytvořit novou prázdnou pracovní knihu (formát XLSX)
Workbook(file_path: str)Naložit pracovní kniha ze stezky souboru .
Workbook(file_path: str, password: str)Naložit pracovní knihu chráněnou heslem

Klíčové vlastnosti

VlastnictvíTyp:Popis:
worksheetsseznamPřístupové pracovní listy podle indexu: workbook.worksheets[0]

Klíčové metody

MetodikaVrátit se.Popis:
save(file_path)Žádný.Uložení do souboru; formát odvodený z rozšíření
save(file_path, save_format)Žádný.Uložení s explicitním SaveFormat
save_as_csv(file_path, options=None)Žádný.Uložení jako CSV
save_as_markdown(file_path, options=None)Žádný.Uložení jako tabulky s odkazem na hodnotu
save_as_json(file_path, options=None)Žádný.Uložení jako JSON
load_csv(file_path, options=None)Žádný.Zplnění pracovní knihy z souboru CSV
add_worksheet(name=None)Pracovní listPřidání nového pracovního listu
get_worksheet(index_or_name)Pracovní listZískejte pracovní list podle indexu nebo názvu .
remove_worksheet(index_or_name)Žádný.Odstranit pracovní list
copy_worksheet(index_or_name_or_ws)Pracovní listKopírovat existující pracovní list
protect(password=None, lock_structure=True)Žádný.Ochrana pracovního seznamu heslem
unprotect(password=None)Žádný.Odstranění ochrany pracovní knihy
is_protected()číňkaZkontrolujte , zda je pracovní kniha chráněna .

Pracovní list

Klíčové vlastnosti

VlastnictvíTyp:Popis:
nameStr. přímýNázev karty pracovního listu
cellsBuňkyVšechny buňky v tomto hárku .
chartsChartCollectionVšechny grafy v tomto pracovním listu

Buňky

Cells podporuje přístup ve stylu slovníku pomocí řetězce adresy buňky.

Základní přístupové vzorce

# 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

Celulární

Konstruktor

Podpis:Popis:
Cell(value=None)Vytvořit buňku s hodnotou (int, float, str nebo None)
Cell(value, formula)Vytvořit buňku vzorce (hodnota je obvykle Žádná)

Klíčové vlastnosti

VlastnictvíTyp:Popis:
valueJakékolivHodnota buňky (str, int, float nebo None)
formulaStr. přímýřetězce vzorců (např.., "=SUM(A1:A5)")
styleStylStyl buňky (písmo, vyplnění)

Styl

VlastnictvíTyp:Popis:
fontPísmo:Nastavení písma pro tento styl
fillVyplňováníNastavení zadání pozadí

Písmo:

Barvy jsou vyjádřeny jako: 8-digit AARRGGBB hex strings bez příspěvku: # Předepísek. Příklady: "FFFF0000" = neprůhledná červená, "FF0000FF" = neprůhledná modrá, "FF000000" Černá.

VlastnictvíTyp:PředvoleněPopis:
nameStr. přímýKvalita:Rodinný název písma
sizeplavba11Velikost písma v bodech
colorStr. přímýFF0000008-digit AARRGGBB hex color string
boldčíňkaNepravdivé.Tvrdá textová položka
italicčíňkaNepravdivé.Kurzově:
underlinečíňkaNepravdivé.Podtržený text
strikethroughčíňkaNepravdivé.Procházení textem

Konstruktor

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

Vyplňování

MetodikaPopis:
set_solid_fill(color)Pevná pozadí.; color je osmiciferný hexáziový řetěz AARRGGBB
set_pattern_fill(pattern_type, fg_color, bg_color)Vzorové plnění
set_no_fill()Odstranění zadání na pozadí

MarkdownHandler

MetodikaVrátit se.Popis:
MarkdownHandler.save_markdown_to_string(workbook)Str. přímýExportovat pracovní knihu do řetězce Markdown v paměti

MarkdownSaveOptions

VlastnictvíTyp:PředvoleněPopis:
default_alignmentStr. přímýlevá stranaNastavení sloupce: levá, pravá nebo středová.
include_worksheet_namečíňkaPravda.Zda se název listu zahrne jako nadpis
header_levelint (včetně)2Míra odhadu (1-6)
worksheet_indexint (včetně)0Index listů pro vývoz; -1 všechny listy na export

ChartCollection

Grafy jsou přidávány pomocí speciálních metod na typ. Indexy řádků a sloupců jsou: nulový základ.

MetodikaVrátit se.Popis:
add_bar(top_row, left_col, bottom_row, right_col)GrafíkPřidání sloupce (svislé pruhy) grafu
add_line(top_row, left_col, bottom_row, right_col)GrafíkPřidání řádkového grafu
add_pie(top_row, left_col, bottom_row, right_col)GrafíkPřidejte koláčový graf.

Grafík

VlastnictvíTyp:Popis:
titleStr. přímýNázev grafu jako jednoduchý řetěz (ne) .title.text)
category_dataStr. přímýRozsah buněk pro štítky kategorie osy x
n_seriesČástky a části:Sběr datových sérií
show_legendčíňkaZda zobrazit legendu
legend_positionStr. přímýPoloha legendy: vpravo, dole, vlevo nebo nahoře.

Částky a části:

MetodikaPopis:
add(data_range, category_data=None, name=None)Přidání jmenované datové řady

SaveFormat Způsobilé číslo.

KonstantaVýstupní formát
SaveFormat.XLSXFormát Excel XML (predvolený)
SaveFormat.CSVHodnoty oddělené čárkou
SaveFormat.TSVKonstanta pouze pro čtení. workbook.save() nepodporuje zvýšení TSV ValueError v době spuštění.
SaveFormat.MARKDOWNTabulky s odkazem na hodnotu
SaveFormat.JSONStrukturalizované údaje JSON

Poznámka:: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX,a) SaveFormat.PPTX jsou: není k dispozici V Aspose.Cells FOSS. Tyto formáty vyžadují komerční platbu, která je k dispozici pro všechny typy vozidel a zařízení. aspose-cells-python balíček.


Příklady kódu

Vytvořit, stylovat a uložit pracovní knihu

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 do paměti Markdown

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)

Vytvořte si linkový graf.

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

Související zdroje

 Čeština