Shape
aspose-cells-foss hỗ trợ việc thêm các hình dạng hình học và hộp văn bản vào các bảng tính thông qua the ShapeCollection (ws.shapes). Mỗi hình dạng được biểu diễn bằng một Shape đối tượng có các thuộc tính fill, line và text có thể cấu hình.
Enumerations: aspose.cells_foss
from aspose.cells_foss import (
MsoDrawingType, FillType, MsoLineDashStyle,
TextAlignmentType, TextAnchorType,
MsoFillFormat, MsoLineFormat, ShapeFont, Shape,
)MsoDrawingType
MsoDrawingType là một IntEnum xác định loại hình dạng hình học.
| Name | Type | Access | Description |
|---|---|---|---|
upper_left_row | `` | Read/Write | Gets or sets the upper left row. |
upper_left_column | `` | Read/Write | Gets or sets the upper left column. |
lower_right_row | `` | Read/Write | Gets or sets the lower right row. |
lower_right_column | `` | Read/Write | Gets or sets the lower right column. |
upper_left_row_offset | `` | Read/Write | Gets or sets the upper left row offset. |
upper_left_column_offset | `` | Read/Write | Gets or sets the upper left column offset. |
lower_right_row_offset | `` | Read/Write | Gets or sets the lower right row offset. |
lower_right_column_offset | `` | Read/Write | Gets or sets the lower right column offset. |
name | `` | Read | Gets the name. |
drawing_type | `` | Read | Gets the drawing type. |
fill | `` | Read | Gets the fill. |
line | `` | Read | Gets the line. |
text | `` | Read | Gets the text. |
font | `` | Read | Gets the font. |
text_horizontal_alignment | `` | Read | Gets the text horizontal alignment. |
text_vertical_alignment | `` | Read | Gets the text vertical alignment. |
is_text_wrapped | `` | Read | Gets the is text wrapped. |
is_locked | `` | Read | Gets the is locked. |
is_hidden | `` | Read | Gets the is hidden. |
placement | `` | Read | Gets the placement. |
hyperlink | `` | Read | Gets the hyperlink. |
FillType
FillType là một IntEnum xác định loại fill được áp dụng cho một hình dạng.
| Signature | Description |
|---|---|
__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 là một IntEnum cho mẫu dash của border/outline line dash pattern.
TextAlignmentType
TextAlignmentType là một IntEnum cho căn chỉnh văn bản ngang bên trong một hình dạng.
TextAnchorType
TextAnchorType là một IntEnum cho việc neo văn bản dọc bên trong một hình dạng.
MsoFillFormat
Điều khiển giao diện fill của một hình dạng. Truy cập qua shape.fill.
Enumerations
Enumerations
copy
fill.copy() -> MsoFillFormatTrả về một bản sao sâu của các cài đặt fill này.
MsoLineFormat
Kiểm soát giao diện viền/đường viền của một hình dạng. Truy cập qua shape.line.
Enumerations
Enumerations
copy
line.copy() -> MsoLineFormatTrả về một bản sao sâu của các cài đặt line này.
ShapeFont
Điều khiển phông chữ văn bản bên trong một hình dạng. Truy cập qua shape.font.
Enumerations
Enumerations
copy
font.copy() -> ShapeFontTrả về một bản sao sâu của các cài đặt phông chữ này.
Enumerations
Shape các đối tượng không được tạo trực tiếp. Sử dụng ws.shapes.add(...) hoặc ws.shapes.add_text_box(...).
Enumerations
Enumerations
copy
shape.copy() -> ShapeTrả về một bản sao sâu của hình dạng này với mọi định dạng được bảo toàn.
ShapeCollection
ShapeCollection được truy cập như ws.shapes. Nó chứa tất cả các hình dạng trên một bảng tính.
Enumerations
add
ws.shapes.add(
drawing_type: MsoDrawingType,
upper_left_row: int,
upper_left_column: int,
lower_right_row: int,
lower_right_column: int
) -> ShapeThêm một hình dạng theo loại được chỉ định. Tất cả các đối số vị trí đều là chỉ số hàng/cột bắt đầu từ 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
) -> ShapePhím tắt cho add(MsoDrawingType.TEXT_BOX, ...).
Thuộc tính và Lặp lại
Enumerations
Thêm một Rectangle với Solid Fill
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")Thêm một Text Box
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")