Aspose.Cells FOSS for Python
Maklumat Pakej
| Pakej PyPI | aspose-cells-foss |
| Python import | from aspose.cells_foss import ... |
| ImageRenderOptions | 26.3.1 |
| ImageRenderOptions | MIT |
| Python keperluan | >= 3.7 |
| ImageRenderOptions | pycryptodome>=3.15.0, olefile>=0.46 |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
| aspose.cells_foss | API hamparan teras: workbooks, worksheets, cells, styles, charts, format handlers |
ImageRenderOptions: Tiada aspose.pydrawing modul dalam Aspose.Cells FOSS. Warna dinyatakan sebagai rentetan heks 8-digit AARRGGBB (contoh,., "FFFF0000" untuk merah legap).
aspose.cells_foss
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Workbook | workbook | Titik masuk untuk membuat, memuatkan, dan menyimpan fail spreadsheet |
Worksheet | worksheet | Mewakili satu helaian; menyediakan akses kepada cells, charts, dan gambar |
Cells | cells | Koleksi seperti kamus bagi Cell objek dalam satu Worksheet |
Cell | cell | Mewakili sel individu; nilai, formula, dan gaya |
Style | gaya | Pemformatan sel: font, isi, sempadan, penjajaran, format nombor, perlindungan |
Font | gaya | Ciri fon: nama, saiz, warna, tebal, condong, garis bawah, garis coret |
Fill | gaya | Isian latar belakang: pepejal, gradien, atau corak |
NumberFormat | gaya | Utiliti carian format nombor terbina dalam |
SaveFormat | buku kerja | Enumerasi format output yang disokong (XLSX, CSV, MARKDOWN, JSON) |
Chart | carta | Mewakili carta yang disematkan dalam lembar kerja |
ChartType | carta | Enum: LINE, BAR, PIE, AREA, STOCK, dan lain-lain |
NSeries | carta | Koleksi siri data pada carta |
ChartSeries | carta | Satu siri data dengan nilai, kategori, dan bar ralat |
ChartAxis | carta | Tetapan paksi: skala, format, tajuk |
ChartView3D | carta | 3D rotation and perspective settings |
ChartErrorBars | carta | Konfigurasi bar ralat untuk satu siri |
DataValidation | data-validation | Peraturan pengesahan tunggal pada julat sel |
DataValidationCollection | data-validation | Semua peraturan pengesahan untuk lembar kerja |
DataValidationType | data-validation | Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM |
DataValidationOperator | data-validation | Enum: BETWEEN, EQUAL, GREATER_THAN, dll. |
DataValidationAlertStyle | data-validation | Enum: STOP, WARNING, INFORMATION |
CSVHandler | csv-handler | Kaedah statik untuk import/eksport CSV |
CSVLoadOptions | csv-handler | Pilihan untuk memuatkan fail CSV |
CSVSaveOptions | csv-handler | Pilihan untuk menyimpan fail CSV |
MarkdownHandler | markdown-handler | Kaedah statik untuk eksport Markdown |
MarkdownSaveOptions | markdown-handler | Pilihan untuk eksport Markdown |
JsonHandler | json-handler | Kaedah statik untuk eksport JSON |
JsonSaveOptions | json-handler | Pilihan untuk eksport JSON |
Shape | bentuk | Melukis bentuk dengan isian, garis, teks, dan pemformatan fon |
ShapeCollection | bentuk | Semua bentuk dalam lembar kerja (ws.shapes) |
MsoDrawingType | bentuk | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, dll. |
Table | jadual | Jadual Excel (rujukan berstruktur) dalam lembar kerja |
TableCollection | jadual | Semua jadual dalam lembar kerja (ws.list_objects) |
TableColumn | jadual | Definisi lajur dalam Jadual |
TableStyleInfo | jadual | Tetapan gaya visual untuk Jadual |
SparklineGroup | sparkline | Kumpulan carta sparkline yang berkongsi gaya visual |
SparklineGroupCollection | sparkline | Semua kumpulan sparkline (ws.sparkline_groups) |
Sparkline | sparkline | Satu sel sparkline tunggal yang dipautkan kepada julat data |
SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
HorizontalPageBreakCollection | hentian halaman | Hentian halaman mendatar manual (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | hentian halaman | Hentian halaman menegak manual (ws.vertical_page_breaks) |
AgileEncryptionParameters | penyulitan | parameter penyulitan AES-256/SHA-512 (disarankan) |
StandardEncryptionParameters | penyulitan | parameter penyulitan Legacy AES-128/SHA-1 |
CipherAlgorithm | penyulitan | Enum: AES_128, AES_192, AES_256 |
HashAlgorithm | penyulitan | Enum: SHA1, SHA256, SHA384, SHA512 |
ImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Workbook() | Cipta buku kerja baru yang kosong (format XLSX) |
Workbook(file_path: str) | Muat buku kerja dari laluan fail |
Workbook(file_path: str, password: str) | Muat buku kerja yang dilindungi kata laluan |
Sifat Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
worksheets | senarai | Akses helaian kerja mengikut indeks: workbook.worksheets[0] |
Kaedah Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
save(file_path) | ImageRenderOptions | Simpan ke fail; format ditentukan daripada sambungan |
save(file_path, save_format) | ImageRenderOptions | Simpan dengan SaveFormat yang jelas |
save_as_csv(file_path, options=None) | ImageRenderOptions | Simpan sebagai CSV |
save_as_markdown(file_path, options=None) | ImageRenderOptions | Simpan sebagai jadual Markdown |
save_as_json(file_path, options=None) | ImageRenderOptions | Simpan sebagai JSON |
load_csv(file_path, options=None) | ImageRenderOptions | Muat data CSV ke dalam buku kerja |
add_worksheet(name=None) | ImageRenderOptions | Tambah helaian kerja baru |
get_worksheet(index_or_name) | ImageRenderOptions | Dapatkan helaian kerja mengikut indeks atau nama |
remove_worksheet(index_or_name) | ImageRenderOptions | Buang helaian kerja |
copy_worksheet(index_or_name_or_ws) | ImageRenderOptions | Salin helaian kerja yang sedia ada |
protect(password=None, lock_structure=True) | ImageRenderOptions | Lindungi buku kerja dengan kata laluan |
unprotect(password=None) | ImageRenderOptions | Buang perlindungan buku kerja |
is_protected() | bool | Semak sama ada buku kerja dilindungi |
ImageRenderOptions
Sifat Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Nama tab helaian kerja |
cells | ImageRenderOptions | Semua sel dalam helaian kerja ini |
charts | ChartCollection | Semua carta dalam lembar kerja ini |
ImageRenderOptions
Cells menyokong akses gaya kamus melalui rentetan alamat sel.
Corak Akses
# 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 cellImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Cell(value=None) | Cipta sel dengan nilai (int, float, str, atau None) |
Cell(value, formula) | Cipta sel formula (nilai biasanya None) |
Sifat Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
value | ImageRenderOptions | Nilai sel (str, int, float, atau None) |
formula | str | Rentetan formula (contoh,., "=SUM(A1:A5)") |
style | ImageRenderOptions | Gaya sel (fon, isi) |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
font | ImageRenderOptions | Tetapan fon untuk gaya ini |
fill | ImageRenderOptions | Tetapan isi latar belakang |
ImageRenderOptions
Warna dinyatakan sebagai 8-digit AARRGGBB hex strings tanpa # awalan. Contoh: "FFFF0000" = merah legap, "FF0000FF" = biru legap, "FF000000" = hitam.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
name | str | ImageRenderOptions | Nama keluarga fon |
size | float | 11 | Saiz fon dalam mata |
color | str | FF000000 | 8-digit AARRGGBB hex color string |
bold | bool | ImageRenderOptions | Teks tebal |
italic | bool | ImageRenderOptions | Teks condong |
underline | bool | ImageRenderOptions | Teks bergaris bawah |
strikethrough | bool | ImageRenderOptions | Teks coret |
ImageRenderOptions
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
set_solid_fill(color) | Latar belakang pepejal; color adalah rentetan heks 8 digit AARRGGBB |
set_pattern_fill(pattern_type, fg_color, bg_color) | Isian bercorak |
set_no_fill() | Buang isian latar belakang |
MarkdownHandler
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | str | Eksport buku kerja ke rentetan Markdown dalam memori |
MarkdownSaveOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
default_alignment | str | kiri | Penjajaran lajur: kiri, kanan, atau tengah |
include_worksheet_name | bool | ImageRenderOptions | Sama ada untuk menyertakan nama helaian sebagai tajuk |
header_level | int | 2 | Tahap tajuk Markdown (1-6) |
worksheet_index | int | 0 | Indeks helaian untuk dieksport; -1 mengeksport semua helaian |
ChartCollection
Carta ditambah menggunakan kaedah khusus mengikut jenis. Indeks baris dan lajur adalah berdasarkan sifar.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambah carta lajur (palang menegak) |
add_line(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambah carta garisan |
add_pie(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambah carta pai |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
title | str | Tajuk carta sebagai rentetan biasa (bukan .title.text) |
category_data | str | Julat sel untuk label kategori paksi-x |
n_series | NSeries | Koleksi siri data |
show_legend | bool | Sama ada untuk memaparkan legenda |
legend_position | str | Kedudukan legenda: kanan, bawah, kiri, atau atas |
NSeries
| ImageRenderOptions | ImageRenderOptions |
|---|---|
add(data_range, category_data=None, name=None) | Tambah siri data bernama |
Enumerasi SaveFormat
| ImageRenderOptions | Format Output |
|---|---|
SaveFormat.XLSX | Excel Open XML (lalai) |
SaveFormat.CSV | Nilai dipisahkan koma |
SaveFormat.TSV | Nilai dipisahkan tab |
SaveFormat.MARKDOWN | Jadual Markdown |
SaveFormat.JSON | data berstruktur JSON |
ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, dan SaveFormat.PPTX adalah tidak tersedia dalam Aspose.Cells FOSS. Format-format ini memerlukan komersial aspose-cells-python pakej.
Contoh Kod
Cipta, gayakan, dan simpan buku kerja
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")Eksport ke Markdown dalam memori
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)Bina carta garisan
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")Sumber Berkaitan
- Panduan Pembangun: Tutorial untuk semua ciri teras
- Mula Menggunakan / Pemasangan: pip install dan persediaan
- Pangkalan Pengetahuan: Panduan cara-cara berorientasikan tugasan
- Gambaran Keseluruhan Produk: Ringkasan ciri dan keupayaan
- Repositori GitHub
- Blog: Memperkenalkan Aspose.Cells FOSS: Gambaran keseluruhan perpustakaan dan permulaan cepat