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(). लाइब्रेरी एक Workbook रूट ऑब्जेक्ट जो वर्कशीट्स, स्टाइल्स, चार्ट्स, और I/O को प्रबंधित करता है।.
कोर एंट्री पॉइंट है Workbook.प्रत्येक Workbook में एक या अधिक Worksheet ऑब्जेक्ट्स को … के माध्यम से एक्सेस किया जाता है wb.worksheets[index].व्यक्तिगत सेल्स को … के माध्यम से पहुँचा जाता है Cells कलेक्शन का उपयोग A1 नोटेशन या शून्य-आधारित पंक्ति/स्तंभ इंडेक्स के द्वारा किया जाता है।.
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 और Worksheet
ImageRenderOptions Workbook क्लास सभी स्प्रेडशीट ऑपरेशन्स के लिए रूट ऑब्जेक्ट है। यह फ़ाइल लोडिंग, सेविंग, और वर्कशीट्स तथा डॉक्यूमेंट प्रॉपर्टीज़ तक पहुँच को संभालता है।.
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
वर्कशीट में चार्ट्स जोड़ने के लिए … का उपयोग करें add_* … पर मेथड्स ws.charts.प्रत्येक मेथड चार पोज़िशनल आर्ग्युमेंट लेता है: top_row, left_col, bottom_row, right_col.इंडेक्स द्वारा चार्ट तक पहुँचें और उसका शीर्षक तथा डेटा सीरीज़ सेट करें।.
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
वर्कशीट में ड्रॉइंग शैप्स और टेक्स्ट बॉक्स जोड़ने के लिए … का उपयोग करें 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"सेल मान और स्टाइल्स
सेल मानों को पढ़ने और लिखने के लिए उपयोग करें .value प्रॉपर्टी। फ़ॉर्मेटिंग को बदलने के लिए एक्सेस करके cell.style सीधे।.
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")ध्यान दें: सेट करते समय font.color, बिना किसी # प्रिफिक्स (उदाहरण के लिए,., "FF0000" लाल के लिए)।.
डेटा वैलिडेशन
सेल रेंज में ड्रॉपडाउन या अन्य वैधता नियम जोड़ें उपयोग करके 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
पासवर्ड-प्रोटेक्टेड वर्कबुक को सहेजें या खोलें:
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
ImageRenderOptions Cells क्लास व्यक्तिगत सेल्स तक पहुंच प्रदान करती है A1-शैली नोटेशन का उपयोग करके (उदाहरण के लिए,., "A1") या 1-आधारित पंक्ति/स्तंभ ट्यूपल इंडेक्स। यह Cell क्लास एक एकल सेल का प्रतिनिधित्व करती है और उजागर करती है value, formula, और style को पढ़ने/लिखने की प्रॉपर्टी के रूप में। सेल्स को मर्ज और अनमर्ज करने का समर्थन किया जाता है द्वारा merge() और unmerge() पर विधियाँ 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 | वर्कबुक | रूट वर्कबुक ऑब्जेक्ट |
Worksheet | वर्कशीट | सेल, चार्ट और शैप्स के साथ एकल वर्कशीट |
Cells | सेल्स | A1 और 1-आधारित (पंक्ति, स्तंभ) एक्सेस के साथ सेल संग्रह |
Cell | सेल | एकल सेल: मान, सूत्र, शैली |
Style | शैली | सेल फ़ॉर्मेटिंग: फ़ॉन्ट, फ़िल, बॉर्डर, संरेखण |
Chart | चार्ट | एम्बेडेड चार्ट |
DataValidation | डेटा-वैधता | सेल रेंज वैधता नियम |
CSVHandler | csv-handler | CSV आयात/निर्यात |
MarkdownHandler | markdown-handler | Markdown निर्यात |
JsonHandler | json-handler | JSON निर्यात |
Shape | आकार | आकृति या टेक्स्ट बॉक्स बनाना |
Table | टेबल | Excel संरचित टेबल |
SparklineGroup | स्पार्कलाइन | स्पार्कलाइन चार्ट |
HorizontalPageBreakCollection | पेज-ब्रेक | मैनुअल पेज ब्रेक्स |
AgileEncryptionParameters | एन्क्रिप्शन | AES एन्क्रिप्शन पैरामीटर |
SaveFormat | वर्कबुक | आउटपुट फ़ॉर्मेट एन्युम |
सामान्य पैटर्न
# 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