Aspose.Cells FOSS
Python
Shape

Shape

aspose-cells-foss stöder att lägga till geometriska former och textrutor i kalkylblad genom den ShapeCollection (ws.shapes). Varje form representeras av en Shape objekt med konfigurerbara fyllnings-, linje- och textegenskaper.

ImageRenderOptions: aspose.cells_foss

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

MsoDrawingType

MsoDrawingType är en IntEnum som identifierar den geometriska 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 är en IntEnum som identifierar typen av fyllning som tillämpas 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 är en IntEnum för kant-/konturlinjens streckmönster.

TextAlignmentType

TextAlignmentType är en IntEnum för horisontell textjustering inom en form.

TextAnchorType

TextAnchorType är en IntEnum för vertikal textförankring inom en form.

MsoFillFormat

Styr fyllningsutseendet för en form. Åtkomst via shape.fill.

ImageRenderOptions

ImageRenderOptions

copy 

fill.copy() -> MsoFillFormat

Returnerar en djup kopia av dessa fyllningsinställningar.

MsoLineFormat

Kontrollerar kontur-/kantutseendet för en form. Åtkomst via shape.line.

ImageRenderOptions

ImageRenderOptions

copy 

line.copy() -> MsoLineFormat

Returnerar en djup kopia av dessa linjeinställningar.

ShapeFont

Styr textens teckensnitt inom en form. Åtkomst via shape.font.

ImageRenderOptions

ImageRenderOptions

copy 

font.copy() -> ShapeFont

Returnerar en djup kopia av dessa teckensnittinställningar.

ImageRenderOptions

Shape objekt konstrueras inte direkt. Använd ws.shapes.add(...) eller ws.shapes.add_text_box(...).

ImageRenderOptions

ImageRenderOptions

copy 

shape.copy() -> Shape

Returnerar en djup kopia av denna form med all formatering bevarad.

ShapeCollection

ShapeCollection åtkomst sker som ws.shapes. Den innehåller alla figurer på ett kalkylblad.

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

Lägger till en form av den angivna typen. Alla positionsargument är 0-baserade rad-/kolumnindex.

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

Genväg för add(MsoDrawingType.TEXT_BOX, ...).

Egenskaper och iteration

ImageRenderOptions

Lägg till en rektangel med solid fyllning 

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

Lägg till en textruta 

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

 Svenska