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, Protection

ImageRenderOptions

ImageRenderOptions

Style()

Membuat default Style tanpa pemformatan eksplisit yang diterapkan.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
fontFontImageRenderOptionsPengaturan font (nama, ukuran, warna, tebal, miring, garis bawah, coret).
fillFillImageRenderOptionsPengaturan isi/latar belakang sel (pola, warna latar depan, warna latar belakang).
bordersBordersImageRenderOptionsSemua pengaturan batas untuk sel (atas, bawah, kiri, kanan, diagonal).
alignmentAlignmentImageRenderOptionsPengaturan perataan teks (horizontal, vertikal, bungkus, indentasi, rotasi).
number_formatstrBaca/TulisString kode format angka aktif (misalnya,., "#,##0.00").
protectionProtectionImageRenderOptionsPengaturan perlindungan sel (dikunci, rumus disembunyikan).

ImageRenderOptions

copy

style.copy() -> Style

Mengembalikan 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrNama keluarga font (misalnya,., "Calibri", "Arial").
size`intfloat`
colorstrWarna font sebagai string heksadesimal RRGGBB (misalnya,., "FF0000" untuk merah).
boldboolTrue untuk menerapkan berat tebal.
italicboolTrue untuk menerapkan gaya miring.
underlineboolTrue untuk menerapkan garis bawah tunggal.
strikethroughboolTrue untuk menerapkan coret.

ImageRenderOptions

ImageRenderOptions

Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
pattern_typestrJenis pola isi (misalnya,., 'solid', 'none', 'darkGray').
foreground_colorstrWarna latar depan sebagai heks RRGGBB.
background_colorstrWarna 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
line_stylestrGaya garis batas: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
colorstrWarna border dalam format heks RRGGBB.
weightintBerat border (ketebalan) sebagai bilangan bulat.

ImageRenderOptions

ImageRenderOptions

Borders()

Kontainer untuk keempat batas sel serta batas diagonal.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
topBorderPengaturan border atas.
bottomBorderPengaturan border bawah.
leftBorderPengaturan border kiri.
rightBorderPengaturan batas kanan.
diagonalBorderPengaturan batas diagonal.
diagonal_upboolTrue untuk menggambar garis diagonal ke atas.
diagonal_downboolTrue 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
horizontalstrPerataan horizontal: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
verticalstrPerataan vertikal: 'top', 'center', 'bottom', 'justify', 'distributed'.
wrap_textboolTrue untuk membungkus teks dalam sel.
indentintTingkat indentasi (0–15).
text_rotationintRotasi teks dalam derajat (0–180 atau 255 untuk ditumpuk).
shrink_to_fitboolTrue 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) -> str

Mengembalikan 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) -> bool

ImageRenderOptions True jika kode format yang diberikan cocok dengan format Excel bawaan yang dikenal.

lookup_builtin_format

NumberFormat.lookup_builtin_format(format_code: str) -> int | None

Mengembalikan ID format bawaan untuk string kode format, atau None jika kode tersebut bukan format bawaan.


ImageRenderOptions

ImageRenderOptions

Protection(locked=True, hidden=False)

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
lockedboolTrue menandakan sel terkunci ketika perlindungan lembar kerja diaktifkan (default).
hiddenboolTrue 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")

Lihat Juga

 Bahasa Indonesia