Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss mendukung penambahan bentuk geometris dan kotak teks ke lembar kerja melalui the ShapeCollection (ws.shapes). Setiap bentuk direpresentasikan oleh sebuah Shape objek dengan properti fill, line, dan text yang dapat dikonfigurasi.

BoundingBoxExtent: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType adalah sebuah IntEnum yang mengidentifikasi tipe bentuk geometris.

FillType

FillType adalah sebuah IntEnum yang mengidentifikasi tipe fill yang diterapkan pada sebuah bentuk.

MsoLineDashStyle

MsoLineDashStyle adalah sebuah IntEnum untuk pola dash garis border/outline.

TextAlignmentType

TextAlignmentType adalah sebuah IntEnum untuk perataan teks horizontal di dalam sebuah bentuk.

TextAnchorType

TextAnchorType adalah sebuah IntEnum untuk penempatan teks vertikal di dalam sebuah bentuk.

MsoFillFormat

Mengontrol tampilan fill sebuah bentuk. Diakses melalui shape.fill.

BoundingBoxExtent

BoundingBoxExtent

salin

fill.copy() -> MsoFillFormat

Mengembalikan salinan mendalam dari pengaturan isian ini.

MsoLineFormat

Mengontrol tampilan outline/border sebuah bentuk. Diakses melalui shape.line.

BoundingBoxExtent

BoundingBoxExtent

salin

line.copy() -> MsoLineFormat

Mengembalikan salinan mendalam dari pengaturan garis ini.

ShapeFont

Mengontrol font teks dalam sebuah bentuk. Diakses melalui shape.font.

BoundingBoxExtent

BoundingBoxExtent

salin

font.copy() -> ShapeFont

Mengembalikan salinan mendalam dari pengaturan font ini.

BoundingBoxExtent

Shape objek tidak dibangun secara langsung. Gunakan ws.shapes.add(...) atau ws.shapes.add_text_box(...).

BoundingBoxExtent

BoundingBoxExtent

salin

shape.copy() -> Shape

Mengembalikan salinan mendalam dari bentuk ini dengan semua format dipertahankan.

ShapeCollection

ShapeCollection diakses sebagai ws.shapes. Ini berisi semua bentuk pada lembar kerja.

BoundingBoxExtent

Properties

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

Menambahkan bentuk dengan tipe yang ditentukan. Semua argumen posisi menggunakan indeks baris/kolom berbasis 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

Pintasan untuk add(MsoDrawingType.TEXT_BOX, ...).

ChartAxis diakses melalui chart.axes[index].

BoundingBoxExtent

Tambahkan Persegi Panjang dengan Isian Padat

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

Tambahkan Kotak Teks

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

Lihat Juga

• Properti dan Iterasi
• Referensi kelas Workbook
• NSeries
• Referensi diagram
• Memulai