Style — Aspose.Cells FOSS for Python API Reference

Style klasa i njezini prateći tipovi kontroliraju sve vizualne i zaštitne formate primijenjene na ćelije u aspose-cells-foss. A Style objekt se dobiva iz ćelije putem cell.get_style() i ponovno primijenjen s cell.apply_style(style).

: aspose.cells_foss

from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, Protection

Style()

Stvara zadani Style bez eksplicitnog formatiranja.

fontFont
Postavke fonta (ime, veličina, boja, podebljano, kurziv, podcrtano, precrtano).
fillFill
Postavke ispune/pozadine ćelije (uzorak, boja prednjeg plana, boja pozadine).
bordersBorders
Sve postavke rubova za ćeliju (gornji, donji, lijevi, desni, dijagonalni).
alignmentAlignment
Postavke poravnavanja teksta (horizontalno, vertikalno, prelamanje, uvlačenje, rotacija).
number_formatstrČitanje/PisanjeAktivni niz koda formata broja (npr., "#,##0.00").
protectionProtection
Postavke zaštite ćelije (zaključano, formula skrivena).

copy

style.copy() -> Style

Vraća duboku kopiju ovog style objekta.

set_fill_color

style.set_fill_color(color: str)

Postavlja jednobojnu boju pozadine. color je RRGGBB heksadecimalni niz (npr., "FFFF00" za žutu).

set_fill_pattern

style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')

Postavlja uzorak ispune. pattern_type vrijednosti uključuju '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()

Uklanja svaku ispunu, postavljajući pozadinu ćelije na prozirno (bez ispune).

set_border_color

style.set_border_color(side: str, color: str)

Postavlja boju jedne stranice okvira. side mora biti jedna od 'top', 'bottom', 'left', 'right', 'diagonal'. color je RRGGBB heksadecimalni niz.

set_border_style

style.set_border_style(side: str, style: str)

Postavlja stil linije stranice okvira. style vrijednosti: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

style.set_border_weight(side: str, weight: int)

Postavlja debljinu (debljinu) linije rubne strane kao cijeli broj.

set_border

style.set_border(side: str, line_style='none', color='FF000000', weight=1)

Pogodna metoda koja u jednom pozivu postavlja stil linije, boju i debljinu za pojedinu rubnu stranu.

set_diagonal_border

style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)

Postavlja dijagonalni okvir. Proslijedite up=True za dijagonalnu liniju prema gore, down=True za dijagonalnu liniju prema dolje, ili oba za crtanje križa.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Postavlja vodoravno poravnanje teksta. Vrijednosti: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Postavlja okomito poravnanje teksta. Vrijednosti: 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

Omogućuje ili onemogućuje prelamanje teksta unutar ćelije.

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Omogućuje ili onemogućuje shrink-to-fit. Kada je omogućeno, tekst se smanjuje kako bi odgovarao širini ćelije.

set_indent

style.set_indent(indent: int)

Postavlja razinu uvlačenja (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Postavlja rotaciju teksta u stupnjevima. Valjane vrijednosti su 0–180 (suprotno od kazaljke na satu od 0°) ili 255 (vertikalni tekst složen odozgo prema dolje).

set_reading_order

style.set_reading_order(order: int)

Postavlja redoslijed čitanja. 0 = ovisi o kontekstu, 1 = s lijeva na desno, 2 = s desna na lijevo.

set_number_format

style.set_number_format(format_code: str)

Primjenjuje prilagođeni niz formata broja (npr., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Primjenjuje jedan od ugrađenih formata broja u Excelu prema njegovom cijelom ID-u (npr., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

Označava ćeliju kao zaključanu. Zaključane ćelije ne mogu se uređivati kada je zaštita radnog lista aktivna.

set_formula_hidden

style.set_formula_hidden(hidden=True)

Skriva formule iz trake formula kada je zaštita radnog lista aktivna.


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

namestrNaziv obitelji fonta (npr., "Calibri", "Arial").
size`intfloat`
colorstrBoja fonta kao RRGGBB heksadecimalni niz (npr., "FF0000" za crvenu).
boldboolTrue za primjenu podebljanog stila.
italicboolTrue za primjenu kurzivnog stila.
underlineboolTrue za primjenu jednostrukog podcrtavanja.
strikethroughboolTrue za primjenu precrtavanja.

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

pattern_typestrVrsta uzorka ispune (npr., 'solid', 'none', 'darkGray').
foreground_colorstrBoja prednjeg sloja kao RRGGBB hex.
background_colorstrBoja pozadine kao RRGGBB hex.

set_solid_fill

fill.set_solid_fill(color: str)

Primjenjuje jednolitno ispunu s navedenom RRGGBB bojom.

set_gradient_fill

fill.set_gradient_fill(start_color: str, end_color: str)

Primjenjuje gradijentno ispunu s dva boja.

set_pattern_fill

fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)

Primjenjuje uzorkovitu ispunu s eksplicitnim bojama prednjeg plana i pozadine.

set_no_fill

fill.set_no_fill()

Uklanja svaku ispunu iz ćelije.


Border(line_style='none', color='FF000000', weight=1)

line_stylestrStil linije obruba: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
colorstrBoja obruba kao RRGGBB hex.
weightintDebljina obruba (debljina) kao cijeli broj.

Borders()

Kontejner za sva četiri rubova ćelije plus dijagonalne rubove.

topBorderPostavke gornjeg obruba.
bottomBorderPostavke donjeg obruba.
leftBorderPostavke lijevog obruba.
rightBorderPostavke desnog obruba.
diagonalBorderPostavke dijagonalnog obruba.
diagonal_upboolTrue za crtanje dijagonalne linije prema gore.
diagonal_downboolTrue za crtanje dijagonalne linije prema dolje.

Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)

horizontalstrVodoravno poravnanje: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
verticalstrOkomito poravnanje: 'top', 'center', 'bottom', 'justify', 'distributed'.
wrap_textboolTrue za prelamanje teksta unutar ćelije.
indentintRazina uvlake (0–15).
text_rotationintRotacija teksta u stupnjevima (0–180 ili 255 za složeno).
shrink_to_fitboolTrue za smanjivanje teksta da stane u ćeliju.

NumberFormat

NumberFormat je pomoćna klasa koja sadrži samo statičke metode. Ne instancira se izravno.

Statičke metode

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Vraća niz koda formata za zadani ugrađeni ID formata (npr., NumberFormat.get_builtin_format(9) vraća "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

True ako se zadani kod formata podudara s poznatim ugrađenim Excel formatom.

lookup_builtin_format

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

Vraća ugrađeni ID formata za niz koda formata, ili None ako kod nije ugrađeni format.


Protection(locked=True, hidden=False)

lockedboolTrue znači da je ćelija zaključana kada je zaštita radnog lista uključena (zadano).
hiddenboolTrue znači da je bilo koja formula u ćeliji skrivena u traci formule kada je zaštita radnog lista uključena.

Sljedeći primjer stilizira zaglavlje ćelije s podebljanim crvenim tekstom, žutom pozadinom i tankim crnim rubom sa svih strana.

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")

Vidi također

 Hrvatski