Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss palaiko geometrinių formų ir teksto laukelių pridėjimą į darbalapius per the ShapeCollection (ws.shapes). Kiekviena forma yra atvaizduojama kaip a Shape objektas su konfigūruojamomis užpildymo, linijos ir teksto savybėmis.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType yra IntEnum identifikuojantis geometrinės formos tipą.

FillType

FillType yra IntEnum identifikuojantis užpildymo tipą, taikomo formai.

MsoLineDashStyle

MsoLineDashStyle yra IntEnum skirtas krašto/apvado linijos brūkšnių modeliui.

TextAlignmentType

TextAlignmentType yra IntEnum skirtas horizontaliam teksto lygiavimui formoje.

TextAnchorType

TextAnchorType yra IntEnum skirtas vertikaliam teksto pritvirtinimui formoje.

MsoFillFormat

Valdo figūros užpildymo išvaizdą. Pasiekiama per shape.fill.

ImageRenderOptions

ImageRenderOptions

copy

fill.copy() -> MsoFillFormat

Grąžina gilų šių užpildymo nustatymų kopiją.

MsoLineFormat

Valdo figūros kontūro/kraštų išvaizdą. Pasiekiama per shape.line.

ImageRenderOptions

ImageRenderOptions

copy

line.copy() -> MsoLineFormat

Grąžina gilų šių linijos nustatymų kopiją.

ShapeFont

Valdo teksto šriftą figūroje. Pasiekiama per shape.font.

ImageRenderOptions

ImageRenderOptions

copy

font.copy() -> ShapeFont

Grąžina gilų šių šrifto nustatymų kopiją.

ImageRenderOptions

Shape objektai nėra kuriami tiesiogiai. Naudokite ws.shapes.add(...) arba ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

copy

shape.copy() -> Shape

Grąžina gilų šios figūros kopiją, išsaugant visą formatavimą.

ShapeCollection

ShapeCollection prieinama kaip ws.shapes. Jame yra visos darbalapio figūros.

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

Prideda figūrą nurodyto tipo. Visi pozicijos argumentai yra nulio pagrindo eilutės/stulpelio indeksai.

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

Spartusis klavišas add(MsoDrawingType.TEXT_BOX, ...).

Savybės ir iteravimas

ImageRenderOptions

Pridėti stačiakampį su vientisu užpildymu

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

Pridėti teksto laukelį

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

Žr. taip pat

• Cells Python API nuoroda pagrindinis
• Workbook klasės nuoroda
• Darbalapio klasės nuoroda
• Diagramų nuoroda
• Pradžia