Aspose.Cells FOSS pro Python
Informace o balení:
| Balíček PyPI | aspose-cells-foss |
| Python import | from aspose.cells_foss import ... |
| Verze: | 26.3.1 |
| Licence | MIT |
| Požadavek Python | >= 3,7 |
| Závislost na jiných produktech | pycryptodome>=3.15.0, olefile>=0.46 |
Moduly
| Modul | Popis: |
|---|---|
| aspose.cells_foss | Základní API pro tabulky: pracovní knihy, listy, buňky, styly, grafy, manipulatory formátu |
Poznámka::Není tu žádná:
aspose.pydrawingModul 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řída | Stránka | Popis: |
|---|---|---|
Workbook | pracovní kniha | Vstupní bod pro vytváření, načítání a ukládání souborů tabulkových listů |
Worksheet | pracovní list | Zobrazuje jediný list; poskytuje přístup k buňkám, tabulkám a obrázkům |
Cells | buňky | Sbírka slovníků Cell objekty v rámci Worksheet |
Cell | celule | Zobrazuje jednotlivé buňky; hodnota, vzorec a styl |
Style | styl | Formátování buňky: písmo, vyplnění, hranice, vyrovnání, formát čísel, ochrana |
Font | styl | Vlastnosti písma: název, velikost, barva, tučná, kurzivní, podtržená, přesná. |
Fill | styl | Způsob vyplnění: pevná, gradientní nebo vzorová. |
NumberFormat | styl | Vestavěné vyhledávací nástroje ve formátu čísel |
SaveFormat | pracovní kniha | Seznam podporovaných výstupních formátů (XLSX, CSV, MARKDOWN, JSON) |
Chart | tabulka | Zobrazuje graf vložený do pracovního listu. |
ChartType | tabulka | Enum: LINE, BAR, PIE, AREA, STOCK a další |
NSeries | tabulka | Sbírka datových řad na grafu |
ChartSeries | tabulka | Jednotná databáze s hodnotami, kategoriemi a odkazy chyb. |
ChartAxis | tabulka | Nastavení osy: rozsah, formát, název |
ChartView3D | tabulka | 3D rotation and perspective settings |
ChartErrorBars | tabulka | Konfigurace řádku v pruhovém pásmu chyb |
DataValidation | ověřování údajů | Jednotné pravidlo ověřování v rozsahu buněk |
DataValidationCollection | ověřování údajů | Všechna pravidla pro ověřování pracovního listu |
DataValidationType | ověřování údajů | Enum: WHOLE_NUMBER, DECIMAL, LIST, Date, TIME, TEXT_LENGTH, CUSTOM (Dejny a časové údaje) |
DataValidationOperator | ověřování údajů | Enum: BETWEEN, EQUAL, GREATER_THAN atd. (Význam a souhrn). |
DataValidationAlertStyle | ověřování údajů | Přestaň, varování. |
CSVHandler | CSV-handler | Statické metody pro vývoz a zpracování dat CSV |
CSVLoadOptions | CSV-handler | Možnosti načítání souborů CSV |
CSVSaveOptions | CSV-handler | Možnosti ukládání souborů CSV |
MarkdownHandler | přepínač pro odbavení | Statické metody pro vývoz Markdownu |
MarkdownSaveOptions | přepínač pro odbavení | Možnosti pro vývoz Markdownu |
JsonHandler | Json-handlerová | Statické metody pro export JSONu |
JsonSaveOptions | Json-handlerová | Možnosti pro export JSONu |
Shape | tvar | Kreslení tvaru s vyplněním, řádkem, textem a formátováním písma |
ShapeCollection | tvar | Všechny tvary v pracovním listu (ws.shapes) |
MsoDrawingType | tvar | Enum: OVAL, TEXT_BOX, ARROW atd. |
Table | tabulka | Tabulka Excel (strukturovaný odkaz) v pracovním listu |
TableCollection | tabulka | Všechny tabulky v pracovním listu (ws.tables) |
TableColumn | tabulka | Definování sloupce v tabulce |
TableStyleInfo | tabulka | Nastavení vizuálního stylu pro tabulku |
SparklineGroup | Špárková řetězec | Skupina žárovkových grafů sdílejících vizuální styl |
SparklineGroupCollection | Špárková řetězec | Všechny skupiny třpytivých linií (ws.sparkline_groups) |
Sparkline | Špárková řetězec | Jediná buňka s palicí spojenou se datovým rozsahem. |
SparklineType | Špárková řetězec | Zde je seznam všech aktivních položek, které jsou v souvislosti s tímto bodem vybrány. |
HorizontalPageBreakCollection | rozbití stránek | Ruční horizontální přestávky (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | rozbití stránek | Ruč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: |
|---|---|---|
worksheets | seznam | Přístupové pracovní listy podle indexu: workbook.worksheets[0] |
Klíčové metody
| Metodika | Vrá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í list | Přidání nového pracovního listu |
get_worksheet(index_or_name) | Pracovní list | Zí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í list | Kopí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() | číňka | Zkontrolujte , zda je pracovní kniha chráněna . |
Pracovní list
Klíčové vlastnosti
| Vlastnictví | Typ: | Popis: |
|---|---|---|
name | Str. přímý | Název karty pracovního listu |
cells | Buňky | Všechny buňky v tomto hárku . |
charts | ChartCollection | Vš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 cellCelulá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: |
|---|---|---|
value | Jakékoliv | Hodnota buňky (str, int, float nebo None) |
formula | Str. přímý | řetězce vzorců (např.., "=SUM(A1:A5)") |
style | Styl | Styl buňky (písmo, vyplnění) |
Styl
| Vlastnictví | Typ: | Popis: |
|---|---|---|
font | Písmo: | Nastavení písma pro tento styl |
fill | Vyplň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: |
|---|---|---|---|
name | Str. přímý | Kvalita: | Rodinný název písma |
size | plavba | 11 | Velikost písma v bodech |
color | Str. přímý | FF000000 | 8-digit AARRGGBB hex color string |
bold | číňka | Nepravdivé. | Tvrdá textová položka |
italic | číňka | Nepravdivé. | Kurzově: |
underline | číňka | Nepravdivé. | Podtržený text |
strikethrough | číňka | Nepravdivé. | Procházení textem |
Konstruktor
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)Vyplňování
| Metodika | Popis: |
|---|---|
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
| Metodika | Vrá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_alignment | Str. přímý | levá strana | Nastavení sloupce: levá, pravá nebo středová. |
include_worksheet_name | číňka | Pravda. | Zda se název listu zahrne jako nadpis |
header_level | int (včetně) | 2 | Míra odhadu (1-6) |
worksheet_index | int (včetně) | 0 | Index 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.
| Metodika | Vrátit se. | Popis: |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | Grafík | Přidání sloupce (svislé pruhy) grafu |
add_line(top_row, left_col, bottom_row, right_col) | Grafík | Přidání řádkového grafu |
add_pie(top_row, left_col, bottom_row, right_col) | Grafík | Přidejte koláčový graf. |
Grafík
| Vlastnictví | Typ: | Popis: |
|---|---|---|
title | Str. přímý | Název grafu jako jednoduchý řetěz (ne) .title.text) |
category_data | Str. přímý | Rozsah buněk pro štítky kategorie osy x |
n_series | Částky a části: | Sběr datových sérií |
show_legend | číňka | Zda zobrazit legendu |
legend_position | Str. přímý | Poloha legendy: vpravo, dole, vlevo nebo nahoře. |
Částky a části:
| Metodika | Popis: |
|---|---|
add(data_range, category_data=None, name=None) | Přidání jmenované datové řady |
SaveFormat Způsobilé číslo.
| Konstanta | Výstupní formát |
|---|---|
SaveFormat.XLSX | Formát Excel XML (predvolený) |
SaveFormat.CSV | Hodnoty oddělené čárkou |
SaveFormat.TSV | Konstanta pouze pro čtení. workbook.save() nepodporuje zvýšení TSV ValueError v době spuštění. |
SaveFormat.MARKDOWN | Tabulky s odkazem na hodnotu |
SaveFormat.JSON | Strukturalizované údaje JSON |
Poznámka::
SaveFormat.PDF,SaveFormat.HTML,SaveFormat.PNG,SaveFormat.TIFF,SaveFormat.DOCX,a)SaveFormat.PPTXjsou: 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-pythonbalíč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
- Příručka pro vývojáře: Poučení pro všechny základní funkce
- Začínání / instalace: instalace a nastavení pip
- Základní znalosti:Příručky pro provádění jednotlivých úkolů
- Přehled produktu: Souhrnnost vlastností a schopností
- GitHub Repozitář
- Blog: Představuji Aspose.Cells FOSS: Přehled knihovny a rychlý start