Shape

aspose-cells-foss støtter å legge til geometriske former og tekstbokser i regneark gjennom the ShapeCollection (ws.shapes). Hver form er representert av en Shape objekt med konfigurerbare fyll-, linje- og tekstegenskaper.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType er en IntEnum som identifiserer den geometriske formtypen.

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 er en IntEnum som identifiserer typen fyll som er brukt på en form.

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 er en IntEnum for kant-/omrisslinjens stiplemønster.


TextAlignmentType

TextAlignmentType er en IntEnum for horisontal tekstjustering innenfor en form.


TextAnchorType

TextAnchorType er en IntEnum for vertikal tekstforankring innenfor en form.


MsoFillFormat

Styrer fyllutseendet til en form. Tilgjengelig via shape.fill.

ImageRenderOptions

ImageRenderOptions

kopi

fill.copy() -> MsoFillFormat

Returnerer en dyp kopi av disse fyllinnstillingene.


MsoLineFormat

Styrer kontur-/kantutseendet til en form. Tilgjengelig via shape.line.

ImageRenderOptions

ImageRenderOptions

kopi

line.copy() -> MsoLineFormat

Returnerer en dyp kopi av disse linjeinnstillingene.


ShapeFont

Styrer tekstskriften innenfor en figur. Tilgjengelig via shape.font.

ImageRenderOptions

ImageRenderOptions

kopi

font.copy() -> ShapeFont

Returnerer en dyp kopi av disse fontinnstillingene.


ImageRenderOptions

Shape objekter konstrueres ikke direkte. Bruk ws.shapes.add(...) eller ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

kopi

shape.copy() -> Shape

Returnerer en dyp kopi av denne formen med all formatering bevart.


ShapeCollection

ShapeCollection tilgås som ws.shapes. Den inneholder alle figurer på et regneark.

ImageRenderOptions

legg til

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

Legger til en form av den angitte typen. Alle posisjonsargumenter er 0-baserte rad-/kolonneindekser.

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

Snarvei for add(MsoDrawingType.TEXT_BOX, ...).

Egenskaper og iterasjon


ImageRenderOptions

Legg til et rektangel med solid fyll

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

Legg til en tekstboks

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

Se også

 Norsk