Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style klase un tās pavadības tipi kontrolē visu vizuālo un aizsargājošo formatēšanu, kas tiek piemērota šūnām aspose-cells-foss. A Style objekts tiek iegūts no šūnas, izmantojot cell.get_style() un atpakaļ piemērots ar cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Izveido noklusējuma Style bez pievienotas skaidras formatēšanas.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Fonta iestatījumi (nosaukums, izmērs, krāsa, treknraksts, slīpraksts, pasvītrojums, pārsvītrojums). |
fill | Fill | ImageRenderOptions | Šūnas aizpildījuma/fona iestatījumi (raksts, priekšplāna krāsa, fona krāsa). |
borders | Borders | ImageRenderOptions | Visi šūnas robežu iestatījumi (augšējā, apakšējā, kreisā, labā, diagonāla). |
alignment | Alignment | ImageRenderOptions | Teksta līdzināšanas iestatījumi (horizontāls, vertikāls, pārnešana, atkāpe, rotācija). |
number_format | str | Lasīt/Rakstīt | Aktīvā skaitļu formāta koda virkne (piemēram,., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Šūnas aizsardzības iestatījumi (noslēgts, formula slēpta). |
ImageRenderOptions
kopēt
style.copy() -> StyleAtgriež dziļu kopiju šī stila objekta.
set_fill_color
style.set_fill_color(color: str)Iestata viendabīgu fona aizpildījuma krāsu. color ir RRGGBB heksadecimāla virkne (piemēram,., "FFFF00" dzeltenai).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Iestata rakstainu aizpildījumu. pattern_type vērtības ietver '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()Notīra jebkuru aizpildījumu, iestatot šūnas fonu caurspīdīgu (bez aizpildījuma).
set_border_color
style.set_border_color(side: str, color: str)Iestata viena robežas malas krāsu. side jābūt kādam no 'top', 'bottom', 'left', 'right', 'diagonal'. color ir RRGGBB heksadecimālais virkne.
set_border_style
style.set_border_style(side: str, style: str)Iestata robežas malas līnijas stilu. style vērtības: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Iestata robežas malas līnijas svaru (biezumu) kā veselu skaitli.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Ērtuma metode, kas vienā izsaukumā iestata līnijas stilu, krāsu un svaru vienai robežas malai.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Iestata diagonālo robežu. Pārsūti up=True augšupvērstai diagonālei, down=True lejupvērstai diagonālei vai abus, lai uzzīmētu krustu.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Iestata horizontālo teksta līdzināšanu. Vērtības: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Iestata vertikālo teksta līdzināšanu. Vērtības: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Ieslēdz vai izslēdz teksta aplaušanu šūnā.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Ieslēdz vai izslēdz samazināšanu, lai ietilptu. Kad ieslēgts, teksts tiek samazināts, lai ietilptu šūnas platumā.
set_indent
style.set_indent(indent: int)Iestata atkāpju līmeni (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Iestata teksta rotāciju grādos. Derīgās vērtības ir 0–180 (pret pulksteņa rādītāju virzienam no 0°) vai 255 (vertikāls teksts sakārtots no augšas uz leju).
set_reading_order
style.set_reading_order(order: int)Iestata lasīšanas kārtību. 0 = konteksts atkarīgs, 1 = no kreisās uz labo, 2 = no labās uz kreiso.
set_number_format
style.set_number_format(format_code: str)= Pielieto pielāgotu skaitļu formāta virkni (piemēram,., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)= Pielieto kādu no Excel iebūvētiem skaitļu formātiem, izmantojot tā veselo skaitļa ID (piemēram,., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)Atzīmē šūnu kā bloķētu. Bloķētas šūnas nevar rediģēt, ja darblapas aizsardzība ir aktivizēta.
set_formula_hidden
style.set_formula_hidden(hidden=True)Paslēpj formulas no formulas joslas, kad darblapas aizsardzība ir aktivizēta.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | = Fonta ģimenes nosaukums (piemēram,., "Calibri", "Arial"). |
size | `int | float` |
color | str | Fonta krāsa kā RRGGBB heksadecimālais virkne (piemēram,., "FF0000" sarkanai). |
bold | bool | True lai piemērotu treknu svaru. |
italic | bool | True lai piemērotu slīpraksta stilu. |
underline | bool | True lai piemērotu vienkāršu pasvītrojumu. |
strikethrough | bool | True lai lietotu pārsvītrojumu. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | Aizpildījuma raksta veids (piemēram,., 'solid', 'none', 'darkGray'). |
foreground_color | str | Priekšplāna krāsa kā RRGGBB heksadecimālais kods. |
background_color | str | Fona krāsa kā RRGGBB heksadecimālais kods. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Pielieto vienkrāsainu aizpildījumu ar norādīto RRGGBB krāsu.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Pielieto divkrāsas gradienta aizpildījumu.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Pielieto rakstainu aizpildījumu ar skaidri norādītām priekšplāna un fona krāsām.
set_no_fill
fill.set_no_fill()Noņem jebkuru aizpildījumu no šūnas.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | Rāmis līnijas stils: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Rāmja krāsa kā RRGGBB heksadecimālais kods. |
weight | int | Rāmja biezums (tievums) kā vesels skaitlis. |
ImageRenderOptions
ImageRenderOptions
Borders()Konteinērs visām četrām šūnas malām plus diagonālajām malām.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Augšējā rāmja iestatījumi. |
bottom | Border | Apakšējā rāmja iestatījumi. |
left | Border | Kreisā rāmja iestatījumi. |
right | Border | Labā rāmja iestatījumi. |
diagonal | Border | Diagonāla rāmja iestatījumi. |
diagonal_up | bool | True lai uzzīmētu augšupvērsto diagonālo līniju. |
diagonal_down | bool | True lai uzzīmētu lejupvērsto diagonālo līniju. |
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 | Horizontālā izlīdzināšana: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Vertikālā izlīdzināšana: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True lai aplauztu tekstu šūnā. |
indent | int | Atkāpju līmenis (0–15). |
text_rotation | int | Teksta rotācija grādos (0–180 vai 255, lai sakrauts). |
shrink_to_fit | bool | True lai samazinātu tekstu, lai tas ietilptu šūnā. |
NumberFormat
NumberFormat ir utilītklase, kurā ir tikai statiskās metodes. Tā netiek tieši instanceizēta.
Statiskās metodes
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strAtgriež formāta koda virkni dotajam iebūvētajam formāta ID (piemēram,., NumberFormat.get_builtin_format(9) atgriež "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True ja dotais formāta kods atbilst zināmam iebūvētajam Excel formātam.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneAtgriež iebūvēto formāta ID formāta koda virknei, vai None ja kods nav iebūvēts formāts.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True norāda, ka šūna ir bloķēta, kad darblapas aizsardzība ir ieslēgta (noklusējums). |
hidden | bool | True norāda, ka jebkura formula šūnā tiek paslēpta formulas joslā, kad darblapas aizsardzība ir ieslēgta. |
ImageRenderOptions
Sekojošais piemērs stilizē galvenes šūnu ar treknu sarkanu tekstu, dzeltenu fonu un plonu melnu rāmi visās pusēs.
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")