API Overview

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 شیء ریشه که worksheets، styles، charts و 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 کلاس شیء ریشه برای تمام عملیات‌های صفحه‌گسترده است. این کلاس بارگذاری، ذخیره‌سازی فایل و دسترسی به worksheets و ویژگی‌های سند را مدیریت می‌کند.

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 encryption

ImageRenderOptions

نمودارها را به یک worksheet اضافه کنید با استفاده از 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_map

ImageRenderOptions

با استفاده از، اشکال رسم و جعبه‌های متن را به یک برگه کاری اضافه کنید 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")
ImageRenderOptionsImageRenderOptionsImageRenderOptions
Workbookکتاب کارشیء کتاب‌کار ریشه‌ای
Worksheetبرگهیک برگه تک با سلول‌ها، نمودارها، اشکال
Cellsسلول‌هامجموعه سلول‌ها با دسترسی A1 و مبتنی بر ۱ (سطر، ستون)
Cellسلولیک سلول: مقدار، فرمول، سبک
Styleسبکقالب‌بندی سلول: قلم، پرکننده، حاشیه‌ها، تراز
Chartنمودارنمودار توکار
DataValidationاعتبارسنجی-دادهقانون اعتبارسنجی محدوده سلول
CSVHandlerمدیر csvوارد/صادر CSV
MarkdownHandlerمدیر markdownصادرات Markdown
JsonHandlerمدیر jsonصادرات JSON
Shapeشکلنقاشی شکل یا جعبه متن
Tableجدولجدول ساختار یافته اکسل
SparklineGroupاسپارکلایننمودارهای اسپارکلاین
HorizontalPageBreakCollectionشکست صفحهشکست‌های صفحه دستی
AgileEncryptionParametersرمزنگاریپارامترهای رمزنگاری AES
SaveFormatدفتر کارenum فرمت خروجی

الگوهای رایج

# 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

همچنین ببینید

 فارسی