Shape — Aspose.Cells FOSS for Python API Reference
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.
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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 là một IntEnum xác định loại fill được áp dụng cho một hình dạng.
| Enumerations | Enumerations |
|---|---|
NONE | 0 |
SOLID | 1 |
GRADIENT | 2 |
PATTERN | 3 |
AUTOMATIC | 4 |
MsoLineDashStyle
MsoLineDashStyle là một IntEnum cho mẫu dash của border/outline line dash pattern.
| Enumerations | Enumerations |
|---|---|
SOLID | 0 |
DASH | 1 |
DOT | 2 |
DASH_DOT | 3 |
DASH_DOT_DOT | 4 |
LONG_DASH | 5 |
LONG_DASH_DOT | 6 |
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.
| Enumerations | Enumerations |
|---|---|
LEFT | 0 |
CENTER | 1 |
RIGHT | 2 |
JUSTIFY | 3 |
DISTRIBUTED | 4 |
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.
| Enumerations | Enumerations |
|---|---|
TOP | 0 |
MIDDLE | 1 |
BOTTOM | 2 |
JUSTIFIED | 3 |
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 | Enumerations | Enumerations |
|---|---|---|
fill_type | FillType | Loại fill đang hoạt động. |
fore_color | str | Màu fill nền (chính) dưới dạng hex RRGGBB. |
transparency | float | Fill opacity là một giá trị từ 0.0 (hoàn toàn không trong suốt) đến 1.0 (hoàn toàn trong suốt). |
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 | Enumerations | Enumerations |
|---|---|---|
is_visible | bool | True để vẽ đường viền hình dạng. |
color | str | Màu đường viền dưới dạng hex RRGGBB. |
weight | int | Độ dày đường viền (thickness) tính bằng điểm. |
dash_style | MsoLineDashStyle | Mẫu gạch cho đường viền. |
transparency | float | Độ trong suốt của đường viền từ 0.0 (đặc) đến 1.0 (trong suốt). |
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 | Enumerations | Enumerations |
|---|---|---|
name | str | Tên họ phông chữ (ví dụ,., "Calibri"). |
size | float | Kích thước phông chữ tính bằng điểm. |
bold | bool | True để in đậm. |
italic | bool | True để in nghiêng. |
underline | bool | True để gạch chân đơn. |
color | str | Màu phông chữ dưới dạng hex RRGGBB. |
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 | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
name | str | Đọc/Ghi | Tên hình (phải là duy nhất trong bảng tính). |
drawing_type | MsoDrawingType | Enumerations | Kiểu hình học của hình này. |
upper_left_row | int | Đọc/Ghi | 0-based row index of the top-left anchor cell. |
upper_left_column | int | Đọc/Ghi | 0-based column index of the top-left anchor cell. |
lower_right_row | int | Đọc/Ghi | 0-based row index of the bottom-right anchor cell. |
lower_right_column | int | Đọc/Ghi | 0-based column index of the bottom-right anchor cell. |
upper_left_row_offset | int | Đọc/Ghi | Khoảng cách tính bằng pixel từ cạnh trên của ô trên‑trái. |
upper_left_column_offset | int | Đọc/Ghi | Khoảng cách tính bằng pixel từ cạnh trái của ô trên‑trái. |
lower_right_row_offset | int | Đọc/Ghi | Khoảng cách tính bằng pixel từ cạnh trên của ô dưới‑phải. |
lower_right_column_offset | int | Đọc/Ghi | Khoảng cách tính bằng pixel từ cạnh trái của ô dưới‑phải. |
fill | MsoFillFormat | Enumerations | Cài đặt tô (nền). |
line | MsoLineFormat | Enumerations | Cài đặt viền/đường viền. |
text | str | Đọc/Ghi | Nội dung văn bản hiển thị bên trong hình dạng. |
font | ShapeFont | Enumerations | Cài đặt phông chữ cho văn bản hình dạng. |
text_horizontal_alignment | TextAlignmentType | Đọc/Ghi | Căn chỉnh văn bản theo chiều ngang bên trong hình dạng. |
text_vertical_alignment | TextAnchorType | Đọc/Ghi | Neo văn bản dọc bên trong hình dạng. |
is_text_wrapped | bool | Đọc/Viết | True để bọc văn bản tại ranh giới của hình dạng. |
is_locked | bool | Đọc/Viết | True để khóa hình dạng khi bảo vệ bảng tính đang hoạt động. |
is_hidden | bool | Đọc/Viết | True để ẩn hình dạng. |
hyperlink | `str | None` | Đọc/Viết |
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 | Enumerations |
|---|---|
count | Số lượng hình dạng trong bộ sưu tập (chỉ đọc). |
__len__() | Enumerations count. |
__iter__() | Lặp lại qua tất cả Shape đối tượng. |
__getitem__(index) | Trả về Shape với chỉ số bắt đầu từ 0 index. |
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")