Style

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, Protection

ImageRenderOptions

ImageRenderOptions

Style()

기본값을 생성합니다 Style 명시적인 서식이 적용되지 않은 상태로.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
fontFontImageRenderOptions글꼴 설정(이름, 크기, 색상, 굵게, 기울임, 밑줄, 취소선).
fillFillImageRenderOptions셀 채우기/배경 설정(패턴, 전경 색상, 배경 색상).
bordersBordersImageRenderOptions셀에 대한 모든 테두리 설정(위, 아래, 왼쪽, 오른쪽, 대각선).
alignmentAlignmentImageRenderOptions텍스트 정렬 설정(수평, 수직, 자동 줄바꿈, 들여쓰기, 회전).
number_formatstr읽기/쓰기활성 숫자 형식 코드 문자열(예:., "#,##0.00").
protectionProtectionImageRenderOptions셀 보호 설정(잠금, 수식 숨김).

ImageRenderOptions

복사

style.copy() -> Style

이 스타일 객체의 깊은 복사본을 반환합니다.

set_fill_color

style.set_fill_color(color: str)

단색 채우기 배경 색상을 설정합니다. color 는 RRGGBB 16진수 문자열입니다(예:., "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 16진수 문자열입니다.

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에 내장된 숫자 형식 중 하나를 정수 ID로 적용합니다(예:., 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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
namestr글꼴 패밀리 이름(예:., "Calibri", "Arial").
size`intfloat`
colorstrRRGGBB 16진수 문자열 형태의 글꼴 색상(예:,., "FF0000" 빨간색용).
boldboolTrue 굵게 적용하려면.
italicboolTrue 기울임꼴을 적용하려면.
underlineboolTrue 단일 밑줄을 적용하려면.
strikethroughboolTrue 취소선을 적용하려면.

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
pattern_typestr채우기 패턴 유형 (예:., 'solid', 'none', 'darkGray').
foreground_colorstr전경색을 RRGGBB 16진수로 지정합니다.
background_colorstr배경색을 RRGGBB 16진수로 지정합니다.

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

ImageRenderOptionsImageRenderOptionsImageRenderOptions
line_stylestr테두리 선 스타일: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'.
colorstr테두리 색을 RRGGBB 16진수로 지정합니다.
weightint테두리 두께(굵기)를 정수로 지정합니다.

ImageRenderOptions

ImageRenderOptions

Borders()

네 개의 셀 테두리와 대각선 테두리를 모두 포함하는 컨테이너입니다.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
topBorder위쪽 테두리 설정.
bottomBorder아래쪽 테두리 설정.
leftBorder왼쪽 테두리 설정.
rightBorder오른쪽 테두리 설정.
diagonalBorder대각선 테두리 설정.
diagonal_upboolTrue 위쪽 대각선 선을 그리려면.
diagonal_downboolTrue 아래쪽 대각선 선을 그리려면.

ImageRenderOptions

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
horizontalstr수평 정렬: 'general', 'left', 'center', 'right', 'fill', 'justify', 'centerContinuous', 'distributed'.
verticalstr수직 정렬: 'top', 'center', 'bottom', 'justify', 'distributed'.
wrap_textboolTrue 셀 내에서 텍스트를 자동으로 줄 바꿈합니다.
indentint들여쓰기 수준 (0–15).
text_rotationint텍스트 회전 각도 (0–180 또는 겹쳐 표시 시 255).
shrink_to_fitboolTrue 셀에 맞게 텍스트를 축소합니다.

NumberFormat

NumberFormat 정적 메서드만을 가진 유틸리티 클래스입니다. 직접 인스턴스화되지 않습니다.

정적 메서드

get_builtin_format

NumberFormat.get_builtin_format(format_id: int) -> str

주어진 내장 형식 ID에 대한 형식 코드 문자열을 반환합니다 (예:., NumberFormat.get_builtin_format(9) 반환합니다 "0%").

is_builtin_format

NumberFormat.is_builtin_format(format_code: str) -> bool

ImageRenderOptions True 주어진 형식 코드가 알려진 내장 Excel 형식과 일치하는 경우.

lookup_builtin_format

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

형식 코드 문자열에 대한 내장 형식 ID를 반환합니다, 또는 None 코드가 내장 형식이 아닌 경우.


ImageRenderOptions

ImageRenderOptions

Protection(locked=True, hidden=False)

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
lockedboolTrue 워크시트 보호가 켜져 있을 때 셀이 잠겨 있음을 의미합니다 (기본값).
hiddenboolTrue 워크시트 보호가 켜져 있을 때 셀의 모든 수식이 수식 입력줄에 숨겨짐을 의미합니다.

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

참고

 한국어