Style — Aspose.Cells FOSS for Python API Reference

Examples Style la clase y sus tipos complementarios controlan todo el formato visual y de protección aplicado a las celdas en aspose-cells-foss. A Style el objeto se obtiene de una celda mediante cell.get_style() y se vuelve a aplicar con cell.apply_style(style).

Examples: aspose.cells_foss

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

Examples

Examples

Style()

Crea un valor predeterminado Style sin formato explícito aplicado.

Examples

Examples

copy

style.copy() -> Style

Devuelve una copia profunda de este objeto de estilo.

set_fill_color

style.set_fill_color(color: str)

Establece el color de fondo de relleno sólido. color es una cadena hexadecimal RRGGBB (p. ej., "FFFF00" para amarillo).

set_fill_pattern

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

Establece un relleno con patrón. pattern_type los valores incluyen '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()

Elimina cualquier relleno, estableciendo el fondo de la celda como transparente (sin relleno).

set_border_color

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

Establece el color de un solo lado del borde. side debe ser uno de 'top', 'bottom', 'left', 'right', 'diagonal'. color es una cadena hexadecimal RRGGBB.

set_border_style

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

Establece el estilo de línea de un lado del borde. style valores: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.

set_border_weight

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

Establece el grosor de la línea (espesor) de un lado del borde como un entero.

set_border

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

Método de conveniencia que establece el estilo de línea, el color y el grosor para un solo lado del borde en una sola llamada.

set_diagonal_border

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

Establece el borde diagonal. Pase up=True para una diagonal ascendente, down=True para una diagonal descendente, o ambas para dibujar una cruz.

set_horizontal_alignment

style.set_horizontal_alignment(alignment: str)

Establece la alineación horizontal del texto. Valores: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.

set_vertical_alignment

style.set_vertical_alignment(alignment: str)

Establece la alineación vertical del texto. Valores: 'top', 'center', 'bottom', 'justify', 'distributed'.

set_text_wrap

style.set_text_wrap(wrap=True)

Habilita o deshabilita el ajuste de texto dentro de la celda.

set_shrink_to_fit

style.set_shrink_to_fit(shrink=True)

Habilita o deshabilita la reducción para ajustar. Cuando está habilitado, el texto se escala hacia abajo para ajustarse al ancho de la celda.

set_indent

style.set_indent(indent: int)

Establece el nivel de sangría (0–15).

set_text_rotation

style.set_text_rotation(rotation: int)

Establece la rotación del texto en grados. Los valores válidos son 0–180 (en sentido antihorario desde 0°) o 255 (texto vertical apilado de arriba a abajo).

set_reading_order

style.set_reading_order(order: int)

Establece el orden de lectura. 0 = dependiente del contexto, 1 = de izquierda a derecha, 2 = de derecha a izquierda.

set_number_format

style.set_number_format(format_code: str)

Aplica una cadena de formato numérico personalizada (p. ej., "DD/MM/YYYY", "#,##0.00 [$€-407]").

set_builtin_number_format

style.set_builtin_number_format(format_id: int)

Aplica uno de los formatos numéricos incorporados de Excel mediante su ID entero (p. ej., 9 = "0%", 14 = "m/d/yy").

set_locked

style.set_locked(locked=True)

Marca la celda como bloqueada. Las celdas bloqueadas no pueden editarse cuando la protección de la hoja está activa.

set_formula_hidden

style.set_formula_hidden(hidden=True)

Oculta las fórmulas de la barra de fórmulas cuando la protección de la hoja está activa.

Examples

Examples

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

Examples

Examples

Examples

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

Examples

Examples

set_solid_fill

fill.set_solid_fill(color: str)

Aplica un relleno sólido con el color RRGGBB proporcionado.

set_gradient_fill

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

Aplica un relleno degradado de dos colores.

set_pattern_fill

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

Aplica un relleno con patrón con colores de primer plano y de fondo explícitos.

set_no_fill

fill.set_no_fill()

Elimina cualquier relleno de la celda.

Examples

Examples

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

Examples

Examples

Examples

Borders()

Un contenedor para los cuatro bordes de la celda más los bordes diagonales.

Examples

Examples

Examples

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

Examples

NumberFormat

NumberFormat es una clase de utilidad con solo métodos estáticos. No se instancia directamente.

Métodos estáticos

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

Devuelve la cadena de código de formato para el ID de formato incorporado dado (p. ej., NumberFormat.get_builtin_format(9) devuelve "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

Examples True si el código de formato proporcionado coincide con un formato integrado conocido de Excel.

lookup_builtin_format

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

Devuelve el ID de formato integrado para una cadena de código de formato, o None si el código no es un formato integrado.

Examples

Examples

Protection(locked=True, hidden=False)

Examples

Examples

El siguiente ejemplo da estilo a una celda de encabezado con texto rojo en negrita, un fondo amarillo y un borde negro delgado en todos los lados.

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

Ver también

• Celdas Python API Reference home
• Referencia de la clase Workbook
• Referencia de la clase Worksheet
• Referencia de la clase Cell
• Primeros pasos