Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss menyokong penambahan bentuk geometri dan kotak teks ke lembar kerja melalui the ShapeCollection (ws.shapes). Setiap bentuk diwakili oleh a Shape objek dengan sifat isian, garis, dan teks yang boleh dikonfigurasi.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType adalah an IntEnum yang mengenal pasti jenis bentuk geometri.

FillType

FillType adalah an IntEnum yang mengenal pasti jenis isian yang diterapkan pada bentuk.

MsoLineDashStyle

MsoLineDashStyle adalah an IntEnum untuk corak dash garis sempadan/garis luar.

TextAlignmentType

TextAlignmentType adalah an IntEnum untuk penjajaran teks mendatar dalam bentuk.

TextAnchorType

TextAnchorType adalah an IntEnum untuk penambatan teks menegak dalam bentuk.

MsoFillFormat

Mengawal penampilan isian bentuk. Diakses melalui shape.fill.

ImageRenderOptions

ImageRenderOptions

salin

fill.copy() -> MsoFillFormat

Mengembalikan salinan mendalam bagi tetapan isian ini.

MsoLineFormat

Mengawal penampilan garis luar/sempadan sesuatu bentuk. Diakses melalui shape.line.

ImageRenderOptions

ImageRenderOptions

salin

line.copy() -> MsoLineFormat

Mengembalikan salinan mendalam bagi tetapan garisan ini.

ShapeFont

Mengawal fon teks dalam bentuk. Diakses melalui shape.font.

ImageRenderOptions

ImageRenderOptions

salin

font.copy() -> ShapeFont

Mengembalikan salinan mendalam bagi tetapan fon ini.

ImageRenderOptions

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

ImageRenderOptions

ImageRenderOptions

salin

shape.copy() -> Shape

Mengembalikan salinan mendalam bagi bentuk ini dengan semua pemformatan dipelihara.

ShapeCollection

ShapeCollection diakses sebagai ws.shapes. Ia mengandungi semua bentuk pada lembar kerja.

ImageRenderOptions

add

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

Menambah bentuk jenis yang ditentukan. Semua argumen kedudukan adalah indeks baris/kolum berasaskan 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, ...).

Sifat dan Iterasi

ImageRenderOptions

Tambah Segi Empat dengan Isian Pepejal

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

Tambah 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

• Sel Python Rujukan API laman utama
• Rujukan kelas Workbook
• Rujukan kelas Worksheet
• Rujukan Carta
• Mula Menggunakan