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, ProtectionStyle()Kreira podrazumevani Style bez primenjenog eksplicitnog formatiranja.
font | Font | Podešavanja fonta (ime, veličina, boja, podebljano, kurziv, podvučeno, precrtano). | |
fill | Fill | Podešavanja popunjavanja/pozadine ćelije (šablon, boja prednjeg plana, boja pozadine). | |
borders | Borders | Sva podešavanja ivica za ćeliju (gornja, donja, leva, desna, dijagonalna). | |
alignment | Alignment | Podešavanja poravnanja teksta (horizontalno, vertikalno, prelamanje, uvlačenje, rotacija). | |
number_format | str | Čitanje/Pisanje | Aktivni niz koda formata broja (npr., "#,##0.00"). |
protection | Protection | Podešavanja zaštite ćelije (zaključano, formula sakrivena). |
copy
style.copy() -> StyleVrać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)name | str | Naziv porodice fonta (npr., "Calibri", "Arial"). |
size | `int | float` |
color | str | Boja fonta kao RRGGBB heksadecimalni string (npr., "FF0000" za crvenu). |
bold | bool | True za primenu podebljanog stila. |
italic | bool | True za primenu kurzivnog stila. |
underline | bool | True za primenu jednostrukog podvlačenja. |
strikethrough | bool | True za primenu precrtavanja. |
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')pattern_type | str | Tip šablona popunjavanja (npr., 'solid', 'none', 'darkGray'). |
foreground_color | str | Boja prednjeg sloja kao RRGGBB heks. |
background_color | str | Boja 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_style | str | Stil linije ivice: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Boja ivice kao RRGGBB heks. |
weight | int | Debljina ivice (debljina) kao ceo broj. |
Borders()Kontejner za sve četiri ivice ćelije plus dijagonalne ivice.
top | Border | Podešavanja gornje ivice. |
bottom | Border | Podešavanja donje ivice. |
left | Border | Podešavanja leve ivice. |
right | Border | Podešavanja desne ivice. |
diagonal | Border | Podešavanja dijagonalne ivice. |
diagonal_up | bool | True za crtanje dijagonalne linije prema gore. |
diagonal_down | bool | True za crtanje dijagonalne linije prema dole. |
Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)horizontal | str | Horizontalno poravnanje: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Vertikalno poravnanje: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True za prelamanje teksta unutar ćelije. |
indent | int | Nivo uvlačenja (0–15). |
text_rotation | int | Rotacija teksta u stepenima (0–180 ili 255 za naslagano). |
shrink_to_fit | bool | True 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) -> strVrać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) -> boolTrue ako dati kod formata odgovara poznatom ugrađenom Excel formatu.lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneVraća ugrađeni ID formata za string koda formata, ili None ako kod nije ugrađeni format.
Protection(locked=True, hidden=False)locked | bool | True znači da je ćelija zaključana kada je zaštita radnog lista uključena (podrazumevano). |
hidden | bool | True 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")