Style — Aspose.Cells FOSS for Python API Reference

Style klasa i njeni prateći tipovi kontrolišu sve vizuelne i zaštitne formatiranja primenjena na ćelije u aspose-cells-foss. A Style objekat se dobija iz ćelije putem cell.get_style() i ponovo se primenjuje pomoću cell.apply_style(style).

: aspose.cells_foss

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

Style()

Kreira podrazumevani Style bez primenjenog eksplicitnog formatiranja.

fontFont
Podešavanja fonta (ime, veličina, boja, podebljano, kurziv, podvučeno, precrtano).
fillFill
Podešavanja popunjavanja/pozadine ćelije (šablon, boja prednjeg plana, boja pozadine).
bordersBorders
Sva podešavanja ivica za ćeliju (gornja, donja, leva, desna, dijagonalna).
alignmentAlignment
Podešavanja poravnanja teksta (horizontalno, vertikalno, prelamanje, uvlačenje, rotacija).
number_formatstrČitanje/PisanjeAktivni niz koda formata broja (npr., "#,##0.00").
protectionProtection
Podešavanja zaštite ćelije (zaključano, formula sakrivena).

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 heks string (npr., "FFFF00" za žutu).

set_fill_pattern

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

Postavlja uzorak popunjavanja. pattern_type vrednosti 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 svako popunjavanje, postavljajući pozadinu ćelije na transparentnu (bez popunjavanja).

set_border_color

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

Postavlja boju jedne strane ivice. side mora biti jedna od 'top', 'bottom', 'left', 'right', 'diagonal'. color je RRGGBB heksadecimalni string.

set_border_style

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

Postavlja stil linije strane ivice. style vrednosti: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

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

Postavlja težinu linije (debljinu) strane ivice kao ceo broj.

set_border

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

Metoda za praktičnost koja postavlja stil linije, boju i debljinu za jednu stranu ivice u jednom pozivu.

set_diagonal_border

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

Postavlja dijagonalnu ivicu. Proslijedite up=True za dijagonalnu liniju prema gore, down=True za dijagonalno nadole, ili oba za crtanje krsta.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Postavlja horizontalno poravnanje teksta. Vrednosti: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Postavlja vertikalno poravnanje teksta. Vrednosti: 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

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

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Omogućava ili onemogućava smanjivanje da bi se uklopilo. Kada je omogućeno, tekst se smanjuje da bi odgovarao širini ćelije.

set_indent

style.set_indent(indent: int)

Postavlja nivo uvlačenja (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Postavlja rotaciju teksta u stepenima. Važeće vrednosti su 0–180 (suprotno od kazaljke na satu od 0°) ili 255 (vertikalni tekst složen odozgo prema dole).

set_reading_order

style.set_reading_order(order: int)

Postavlja redosled čitanja. 0 = zavisi od konteksta, 1 = s leva na desno, 2 = s desna na levo.

set_number_format

style.set_number_format(format_code: str)

Primena prilagođenog stringa za format broja (npr., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Primeni jedan od ugrađenih formata brojeva u Excelu po njegovom celobrojnom 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 da se uređuju 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 porodice fonta (npr., "Calibri", "Arial").
size`intfloat`
colorstrBoja fonta kao RRGGBB heksadecimalni string (npr., "FF0000" za crvenu).
boldboolTrue za primenu podebljanog stila.
italicboolTrue za primenu kurzivnog stila.
underlineboolTrue za primenu jednostrukog podvlačenja.
strikethroughboolTrue za primenu precrtavanja.

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

pattern_typestrTip šablona popunjavanja (npr., 'solid', 'none', 'darkGray').
foreground_colorstrBoja prednjeg sloja kao RRGGBB heks.
background_colorstrBoja pozadine kao RRGGBB heks.

set_solid_fill

fill.set_solid_fill(color: str)

Primena jednobojnog popunjavanja sa zadatom RRGGBB bojom.

set_gradient_fill

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

Primena gradijentnog popunjavanja sa dve boje.

set_pattern_fill

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

Primjenjuje uzorak popunjavanja sa eksplicitnim bojama prednjeg i pozadinskog sloja.

set_no_fill

fill.set_no_fill()

Uklanja svako popunjavanje iz ćelije.


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

line_stylestrStil linije ivice: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
colorstrBoja ivice kao RRGGBB heks.
weightintDebljina ivice (debljina) kao ceo broj.

Borders()

Kontejner za sve četiri ivice ćelije plus dijagonalne ivice.

topBorderPodešavanja gornje ivice.
bottomBorderPodešavanja donje ivice.
leftBorderPodešavanja leve ivice.
rightBorderPodešavanja desne ivice.
diagonalBorderPodešavanja dijagonalne ivice.
diagonal_upboolTrue za crtanje dijagonalne linije prema gore.
diagonal_downboolTrue za crtanje dijagonalne linije prema dole.

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

horizontalstrHorizontalno poravnanje: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
verticalstrVertikalno poravnanje: 'top', 'center', 'bottom', 'justify', 'distributed'.
wrap_textboolTrue za prelamanje teksta unutar ćelije.
indentintNivo uvlačenja (0–15).
text_rotationintRotacija teksta u stepenima (0–180 ili 255 za naslagano).
shrink_to_fitboolTrue za smanjenje teksta da stane u ćeliju.

NumberFormat

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

Statičke metode

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Vraća string koda formata za dati 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 dati kod formata odgovara poznatom ugrađenom Excel formatu.

lookup_builtin_format

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

Vraća ugrađeni ID formata za string 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 (podrazumevano).
hiddenboolTrue znači da je svaka formula u ćeliji sakrivena u traci formula kada je zaštita radnog lista uključena.

Sledeći primer stilizuje zaglavlje ćelije podebljanim crvenim tekstom, žutom pozadinom i tankom crnom ivicom 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 i

 Српски