Style — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Style класс и его сопутствующие типы управляют всей визуальной и защитной форматировкой, применяемой к ячейкам в aspose-cells-foss. A Style объект получается из ячейки с помощью cell.get_style() и применяется обратно с помощью cell.apply_style(style).
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import Style, Font, Fill, Border, Borders, Alignment, NumberFormat, ProtectionImageRenderOptions
ImageRenderOptions
Style()Создаёт значение по умолчанию Style без явного применения форматирования.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
font | Font | ImageRenderOptions | Настройки шрифта (имя, размер, цвет, полужирный, курсив, подчеркивание, зачеркивание). |
fill | Fill | ImageRenderOptions | Настройки заливки/фона ячейки (узор, цвет переднего плана, цвет фона). |
borders | Borders | ImageRenderOptions | Все настройки границ ячейки (верх, низ, слева, справа, диагональ). |
alignment | Alignment | ImageRenderOptions | Настройки выравнивания текста (горизонтальное, вертикальное, перенос, отступ, вращение). |
number_format | str | Чтение/Запись | Активная строка кода формата числа (например,., "#,##0.00"). |
protection | Protection | ImageRenderOptions | Настройки защиты ячейки (заблокировано, формула скрыта). |
ImageRenderOptions
copy
style.copy() -> StyleВозвращает глубокую копию этого объекта стиля.
set_fill_color
style.set_fill_color(color: str)Устанавливает сплошной цвет фона заливки. color является шестнадцатеричной строкой RRGGBB (например,., "FFFF00" для желтого).
set_fill_pattern
style.set_fill_pattern(pattern_type: str, fg_color: str = 'FFFFFFFF', bg_color: str = 'FFFFFFFF')Устанавливает узорчатую заливку. pattern_type значения включают '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()Очищает любую заливку, делая фон ячейки прозрачным (без заливки).
set_border_color
style.set_border_color(side: str, color: str)Устанавливает цвет одной стороны границы. side должно быть одним из 'top', 'bottom', 'left', 'right', 'diagonal'. color является шестнадцатеричной строкой RRGGBB.
set_border_style
style.set_border_style(side: str, style: str)Устанавливает стиль линии стороны границы. style значения: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
set_border_weight
style.set_border_weight(side: str, weight: int)Устанавливает толщину линии (ширину) стороны границы как целое число.
set_border
style.set_border(side: str, line_style='none', color='FF000000', weight=1)Удобный метод, который за один вызов задает стиль линии, цвет и толщину для одной стороны границы.
set_diagonal_border
style.set_diagonal_border(line_style='none', color='FF000000', weight=1, up=False, down=False)Устанавливает диагональную границу. Передайте up=True для восходящей диагонали, down=True для диагонали вниз, или оба для рисования крестика.
set_horizontal_alignment
style.set_horizontal_alignment(alignment: str)Устанавливает горизонтальное выравнивание текста. Значения: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
set_vertical_alignment
style.set_vertical_alignment(alignment: str)Устанавливает вертикальное выравнивание текста. Значения: 'top', 'center', 'bottom', 'justify', 'distributed'.
set_text_wrap
style.set_text_wrap(wrap=True)Включает или отключает перенос текста внутри ячейки.
set_shrink_to_fit
style.set_shrink_to_fit(shrink=True)Включает или отключает сжатие до размера. При включении текст масштабируется вниз, чтобы поместиться в ширину ячейки.
set_indent
style.set_indent(indent: int)Устанавливает уровень отступа (0–15).
set_text_rotation
style.set_text_rotation(rotation: int)Устанавливает поворот текста в градусах. Допустимые значения: 0–180 (против часовой стрелки от 0°) или 255 (вертикальный текст, расположенный сверху вниз).
set_reading_order
style.set_reading_order(order: int)Устанавливает порядок чтения. 0 = зависит от контекста, 1 = слева направо, 2 = справа налево.
set_number_format
style.set_number_format(format_code: str)Применяет пользовательскую строку формата числа (например,., "DD/MM/YYYY", "#,##0.00 [$€-407]").
set_builtin_number_format
style.set_builtin_number_format(format_id: int)Применяет один из встроенных числовых форматов Excel по его целочисленному идентификатору (например,., 9 = "0%", 14 = "m/d/yy").
set_locked
style.set_locked(locked=True)Помечает ячейку как заблокированную. Заблокированные ячейки нельзя редактировать, когда защита листа активна.
set_formula_hidden
style.set_formula_hidden(hidden=True)Скрывает формулы из строки формул, когда защита листа активна.
ImageRenderOptions
ImageRenderOptions
Font(name='Calibri', size=11, color='FF000000', bold=False, italic=False, underline=False, strikethrough=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | Название семейства шрифта (например,., "Calibri", "Arial"). |
size | `int | float` |
color | str | Цвет шрифта в виде шестнадцатеричной строки RRGGBB (например,., "FF0000" для красного). |
bold | bool | True для применения полужирного начертания. |
italic | bool | True для применения курсивного стиля. |
underline | bool | True для применения одинарного подчеркивания. |
strikethrough | bool | True для применения зачеркивания. |
ImageRenderOptions
ImageRenderOptions
Fill(pattern_type='none', foreground_color='FFFFFFFF', background_color='FFFFFFFF')ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
pattern_type | str | Тип заливки (например,., 'solid', 'none', 'darkGray'). |
foreground_color | str | Цвет переднего плана в виде шестнадцатеричного RRGGBB. |
background_color | str | Цвет фона в виде шестнадцатеричного RRGGBB. |
ImageRenderOptions
set_solid_fill
fill.set_solid_fill(color: str)Применяет сплошную заливку с указанным цветом RRGGBB.
set_gradient_fill
fill.set_gradient_fill(start_color: str, end_color: str)Применяет градиентную заливку из двух цветов.
set_pattern_fill
fill.set_pattern_fill(pattern_type: str, fg_color: str, bg_color: str)Применяет узорчатую заливку с явно заданными цветами переднего плана и фона.
set_no_fill
fill.set_no_fill()Удаляет любую заливку из ячейки.
ImageRenderOptions
ImageRenderOptions
Border(line_style='none', color='FF000000', weight=1)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | Стиль линии границы: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | Цвет границы в виде шестнадцатеричного RRGGBB. |
weight | int | Вес границы (толщина) как целое число. |
ImageRenderOptions
ImageRenderOptions
Borders()Контейнер для всех четырёх границ ячейки плюс диагональных границ.
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
top | Border | Настройки верхней границы. |
bottom | Border | Настройки нижней границы. |
left | Border | Настройки левой границы. |
right | Border | Настройки правой границы. |
diagonal | Border | Настройки диагональной границы. |
diagonal_up | bool | True для рисования восходящей диагональной линии. |
diagonal_down | bool | True для рисования нисходящей диагональной линии. |
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 | Горизонтальное выравнивание: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'. |
vertical | str | Вертикальное выравнивание: 'top', 'center', 'bottom', 'justify', 'distributed'. |
wrap_text | bool | True для переноса текста в ячейке. |
indent | int | Уровень отступа (0–15). |
text_rotation | int | Поворот текста в градусах (0–180 или 255 для сложенного). |
shrink_to_fit | bool | True для уменьшения текста до размеров ячейки. |
NumberFormat
NumberFormat является утилитным классом, содержащим только статические методы. Он не создаётся напрямую.
Статические методы
get_builtin_format
NumberFormat.get_builtin_format(format_id: int) -> strВозвращает строку кода формата для заданного встроенного идентификатора формата (например,., NumberFormat.get_builtin_format(9) возвращает "0%").
is_builtin_format
NumberFormat.is_builtin_format(format_code: str) -> boolImageRenderOptions True если указанный код формата соответствует известному встроенному формату Excel.
lookup_builtin_format
NumberFormat.lookup_builtin_format(format_code: str) -> int | NoneВозвращает встроенный идентификатор формата для строки кода формата, или None если код не является встроенным форматом.
ImageRenderOptions
ImageRenderOptions
Protection(locked=True, hidden=False)ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
locked | bool | True означает, что ячейка заблокирована, когда защита листа включена (по умолчанию). |
hidden | bool | True означает, что любая формула в ячейке скрыта в строке формул, когда защита листа включена. |
ImageRenderOptions
Следующий пример оформляет ячейку заголовка жирным красным текстом, желтым фоном и тонкой черной границей со всех сторон.
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")