Aspose.Cells FOSS for Python
Thông tin gói
| gói PyPI | aspose-cells-foss |
| Python import | from aspose.cells_foss import ... |
| Enumerations | 26.3.1 |
| Enumerations | MIT |
| yêu cầu Python | >= 3.7 |
| Enumerations | pycryptodome>=3.15.0, olefile>=0.46 |
Enumerations
| Enumerations | Enumerations |
|---|---|
| aspose.cells_foss | API 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
| Enumerations | Enumerations | Enumerations |
|---|---|---|
Workbook | sổ làm việc | Điểm vào để tạo, tải và lưu các tệp bảng tính |
Worksheet | worksheet | Biể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ạng | Thuộ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 |
Fill | kiểu | Đổ nền: đặc, gradient, hoặc mẫu |
NumberFormat | kiểu | Tiện ích tra cứu định dạng số tích hợp |
SaveFormat | sổ làm việc | Liệt kê các định dạng đầu ra được hỗ trợ (XLSX, CSV, MARKDOWN, JSON) |
Chart | biểu đồ | Biểu thị một biểu đồ được nhúng trong một worksheet |
ChartType | biểu đồ | Enum: LINE, BAR, PIE, AREA, STOCK, và các loại khác |
NSeries | biểu đồ | Bộ sưu tập chuỗi dữ liệu trên một biểu đồ |
ChartSeries | biểu đồ | Một chuỗi dữ liệu đơn với các giá trị, danh mục và thanh lỗi |
ChartAxis | biểu đồ | Cài đặt trục: tỷ lệ, định dạng, tiêu đề |
ChartView3D | biểu đồ | 3D rotation and perspective settings |
ChartErrorBars | biểu đồ | Cấu hình thanh lỗi cho một chuỗi |
DataValidation | data-validation | Quy tắc xác thực duy nhất trên một phạm vi ô |
DataValidationCollection | data-validation | Tất cả các quy tắc xác thực cho một bảng tính |
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 | Các phương thức tĩnh cho việc nhập/xuất CSV |
CSVLoadOptions | csv-handler | Các tùy chọn để tải tệp CSV |
CSVSaveOptions | csv-handler | Các tùy chọn lưu tệp CSV |
MarkdownHandler | markdown-handler | Các phương thức tĩnh để xuất Markdown |
MarkdownSaveOptions | markdown-handler | Các tùy chọn xuất Markdown |
JsonHandler | json-handler | Các phương thức tĩnh cho việc xuất JSON |
JsonSaveOptions | json-handler | Các tùy chọn cho việc xuất JSON |
Shape | shape | Vẽ hình dạng với màu nền, đường viền, văn bản và định dạng phông chữ |
ShapeCollection | shape | Tất cả các hình dạng trong một bảng tính (ws.shapes) |
MsoDrawingType | shape | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, v.v. |
Table | table | Bảng Excel (tham chiếu có cấu trúc) trong một bảng tính |
TableCollection | table | Tất cả các bảng trong một bảng tính (ws.list_objects) |
TableColumn | table | Định nghĩa cột trong một Bảng |
TableStyleInfo | bảng | Cài đặt kiểu hiển thị cho bảng |
SparklineGroup | sparkline | Nhóm các biểu đồ sparkline chia sẻ cùng một kiểu hiển thị |
SparklineGroupCollection | sparkline | Tất cả các nhóm sparkline (ws.sparkline_groups) |
Sparkline | sparkline | Một ô sparkline đơn lẻ được liên kết với một phạm vi dữ liệu |
SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
HorizontalPageBreakCollection | ngắt trang | Ngắt trang ngang thủ công (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | ngắt trang | Ngắt trang dọc thủ công (ws.vertical_page_breaks) |
AgileEncryptionParameters | mã hoá | các tham số mã hoá AES-256/SHA-512 (được khuyến nghị) |
StandardEncryptionParameters | mã hoá | các tham số mã hoá Legacy AES-128/SHA-1 |
CipherAlgorithm | mã hoá | Enum: AES_128, AES_192, AES_256 |
HashAlgorithm | mã hoá | Enum: SHA1, SHA256, SHA384, SHA512 |
Enumerations
Enumerations
| Enumerations | Enumerations |
|---|---|
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
| Enumerations | Enumerations | Enumerations |
|---|---|---|
worksheets | danh sách | Truy cập các worksheet theo chỉ mục: workbook.worksheets[0] |
Phương thức chính
| Enumerations | Enumerations | Enumerations |
|---|---|---|
save(file_path) | Enumerations | Lưu vào tệp; định dạng được suy ra từ phần mở rộng |
save(file_path, save_format) | Enumerations | Lưu với SaveFormat rõ ràng |
save_as_csv(file_path, options=None) | Enumerations | Lưu dưới dạng CSV |
save_as_markdown(file_path, options=None) | Enumerations | Lưu dưới dạng bảng Markdown |
save_as_json(file_path, options=None) | Enumerations | Lưu dưới dạng JSON |
load_csv(file_path, options=None) | Enumerations | Tải dữ liệu CSV vào workbook |
add_worksheet(name=None) | Enumerations | Thêm một worksheet mới |
get_worksheet(index_or_name) | Enumerations | Lấy worksheet theo chỉ mục hoặc tên |
remove_worksheet(index_or_name) | Enumerations | Xóa một worksheet |
copy_worksheet(index_or_name_or_ws) | Enumerations | Sao chép một worksheet hiện có |
protect(password=None, lock_structure=True) | Enumerations | Bảo vệ workbook bằng mật khẩu |
unprotect(password=None) | Enumerations | Gỡ bỏ bảo vệ workbook |
is_protected() | bool | Kiểm tra xem workbook có được bảo vệ không |
Enumerations
Thuộc tính chính
| Enumerations | Enumerations | Enumerations |
|---|---|---|
name | str | Tên tab Worksheet |
cells | Enumerations | Tất cả các ô trong worksheet này |
charts | ChartCollection | Tấ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 cellEnumerations
Enumerations
| Enumerations | Enumerations |
|---|---|
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
| Enumerations | Enumerations | Enumerations |
|---|---|---|
value | Enumerations | Giá trị ô (str, int, float, hoặc None) |
formula | str | Chuỗi công thức (ví dụ,., "=SUM(A1:A5)") |
style | Enumerations | Kiểu ô (phông chữ, fill) |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
font | Enumerations | Cài đặt phông chữ cho kiểu này |
fill | Enumerations | Cà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.
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
name | str | Enumerations | Tên phông chữ |
size | float | 11 | Kích thước phông chữ tính bằng điểm |
color | str | FF000000 | 8-digit AARRGGBB hex color string |
bold | bool | Enumerations | Văn bản in đậm |
italic | bool | Enumerations | Văn bản in nghiêng |
underline | bool | Enumerations | Văn bản gạch chân |
strikethrough | bool | Enumerations | Văn bản gạch ngang |
Enumerations
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)Enumerations
| Enumerations | Enumerations |
|---|---|
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
| Enumerations | Enumerations | Enumerations |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | str | Xuất sổ làm việc thành chuỗi Markdown trong bộ nhớ |
MarkdownSaveOptions
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
default_alignment | str | trái | Căn cột: trái, phải, hoặc trung tâm |
include_worksheet_name | bool | Enumerations | Có nên bao gồm tên sheet làm tiêu đề hay không |
header_level | int | 2 | Cấp độ tiêu đề Markdown (1-6) |
worksheet_index | int | 0 | Chỉ 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.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | Enumerations | Thêm biểu đồ cột (cột dọc) |
add_line(top_row, left_col, bottom_row, right_col) | Enumerations | Thêm biểu đồ đường |
add_pie(top_row, left_col, bottom_row, right_col) | Enumerations | Thêm biểu đồ tròn |
Enumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
title | str | Tiêu đề biểu đồ dưới dạng chuỗi thuần (không .title.text) |
category_data | str | Phạm vi ô cho nhãn danh mục trục x |
n_series | NSeries | Bộ sưu tập chuỗi dữ liệu |
show_legend | bool | Có hiển thị chú giải hay không |
legend_position | str | Vị trí chú giải: phải, dưới, trái hoặc trên |
NSeries
| Enumerations | Enumerations |
|---|---|
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.XLSX | Excel Open XML (mặc định) |
SaveFormat.CSV | Giá trị phân tách bằng dấu phẩy |
SaveFormat.TSV | Giá trị phân tách bằng tab |
SaveFormat.MARKDOWN | Bảng Markdown |
SaveFormat.JSON | Dữ liệu có cấu trúc JSON |
Enumerations: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, và SaveFormat.PPTX là khô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
- Hướng dẫn dành cho nhà phát triển: Hướng dẫn cho tất cả các tính năng cốt lõi
- Bắt đầu / Cài đặt: cài đặt pip và thiết lập
- Cơ sở tri thức: Hướng dẫn thực hành theo nhiệm vụ
- Tổng quan sản phẩm: Tóm tắt tính năng và khả năng
- Kho GitHub
- Blog: Giới thiệu Aspose.Cells FOSS: Tổng quan thư viện và bắt đầu nhanh