Style — Aspose.Cells FOSS for Python API Reference

ImageRenderOptions Style la classe e i suoi tipi associati controllano tutta la formattazione visiva e di protezione applicata alle celle in aspose-cells-foss. A Style l’oggetto viene ottenuto da una cella tramite cell.get_style() e applicato nuovamente con cell.apply_style(style).

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, Protection

ImageRenderOptions

ImageRenderOptions

Style()

Crea un valore predefinito Style senza alcuna formattazione esplicita applicata.

ImageRenderOptions

ImageRenderOptions

copia

style.copy() -> Style

Restituisce una copia profonda di questo oggetto style.

set_fill_color

style.set_fill_color(color: str)

Imposta il colore di sfondo del riempimento solido. color è una stringa esadecimale RRGGBB (ad es., "FFFF00" per il giallo).

set_fill_pattern

style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')

Imposta un riempimento a trama. pattern_type i valori includono '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()

Cancella qualsiasi riempimento, impostando lo sfondo della cella a trasparente (nessun riempimento).

set_border_color

style.set_border_color(side: str, color: str)

Imposta il colore di un singolo lato del bordo. side deve essere uno tra 'top', 'bottom', 'left', 'right', 'diagonal'. color è una stringa esadecimale RRGGBB.

set_border_style

style.set_border_style(side: str, style: str)

Imposta lo stile della linea di un lato del bordo. style valori: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

style.set_border_weight(side: str, weight: int)

Imposta lo spessore della linea (spessore) di un lato del bordo come intero.

set_border

style.set_border(side: str, line_style='none', color='FF000000', weight=1)

Metodo di convenienza che imposta lo stile della linea, il colore e lo spessore per un singolo lato del bordo in una sola chiamata.

set_diagonal_border

style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)

Imposta il bordo diagonale. Passa up=True per una diagonale verso l’alto, down=True per una diagonale discendente, o entrambi per disegnare una croce.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Imposta l’allineamento orizzontale del testo. Valori: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Imposta l’allineamento verticale del testo. Valori: 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

Abilita o disabilita l’andare a capo del testo all’interno della cella.

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Abilita o disabilita la riduzione per adattamento. Quando abilitata, il testo viene ridotto per adattarsi alla larghezza della cella.

set_indent

style.set_indent(indent: int)

Imposta il livello di rientro (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Imposta la rotazione del testo in gradi. I valori validi sono 0–180 (in senso antiorario da 0°) o 255 (testo verticale impilato dall’alto verso il basso).

set_reading_order

style.set_reading_order(order: int)

Imposta l’ordine di lettura. 0 = dipendente dal contesto, 1 = da sinistra a destra, 2 = da destra a sinistra.

set_number_format

style.set_number_format(format_code: str)

Applica una stringa di formato numerico personalizzata (ad es., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Applica uno dei formati numerici predefiniti di Excel tramite il suo ID intero (ad es., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

Contrassegna la cella come bloccata. Le celle bloccate non possono essere modificate quando la protezione del foglio è attiva.

set_formula_hidden

style.set_formula_hidden(hidden=True)

Nasconde le formule dalla barra della formula quando la protezione del foglio è attiva.

ImageRenderOptions

ImageRenderOptions

Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions

set_solid_fill

fill.set_solid_fill(color: str)

Applica un riempimento solido con il colore RRGGBB fornito.

set_gradient_fill

fill.set_gradient_fill(start_color: str, end_color: str)

Applica un riempimento a gradiente a due colori.

set_pattern_fill

fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)

Applica un riempimento a motivo con colori di primo piano e di sfondo espliciti.

set_no_fill

fill.set_no_fill()

Rimuove qualsiasi riempimento dalla cella.

ImageRenderOptions

ImageRenderOptions

Border(line_style='none', color='FF000000', weight=1)

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

Borders()

Un contenitore per tutti e quattro i bordi della cella più i bordi diagonali.

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

Alignment(horizontal='general', vertical='bottom', wrap_text=False, indent=0, text_rotation=0, shrink_to_fit=False)

ImageRenderOptions

NumberFormat

NumberFormat è una classe di utilità con solo metodi statici. Non viene istanziata direttamente.

Metodi statici

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Restituisce la stringa del codice di formato per l’ID di formato incorporato fornito (ad es., NumberFormat.get_builtin_format(9) restituisce "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

ImageRenderOptions True se il codice di formato fornito corrisponde a un formato Excel incorporato noto.

lookup_builtin_format

NumberFormat.lookup_builtin_format(format_code: str) -> int | None

Restituisce l’ID di formato incorporato per una stringa di codice di formato, o None se il codice non è un formato incorporato.

ImageRenderOptions

ImageRenderOptions

Protection(locked=True, hidden=False)

ImageRenderOptions

ImageRenderOptions

Il seguente esempio formatta una cella di intestazione con testo rosso in grassetto, uno sfondo giallo e un bordo nero sottile su tutti i lati.

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")

Vedi anche

• Cells Python Riferimento API home
• Riferimento classe Workbook
• Riferimento classe Worksheet
• Riferimento alla classe Cell
• Guida introduttiva