Aspose.Cells FOSS
Shape

Shape

aspose-cells-foss 支持通过以下方式向工作表添加几何形状和文本框 ShapeCollection (ws.shapes). 每个形状由一个 Shape 对象，具有可配置的填充、线条和文本属性。.

Properties: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType 是一个 IntEnum 用于标识几何形状类型的.

NameTypeAccessDescription
upper_left_row``Read/WriteGets or sets the upper left row.
upper_left_column``Read/WriteGets or sets the upper left column.
lower_right_row``Read/WriteGets or sets the lower right row.
lower_right_column``Read/WriteGets or sets the lower right column.
upper_left_row_offset``Read/WriteGets or sets the upper left row offset.
upper_left_column_offset``Read/WriteGets or sets the upper left column offset.
lower_right_row_offset``Read/WriteGets or sets the lower right row offset.
lower_right_column_offset``Read/WriteGets or sets the lower right column offset.
name``ReadGets the name.
drawing_type``ReadGets the drawing type.
fill``ReadGets the fill.
line``ReadGets the line.
text``ReadGets the text.
font``ReadGets the font.
text_horizontal_alignment``ReadGets the text horizontal alignment.
text_vertical_alignment``ReadGets the text vertical alignment.
is_text_wrapped``ReadGets the is text wrapped.
is_locked``ReadGets the is locked.
is_hidden``ReadGets the is hidden.
placement``ReadGets the placement.
hyperlink``ReadGets the hyperlink.

FillType

FillType 是一个 IntEnum 用于标识形状所应用的填充类型的.

SignatureDescription
__init__(drawing_type, upper_left_row, upper_left_column, lower_right_row, lower_right_column)
copy()Creates a duplicate of the shape object

MsoLineDashStyle

MsoLineDashStyle 是一个 IntEnum 用于边框/轮廓线虚线模式的.

TextAlignmentType

TextAlignmentType 是一个 IntEnum 用于形状内部水平文本对齐的.

TextAnchorType

TextAnchorType 是一个 IntEnum 用于形状内部垂直文本锚定的.

MsoFillFormat

控制形状的填充外观。通过以下方式访问 shape.fill.

Properties

Properties

copy 

fill.copy() -> MsoFillFormat

返回这些填充设置的深拷贝。.

MsoLineFormat

控制形状的轮廓/边框外观。通过 shape.line.

Properties

Properties

copy 

line.copy() -> MsoLineFormat

返回这些线条设置的深拷贝。.

ShapeFont

控制形状内文本的字体。通过以下方式访问 shape.font.

Properties

Properties

copy 

font.copy() -> ShapeFont

返回这些字体设置的深拷贝。.

Properties

Shape 对象不能直接构造。请使用 ws.shapes.add(...) 或 ws.shapes.add_text_box(...).

Properties

Properties

copy 

shape.copy() -> Shape

返回此形状的深拷贝，保留所有格式设置。.

ShapeCollection

ShapeCollection 可访问为 ws.shapes. 它包含工作表上的所有形状。.

Properties

add 

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, ...).

属性和迭代

Properties

添加实心填充的矩形 

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

另见

 中文