Aspose.Cells FOSS for Python

Maklumat Pakej

Pakej PyPIaspose-cells-foss
Python importfrom aspose.cells_foss import ...
ImageRenderOptions26.3.1
ImageRenderOptionsMIT
Python keperluan>= 3.7
ImageRenderOptionspycryptodome>=3.15.0, olefile>=0.46

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
aspose.cells_fossAPI 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
WorkbookworkbookTitik masuk untuk membuat, memuatkan, dan menyimpan fail spreadsheet
WorksheetworksheetMewakili satu helaian; menyediakan akses kepada cells, charts, dan gambar
CellscellsKoleksi seperti kamus bagi Cell objek dalam satu Worksheet
CellcellMewakili sel individu; nilai, formula, dan gaya
StylegayaPemformatan sel: font, isi, sempadan, penjajaran, format nombor, perlindungan
FontgayaCiri fon: nama, saiz, warna, tebal, condong, garis bawah, garis coret
FillgayaIsian latar belakang: pepejal, gradien, atau corak
NumberFormatgayaUtiliti carian format nombor terbina dalam
SaveFormatbuku kerjaEnumerasi format output yang disokong (XLSX, CSV, MARKDOWN, JSON)
ChartcartaMewakili carta yang disematkan dalam lembar kerja
ChartTypecartaEnum: LINE, BAR, PIE, AREA, STOCK, dan lain-lain
NSeriescartaKoleksi siri data pada carta
ChartSeriescartaSatu siri data dengan nilai, kategori, dan bar ralat
ChartAxiscartaTetapan paksi: skala, format, tajuk
ChartView3Dcarta3D rotation and perspective settings
ChartErrorBarscartaKonfigurasi bar ralat untuk satu siri
DataValidationdata-validationPeraturan pengesahan tunggal pada julat sel
DataValidationCollectiondata-validationSemua peraturan pengesahan untuk lembar kerja
DataValidationTypedata-validationEnum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
DataValidationOperatordata-validationEnum: BETWEEN, EQUAL, GREATER_THAN, dll.
DataValidationAlertStyledata-validationEnum: STOP, WARNING, INFORMATION
CSVHandlercsv-handlerKaedah statik untuk import/eksport CSV
CSVLoadOptionscsv-handlerPilihan untuk memuatkan fail CSV
CSVSaveOptionscsv-handlerPilihan untuk menyimpan fail CSV
MarkdownHandlermarkdown-handlerKaedah statik untuk eksport Markdown
MarkdownSaveOptionsmarkdown-handlerPilihan untuk eksport Markdown
JsonHandlerjson-handlerKaedah statik untuk eksport JSON
JsonSaveOptionsjson-handlerPilihan untuk eksport JSON
ShapebentukMelukis bentuk dengan isian, garis, teks, dan pemformatan fon
ShapeCollectionbentukSemua bentuk dalam lembar kerja (ws.shapes)
MsoDrawingTypebentukEnum: RECTANGLE, OVAL, TEXT_BOX, ARROW, dll.
TablejadualJadual Excel (rujukan berstruktur) dalam lembar kerja
TableCollectionjadualSemua jadual dalam lembar kerja (ws.list_objects)
TableColumnjadualDefinisi lajur dalam Jadual
TableStyleInfojadualTetapan gaya visual untuk Jadual
SparklineGroupsparklineKumpulan carta sparkline yang berkongsi gaya visual
SparklineGroupCollectionsparklineSemua kumpulan sparkline (ws.sparkline_groups)
SparklinesparklineSatu sel sparkline tunggal yang dipautkan kepada julat data
SparklineTypesparklineEnum: LINE, COLUMN, WIN_LOSS
HorizontalPageBreakCollectionhentian halamanHentian halaman mendatar manual (ws.horizontal_page_breaks)
VerticalPageBreakCollectionhentian halamanHentian halaman menegak manual (ws.vertical_page_breaks)
AgileEncryptionParameterspenyulitanparameter penyulitan AES-256/SHA-512 (disarankan)
StandardEncryptionParameterspenyulitanparameter penyulitan Legacy AES-128/SHA-1
CipherAlgorithmpenyulitanEnum: AES_128, AES_192, AES_256
HashAlgorithmpenyulitanEnum: SHA1, SHA256, SHA384, SHA512

ImageRenderOptions

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
worksheetssenaraiAkses helaian kerja mengikut indeks: workbook.worksheets[0]

Kaedah Utama

ImageRenderOptionsImageRenderOptionsImageRenderOptions
save(file_path)ImageRenderOptionsSimpan ke fail; format ditentukan daripada sambungan
save(file_path, save_format)ImageRenderOptionsSimpan dengan SaveFormat yang jelas
save_as_csv(file_path, options=None)ImageRenderOptionsSimpan sebagai CSV
save_as_markdown(file_path, options=None)ImageRenderOptionsSimpan sebagai jadual Markdown
save_as_json(file_path, options=None)ImageRenderOptionsSimpan sebagai JSON
load_csv(file_path, options=None)ImageRenderOptionsMuat data CSV ke dalam buku kerja
add_worksheet(name=None)ImageRenderOptionsTambah helaian kerja baru
get_worksheet(index_or_name)ImageRenderOptionsDapatkan helaian kerja mengikut indeks atau nama
remove_worksheet(index_or_name)ImageRenderOptionsBuang helaian kerja
copy_worksheet(index_or_name_or_ws)ImageRenderOptionsSalin helaian kerja yang sedia ada
protect(password=None, lock_structure=True)ImageRenderOptionsLindungi buku kerja dengan kata laluan
unprotect(password=None)ImageRenderOptionsBuang perlindungan buku kerja
is_protected()boolSemak sama ada buku kerja dilindungi

ImageRenderOptions

Sifat Utama

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrNama tab helaian kerja
cellsImageRenderOptionsSemua sel dalam helaian kerja ini
chartsChartCollectionSemua 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 cell

ImageRenderOptions

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
Cell(value=None)Cipta sel dengan nilai (int, float, str, atau None)
Cell(value, formula)Cipta sel formula (nilai biasanya None)

Sifat Utama

ImageRenderOptionsImageRenderOptionsImageRenderOptions
valueImageRenderOptionsNilai sel (str, int, float, atau None)
formulastrRentetan formula (contoh,., "=SUM(A1:A5)")
styleImageRenderOptionsGaya sel (fon, isi)

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
fontImageRenderOptionsTetapan fon untuk gaya ini
fillImageRenderOptionsTetapan isi latar belakang

ImageRenderOptions

Warna dinyatakan sebagai 8-digit AARRGGBB hex strings tanpa # awalan. Contoh: "FFFF0000" = merah legap, "FF0000FF" = biru legap, "FF000000" = hitam.

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrImageRenderOptionsNama keluarga fon
sizefloat11Saiz fon dalam mata
colorstrFF0000008-digit AARRGGBB hex color string
boldboolImageRenderOptionsTeks tebal
italicboolImageRenderOptionsTeks condong
underlineboolImageRenderOptionsTeks bergaris bawah
strikethroughboolImageRenderOptionsTeks coret

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptionsImageRenderOptions
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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
MarkdownHandler.save_markdown_to_string(workbook)strEksport buku kerja ke rentetan Markdown dalam memori

MarkdownSaveOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
default_alignmentstrkiriPenjajaran lajur: kiri, kanan, atau tengah
include_worksheet_nameboolImageRenderOptionsSama ada untuk menyertakan nama helaian sebagai tajuk
header_levelint2Tahap tajuk Markdown (1-6)
worksheet_indexint0Indeks helaian untuk dieksport; -1 mengeksport semua helaian

ChartCollection

Carta ditambah menggunakan kaedah khusus mengikut jenis. Indeks baris dan lajur adalah berdasarkan sifar.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
add_bar(top_row, left_col, bottom_row, right_col)ImageRenderOptionsTambah carta lajur (palang menegak)
add_line(top_row, left_col, bottom_row, right_col)ImageRenderOptionsTambah carta garisan
add_pie(top_row, left_col, bottom_row, right_col)ImageRenderOptionsTambah carta pai

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
titlestrTajuk carta sebagai rentetan biasa (bukan .title.text)
category_datastrJulat sel untuk label kategori paksi-x
n_seriesNSeriesKoleksi siri data
show_legendboolSama ada untuk memaparkan legenda
legend_positionstrKedudukan legenda: kanan, bawah, kiri, atau atas

NSeries

ImageRenderOptionsImageRenderOptions
add(data_range, category_data=None, name=None)Tambah siri data bernama

Enumerasi SaveFormat

ImageRenderOptionsFormat Output
SaveFormat.XLSXExcel Open XML (lalai)
SaveFormat.CSVNilai dipisahkan koma
SaveFormat.TSVNilai dipisahkan tab
SaveFormat.MARKDOWNJadual Markdown
SaveFormat.JSONdata 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

 Bahasa Melayu