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
복사
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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | str | 글꼴 패밀리 이름(예:., "Calibri", "Arial"). |
size | `int | float` |
color | str | RRGGBB 16진수 문자열 형태의 글꼴 색상(예:,., "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 16진수로 지정합니다. |
background_color | str | 배경색을 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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
line_style | str | 테두리 선 스타일: 'none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'. |
color | str | 테두리 색을 RRGGBB 16진수로 지정합니다. |
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주어진 내장 형식 ID에 대한 형식 코드 문자열을 반환합니다 (예:., 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형식 코드 문자열에 대한 내장 형식 ID를 반환합니다, 또는 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")