Shape — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss obsługuje dodawanie kształtów geometrycznych i pól tekstowych do arkuszy poprzez ShapeCollection (ws.shapes). Każdy kształt jest reprezentowany przez Shape obiekt z konfigurowalnymi właściwościami wypełnienia, linii i tekstu.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType jest IntEnum identyfikującym typ kształtu geometrycznego.

FillType

FillType jest IntEnum identyfikującym typ wypełnienia zastosowanego do kształtu.

MsoLineDashStyle

MsoLineDashStyle jest IntEnum dla wzoru kreskowania linii obramowania/konturu.

TextAlignmentType

TextAlignmentType jest IntEnum dla poziomego wyrównania tekstu wewnątrz kształtu.

TextAnchorType

TextAnchorType jest IntEnum dla pionowego kotwiczenia tekstu wewnątrz kształtu.

MsoFillFormat

Kontroluje wygląd wypełnienia kształtu. Dostępny przez shape.fill.

ImageRenderOptions

ImageRenderOptions

kopiuj

fill.copy() -> MsoFillFormat

Zwraca głęboką kopię tych ustawień wypełnienia.

MsoLineFormat

Kontroluje wygląd konturu/brzegu kształtu. Dostępny przez shape.line.

ImageRenderOptions

ImageRenderOptions

kopiuj

line.copy() -> MsoLineFormat

Zwraca głęboką kopię tych ustawień linii.

ShapeFont

Kontroluje czcionkę tekstu wewnątrz kształtu. Dostępne przez shape.font.

ImageRenderOptions

ImageRenderOptions

kopiuj

font.copy() -> ShapeFont

Zwraca głęboką kopię tych ustawień czcionki.

ImageRenderOptions

Shape obiekty nie są tworzone bezpośrednio. Użyj ws.shapes.add(...) lub ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopiuj

shape.copy() -> Shape

Zwraca głęboką kopię tego kształtu ze wszystkimi zachowanymi formatowaniami.

ShapeCollection

ShapeCollection jest dostępny jako ws.shapes. Zawiera wszystkie kształty na arkuszu.

ImageRenderOptions

dodaj

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

Dodaje kształt określonego typu. Wszystkie argumenty pozycji są indeksami wiersza/kolumny zaczynającymi się od 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

Skrót do add(MsoDrawingType.TEXT_BOX, ...).

Właściwości i iteracja

ImageRenderOptions

Dodaj prostokąt z wypełnieniem jednolitym

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

Dodaj pole tekstowe

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

Zobacz także

• Cells Python API Reference strona główna
• Referencja klasy Workbook
• Referencja klasy Worksheet
• Odwołanie do wykresu
• Rozpoczęcie