Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style klasė ir jos gretutiniai tipai valdo visą vizualinį ir apsauginį formatavimą, taikomą langeliams aspose-cells-foss. A Style objektas gaunamas iš langelio per cell.get_style() ir pritaikomas atgal su cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Sukuria numatytąjį Style be jokio aiškaus formatavimo.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Šrifto nustatymai (pavadinimas, dydis, spalva, pusjuodis, kursyvas, pabraukimas, perbraukimas). |
fill | Fill | ImageRenderOptions | Langelio užpildymo/fono nustatymai (raštas, priekinės spalvos, fono spalvos). |
borders | Borders | ImageRenderOptions | Visi langelio kraštų nustatymai (viršus, apačia, kairė, dešinė, įstrižas). |
alignment | Alignment | ImageRenderOptions | Teksto lygiavimo nustatymai (horizontaliai, vertikaliai, perkėlimas, įtraukimas, sukimas). |
number_format | str | Skaityti/Rašyti | Aktyvus skaičių formato kodo eilutė (pvz., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Langelio apsaugos nustatymai (užrakintas, formulė paslėpta). |
ImageRenderOptions
copy
style.copy() -> StyleGrąžina šio stiliaus objekto gilų kopiją.
set_fill_color
style.set_fill_color(color: str)Nustato vientiso užpildymo fono spalvą. color yra RRGGBB šešioliktainė eilutė (pvz., "FFFF00" geltonai).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Nustato raštinį užpildą. pattern_type reikšmės apima '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()Išvalo bet kokį užpildą, nustatydamas langelio foną kaip permatoma (be užpildo).
set_border_color
style.set_border_color(side: str, color: str)Nustato vienos kraštinės spalvą. side turi būti vienas iš 'top', 'bottom', 'left', 'right', 'diagonal'. color yra RRGGBB šešioliktainė eilutė.
set_border_style
style.set_border_style(side: str, style: str)Nustato kraštinės linijos stilių. style reikšmės: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Nustato krašto pusės linijos storį (storis) kaip sveikąjį skaičių.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Patogus metodas, kuris vienu iškvietimu nustato linijos stilių, spalvą ir storį vienai krašto pusei.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Nustato įstrižą kraštą. Praleiskite up=True aukštyn įstrižai, down=True žemyn įstrižai, arba abu, kad nupieštumėte kryžiaus formą.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Nustato horizontalią teksto lygiavimą. Reikšmės: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Nustato vertikalų teksto lygiavimą. Reikšmės: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Įjungia arba išjungia teksto perkėlimą į kitą eilutę ląstelėje.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Įjungia arba išjungia susitraukimą iki talpinimo. Kai įjungta, tekstas sumažinamas, kad tilptų į ląstelės plotį.
set_indent
style.set_indent(indent: int)Nustato įtraukos lygį (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Nustato teksto pasukimą laipsniais. Galimos reikšmės: 0–180 (prieš laikrodžio rodyklę nuo 0°) arba 255 (vertikalus tekstas išdėstytas iš viršaus į apačią).
set_reading_order
style.set_reading_order(order: int)Nustato skaitymo tvarką. 0 = priklauso nuo konteksto, 1 = iš kairės į dešinę, 2 = dešinė į kairę.
set_number_format
style.set_number_format(format_code: str)= Taikoma pasirinktinė skaičių formato eilutė (pvz., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)= Taikoma viena iš Excel įmontuotų skaičių formatų pagal jos sveikąjį ID (pvz., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)Žymi langelį kaip užrakintą. Užrakinti langeliai negali būti redaguojami, kai aktyvuota darbalapio apsauga.
set_formula_hidden
style.set_formula_hidden(hidden=True)Paslėpia formules iš formulės juostos, kai aktyvuota darbalapio apsauga.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | = Šrifto šeimos pavadinimas (pvz., "Calibri", "Arial"). |
size | `int | float` |
color | str | = Šrifto spalva kaip RRGGBB šešioliktainė eilutė (pvz., "FF0000" = raudonai). |
bold | bool | True = taikyti pusjuodį šriftą. |
italic | bool | True = taikyti kursyvinį stilių. |
underline | bool | True = taikyti viengubą pabraukimą. |
strikethrough | bool | True = taikyti perbraukimą. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | = Užpildo rašto tipas (pvz., 'solid', 'none', 'darkGray'). |
foreground_color | str | = Priekinės spalvos kaip RRGGBB šešioliktainė. |
background_color | str | = Fono spalva kaip RRGGBB šešioliktainė. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Taikoma vientisa užpildas su nurodyta RRGGBB spalva.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Taikoma dviejų spalvų gradientinis užpildas.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Taikoma rašto užpildas su aiškiai nurodytais priekinės ir fono spalvomis.
set_no_fill
fill.set_no_fill()Pašalina bet kokį užpildą iš langelio.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | = Rėmelio linijos stilius: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Kraštinės spalva kaip RRGGBB šešioliktainis. |
weight | int | Kraštinės storis (plotis) kaip sveikasis skaičius. |
ImageRenderOptions
ImageRenderOptions
Borders()Konteineris visiems keturiems langelio kraštams ir įstrižiems kraštams.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Viršutinės kraštinės nustatymai. |
bottom | Border | Apatinės kraštinės nustatymai. |
left | Border | Kairės kraštinės nustatymai. |
right | Border | Dešinės kraštinės nustatymai. |
diagonal | Border | Įstrižos kraštinės nustatymai. |
diagonal_up | bool | True nupiešti į viršų įstrižą liniją. |
diagonal_down | bool | True nupiešti į apačią įstrižą liniją. |
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 | Horizontalus lygiavimas: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Vertikalus lygiavimas: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True laukyti teksto perkėlimo į kitą eilutę langelyje. |
indent | int | Įtraukos lygis (0–15). |
text_rotation | int | Teksto sukimas laipsniais (0–180 arba 255, kai tekstas sukraunamas). |
shrink_to_fit | bool | True sumažinti tekstą, kad tilptų į langelį. |
NumberFormat
NumberFormat yra pagalbinė klasė, turinti tik statinius metodus. Ji nėra tiesiogiai instancijuojama.
Statiniai metodai
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strGrąžina formato kodo eilutę nurodytam įterptam formato ID (pvz., NumberFormat.get_builtin_format(9) gražina "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True jei pateiktas formato kodas atitinka žinomą įmontuotą Excel formatą.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneGrąžina įmontuoto formato ID formatų kodo eilutei, arba None jei kodas nėra įmontuotas formatas.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True reiškia, kad langelis yra užrakintas, kai worksheet protection įjungta (numatyta). |
hidden | bool | True reiškia, kad bet kuri formulė ląstelėje yra paslėpta formulės juostoje, kai worksheet protection įjungta. |
ImageRenderOptions
Šiame pavyzdyje antraštės langelis stiliuojamas paryškintu raudonu tekstu, geltonu fonu ir plonu juodu kraštu iš visų pusių.
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")