Aspose.Cells FOSS for Python
Informácie o balíku
| balík PyPI | aspose-cells-foss |
| Python import | from aspose.cells_foss import ... |
| ImageRenderOptions | 26.3.1 |
| ImageRenderOptions | MIT |
| Python požiadavka | >= 3.7 |
| ImageRenderOptions | pycryptodome>=3.15.0, olefile>=0.46 |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
| aspose.cells_foss | Základné API tabuľkového procesora: workbooks, worksheets, cells, styles, charts, format handlers |
ImageRenderOptions: Nie je aspose.pydrawing modul v Aspose.Cells FOSS. Farby sú vyjadrené ako 8‑ciferné AARRGGBB hex reťazce (napr., "FFFF0000" pre nepriehľadnú červenú).
aspose.cells_foss
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Workbook | zošit | Vstupný bod pre vytváranie, načítanie a ukladanie súborov tabuľkových procesorov |
Worksheet | hárok | Zastupuje jeden hárok; poskytuje prístup k bunkám, grafom a obrázkom |
Cells | bunky | Zbierka podobná slovníku Cell objektov v Worksheet |
Cell | bunka | Zastupuje jednotlivú bunku; hodnotu, vzorec a štýl |
Style | štýl | Formátovanie bunky: písmo, výplň, okraje, zarovnanie, formát čísla, ochrana |
Font | štýl | Vlastnosti písma: názov, veľkosť, farba, tučné, kurzíva, podčiarknutie, prečiarknutie |
Fill | štýl | Výplň pozadia: plná, prechodová alebo vzorová |
NumberFormat | štýl | Vstavané nástroje na vyhľadávanie formátov čísel |
SaveFormat | zošit | Vymenovanie podporovaných výstupných formátov (XLSX, CSV, MARKDOWN, JSON) |
Chart | graf | Zastupuje graf vložený do pracovného hárku |
ChartType | graf | Výčtový typ: LINE, BAR, PIE, AREA, STOCK a ďalšie |
NSeries | graf | Zbierka dátových sérií na grafe |
ChartSeries | graf | Jedna dátová séria s hodnotami, kategóriami a chybovými pruhmi |
ChartAxis | graf | Nastavenia osi: mierka, formát, názov |
ChartView3D | graf | 3D rotation and perspective settings |
ChartErrorBars | graf | Konfigurácia chybových úsekov pre sériu |
DataValidation | data-validation | Jedno pravidlo validácie na rozsah buniek |
DataValidationCollection | data-validation | Všetky pravidlá validácie pre pracovný list |
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 | Statické metódy pre import/export CSV |
CSVLoadOptions | csv-handler | Možnosti načítania CSV súborov |
CSVSaveOptions | csv-handler | Možnosti ukladania CSV súborov |
MarkdownHandler | markdown-handler | Statické metódy pre export Markdown |
MarkdownSaveOptions | markdown-handler | Možnosti exportu Markdown |
JsonHandler | json-handler | Statické metódy pre export JSON |
JsonSaveOptions | json-handler | Možnosti pre export JSON |
Shape | tvar | Kreslenie tvaru s výplňou, čiarou, textom a formátovaním písma |
ShapeCollection | tvar | Všetky tvary v pracovnom hárku (ws.shapes) |
MsoDrawingType | tvar | Výčtový typ: RECTANGLE, OVAL, TEXT_BOX, ARROW, atď. |
Table | tabuľka | Excel tabuľka (štruktúrovaný odkaz) v pracovnom hárku |
TableCollection | tabuľka | Všetky tabuľky v pracovnom hárku (ws.list_objects) |
TableColumn | tabuľka | Definícia stĺpca v tabuľke |
TableStyleInfo | tabuľka | Nastavenia vizuálneho štýlu pre tabuľku |
SparklineGroup | sparkline | Skupina sparkline grafov zdieľajúcich vizuálny štýl |
SparklineGroupCollection | sparkline | Všetky skupiny sparkline (ws.sparkline_groups) |
Sparkline | sparkline | Jedna bunka sparkline prepojená s dátovým rozsahom |
SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
HorizontalPageBreakCollection | zalomenie stránky | Manuálne horizontálne zalomenia stránok (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | page-break | Manuálne vertikálne zalomenia stránok (ws.vertical_page_breaks) |
AgileEncryptionParameters | šifrovanie | Parametre šifrovania AES-256/SHA-512 (odporúčané) |
StandardEncryptionParameters | šifrovanie | Parametre šifrovania Legacy AES-128/SHA-1 |
CipherAlgorithm | šifrovanie | Enum: AES_128, AES_192, AES_256 |
HashAlgorithm | šifrovanie | Enum: SHA1, SHA256, SHA384, SHA512 |
ImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Workbook() | Vytvorte nový prázdny zošit (formát XLSX) |
Workbook(file_path: str) | Načítajte zošit z cesty k súboru |
Workbook(file_path: str, password: str) | Načítajte pracovný zošit chránený heslom |
Kľúčové vlastnosti
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
worksheets | zoznam | Prístup k hárkom podľa indexu: workbook.worksheets[0] |
Kľúčové metódy
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
save(file_path) | ImageRenderOptions | Uložte do súboru; formát je odvodený od prípony |
save(file_path, save_format) | ImageRenderOptions | Uložte s explicitným SaveFormat |
save_as_csv(file_path, options=None) | ImageRenderOptions | Uložte ako CSV |
save_as_markdown(file_path, options=None) | ImageRenderOptions | Uložte ako tabuľky Markdown |
save_as_json(file_path, options=None) | ImageRenderOptions | Uložte ako JSON |
load_csv(file_path, options=None) | ImageRenderOptions | Načítajte CSV dáta do pracovného zošita |
add_worksheet(name=None) | ImageRenderOptions | Pridajte nový hárok |
get_worksheet(index_or_name) | ImageRenderOptions | Získajte hárok podľa indexu alebo názvu |
remove_worksheet(index_or_name) | ImageRenderOptions | Odstráňte hárok |
copy_worksheet(index_or_name_or_ws) | ImageRenderOptions | Skopírujte existujúci hárok |
protect(password=None, lock_structure=True) | ImageRenderOptions | Chráňte pracovný zošit heslom |
unprotect(password=None) | ImageRenderOptions | Odstráňte ochranu pracovného zošita |
is_protected() | bool | Skontrolujte, či je zošit chránený |
ImageRenderOptions
Kľúčové vlastnosti
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Názov karty hárku |
cells | ImageRenderOptions | Všetky bunky v tomto hárku |
charts | ChartCollection | Všetky grafy v tomto pracovnom hárku |
ImageRenderOptions
Cells podporuje prístup v štýle slovníka pomocou reťazca adresy bunky.
Prístupové vzory
# 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 cellImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Cell(value=None) | Vytvorte bunku s hodnotou (int, float, str alebo None) |
Cell(value, formula) | Vytvorte bunku s formulou (hodnota je zvyčajne None) |
Kľúčové vlastnosti
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
value | ImageRenderOptions | Hodnota bunky (str, int, float alebo None) |
formula | str | Reťazec vzorca (napr., "=SUM(A1:A5)") |
style | ImageRenderOptions | Štýl bunky (písmo, výplň) |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
font | ImageRenderOptions | Nastavenia písma pre tento štýl |
fill | ImageRenderOptions | Nastavenia výplne pozadia |
ImageRenderOptions
Farby sú vyjadrené ako 8-digit AARRGGBB hex strings bez # predpony. Príklady: "FFFF0000" = nepriehľadná červená, "FF0000FF" = nepriehľadná modrá, "FF000000" = čierna.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
name | str | ImageRenderOptions | Názov rodiny písma |
size | float | 11 | Veľkosť písma v bodoch |
color | str | FF000000 | 8-digit AARRGGBB hex color string |
bold | bool | ImageRenderOptions | Tučný text |
italic | bool | ImageRenderOptions | Kurzívny text |
underline | bool | ImageRenderOptions | Podčiarknutý text |
strikethrough | bool | ImageRenderOptions | Prečiarknutý text |
ImageRenderOptions
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
set_solid_fill(color) | Jednofarečné pozadie; color je 8‑znakový hexadecimálny reťazec AARRGGBB |
set_pattern_fill(pattern_type, fg_color, bg_color) | Vzorovaná výplň |
set_no_fill() | Odstrániť výplň pozadia |
MarkdownHandler
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | str | Exportovať zošit do reťazca Markdown v pamäti |
MarkdownSaveOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
default_alignment | str | vľavo | Zarovnanie stĺpca: vľavo, vpravo alebo na stred |
include_worksheet_name | bool | ImageRenderOptions | Či zahrnúť názov hárku ako nadpis |
header_level | int | 2 | Úroveň nadpisu v Markdown (1-6) |
worksheet_index | int | 0 | Index hárku na export; -1 exportuje všetky hárky |
ChartCollection
Grafy sa pridávajú pomocou špecializovaných metód pre každý typ. Indexy riadkov a stĺpcov sú od nuly.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Pridať stĺpcový (vertikálny pruhový) graf |
add_line(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Pridať čiarový graf |
add_pie(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Pridať koláčový graf |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
title | str | Názov grafu ako obyčajný reťazec (nie .title.text) |
category_data | str | Rozsah buniek pre kategóriové popisky osi x |
n_series | NSeries | Zbierka dátových sérií |
show_legend | bool | Či zobraziť legendu |
legend_position | str | Pozícia legendy: vpravo, dole, vľavo alebo hore |
NSeries
| ImageRenderOptions | ImageRenderOptions |
|---|---|
add(data_range, category_data=None, name=None) | Pridať pomenovanú dátovú sériu |
Výčet SaveFormat
| ImageRenderOptions | Formát výstupu |
|---|---|
SaveFormat.XLSX | Excel Open XML (predvolené) |
SaveFormat.CSV | Hodnoty oddelené čiarkou |
SaveFormat.TSV | Hodnoty oddelené tabulátorom |
SaveFormat.MARKDOWN | Markdown tabuľky |
SaveFormat.JSON | JSON-štruktúrované dáta |
ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, a SaveFormat.PPTX sú nie sú k dispozícii v Aspose.Cells FOSS. Tieto formáty vyžadujú komerčný aspose-cells-python balík.
Príklady kódu
Vytvorte, naformátujte a uložte zošit
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")Exportovať do Markdownu v pamäti
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)Vytvorte čiarový 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")Súvisiace zdroje
- Príručka pre vývojárov: Tutoriály pre všetky základné funkcie
- Začíname / Inštalácia: pip inštalácia a nastavenie
- Znalostná báza: Úlohou orientované návody typu ako na to
- Prehľad produktu: Zhrnutie funkcií a schopností
- Repozitár na GitHubu
- Blog: Predstavenie Aspose.Cells FOSS: Prehľad knižnice a rýchly štart