Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style az osztály és társ típusai szabályozzák a cellákra alkalmazott összes vizuális és védelmi formázást az aspose-cells-foss-ban. A Style objektum egy cellából szerezhető meg a következővel via cell.get_style() és visszaalkalmazható a következővel cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Létrehoz egy alapértelmezett Style kifejezett formázás nélkül.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Betűtípus beállítások (név, méret, szín, félkövér, dőlt, aláhúzás, áthúzás). |
fill | Fill | ImageRenderOptions | Cellárazás/háttér beállítások (minta, előtér szín, háttér szín). |
borders | Borders | ImageRenderOptions | A cella összes szegély beállítása (felső, alsó, bal, jobb, átlós). |
alignment | Alignment | ImageRenderOptions | Szövegigazítás beállítások (vízszintes, függőleges, sortörés, behúzás, forgatás). |
number_format | str | Olvasás/Írás | Az aktív számformátum kódsztring (például,., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Cellavédelem beállítások (zárolt, képlet rejtett). |
ImageRenderOptions
copy
style.copy() -> StyleVisszaadja ennek a stílusobjektumnak a mélymásolatát.
set_fill_color
style.set_fill_color(color: str)Beállítja az egyszínű kitöltés háttérszínét. color egy RRGGBB hexadecimális karakterlánc (például,., "FFFF00" a sárga színhez).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Beállít egy mintás kitöltést. pattern_type az értékek a következők '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()Eltávolítja a kitöltést, a cella háttérét átlátszóvá (nincs kitöltés) állítja.
set_border_color
style.set_border_color(side: str, color: str)Beállítja egyetlen keretoldal színét. side az alábbiak közül kell legyen 'top', 'bottom', 'left', 'right', 'diagonal'. color egy RRGGBB hexadecimális karakterlánc.
set_border_style
style.set_border_style(side: str, style: str)Beállítja a szegély oldalának vonalstílusát. style értékek: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Beállítja a szegély oldal vonalvastagságát (vastagságát) egész számként.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Kényelmi metódus, amely egy hívásban beállítja a vonalstílust, színt és vastagságot egyetlen szegély oldalra.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Beállítja az átlós szegélyt. Adja meg a up=True felfelé irányuló átlóhoz, down=True lefelé irányuló átlóhoz, vagy mindkettőt a kereszt rajzolásához.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Beállítja a vízszintes szövegigazítást. Értékek: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Beállítja a függőleges szövegigazítást. Értékek: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Engedélyezi vagy letiltja a szöveg tördelését a cellán belül.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Engedélyezi vagy letiltja a kicsinyítést, hogy illeszkedjen. Ha engedélyezve van, a szöveg le lesz kicsinyítve, hogy illeszkedjen a cella szélességéhez.
set_indent
style.set_indent(indent: int)Beállítja a behúzás szintjét (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Beállítja a szöveg forgását fokban. Érvényes értékek: 0–180 (0°-tól óramutató járásával ellentétesen) vagy 255 (függőleges szöveg, felülről lefelé halmozva).
set_reading_order
style.set_reading_order(order: int)Beállítja az olvasási sorrendet. 0 = kontextustól függő, 1 = balról jobbra, 2 = jobbról balra.
set_number_format
style.set_number_format(format_code: str)Alkalmaz egy egyéni számformátum karakterláncot (például,., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)Alkalmazza az Excel beépített számformátumai közül az egyikét az egész szám azonosítója alapján (például,., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)A cellát zároltként jelöli. A zárolt cellákat nem lehet szerkeszteni, ha a munkalap védelem aktív.
set_formula_hidden
style.set_formula_hidden(hidden=True)Elrejti a képleteket a képletsorból, ha a munkalap védelem aktív.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Betűcsalád neve (például,., "Calibri", "Arial"). |
size | `int | float` |
color | str | Betűszín RRGGBB hexadecimális karakterláncként (például,., "FF0000" vörösre). |
bold | bool | True a félkövér súly alkalmazásához. |
italic | bool | True a dőlt stílus alkalmazásához. |
underline | bool | True az egyszeres aláhúzás alkalmazásához. |
strikethrough | bool | True a szöveg áthúzásához. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | Kitöltési minta típusa (pl., 'solid', 'none', 'darkGray'). |
foreground_color | str | Előtér szín RRGGBB hexadecimális formátumban. |
background_color | str | Háttér szín RRGGBB hexadecimális formátumban. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Alkalmaz egy egyszínű kitöltést a megadott RRGGBB színnel.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Alkalmaz egy két színű színátmenetes kitöltést.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Minta kitöltést alkalmaz kifejezett előtér- és háttérszínekkel.
set_no_fill
fill.set_no_fill()Eltávolítja a cella bármely kitöltését.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | Szegély vonal stílusa: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Szegély szín RRGGBB hexadecimális formátumban. |
weight | int | Szegély vastagsága (súlya) egész számként. |
ImageRenderOptions
ImageRenderOptions
Borders()Egy tároló az összes négy cellaszegélyhez, valamint az átlós szegélyekhez.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Felső szegély beállításai. |
bottom | Border | Alsó szegély beállításai. |
left | Border | Bal szegély beállításai. |
right | Border | Jobb szegély beállításai. |
diagonal | Border | Átlós szegély beállításai. |
diagonal_up | bool | True az emelkedő átló vonal megrajzolásához. |
diagonal_down | bool | True a leereszkedő átló vonal megrajzolásához. |
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 | Vízszintes igazítás: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Függőleges igazítás: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True a szöveg sortördelése a cellában. |
indent | int | Behúzási szint (0–15). |
text_rotation | int | Szöveg forgatása fokban (0–180 vagy 255 a halmozott esetben). |
shrink_to_fit | bool | True a szöveg kicsinyítése, hogy a cellába illeszkedjen. |
NumberFormat
NumberFormat egy segédosztály, amely csak statikus metódusokat tartalmaz. Nem példányosítják közvetlenül.
Statikus metódusok
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strVisszaadja a formátumkód karakterláncot a megadott beépített formátumazonosítóhoz (például,., NumberFormat.get_builtin_format(9) visszaadja "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True ha a megadott formátumkód egyezik egy ismert beépített Excel formátummal.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneVisszaadja a beépített formátumazonosítót egy formátumkód karakterlánchoz, vagy None ha a kód nem beépített formátum.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True azt jelenti, hogy a cella zárolva van, ha a munkalap védelem be van kapcsolva (alapértelmezett). |
hidden | bool | True azt jelenti, hogy a cellában lévő bármely képlet el van rejtve a képletsorban, ha a munkalap védelem be van kapcsolva. |
ImageRenderOptions
Az alábbi példa egy fejléccellát formáz félkövér piros szöveggel, sárga háttérrel és vékony fekete szegéllyel minden oldalon.
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")