Aspose.Cells FOSS for Python
Informasi Paket
| paket PyPI | aspose-cells-foss |
| Python impor | from aspose.cells_foss import ... |
| ImageRenderOptions | 26.3.1 |
| ImageRenderOptions | MIT |
| Python persyaratan | >= 3.7 |
| ImageRenderOptions | pycryptodome>=3.15.0, olefile>=0.46 |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
| aspose.cells_foss | API spreadsheet inti: workbooks, worksheets, cells, styles, charts, format handlers |
ImageRenderOptions: Tidak ada aspose.pydrawing modul dalam Aspose.Cells FOSS. Warna diekspresikan sebagai string heksadesimal 8-digit AARRGGBB (misalnya,., "FFFF0000" untuk merah pekat).
aspose.cells_foss
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Workbook | workbook | Titik masuk untuk membuat, memuat, dan menyimpan file spreadsheet |
Worksheet | worksheet | Mewakili satu lembar; menyediakan akses ke cells, charts, dan pictures |
Cells | cells | Koleksi mirip kamus dari Cell objek dalam sebuah Worksheet |
Cell | cell | Mewakili sel individu; nilai, rumus, dan gaya |
Style | gaya | Pemformatan sel: font, fill, borders, alignment, number format, protection |
Font | gaya | Properti font: nama, ukuran, warna, tebal, miring, garis bawah, coret |
Fill | gaya | Pengisian latar belakang: padat, gradasi, atau pola |
NumberFormat | gaya | Utilitas pencarian format angka bawaan |
SaveFormat | buku kerja | Enumerasi format output yang didukung (XLSX, CSV, MARKDOWN, JSON) |
Chart | grafik | Mewakili grafik yang disematkan dalam lembar kerja |
ChartType | grafik | Enum: LINE, BAR, PIE, AREA, STOCK, dan lainnya |
NSeries | grafik | Koleksi seri data pada grafik |
ChartSeries | grafik | Satu seri data dengan nilai, kategori, dan batang kesalahan |
ChartAxis | grafik | Pengaturan sumbu: skala, format, judul |
ChartView3D | grafik | 3D rotation and perspective settings |
ChartErrorBars | grafik | Konfigurasi batang kesalahan untuk satu seri |
DataValidation | data-validation | Aturan validasi tunggal pada rentang sel |
DataValidationCollection | data-validation | Semua aturan validasi untuk lembar kerja |
DataValidationType | data-validation | Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM |
DataValidationOperator | validasi-data | Enum: BETWEEN, EQUAL, GREATER_THAN, etc. |
DataValidationAlertStyle | validasi-data | Enum: STOP, WARNING, INFORMATION |
CSVHandler | csv-handler | Metode statis untuk impor/ekspor CSV |
CSVLoadOptions | csv-handler | Opsi untuk memuat file CSV |
CSVSaveOptions | csv-handler | Opsi untuk menyimpan file CSV |
MarkdownHandler | markdown-handler | Metode statis untuk ekspor Markdown |
MarkdownSaveOptions | markdown-handler | Opsi untuk ekspor Markdown |
JsonHandler | json-handler | Metode statis untuk ekspor JSON |
JsonSaveOptions | json-handler | Opsi untuk ekspor JSON |
Shape | bentuk | Menggambar bentuk dengan isian, garis, teks, dan pemformatan font |
ShapeCollection | bentuk | Semua bentuk dalam lembar kerja (ws.shapes) |
MsoDrawingType | bentuk | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, dll. |
Table | tabel | Tabel Excel (referensi terstruktur) dalam lembar kerja |
TableCollection | tabel | Semua tabel dalam lembar kerja (ws.list_objects) |
TableColumn | tabel | Definisi kolom dalam sebuah Tabel |
TableStyleInfo | tabel | Pengaturan gaya visual untuk Tabel |
SparklineGroup | sparkline | Kelompok grafik sparkline yang berbagi gaya visual |
SparklineGroupCollection | sparkline | Semua grup sparkline (ws.sparkline_groups) |
Sparkline | sparkline | Sebuah sel sparkline tunggal yang terhubung ke rentang data |
SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
HorizontalPageBreakCollection | page-break | Pemutusan halaman horizontal manual (ws.horizontal_page_breaks) |
VerticalPageBreakCollection | page-break | Pemutusan halaman vertikal manual (ws.vertical_page_breaks) |
AgileEncryptionParameters | enkripsi | parameter enkripsi AES-256/SHA-512 (direkomendasikan) |
StandardEncryptionParameters | enkripsi | Parameter enkripsi Legacy AES-128/SHA-1 |
CipherAlgorithm | enkripsi | Enum: AES_128, AES_192, AES_256 |
HashAlgorithm | enkripsi | Enum: SHA1, SHA256, SHA384, SHA512 |
ImageRenderOptions
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Workbook() | Buat buku kerja baru yang kosong (format XLSX) |
Workbook(file_path: str) | Muat buku kerja dari jalur file |
Workbook(file_path: str, password: str) | Muat buku kerja yang dilindungi kata sandi |
Properti Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
worksheets | daftar | Akses lembar kerja berdasarkan indeks: workbook.worksheets[0] |
Metode Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
save(file_path) | ImageRenderOptions | Simpan ke file; format diperkirakan dari ekstensi |
save(file_path, save_format) | ImageRenderOptions | Simpan dengan SaveFormat eksplisit |
save_as_csv(file_path, options=None) | ImageRenderOptions | Simpan sebagai CSV |
save_as_markdown(file_path, options=None) | ImageRenderOptions | Simpan sebagai tabel 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 | Tambahkan lembar kerja baru |
get_worksheet(index_or_name) | ImageRenderOptions | Dapatkan lembar kerja berdasarkan indeks atau nama |
remove_worksheet(index_or_name) | ImageRenderOptions | Hapus lembar kerja |
copy_worksheet(index_or_name_or_ws) | ImageRenderOptions | Salin lembar kerja yang ada |
protect(password=None, lock_structure=True) | ImageRenderOptions | Lindungi buku kerja dengan kata sandi |
unprotect(password=None) | ImageRenderOptions | Hapus perlindungan buku kerja |
is_protected() | bool | Periksa apakah workbook dilindungi |
ImageRenderOptions
Properti Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Nama tab lembar kerja |
cells | ImageRenderOptions | Semua sel di lembar kerja ini |
charts | ChartCollection | Semua grafik dalam lembar kerja ini |
ImageRenderOptions
Cells mendukung akses bergaya kamus dengan string alamat sel.
Pola 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) | Buat sel dengan nilai (int, float, str, atau None) |
Cell(value, formula) | Buat sel formula (nilai biasanya None) |
Properti Utama
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
value | ImageRenderOptions | Nilai sel (str, int, float, atau None) |
formula | str | String formula (misalnya,., "=SUM(A1:A5)") |
style | ImageRenderOptions | Gaya sel (font, isi) |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
font | ImageRenderOptions | Pengaturan font untuk gaya ini |
fill | ImageRenderOptions | Pengaturan isi latar belakang |
ImageRenderOptions
Warna dinyatakan sebagai 8-digit AARRGGBB hex strings tanpa # awalan. Contoh: "FFFF0000" = merah pekat, "FF0000FF" = biru pekat, "FF000000" = hitam.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
name | str | ImageRenderOptions | Nama keluarga font |
size | float | 11 | Ukuran font dalam poin |
color | str | FF000000 | 8-digit AARRGGBB hex color string |
bold | bool | ImageRenderOptions | Teks tebal |
italic | bool | ImageRenderOptions | Teks miring |
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 solid; color adalah string heksadesimal 8 digit AARRGGBB |
set_pattern_fill(pattern_type, fg_color, bg_color) | Isian berpola |
set_no_fill() | Hapus isian latar belakang |
MarkdownHandler
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
MarkdownHandler.save_markdown_to_string(workbook) | str | Ekspor buku kerja ke string Markdown dalam memori |
MarkdownSaveOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
default_alignment | str | kiri | Perataan kolom: kiri, kanan, atau tengah |
include_worksheet_name | bool | ImageRenderOptions | Apakah menyertakan nama lembar sebagai judul |
header_level | int | 2 | Tingkat judul Markdown (1-6) |
worksheet_index | int | 0 | Indeks lembar untuk diekspor; -1 mengekspor semua lembar |
ChartCollection
Diagram ditambahkan menggunakan metode khusus per-jenis. Indeks baris dan kolom adalah berbasis nol.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
add_bar(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambahkan diagram kolom (batang vertikal) |
add_line(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambahkan diagram garis |
add_pie(top_row, left_col, bottom_row, right_col) | ImageRenderOptions | Tambahkan diagram lingkaran |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
title | str | Judul diagram sebagai string biasa (bukan .title.text) |
category_data | str | Rentang sel untuk label kategori sumbu x |
n_series | NSeries | Koleksi seri data |
show_legend | bool | Apakah menampilkan legenda |
legend_position | str | Posisi legenda: kanan, bawah, kiri, atau atas |
NSeries
| ImageRenderOptions | ImageRenderOptions |
|---|---|
add(data_range, category_data=None, name=None) | Tambahkan seri data bernama |
Enumerasi SaveFormat
| ImageRenderOptions | Format Output |
|---|---|
SaveFormat.XLSX | Excel Open XML (default) |
SaveFormat.CSV | Nilai yang dipisahkan koma |
SaveFormat.TSV | Nilai yang dipisahkan tab |
SaveFormat.MARKDOWN | Tabel Markdown |
SaveFormat.JSON | Data terstruktur JSON |
ImageRenderOptions: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, dan SaveFormat.PPTX adalah tidak tersedia di Aspose.Cells FOSS. Format-format ini memerlukan versi komersial aspose-cells-python paket.
Contoh Kode
Buat, beri gaya, dan simpan 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")Ekspor 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)Buat diagram garis
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 Daya Terkait
- Panduan Pengembang: Tutorial untuk semua fitur inti
- Memulai / Instalasi: pip install dan penyiapan
- Basis Pengetahuan: Panduan cara-cara berorientasi tugas
- Ikhtisar Produk: Ringkasan fitur dan kemampuan
- Repositori GitHub
- Blog: Memperkenalkan Aspose.Cells FOSS: Ikhtisar perpustakaan dan memulai cepat