Shape

Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss는 워크시트에 기하학적 도형 및 텍스트 상자를 추가하는 것을 지원합니다 ShapeCollection (ws.shapes). 각 도형은 Shape 구성 가능한 채우기, 선 및 텍스트 속성을 가진 객체.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import (
    MsoDrawingType, FillType, MsoLineDashStyle,
    TextAlignmentType, TextAnchorType,
    MsoFillFormat, MsoLineFormat, ShapeFont, Shape,
)

MsoDrawingType

MsoDrawingType 은 IntEnum 기하학적 도형 유형을 식별합니다.

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`UNKNOWN`	0	`TEXT_BOX`	21
`RECTANGLE`	1	`CALLOUT`	22
`ROUNDED_RECTANGLE`	2	`PENTAGON`	23
`OVAL`	3	`CLOUD`	24
`DIAMOND`	4	`HEART`	25
`TRIANGLE`	5	`LIGHTNING_BOLT`	26
`RIGHT_TRIANGLE`	6	`SMILEY_FACE`	27
`PARALLELOGRAM`	7	`LEFT_RIGHT_ARROW`	28
`TRAPEZOID`	8	`UP_DOWN_ARROW`	29
`HEXAGON`	9	`CUBE`	30
`OCTAGON`	10	`BEVEL`	31
`CROSS`	11	`STAR_4`	12
`RIGHT_ARROW`	17	`STAR_5`	13
`LEFT_ARROW`	18	`STAR_6`	14
`UP_ARROW`	19	`STAR_7`	15
`DOWN_ARROW`	20	`STAR_8`	16

FillType

FillType 은 IntEnum 도형에 적용된 채우기 유형을 식별합니다.

ImageRenderOptions	ImageRenderOptions
`NONE`	0
`SOLID`	1
`GRADIENT`	2
`PATTERN`	3
`AUTOMATIC`	4

MsoLineDashStyle

MsoLineDashStyle 은 IntEnum 테두리/외곽선 선 대시 패턴을 위한.

ImageRenderOptions	ImageRenderOptions
`SOLID`	0
`DASH`	1
`DOT`	2
`DASH_DOT`	3
`DASH_DOT_DOT`	4
`LONG_DASH`	5
`LONG_DASH_DOT`	6

TextAlignmentType

TextAlignmentType 은 IntEnum 도형 내 수평 텍스트 정렬을 위한.

ImageRenderOptions	ImageRenderOptions
`LEFT`	0
`CENTER`	1
`RIGHT`	2
`JUSTIFY`	3
`DISTRIBUTED`	4

TextAnchorType

TextAnchorType 은 IntEnum 도형 내 수직 텍스트 고정을 위한.

ImageRenderOptions	ImageRenderOptions
`TOP`	0
`MIDDLE`	1
`BOTTOM`	2
`JUSTIFIED`	3

MsoFillFormat

도형의 채우기 모양을 제어합니다. 다음을 통해 접근합니다 shape.fill.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`fill_type`	`FillType`	활성화된 채우기 유형.
`fore_color`	`str`	전경(기본) 채우기 색상은 RRGGBB 16진수 형식입니다.
`transparency`	`float`	채우기 불투명도는 값으로 지정합니다 `0.0` (완전 불투명)부터 `1.0` (완전 투명).

ImageRenderOptions

복사

fill.copy() -> MsoFillFormat

이 채우기 설정의 깊은 복사본을 반환합니다.

MsoLineFormat

도형의 외곽선/테두리 모양을 제어합니다. 다음을 통해 접근합니다 shape.line.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`is_visible`	`bool`	`True` 도형 외곽선을 그리기 위해.
`color`	`str`	외곽선 색상은 RRGGBB 16진수 형식입니다.
`weight`	`int`	외곽선 두께(굵기)는 포인트 단위입니다.
`dash_style`	`MsoLineDashStyle`	외곽선의 대시 패턴.
`transparency`	`float`	외곽선 불투명도는 다음에서 `0.0` (불투명)에서 `1.0` (투명)까지.

ImageRenderOptions

복사

line.copy() -> MsoLineFormat

이 선 설정의 깊은 복사본을 반환합니다.

ShapeFont

도형 내부 텍스트 폰트를 제어합니다. 다음을 통해 접근합니다. shape.font.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	`str`	폰트 패밀리 이름(예:., `"Calibri"`).
`size`	`float`	폰트 크기(포인트).
`bold`	`bool`	`True` 굵게(볼드) 적용.
`italic`	`bool`	`True` 이탤릭 스타일 적용.
`underline`	`bool`	`True` 단일 밑줄 적용.
`color`	`str`	폰트 색상은 RRGGBB 16진수 형식입니다.

ImageRenderOptions

복사

font.copy() -> ShapeFont

이 폰트 설정의 깊은 복사본을 반환합니다.

ImageRenderOptions

Shape 객체는 직접 생성되지 않습니다. 다음을 사용하세요. ws.shapes.add(...) 또는 ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	`str`	읽기/쓰기	도형 이름 (워크시트 내에서 고유해야 함).
`drawing_type`	`MsoDrawingType`	ImageRenderOptions	이 도형의 기하학적 유형.
`upper_left_row`	`int`	읽기/쓰기	0-based row index of the top-left anchor cell.
`upper_left_column`	`int`	읽기/쓰기	0-based column index of the top-left anchor cell.
`lower_right_row`	`int`	읽기/쓰기	0-based row index of the bottom-right anchor cell.
`lower_right_column`	`int`	읽기/쓰기	0-based column index of the bottom-right anchor cell.
`upper_left_row_offset`	`int`	읽기/쓰기	좌상단 셀의 위쪽 가장자리에서 픽셀 오프셋.
`upper_left_column_offset`	`int`	읽기/쓰기	좌상단 셀의 왼쪽 가장자리에서 픽셀 오프셋.
`lower_right_row_offset`	`int`	읽기/쓰기	우하단 셀의 위쪽 가장자리에서 픽셀 오프셋.
`lower_right_column_offset`	`int`	읽기/쓰기	우하단 셀의 왼쪽 가장자리에서 픽셀 오프셋.
`fill`	`MsoFillFormat`	ImageRenderOptions	채우기(배경) 설정.
`line`	`MsoLineFormat`	ImageRenderOptions	외곽선/테두리 설정.
`text`	`str`	읽기/쓰기	도형 내부에 표시되는 텍스트 내용.
`font`	`ShapeFont`	ImageRenderOptions	도형 텍스트에 대한 글꼴 설정.
`text_horizontal_alignment`	`TextAlignmentType`	읽기/쓰기	도형 내부의 가로 텍스트 정렬.
`text_vertical_alignment`	`TextAnchorType`	읽기/쓰기	도형 내부의 세로 텍스트 고정.
`is_text_wrapped`	`bool`	읽기/쓰기	`True` 텍스트를 도형 경계에서 자동 줄 바꿈하도록 합니다.
`is_locked`	`bool`	읽기/쓰기	`True` 워크시트 보호가 활성화된 경우 도형을 잠급니다.
`is_hidden`	`bool`	읽기/쓰기	`True` 도형을 숨깁니다.
`hyperlink`	`str	None`	읽기/쓰기

ImageRenderOptions

복사

shape.copy() -> Shape

모든 서식이 보존된 이 도형의 깊은 복사본을 반환합니다.

ShapeCollection

ShapeCollection 은(는) 다음과 같이 액세스됩니다 ws.shapes. 워크시트의 모든 도형을 포함합니다.

ImageRenderOptions

추가

ws.shapes.add(
    drawing_type: MsoDrawingType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

지정된 유형의 도형을 추가합니다. 모든 위치 인자는 0부터 시작하는 행/열 인덱스입니다.

add_text_box

ws.shapes.add_text_box(
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Shape

다음에 대한 바로 가기 add(MsoDrawingType.TEXT_BOX, ...).

속성 및 반복

ImageRenderOptions	ImageRenderOptions
`count`	컬렉션에 포함된 도형 수(읽기 전용).
`__len__()`	ImageRenderOptions `count`.
`__iter__()`	모든 항목을 반복합니다 `Shape` 객체들.
`__getitem__(index)`	다음을 반환합니다 `Shape` 0 기반에서 `index`.

ImageRenderOptions

단색 채우기 사각형 추가

from aspose.cells_foss import Workbook, MsoDrawingType, FillType, MsoLineDashStyle, TextAlignmentType

wb = Workbook()
ws = wb.worksheets[0]

# Add a blue rectangle spanning rows 1-5, columns 1-4 (0-based)
rect = ws.shapes.add(MsoDrawingType.RECTANGLE, 1, 1, 5, 4)
rect.name = "BlueBox"

rect.fill.fill_type = FillType.SOLID
rect.fill.fore_color = "4472C4"      # blue
rect.fill.transparency = 0.0

rect.line.is_visible = True
rect.line.color = "1F3864"           # dark blue
rect.line.weight = 2
rect.line.dash_style = MsoLineDashStyle.SOLID

rect.text = "Sales Summary"
rect.font.bold = True
rect.font.color = "FFFFFF"           # white text
rect.font.size = 12
rect.text_horizontal_alignment = TextAlignmentType.CENTER

wb.save("shapes.xlsx")

텍스트 상자 추가

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

tb = ws.shapes.add_text_box(2, 0, 5, 3)
tb.name = "NoteBox"
tb.text = "Review this section before publishing."
tb.font.italic = True
tb.font.color = "595959"
tb.is_text_wrapped = True
tb.line.is_visible = True
tb.line.color = "BFBFBF"

wb.save("textbox.xlsx")

Shape — Aspose.Cells FOSS for Python API Reference

MsoDrawingType

FillType

MsoLineDashStyle

TextAlignmentType

TextAnchorType

MsoFillFormat

ImageRenderOptions

ImageRenderOptions

복사

MsoLineFormat

ImageRenderOptions

ImageRenderOptions

복사

ShapeFont

ImageRenderOptions

ImageRenderOptions

복사

ImageRenderOptions

ImageRenderOptions

ImageRenderOptions

복사

ShapeCollection

ImageRenderOptions

추가

add_text_box

속성 및 반복

ImageRenderOptions

단색 채우기 사각형 추가

텍스트 상자 추가

참고