Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style kelas dan tipe pendampingnya mengontrol semua pemformatan visual dan protektif yang diterapkan pada sel di aspose-cells-foss. A Style objek diperoleh dari sel melalui cell.get_style() dan diterapkan kembali dengan cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Membuat default Style tanpa pemformatan eksplisit yang diterapkan.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Pengaturan font (nama, ukuran, warna, tebal, miring, garis bawah, coret). |
fill | Fill | ImageRenderOptions | Pengaturan isi/latar belakang sel (pola, warna latar depan, warna latar belakang). |
borders | Borders | ImageRenderOptions | Semua pengaturan batas untuk sel (atas, bawah, kiri, kanan, diagonal). |
alignment | Alignment | ImageRenderOptions | Pengaturan perataan teks (horizontal, vertikal, bungkus, indentasi, rotasi). |
number_format | str | Baca/Tulis | String kode format angka aktif (misalnya,., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Pengaturan perlindungan sel (dikunci, rumus disembunyikan). |
ImageRenderOptions
copy
style.copy() -> StyleMengembalikan salinan mendalam dari objek style ini.
set_fill_color
style.set_fill_color(color: str)Mengatur warna latar belakang isi padat. color adalah string heks RRGGBB (misalnya,., "FFFF00" untuk kuning).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Mengatur isi berpola. pattern_type nilai meliputi 'solid', 'darkGray', 'mediumGray', 'lightGray', 'gray125', 'gray0625', 'darkHorizontal', 'darkVertical', 'darkDown', 'darkUp', 'darkGrid', 'darkTrellis', 'lightHorizontal', 'lightVertical', 'lightDown', 'lightUp', 'lightGrid', 'lightTrellis'.
set_no_fill
style.set_no_fill()Menghapus semua isian, menjadikan latar belakang sel transparan (tanpa isian).
set_border_color
style.set_border_color(side: str, color: str)Mengatur warna satu sisi border. side harus salah satu dari 'top', 'bottom', 'left', 'right', 'diagonal'. color adalah string heksadesimal RRGGBB.
set_border_style
style.set_border_style(side: str, style: str)Mengatur gaya garis sisi batas. style nilai: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Mengatur berat garis (ketebalan) sisi border sebagai integer.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Metode kemudahan yang mengatur gaya garis, warna, dan berat untuk satu sisi border dalam satu panggilan.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Mengatur batas diagonal. Berikan up=True untuk diagonal naik, down=True untuk diagonal turun, atau keduanya untuk menggambar silang.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Mengatur perataan teks horizontal. Nilai: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Mengatur perataan teks vertikal. Nilai: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Mengaktifkan atau menonaktifkan pembungkus teks di dalam sel.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Mengaktifkan atau menonaktifkan shrink-to-fit. Ketika diaktifkan, teks diperkecil agar sesuai dengan lebar sel.
set_indent
style.set_indent(indent: int)Mengatur tingkat indentasi (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Mengatur rotasi teks dalam derajat. Nilai yang valid adalah 0–180 (berlawanan arah jarum jam dari 0°) atau 255 (teks vertikal ditumpuk dari atas ke bawah).
set_reading_order
style.set_reading_order(order: int)Mengatur urutan baca. 0 = tergantung konteks, 1 = kiri-ke-kanan, 2 = kanan-ke-kiri.
set_number_format
style.set_number_format(format_code: str)Menerapkan string format angka khusus (misalnya,., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)Menerapkan salah satu format angka bawaan Excel berdasarkan ID integer‑nya (misalnya,., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)Menandai sel sebagai terkunci. Sel yang terkunci tidak dapat diedit ketika perlindungan lembar kerja aktif.
set_formula_hidden
style.set_formula_hidden(hidden=True)Menyembunyikan rumus dari bilah formula ketika perlindungan lembar kerja aktif.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Nama keluarga font (misalnya,., "Calibri", "Arial"). |
size | `int | float` |
color | str | Warna font sebagai string heksadesimal RRGGBB (misalnya,., "FF0000" untuk merah). |
bold | bool | True untuk menerapkan berat tebal. |
italic | bool | True untuk menerapkan gaya miring. |
underline | bool | True untuk menerapkan garis bawah tunggal. |
strikethrough | bool | True untuk menerapkan coret. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | Jenis pola isi (misalnya,., 'solid', 'none', 'darkGray'). |
foreground_color | str | Warna latar depan sebagai heks RRGGBB. |
background_color | str | Warna latar belakang sebagai heks RRGGBB. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Menerapkan isian padat dengan warna RRGGBB yang diberikan.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Menerapkan isian gradien dua warna.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Menerapkan isian ber pola dengan warna latar depan dan latar belakang yang eksplisit.
set_no_fill
fill.set_no_fill()Menghapus semua isian dari sel.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | Gaya garis batas: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Warna border dalam format heks RRGGBB. |
weight | int | Berat border (ketebalan) sebagai bilangan bulat. |
ImageRenderOptions
ImageRenderOptions
Borders()Kontainer untuk keempat batas sel serta batas diagonal.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Pengaturan border atas. |
bottom | Border | Pengaturan border bawah. |
left | Border | Pengaturan border kiri. |
right | Border | Pengaturan batas kanan. |
diagonal | Border | Pengaturan batas diagonal. |
diagonal_up | bool | True untuk menggambar garis diagonal ke atas. |
diagonal_down | bool | True untuk menggambar garis diagonal ke bawah. |
ImageRenderOptions
ImageRenderOptions
Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
horizontal | str | Perataan horizontal: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Perataan vertikal: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True untuk membungkus teks dalam sel. |
indent | int | Tingkat indentasi (0–15). |
text_rotation | int | Rotasi teks dalam derajat (0–180 atau 255 untuk ditumpuk). |
shrink_to_fit | bool | True untuk memperkecil teks agar sesuai dengan sel. |
NumberFormat
NumberFormat adalah kelas utilitas dengan hanya metode statis. Tidak diinstansiasi secara langsung.
Metode Statis
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strMengembalikan string kode format untuk ID format bawaan yang diberikan (misalnya,., NumberFormat.get_builtin_format(9) mengembalikan "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True jika kode format yang diberikan cocok dengan format Excel bawaan yang dikenal.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneMengembalikan ID format bawaan untuk string kode format, atau None jika kode tersebut bukan format bawaan.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True menandakan sel terkunci ketika perlindungan lembar kerja diaktifkan (default). |
hidden | bool | True menandakan setiap rumus dalam sel disembunyikan di bilah formula ketika perlindungan lembar kerja diaktifkan. |
ImageRenderOptions
Contoh berikut memberi gaya pada sel header dengan teks merah tebal, latar belakang kuning, dan batas hitam tipis di semua sisi.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].put_value("Total Revenue")
style = ws.cells["A1"].get_style()
# Bold red font
style.font.bold = True
style.font.color = "FF0000" # red
style.font.size = 13
# Yellow solid fill
style.set_fill_color("FFFF00")
# Thin black border on all four sides
for side in ("top", "bottom", "left", "right"):
style.set_border(side, line_style="thin", color="000000", weight=1)
# Center the text
style.set_horizontal_alignment("center")
ws.cells["A1"].apply_style(style)
wb.save("styled.xlsx")