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

ImageRenderOptions

ImageRenderOptions

Style()

Létrehoz egy alapértelmezett Style kifejezett formázás nélkül.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
fontFontImageRenderOptionsBetű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).
fillFillImageRenderOptionsCellárazás/háttér beállítások (minta, előtér szín, háttér szín).
bordersBordersImageRenderOptionsA cella összes szegély beállítása (felső, alsó, bal, jobb, átlós).
alignmentAlignmentImageRenderOptionsSzövegigazítás beállítások (vízszintes, függőleges, sortörés, behúzás, forgatás).
number_formatstrOlvasás/ÍrásAz aktív számformátum kódsztring (például,., "#,##0.00").
protectionProtectionImageRenderOptionsCellavédelem beállítások (zárolt, képlet rejtett).

ImageRenderOptions

copy

style.copy() -> Style

Visszaadja 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestrBetűcsalád neve (például,., "Calibri", "Arial").
size`intfloat`
colorstrBetűszín RRGGBB hexadecimális karakterláncként (például,., "FF0000" vörösre).
boldboolTrue a félkövér súly alkalmazásához.
italicboolTrue a dőlt stílus alkalmazásához.
underlineboolTrue az egyszeres aláhúzás alkalmazásához.
strikethroughboolTrue a szöveg áthúzásához.

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
pattern_typestrKitöltési minta típusa (pl., 'solid', 'none', 'darkGray').
foreground_colorstrElőtér szín RRGGBB hexadecimális formátumban.
background_colorstrHá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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
line_stylestrSzegély vonal stílusa: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
colorstrSzegély szín RRGGBB hexadecimális formátumban.
weightintSzegé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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
topBorderFelső szegély beállításai.
bottomBorderAlsó szegély beállításai.
leftBorderBal szegély beállításai.
rightBorderJobb szegély beállításai.
diagonalBorderÁtlós szegély beállításai.
diagonal_upboolTrue az emelkedő átló vonal megrajzolásához.
diagonal_downboolTrue 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
horizontalstrVízszintes igazítás: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
verticalstrFüggőleges igazítás: 'top', 'center', 'bottom', 'justify', 'distributed'.
wrap_textboolTrue a szöveg sortördelése a cellában.
indentintBehúzási szint (0–15).
text_rotationintSzöveg forgatása fokban (0–180 vagy 255 a halmozott esetben).
shrink_to_fitboolTrue 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) -> str

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

ImageRenderOptions 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 | None

Visszaadja 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
lockedboolTrue azt jelenti, hogy a cella zárolva van, ha a munkalap védelem be van kapcsolva (alapértelmezett).
hiddenboolTrue 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")

Lásd még

 Magyar