Aspose.Cells FOSS API Reference
ImageRenderOptions
Aspose.Cells FOSS is an open-source Python library for creating, reading, and modifying spreadsheet files without requiring Microsoft Excel. It supports XLSX and CSV formats for input, and adds Markdown export via save_as_markdown(). Biblioteca este structurată în jurul unui Workbook obiect rădăcină care gestionează foi de calcul, stiluri, grafice și I/O.
Punctul de intrare principal este Workbook.Fiecare Workbook conține unul sau mai multe Worksheet obiecte accesate prin wb.worksheets[index].Celulele individuale sunt accesate prin Cells colecție utilizând notația A1 sau indici de rând/coloană cu bază zero.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue"
ws.cells["B2"].value = 42
wb.save("output.xlsx")Workbook și Worksheet
ImageRenderOptions Workbook class este obiectul rădăcină pentru toate operațiunile de foi de calcul. Aceasta gestionează încărcarea și salvarea fișierelor, precum și accesul la foi de calcul și la proprietățile documentului.
from aspose.cells_foss import Workbook
wb = Workbook() # new workbook
wb = Workbook("input.xlsx") # open existing file
wb = Workbook("protected.xlsx", password="secret") # open encrypted file
ws = wb.worksheets[0] # first worksheet (0-based)
ws = wb.add_worksheet("Sheet2") # add a named worksheet
ws.cells["A1"].put_value("Hello") # write by A1 reference
ws.cells["A1"].value # read value (property, no parentheses)
ws.cells["A2"].formula = "=SUM(B1:B5)"
wb.save("output.xlsx") # save as XLSX
wb.save("output.csv") # auto-detects format from extension
wb.save_as_markdown("output.md") # export as Markdown table
wb.save("output.xlsx", password="secret") # save with AES encryptionImageRenderOptions
Adăugați grafice la o foaie de calcul utilizând add_* metodele pe ws.charts. Fiecare metodă primește patru argumente poziționale: top_row, left_col, bottom_row, right_col. Accesați graficul prin index pentru a-i seta titlul și seria de date.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
chart_idx = ws.charts.add_line(upper_left_row=0, upper_left_col=4,
lower_right_row=20, lower_right_col=12)
chart = ws.charts[chart_idx]
chart.title = "Monthly Sales"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Sales")
# Other add methods: add_bar, add_pie, add_area, add_scatter,
# add_waterfall, add_combo, add_stock, add_surface, add_radar,
# add_treemap, add_sunburst, add_histogram, add_funnel,
# add_box_whisker, add_mapImageRenderOptions
Adăugați forme de desen și casete de text într-o foaie de calcul utilizând ws.shapes.
from aspose.cells_foss import Workbook
from aspose.cells_foss import MsoDrawingType, TextAlignmentType, TextAnchorType
wb = Workbook()
ws = wb.worksheets[0]
shape = ws.shapes.add(MsoDrawingType.ROUNDED_RECTANGLE, 1, 1, 5, 5)
shape.text = "Hello"
shape.fill.fore_color = "90EE90"
shape.font.bold = True
shape.text_horizontal_alignment = TextAlignmentType.CENTER
shape.text_vertical_alignment = TextAnchorType.MIDDLE
textbox = ws.shapes.add_text_box(7, 1, 11, 8)
textbox.text = "Notes"Valori și stiluri ale celulelor
Citiți și scrieți valori în celule utilizând .value proprietatea. Modificați formatarea accesând cell.style direct.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
# Write values
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"
worksheet.cells["A2"].value = 42
worksheet.cells["B2"].value = 3.14
# Read a value
value = worksheet.cells["A1"].value
print(f"Cell A1 contains: {value}")
# Apply a style via the cell's style property
cell = worksheet.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # RRGGBB hex, no # prefix
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")
workbook.save("output.xlsx")Notă: când setați font.color, folosiți un șir hex fără un # prefix (de ex., "FF0000" pentru roșu).
Validare de date
Adăugați un meniu derulant sau alte reguli de validare la un interval de celule utilizând ws.data_validations.
from aspose.cells_foss import Workbook, DataValidationType
workbook = Workbook()
worksheet = workbook.worksheets[0]
validation = worksheet.data_validations.add("A1:A10")
validation.type = DataValidationType.LIST
validation.formula1 = '"Option1,Option2,Option3"'
workbook.save("validation.xlsx")ImageRenderOptions
Salvați sau deschideți registre de lucru protejate prin parolă:
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Confidential Data"
# Save with password protection
workbook.save("protected.xlsx", password="mypassword")
# Open a password-protected file
workbook2 = Workbook("protected.xlsx", password="mypassword")API public
ImageRenderOptions Cells clasa oferă acces la celulele individuale utilizând notația de tip A1 (de exemplu,., "A1") sau indici de tip tuplu rând/coloană cu indexare de la 1. Clasa Cell clasa reprezintă o singură celulă și expune value, formula, și style ca proprietăți de citire/scriere. Îmbinarea și separarea celulelor este suportată prin merge() și unmerge() metode pe Cells.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World" # A1 notation preferred
workbook.save("output.xlsx")| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Workbook | workbook | Obiectul workbook rădăcină |
Worksheet | worksheet | Foaie de lucru unică cu celule, grafice, forme |
Cells | celule | Colecție de celule cu acces A1 și bazat pe 1 (rând, col) |
Cell | celulă | Celulă unică: valoare, formulă, stil |
Style | stil | Formatarea celulei: font, umplere, margini, aliniere |
Chart | diagramă | Diagramă încorporată |
DataValidation | validare-date | Regula de validare a intervalului de celule |
CSVHandler | csv-handler | Import/export CSV |
MarkdownHandler | markdown-handler | Export Markdown |
JsonHandler | json-handler | Export JSON |
Shape | formă | Desenarea formei sau a casetei de text |
Table | tabel | Tabel structurat Excel |
SparklineGroup | sparkline | Grafice sparkline |
HorizontalPageBreakCollection | întrerupere de pagină | Întreruperi de pagină manuale |
AgileEncryptionParameters | criptare | Parametrii de criptare AES |
SaveFormat | caiet de lucru | Enum de format de ieșire |
Tipare comune
# Styling a cell
cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # red (RRGGBB, no #)
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")# Add a dropdown validation
from aspose.cells_foss import DataValidationType
dv = ws.data_validations.add("B1:B10")
dv.type = DataValidationType.LIST
dv.formula1 = '"Red,Green,Blue"'
dv.show_dropdown = True