Aspose.Cells FOSS for Python

Thông tin gói

gói PyPIaspose-cells-foss
Python importfrom aspose.cells_foss import ...
Enumerations26.3.1
EnumerationsMIT
yêu cầu Python>= 3.7
Enumerationspycryptodome>=3.15.0, olefile>=0.46

Enumerations

EnumerationsEnumerations
aspose.cells_fossAPI bảng tính cốt lõi: workbooks, worksheets, cells, styles, charts, format handlers

Enumerations: Không có aspose.pydrawing module trong Aspose.Cells FOSS. Màu được biểu diễn dưới dạng chuỗi thập lục phân 8 ký tự AARRGGBB (ví dụ,., "FFFF0000" cho màu đỏ không trong suốt).


aspose.cells_foss

Enumerations

EnumerationsEnumerationsEnumerations
Workbooksổ làm việcĐiểm vào để tạo, tải và lưu các tệp bảng tính
WorksheetworksheetBiểu diễn một sheet duy nhất; cung cấp quyền truy cập vào cells, charts và pictures
CellsôBộ sưu tập kiểu từ điển của Cell các đối tượng trong một Worksheet
CellôBiểu thị một ô riêng lẻ; giá trị, công thức và định dạng
Styleđịnh dạngĐịnh dạng ô: phông chữ, nền, viền, căn chỉnh, định dạng số, bảo vệ
Fontđịnh dạngThuộc tính phông chữ: tên, kích thước, màu, in đậm, in nghiêng, gạch dưới, gạch ngang
FillkiểuĐổ nền: đặc, gradient, hoặc mẫu
NumberFormatkiểuTiện ích tra cứu định dạng số tích hợp
SaveFormatsổ làm việcLiệt kê các định dạng đầu ra được hỗ trợ (XLSX, CSV, MARKDOWN, JSON)
Chartbiểu đồBiểu thị một biểu đồ được nhúng trong một worksheet
ChartTypebiểu đồEnum: LINE, BAR, PIE, AREA, STOCK, và các loại khác
NSeriesbiểu đồBộ sưu tập chuỗi dữ liệu trên một biểu đồ
ChartSeriesbiểu đồMột chuỗi dữ liệu đơn với các giá trị, danh mục và thanh lỗi
ChartAxisbiểu đồCài đặt trục: tỷ lệ, định dạng, tiêu đề
ChartView3Dbiểu đồ3D rotation and perspective settings
ChartErrorBarsbiểu đồCấu hình thanh lỗi cho một chuỗi
DataValidationdata-validationQuy tắc xác thực duy nhất trên một phạm vi ô
DataValidationCollectiondata-validationTất cả các quy tắc xác thực cho một bảng tính
DataValidationTypedata-validationEnum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
DataValidationOperatordata-validationEnum: BETWEEN, EQUAL, GREATER_THAN, etc.
DataValidationAlertStyledata-validationEnum: STOP, WARNING, INFORMATION
CSVHandlercsv-handlerCác phương thức tĩnh cho việc nhập/xuất CSV
CSVLoadOptionscsv-handlerCác tùy chọn để tải tệp CSV
CSVSaveOptionscsv-handlerCác tùy chọn lưu tệp CSV
MarkdownHandlermarkdown-handlerCác phương thức tĩnh để xuất Markdown
MarkdownSaveOptionsmarkdown-handlerCác tùy chọn xuất Markdown
JsonHandlerjson-handlerCác phương thức tĩnh cho việc xuất JSON
JsonSaveOptionsjson-handlerCác tùy chọn cho việc xuất JSON
ShapeshapeVẽ hình dạng với màu nền, đường viền, văn bản và định dạng phông chữ
ShapeCollectionshapeTất cả các hình dạng trong một bảng tính (ws.shapes)
MsoDrawingTypeshapeEnum: RECTANGLE, OVAL, TEXT_BOX, ARROW, v.v.
TabletableBảng Excel (tham chiếu có cấu trúc) trong một bảng tính
TableCollectiontableTất cả các bảng trong một bảng tính (ws.list_objects)
TableColumntableĐịnh nghĩa cột trong một Bảng
TableStyleInfobảngCài đặt kiểu hiển thị cho bảng
SparklineGroupsparklineNhóm các biểu đồ sparkline chia sẻ cùng một kiểu hiển thị
SparklineGroupCollectionsparklineTất cả các nhóm sparkline (ws.sparkline_groups)
SparklinesparklineMột ô sparkline đơn lẻ được liên kết với một phạm vi dữ liệu
SparklineTypesparklineEnum: LINE, COLUMN, WIN_LOSS
HorizontalPageBreakCollectionngắt trangNgắt trang ngang thủ công (ws.horizontal_page_breaks)
VerticalPageBreakCollectionngắt trangNgắt trang dọc thủ công (ws.vertical_page_breaks)
AgileEncryptionParametersmã hoácác tham số mã hoá AES-256/SHA-512 (được khuyến nghị)
StandardEncryptionParametersmã hoácác tham số mã hoá Legacy AES-128/SHA-1
CipherAlgorithmmã hoáEnum: AES_128, AES_192, AES_256
HashAlgorithmmã hoáEnum: SHA1, SHA256, SHA384, SHA512

Enumerations

Enumerations

EnumerationsEnumerations
Workbook()Tạo một workbook mới trống (định dạng XLSX)
Workbook(file_path: str)Tải một workbook từ đường dẫn tệp
Workbook(file_path: str, password: str)Tải một workbook được bảo vệ bằng mật khẩu

Thuộc tính chính

EnumerationsEnumerationsEnumerations
worksheetsdanh sáchTruy cập các worksheet theo chỉ mục: workbook.worksheets[0]

Phương thức chính

EnumerationsEnumerationsEnumerations
save(file_path)EnumerationsLưu vào tệp; định dạng được suy ra từ phần mở rộng
save(file_path, save_format)EnumerationsLưu với SaveFormat rõ ràng
save_as_csv(file_path, options=None)EnumerationsLưu dưới dạng CSV
save_as_markdown(file_path, options=None)EnumerationsLưu dưới dạng bảng Markdown
save_as_json(file_path, options=None)EnumerationsLưu dưới dạng JSON
load_csv(file_path, options=None)EnumerationsTải dữ liệu CSV vào workbook
add_worksheet(name=None)EnumerationsThêm một worksheet mới
get_worksheet(index_or_name)EnumerationsLấy worksheet theo chỉ mục hoặc tên
remove_worksheet(index_or_name)EnumerationsXóa một worksheet
copy_worksheet(index_or_name_or_ws)EnumerationsSao chép một worksheet hiện có
protect(password=None, lock_structure=True)EnumerationsBảo vệ workbook bằng mật khẩu
unprotect(password=None)EnumerationsGỡ bỏ bảo vệ workbook
is_protected()boolKiểm tra xem workbook có được bảo vệ không

Enumerations

Thuộc tính chính

EnumerationsEnumerationsEnumerations
namestrTên tab Worksheet
cellsEnumerationsTất cả các ô trong worksheet này
chartsChartCollectionTất cả biểu đồ trong bảng tính này

Enumerations

Cells hỗ trợ truy cập kiểu từ điển bằng chuỗi địa chỉ ô.

Mẫu truy cập

# 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 cell

Enumerations

Enumerations

EnumerationsEnumerations
Cell(value=None)Tạo một ô với giá trị (int, float, str, hoặc None)
Cell(value, formula)Tạo một ô công thức (giá trị thường là None)

Thuộc tính chính

EnumerationsEnumerationsEnumerations
valueEnumerationsGiá trị ô (str, int, float, hoặc None)
formulastrChuỗi công thức (ví dụ,., "=SUM(A1:A5)")
styleEnumerationsKiểu ô (phông chữ, fill)

Enumerations

EnumerationsEnumerationsEnumerations
fontEnumerationsCài đặt phông chữ cho kiểu này
fillEnumerationsCài đặt nền fill

Enumerations

Màu được biểu thị dưới dạng 8-digit AARRGGBB hex strings không có một # tiền tố. Ví dụ: "FFFF0000" = màu đỏ đục, "FF0000FF" = màu xanh dương đục, "FF000000" = đen.

EnumerationsEnumerationsEnumerationsEnumerations
namestrEnumerationsTên phông chữ
sizefloat11Kích thước phông chữ tính bằng điểm
colorstrFF0000008-digit AARRGGBB hex color string
boldboolEnumerationsVăn bản in đậm
italicboolEnumerationsVăn bản in nghiêng
underlineboolEnumerationsVăn bản gạch chân
strikethroughboolEnumerationsVăn bản gạch ngang

Enumerations

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)

Enumerations

EnumerationsEnumerations
set_solid_fill(color)Nền đặc; color là một chuỗi hex 8 ký tự AARRGGBB
set_pattern_fill(pattern_type, fg_color, bg_color)Đổ màu có hoa văn
set_no_fill()Xóa màu nền

MarkdownHandler

EnumerationsEnumerationsEnumerations
MarkdownHandler.save_markdown_to_string(workbook)strXuất sổ làm việc thành chuỗi Markdown trong bộ nhớ

MarkdownSaveOptions

EnumerationsEnumerationsEnumerationsEnumerations
default_alignmentstrtráiCăn cột: trái, phải, hoặc trung tâm
include_worksheet_nameboolEnumerationsCó nên bao gồm tên sheet làm tiêu đề hay không
header_levelint2Cấp độ tiêu đề Markdown (1-6)
worksheet_indexint0Chỉ số sheet để xuất; -1 sẽ xuất tất cả các sheet

ChartCollection

Biểu đồ được thêm bằng các phương pháp riêng cho từng loại. Chỉ số hàng và cột là đánh số từ 0.

EnumerationsEnumerationsEnumerations
add_bar(top_row, left_col, bottom_row, right_col)EnumerationsThêm biểu đồ cột (cột dọc)
add_line(top_row, left_col, bottom_row, right_col)EnumerationsThêm biểu đồ đường
add_pie(top_row, left_col, bottom_row, right_col)EnumerationsThêm biểu đồ tròn

Enumerations

EnumerationsEnumerationsEnumerations
titlestrTiêu đề biểu đồ dưới dạng chuỗi thuần (không .title.text)
category_datastrPhạm vi ô cho nhãn danh mục trục x
n_seriesNSeriesBộ sưu tập chuỗi dữ liệu
show_legendboolCó hiển thị chú giải hay không
legend_positionstrVị trí chú giải: phải, dưới, trái hoặc trên

NSeries

EnumerationsEnumerations
add(data_range, category_data=None, name=None)Thêm một chuỗi dữ liệu có tên

Liệt kê SaveFormat

EnumerationsĐịnh dạng đầu ra
SaveFormat.XLSXExcel Open XML (mặc định)
SaveFormat.CSVGiá trị phân tách bằng dấu phẩy
SaveFormat.TSVGiá trị phân tách bằng tab
SaveFormat.MARKDOWNBảng Markdown
SaveFormat.JSONDữ liệu có cấu trúc JSON

Enumerations: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, và SaveFormat.PPTXkhông khả dụng trong Aspose.Cells FOSS. Các định dạng này yêu cầu bản thương mại aspose-cells-python gói.


Ví dụ mã

Tạo, định dạng và lưu một workbook

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")

Xuất ra Markdown trong bộ nhớ

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)

Tạo biểu đồ đường

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")

Tài nguyên liên quan

 Tiếng Việt