Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style klass och dess komplementära typer styr all visuell och skyddande formatering som tillämpas på celler i aspose-cells-foss. En Style objekt erhålls från en cell via cell.get_style() och appliceras tillbaka med cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Skapar en standard Style utan någon explicit formatering tillämpad.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Teckensnittsinställningar (namn, storlek, färg, fet, kursiv, understruken, genomstruken). |
fill | Fill | ImageRenderOptions | Cellfyllnings-/bakgrundsinställningar (mönster, förgrundsfärg, bakgrundsfärg). |
borders | Borders | ImageRenderOptions | Alla kantinställningar för cellen (övre, nedre, vänster, höger, diagonal). |
alignment | Alignment | ImageRenderOptions | Textjusteringsinställningar (horisontell, vertikal, radbrytning, indrag, rotation). |
number_format | str | Läs/skriv | Den aktiva talformatkodsträngen (t.ex., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Cellskyddsinställningar (låst, formel dold). |
ImageRenderOptions
copy
style.copy() -> StyleReturnerar en djup kopia av detta stilobjekt.
set_fill_color
style.set_fill_color(color: str)Ställer in den solida fyllningsbakgrundsfärgen. color är en RRGGBB-hexsträng (t.ex., "FFFF00" för gult).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Ställer in en mönstrad fyllning. pattern_type värden inkluderar '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()Rensar all fyllning och sätter cellens bakgrund till transparent (ingen fyllning).
set_border_color
style.set_border_color(side: str, color: str)Sätter färgen på en enskild kant. side måste vara en av 'top', 'bottom', 'left', 'right', 'diagonal'. color är en RRGGBB-hexsträng.
set_border_style
style.set_border_style(side: str, style: str)Ställer in linjestilen för en kantens sida. style värden: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Ställer in linjebredden (tjockleken) för en kant som ett heltal.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Bekvämlighetsmetod som sätter linjestil, färg och tjocklek för en enskild kant i ett enda anrop.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Ställer in den diagonala kanten. Skicka up=True för en uppåtriktad diagonal, down=True för en nedåtriktad diagonal, eller båda för att rita ett kors.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Ställer in horisontell textjustering. Värden: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Ställer in vertikal textjustering. Värden: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Aktiverar eller inaktiverar radbrytning av text inom cellen.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Aktiverar eller inaktiverar krympning för att passa. När den är aktiverad skalas texten ner för att passa cellens bredd.
set_indent
style.set_indent(indent: int)Ställer in indenteringsnivån (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Ställer in textrotation i grader. Giltiga värden är 0–180 (moturs från 0°) eller 255 (vertikal text staplad uppifrån och ner).
set_reading_order
style.set_reading_order(order: int)Ställer in läsriktningen. 0 = kontextberoende, 1 = vänster-till-höger, 2 = höger-till-vänster.
set_number_format
style.set_number_format(format_code: str)Tillämpar en anpassad talformatsträng (t.ex., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)Tillämpar ett av Excels inbyggda talformat med dess heltals-ID (t.ex., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)Markerar cellen som låst. Låsta celler kan inte redigeras när bladskydd är aktivt.
set_formula_hidden
style.set_formula_hidden(hidden=True)Döljer formler från formelfältet när bladskydd är aktivt.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Typsnittsfamiljens namn (t.ex., "Calibri", "Arial"). |
size | `int | float` |
color | str | Typsnittsfärg som en RRGGBB-hexsträng (t.ex., "FF0000" för röd). |
bold | bool | True för att applicera fet vikt. |
italic | bool | True för att applicera kursiv stil. |
underline | bool | True för att applicera enkel understrykning. |
strikethrough | bool | True för att tillämpa genomstrykning. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | Fyllmönster-typ (t.ex., 'solid', 'none', 'darkGray'). |
foreground_color | str | Förgrundsfärg som RRGGBB-hex. |
background_color | str | Bakgrundsfärg som RRGGBB-hex. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Tillämpar en solid fyllning med den angivna RRGGBB-färgen.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Tillämpar en tvåfärgsgradientfyllning.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Tillämpar en mönstrad fyllning med explicit förgrunds- och bakgrundsfärg.
set_no_fill
fill.set_no_fill()Tar bort all fyllning från cellen.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | Kantlinjestil: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Kantfärg som RRGGBB-hex. |
weight | int | Kanttjocklek (bredd) som ett heltal. |
ImageRenderOptions
ImageRenderOptions
Borders()En behållare för alla fyra cellkanter samt diagonala kanter.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Inställningar för övre kant. |
bottom | Border | Inställningar för nedre kant. |
left | Border | Inställningar för vänster kant. |
right | Border | Inställningar för höger kant. |
diagonal | Border | Inställningar för diagonal kant. |
diagonal_up | bool | True för att rita den uppåtriktade diagonala linjen. |
diagonal_down | bool | True för att rita den nedåtriktade diagonala linjen. |
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 | Horisontell justering: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Vertikal justering: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True för att radbryta text i cellen. |
indent | int | Indenteringsnivå (0–15). |
text_rotation | int | Textrotation i grader (0–180 eller 255 för staplad). |
shrink_to_fit | bool | True för att krympa text så att den får plats i cellen. |
NumberFormat
NumberFormat är en verktygsklass med endast statiska metoder. Den instansieras inte direkt.
Statiska metoder
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strReturnerar formatkodsträngen för det angivna inbyggda format-ID:t (t.ex., NumberFormat.get_builtin_format(9) returnerar "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True om den angivna formatkoden matchar ett känt inbyggt Excel-format.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneReturnerar det inbyggda format-ID:t för en formatkodsträng, eller None om koden inte är ett inbyggt format.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True betyder att cellen är låst när bladskydd är på (standard). |
hidden | bool | True betyder att alla formler i cellen är dolda i formelfältet när bladskydd är på. |
ImageRenderOptions
Följande exempel formaterar en rubrikcell med fet röd text, en gul bakgrund och en tunn svart kant på alla sidor.
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")