Cells
Python
Shape

Shape

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.

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 adalah an IntEnum yang mengenal pasti jenis isian yang diterapkan pada bentuk.

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

 Bahasa Melayu